Version 7.0 for WINDOWS NT® 4.0 for WINDOWS® 98 for WINDOWS® 95
User Guide
WRQ
Reflection Reflection Reflection
®
WRQ
for HP with NS/VT
®
WRQ
for UNIX and Digital
®
for ReGIS Graphics
Copyright © 1994–1998 by WRQ, Inc. All rights reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language, in any form by any means, without the written permission of WRQ, Inc. Visual Basic © 1996, Microsoft Corporation. All rights reserved. Reflection for HP with NS/VT Reflection for UNIX and Digital Reflection for ReGIS Graphics User Guide Version 7.0 September 1998
Licenses and Trademarks WRQ, the WRQ logo, and Reflection are trademarks of WRQ, Inc., registered in the USA and other countries. Reflection Signature and Reflection Deploy are trademarks of WRQ, Inc. Patent pending. Adobe Systems Incorporated — Adobe, Acrobat, and Acrobat Reader are registered trademarks. Digital Equipment Corporation, Inc. — DEC, LAT, VAX, and OpenVMS are registered trademarks. Hewlett-Packard Company — Hewlett-Packard, HP, and OpenMail are registered trademarks. INSO Corporation — INSO is a registered trademark, and International Proofreader is a trademark. International Business Machines Corporation — AT, IBM, and AS/400 are registered trademarks. Microsoft Corporation — Microsoft, MS-DOS, Windows, Windows NT, and Visual Basic are registered trademarks. NCompass Labs, Inc. — NCompass and DocActive are trademarks. NetManage, Inc. — NetManage and NS/Router are registered trademarks. Novell, Inc. — Novell and NetWare are registered trademarks. The Open Company — UNIX is a registered trademark. All other brand and product names mentioned in this manual are the trademarks of their respective owners.
Customer Service WRQ Corporate Headquarters 1500 Dexter Avenue North Seattle, WA 98109 USA +1.206.217.7100 +1.206.217.0293 FAX 800.872.2829
European Headquarters The Netherlands +31.70.375.11.00 +31.70.356.12.44 FAX
S.E. Asian Headquarters Singapore +65.336.3122 +65.336.5233 FAX
Technical Support in the USA E-mail:
[email protected] WWW: support.wrq.com Reflection Technical Notes (24-hour automated fax request line): 206.216.2680 Bulletin Board (BBS): 206.217.0145 BBS Telnet Gateway: bbs.wrq.com Anonymous FTP Server: ftp.wrq.com Technical Support: 206.217.7000 Technical Support Fax: 206.217.9492
Technical Support Outside the USA Please contact your International Business Partner: visit www.wrq.com/bp/intldist.htm, or call WRQ for the name of the Business Partner nearest you. You can also send an e-mail to
[email protected].
Technical Documentation Visit the following web site to download the PDF (Portable Document Format) version of this and other WRQ manuals: www.wrq.com/products/evaluate/download/docindex.htm. We welcome suggestions on how to improve our printed and online documentation. Send your comments to
[email protected].
At WRQ we are comm itted to using p roducts that conserve the world’s resource s. Therefore, the printed version of this manual uses recyc led, elemen tal chlorine-free paper with 20% pos t-cons umer waste and s oy-based inks. Printed in the USA.
20-0139-002
Ta bl e of C o nt en ts
SECTION 1 Introducing Reflection Chapter 1
· Introducing Reflection .................................................................................................................. 3 Reflection Product Overview .......................................................................................................... 3 New Features in This Release .......................................................................................................... 3 Reflection Documentation Overview ............................................................................................... 4 Installing Acrobat to View and Print the Electronic Manuals ............................................................... 6 Reflection Online Help Overview .................................................................................................... 7
Chapter 2
· Installing Reflection ..................................................................................................................... 9 About the Setup Documentation .................................................................................................... 9 System and Product Requirements ............................................................................................... 10 Installing Reflection ..................................................................................................................... 12 Installing Reflection from a Server ................................................................................................. 18 Removing a Reflection Product from Your PC ................................................................................. 18 Other Installation Topics .............................................................................................................. 19 Related Online Help Topics ........................................................................................................... 20
SECTION 2 Starting Reflection and Getting Connected Chapter 3
· Setting Up the Host Connection .................................................................................................. 23 Network Connection Setup .......................................................................................................... 23 Modem Connection Setup ........................................................................................................... 25 Direct Serial Connection Setup ..................................................................................................... 26
v
Project Name • Chapter • • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\RWINUG.TOC • 8.24.98 • 11:18am
vi
Table of Contents
Chapter 4
· Starting Reflection and Connecting to the Host ........................................................................... 29 Starting Reflection ...................................................................................................................... 29 Running Multiple Sessions of Reflection ......................................................................................... 30 Changing the Terminal Reflection Emulates ................................................................................... 31 Saving Your Settings ................................................................................................................... 33 Disconnecting from the Host ........................................................................................................ 34 Reconnecting to Your Last Connection .......................................................................................... 34 Exiting Reflection ........................................................................................................................ 35 Related Online Help Topics ........................................................................................................... 35
Chapter 5
· Using the Reflection Wizards ...................................................................................................... 37 Starting the Reflection Settings Conversion Wizard ......................................................................... 37 Restoring Converted Settings ....................................................................................................... 41 Using the Conversion Wizard Log File ............................................................................................ 42 Introducing the Reflection Connection Wizard ............................................................................... 42 Starting the Connection Wizard .................................................................................................... 43
SECTION 3 Working in the Terminal Window Chapter 6
· Working in the Terminal Window ................................................................................................ 47 Changing the Terminal Window’s Title Bar Text .............................................................................. 48 Working with Text in the Terminal Window .................................................................................... 50 Working with the Mouse .............................................................................................................. 52 Default Keyboard Shortcut for Copy/Paste Commands .................................................................... 53 Related Online Help Topics ........................................................................................................... 54
Chapter 7
· Using Events in Reflection .......................................................................................................... 55 Types of Events ........................................................................................................................... 56 Defining a New Event .................................................................................................................. 56
Table of Contents vii
Ordering Events .......................................................................................................................... 59 Enabling and Disabling Events ...................................................................................................... 59 Creating a New Event from an Existing Event ................................................................................. 60 Viewing and Changing the Properties of an Event ........................................................................... 60 Deleting an Event ........................................................................................................................ 61 Related Online Help Topics ........................................................................................................... 61 Chapter 8
· Working with Settings Files ........................................................................................................ 63 File Extensions Used by Reflection Products ................................................................................... 64 Creating and Opening Settings Files .............................................................................................. 65 Related Online Help Topics ........................................................................................................... 66
Chapter 9
· Setting Up Colors ....................................................................................................................... 67 Changing Colors and Saving Color Schemes ................................................................................... 67 Creating Custom Colors ............................................................................................................... 68 Creating Custom Colors Under ANSI Emulation ............................................................................... 70 Related Online Help Topics ........................................................................................................... 71
Chapter 10
· Changing the Display Font ......................................................................................................... 73 Fonts Installed by Reflection’s Setup Program ................................................................................ 73 Reflection’s Default Display Font ................................................................................................... 74 Changing the Display Font ........................................................................................................... 75 Where Reflection Looks for Its Fonts .............................................................................................. 76 Printing Text Using the Display Font .............................................................................................. 77 Understanding TrueType Font Support in Reflection ....................................................................... 77 Related Online Help Topics ........................................................................................................... 77
Chapter 11
· Printing and Logging ................................................................................................................. 79 How to Print from Reflection ........................................................................................................ 79 Changing the Print Setup ............................................................................................................. 81 Changing the Page Options .......................................................................................................... 84 Printing Graphics in Reflection for ReGIS Graphics ........................................................................... 86
viii
Table of Contents
Logging in Reflection .................................................................................................................. 87 Related Online Help Topics ........................................................................................................... 88 Chapter 12
· Running Reflection from a Browser ............................................................................................. 89 Supported Browsers ................................................................................................................... 89 Starting Reflection from a Web Browser ......................................................................................... 90 Starting the Reflection Browser Demonstration .............................................................................. 90 Reflection Commands in the Browser’s Menu Bar ............................................................................ 91 Paging Beyond the Page Limit of the Browser ................................................................................ 92 Browser Frequently Asked Questions ............................................................................................. 93
Chapter 13
· Customizing the Menu Bar ......................................................................................................... 95 Opening the Menu Setup Dialog Box ............................................................................................. 96 Adding a Menu to the Menu Bar ................................................................................................... 97 Defining a Keyboard Shortcut Key for a Menu or Menu Item ............................................................ 103 Rearranging the Menu Bar .......................................................................................................... 104 Restoring a Default Menu or Menu Item ........................................................................................ 104 Restoring Version 6.x or 5.x Menu Items ........................................................................................ 105 Example: Restoring the Script Menu ............................................................................................. 105 Guidelines for Adding and Editing Menus and Menu Items ............................................................. 106
Chapter 14
· Working with the Toolbar ......................................................................................................... 107 The Reflection Predefined Toolbars .............................................................................................. 107 The Reflection Toolbar Tabs ........................................................................................................ 108 Working with the Toolbar ........................................................................................................... 110 Adding Pictures to Toolbar Setup ................................................................................................. 113 Related Online Help Topics .......................................................................................................... 114
Chapter 15
· Customizing the Keyboard ....................................................................................................... 115 Opening the Keyboard Map Setup Dialog Box ............................................................................... 115 Mapping a Keystroke .................................................................................................................. 116 Removing a Mapping ................................................................................................................. 117 Restoring the Default Keyboard Mapping ..................................................................................... 117
Table of Contents ix
Drag-and-Drop Options ............................................................................................................. 118 Changing Your PC or Host Keyboard ............................................................................................ 118 Related Online Help Topics ......................................................................................................... 119 Chapter 16 · Mouse Mapping ....................................................................................................................... 121 Mouse Chords ........................................................................................................................... 121 Mapping a Mouse Chord ............................................................................................................ 122 Identifying a Mouse Chord ......................................................................................................... 122 Identifying an Action ................................................................................................................. 123 Disabling a Mouse Chord ............................................................................................................ 124 Chapter 17 · Using the Graphical Terminal Keyboard ..................................................................................... 125 Displaying the Terminal Keyboard ............................................................................................... 125 When to Use the Terminal Keyboard ............................................................................................ 125 Moving and Attaching the Terminal Keyboard .............................................................................. 126 Changing the Terminal Keyboard’s Appearance ............................................................................ 127 Chapter 18 · Configuring Hotspots ............................................................................................................... 129 Enabling and Showing Hotspots ................................................................................................. 129 Defining Hotspots ..................................................................................................................... 130 Related Online Help Topics ......................................................................................................... 132 Chapter 19 · Transferring Files ..................................................................................................................... 133 File Transfer Protocols ................................................................................................................ 133 Preparing to Transfer Files .......................................................................................................... 135 Transferring Files ...................................................................................................................... 137 Related Online Help Topics ......................................................................................................... 139
x
Table of Contents
SECTION 4 Using Reflection’s Advanced Features Chapter 20
· Advanced Host Connection Options .......................................................................................... 143 Network Connections (Best Network) ........................................................................................... 143 Modem Connections .................................................................................................................. 144 Demonstration Connections ........................................................................................................ 145 Specifying a Hosts File ................................................................................................................ 146 Related Online Help Topics .......................................................................................................... 147
Chapter 21
· Using Visual Basic and Macro Recording .................................................................................... 149 Visual Basic for Applications ........................................................................................................ 149 Using Reflection and Visual Basic Help .......................................................................................... 149 Recording and Using Macros ....................................................................................................... 150
.................................................................................................................. 152 Reflection Basic Support ............................................................................................................. 153 Restoring the Script Menu .......................................................................................................... 153 The Command Line
Chapter 22
· Working with Host Graphics in Reflection for ReGIS Graphics ..................................................... 155 Configuring Reflection for Graphics Emulation .............................................................................. 156 Displaying a Sample ReGIS Graphic .............................................................................................. 156 Selecting Graphics ...................................................................................................................... 157 Saving Graphics ......................................................................................................................... 158 Controlling the Printing of Graphics ............................................................................................. 158 Changing the Terminal Window Color in ReGIS Mode ..................................................................... 159 Tektronix Graphics ..................................................................................................................... 160 Related Online Help Topics .......................................................................................................... 161
Chapter 23
· Viewing Reflection Settings ...................................................................................................... 163 Finding a Setting ........................................................................................................................ 163 Changing a Setting Value ............................................................................................................ 164 Site Defaults vs. Factory Defaults .................................................................................................. 164 · Index ....................................................................................................................................... 165
S E CT ION
1
Introducing Reflection
C ha pt er
1
Introducing Reflection WRQ makes PC software that connects personal computer users to enterprise computers and information networks. WRQ offers Reflection products for connections to IBM, UNIX, Digital, Unisys, and HP host systems. WRQ is also a leader in network security, communications, and utilities applications, products for the X Window System, and software management.
Reflection Product Overview Reflection connectivity software products, described next, can establish and maintain communications to an HP, UNIX, Unisys, or Digital host from a PC running Microsoft Windows 95, Windows 98, or Windows NT version 4.0 (Windows NT version 3.51 is supported using Reflection version 5.21, included on the Reflection product CD): ·
Reflection for HP with NS/VT allows you to communicate with an HP 1000, 3000, 9000, or UNIX system. Your PC can emulate an HP 2392A, 700/92, 700/94, 700/96, or 700/98 terminal. Reflection for HP with NS/VT also provides VT52, VT102, and VT220 emulation.
·
Reflection for UNIX and Digital allows you to communicate with a Digital, UNIX, or Unisys host. Your PC can emulate the Digital Equipment Corporation VT420, VT320, VT220, VT102, VT101, VT100, and VT52 text terminals. It can also emulate ANSI, ADDS, WYSE, DG, and Unisys T27 terminals.
·
Reflection for ReGIS Graphics allows you to communicate with a Digital, UNIX, or Unisys host. Your PC can emulate the same terminals as Reflection for UNIX and Digital, and adds the ReGIS (Remote Graphics Instruction Set), Tektronix 4010/4014, and sixel graphics features of Digital’s VT340, VT330, VT241, and VT240 graphics terminals. You can use either a bus or serial mouse in ReGIS as a locator device.
New Features in This Release For a list of features new or changed in the version 7.0 release of Reflection: 1.
On the Help menu, click Help Topics.
2.
Using the Index tab in the Help window, search for Features, list of features new to this version.
3
Project Name • Chapter 1 • Introducing Reflection • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\INTRO.FM • 8.24.98 • 11:18am
4
Introducing Reflection
Reflection Documentation Overview WRQ provides this printed User Guide and online help files for customers who need basic information on Reflection. Additional information on Reflection is available either by viewing any of the supplemental PDF (Portable Document Format) files on the Reflection product CD (explained on page 6), or by installing advanced online help using the Custom installation option (explained on page 12). These sources provide in-depth information on Reflection topics from programming to advanced installation and setup. If you want to purchase printed copies of the books described below, contact WRQ Customer Service or your authorized Reflection Business Partner. The remainder of this chapter describes the documentation shipped with your Reflection product.
The Reflection User Guide This Reflection User Guide presents a comprehensive overview of Reflection features. Use it to install Reflection, establish your first host connection, and customize the user interface. Related online help topics are listed at the end of many of the chapters in this manual. This guide is also included as a PDF file in an electronic format, for viewing from Acrobat.
The Reflection System Administrator Guide The Reflection System Administrator Guide is designed for the person who must set up and control the environment in which a group of Reflection users work. This guide is included as a PDF file in an electronic format, for viewing from Acrobat, and it covers these topics: Setting Up Your Connectivity Environment Provides guidelines on connection methodology, such as when you should connect to multiple hosts and how to integrate connection macros into settings files. Using the Reflection Profiler Describes how the Reflection Profiler lets you customize the availability of particular features and commands in Reflection. Also covered are topics such as restricting access to online help and protecting environment information by using passwords. Creating a Secure Environment Explains those features in Reflection than can enhance the security of your host connections. How to record and save (or not save) passwords is also described.
Introducing Reflection 5
Creating Custom Help Describes how to add a customized Windows help file to Reflection’s Help menu to supplement the standard help included with the product. Uploading the Host Program (and Advanced File Transfer Topics) Before Reflection users can transfer files between their PCs and a host, a host version of the file transfer program must be available to work with Reflection. This procedure is documented, along with other advanced file transfer topics (such as adding parameters to the host startup sequence). Programmatically Controlling Reflection Describes how to control Reflection using host-initiated commands. Character Sets and National Characters Explains how to enter national characters, and provides figures of the supported character sets.
Terminal Reference Manuals The Reflection Terminal Reference Manuals are intended for users who need to control Reflection programmatically by writing programs and sending escape sequences or control functions directly to Reflection. These manuals are available only as PDF files, in an electronic format, for viewing from Acrobat.
Reflection Methods and Properties Reference Manual The Reflection Methods and Properties Reference Manual provides detailed information on methods and properties used to programmatically control Reflection in Reflection macros, or via Automation-compliant applications, such as stand-alone Visual Basic, Excel, and Word. This manual is also included as a PDF file, in an electronic format, for viewing from Acrobat.
Programming with Reflection: Visual Basic for Applications User Guide The Programming with Reflection: Visual Basic for Applications User Guide provides reference, tutorials, and procedures on working with Reflection within the stand-alone Visual Basic environment. This guide is also included as a PDF file, in an electronic format, for viewing from Acrobat.
6
Introducing Reflection
Installing Acrobat to View and Print the Electronic Manuals When you first run Setup, you are given the option of installing Adobe Acrobat Reader, the utility used to view or print the electronic manuals described above. You cannot view and print these PDF files without this program, but can install and share a network copy of this program if space on a local workstation is not available. To install the electronic manuals: 1.
Install Acrobat by running the Setup program from the Reflection product CD, and selecting the Adobe Acrobat Reader option. Setup then installs Acrobat in this location: C:\Acrobat3\Reader
2.
With the Reflection product CD in the CD-ROM drive, start Windows Explorer and change to the Manuals folder on the CD.
3.
Open a book by double-clicking on the associated PDF file in Windows Explorer (the books are described by file name in the list below).
You can view the books directly from the CD in the Manuals folder. Or copy one or more of the books to a folder on your local drive. The books are named as follows: ·
Rhud70ug.pdf (Reflection User Guide)
·
Rhud70sg.pdf (Reflection System Administrator Guide)
·
Rhp70ref.pdf (Reflection Terminal Reference Manual for HP emulation)
·
Rvt70ref.pdf (Reflection Terminal Reference Manual for ADDS, ANSI, DG, Unisys, VT, and WYSE emulation)
·
Rmp70win.pdf (Reflection Methods and Properties Reference Manual)
·
Vb0898ug.pdf (Programming with Reflection: Visual Basic for Applications User Guide)
Acrobat includes its own online help to assist you in viewing and using these electronic manuals.
Ordering Reflection Documentation If you do not want to print your own manuals using the Acrobat Reader, you can purchase the same manuals, already printed, from WRQ (the terminal reference manuals are not available in printed form). To order any of these manuals, contact WRQ customer service or your authorized Reflection Business Partner.
Introducing Reflection 7
Reflection Online Help Overview Reflection provides help for all of its features. The online help is a convenient way to look up information about Reflection menu commands and dialog box options. The emulator help file (Rwin.hlp) is copied to the Reflection Help subfolder when you select the Typical installation option during Setup. The online help should answer almost any question you have. Different help files are copied to the Reflection Help subfolder depending on both the installation option you choose (Minimal, Typical, or Custom) and which components of Reflection you decide to install. Here is a partial list describing some of the help files you can install: ·
Reflection Online Help: Installs the user guide help file (Rwin.hlp), Reflection methods and properties and how-to programming help files, and the Reflection FTP product help file (Rftpc.hlp). Installed using the Typical installation option.
·
System Administrator Online Help: Installs a help file (Rwinsys.hlp) containing advanced terminal emulation topics and system administrator topics. Installed using the Custom installation option.
·
Stand-Alone Visual Basic Online Help: When you select the VBA Online Help component, as a Custom installation option, installs Microsoft’s online help for Visual Basic for Applications.
·
Deployment Manager: Installs the Deployment Manager and its help file (Rdeploy.hlp). Installed using the Custom installation option.
·
Connection Wizard: Installs the Reflection Connection Wizard, as well as the wizard’s help file (Cnectwiz.hlp). Installed using the Typical installation option.
·
FTP Client: Installs the Reflection FTP Client, which includes its help file (Rftpc.hlp). Note that this help file is the only source of documentation for the Reflection FTP Client application. Installed using the Typical installation option.
·
Reflection Basic and Reflection Command Language Online Help: When you select the Prior Version Scripting Tools component, installs Reflection Basic and Reflection Command Language online help, as well as the Reflection Basic Editor. Installed using the Custom installation option.
Reflection includes many other help files that detail how to use the various utilities provided with the product. To see a complete list of online help files, search for Online help, help files shipped with Reflection in the Help Topics window.
8
Introducing Reflection
Printing Topics from the Online Help To print the currently displayed help topic, either right-click in the Help window and click Print Topic, or click the Print button in the Help viewer’s menu bar. This method can also be used for printing procedure-type topics (these appear in a smaller window without the menu bar). To print an entire help file shipped with Reflection: 1.
Click the Contents tab in the Help Topics window.
2.
Highlight the book icon you want to print.
3.
Click the Print button in the bottom of the Help Topics window. This prints all topics, in the order they are shown within the selected book.
C ha pt er
2
Installing Reflection This chapter contains information about: ·
Reflection system and product requirements.
·
Installing Reflection on a single PC with Reflection Setup or on a server with the Deployment Manager.
·
Configuring workstations to run Reflection from a server.
·
Distributing multi-user license versions of Reflection from a server.
·
Removing a Reflection product from your PC.
About the Setup Documentation When you run the Setup program, use the online help if you need more information than this chapter provides. The online help is your most complete resource for all Setup and troubleshooting information, including advanced installation topics and descriptions of Setup error messages. To view the Setup online help: ·
Click Help in the dialog boxes that guide you through the Setup program, or
·
After installing Reflection, access the Setup help file (Setup.hlp) by clicking your Start menu, pointing to Programs, then Reflection, then Documents. Click the online help icon for your Reflection product, then click Setup. Note: When you configure a workstation to run Reflection from a shared network drive (explained on page 18), Setup does not copy Setup.hlp to the local workstation. Instead, Setup.hlp is installed to the Setup folder under Reflection on the shared network drive. à
9
Project Name • Chapter 2 • Installing Reflection • TEMPLATE: docs_v3 • D:\working\rwin\ug\online\INSTALL.FM • 8.24.98 • 11:18am
10
Installing Reflection
System and Product Requirements To install Reflection you need: ·
The Reflection product CD.
·
An 80386-based, 80486-based or Pentium-based PC.
·
Microsoft Windows 95, Windows 98, or Windows NT 4.0. Windows NT 3.51 support is explained on page 19.
·
Microsoft Internet Explorer version 3.0 or higher, Netscape Navigator version 2.2 Gold or higher (Deployment Manager requires version 3.02 or higher), or Netscape Communicator 4.0 or higher if you intend to run Reflection in a web browser.
·
A PC hard disk or a shared network drive.
·
1 megabyte (MB) of temporary disk space to run the Setup program.
·
4 MB of RAM for a Windows 95 or Windows 98 machine; 6 MB of RAM are recommended. A minimum of 12 MB is required for a Windows NT 4.0 machine.
·
The amount of disk space you need depends on what type of installation you are performing and which Reflection product you are installing: Installation Option
Approximate Disk Space Needed
Minimal
30 MB
Typical
46 MB
Custom
56 MB (when installing all program files)
·
A display adapter supported by Windows. Reflection for ReGIS Graphics performs best when used with a 256-color video driver at 1024 × 768 resolution.
·
TrueType font support under Windows installed and enabled (if you want to view and print with TrueType fonts).
·
A mouse is recommended for working in the Windows environment.
Installing Reflection 11
Host Communication Requirements Communicating with a host requires the following: ·
A host computer with serial or network communications capabilities.
·
A link to the host computer. For network connections, you need an X.25 or appropriate LAN card, as well as networking software. For serial connections, you need a serial port on the PC and a direct RS-232 cable connection, an external modem with an RS-232 cable connected to the PC, or an internal modem card.
·
For file transfers to a DEC host, you must have VMS version 5.x or higher to use the WRQ/Reflection file transfer protocol on VMS systems.
HP 3000 Requirements HP 3000 requirements when using Reflection for HP with NS/VT include the following: ·
An Ethernet or Token-Ring connection between the PC and the host. Ethernet must be enabled on the HP 3000.
·
The HP 3000 must have NS/VT capability, which is included with Hewlett-Packard’s Network Services software and the Local Area Network Interface Controller, or LANIC (ThinLAN 3000 Link for Classic HP 3000s or ThinLAN 3000/XL Link for HP 3000 XL or MPE/iX).
·
You must have the appropriate HP 3000 software to support Streams mode.
12
Installing Reflection
Installing Reflection This procedure explains how to install Reflection for the first time. If you have a multi-user version already installed, see page 18 for instructions on configuring a workstation or installing from a server. To install Reflection: 1.
Start Microsoft Windows.
2.
Close any other Windows applications. Reflection Setup may need to update files that these applications share.
3.
Put the Reflection CD in the CD-ROM drive.
4.
The dialog box that appears gives you the following choices: ·
Reflection (using single-user Setup): Install a single-user version of Reflection. You can also use this option to install a multi-user version of Reflection, although the Deployment Manager is a much better option in this case.
·
Reflection (using Deployment Manager): Deploy Reflection to multiple users with the Deployment Manager, a new utility for system administrators that also offers several maintenance and customization options.
·
Adobe Acrobat Reader: Install this to view and print PDF files shipped with Reflection, as explained on page 6.
·
3.5" Disk Utility: Create 3.5-inch disks to install Reflection on PCs without network access or a CD-ROM drive.
·
Readme: View the Reflection for Windows Readme help file.
The Reflection (using single-user Setup) installation option is described next. Reflection (using Deployment Manager) is described starting on page 15.
Installing Reflection 13
Installing Reflection Using Single-User Setup You can use Reflection Setup to install a single-user version of Reflection on your local PC or a multi-user version of Reflection on a server. However, if you are installing the latter, you can also use the Deployment Manager, described on page 15. The following procedure assumes you are installing a single-user version of Reflection: 1.
After you click Reflection (using single-user Setup), a few moments will pass as you see the text “Initializing Setup. Please wait...” Click Accept in the legal agreement that displays.
2.
The Welcome to Reflection Setup dialog box appears; click Next to continue.
3.
The next dialog box prompts you for Reflection’s destination path. Setup proposes the drive on which Windows is installed. Click Next to accept the default, or type a new path in the box.
4.
If you have an earlier version of Reflection installed in the designated path, Setup displays the Previous Installation Detected dialog box (the wording is slightly different if you are installing to a server) and informs you that this installation will be overwritten. Click Next.
5.
Accept the default User folder path (\Program Files\Reflection\User). This is where Reflection will store files you create, such as settings files you create in Reflection sessions. To change the proposed path, type it in the box, then click Next.
6.
In the next dialog box, select the Minimal, Typical, or Custom installation option. Search the Setup online help for Installation, list of options to see what is installed with each option. Step 7 describes the Custom installation option; if you selected a Minimal or Typical installation, skip to step 8.
7.
The next dialog box shows a list of components you can install. Select a check box to have Setup install the component. You can always rerun Setup again to add components. Click Next to continue installing Reflection.
8.
In the next dialog box, Setup offers to create Windows shortcuts to the Reflection application and utilities you are installing. Choose to have Setup create these shortcuts in either the default Reflection folder shown in the Program folder list box, or any existing program folder Setup detects on your PC. If you do not want Windows shortcuts created, select the Do not create shortcuts check box. Click Next to continue installing Reflection.
14
Installing Reflection
9.
To make Reflection the default Telnet application, select the Telnet check box. Reflection will be used by other Windows applications requiring Telnet. For example, many public libraries require Telnet capability for catalog searches over a browser. Reflection will start and connect when called upon by the browser for this or a similar task. Click Next to continue.
10. If Setup detects a time-limited copy of Reflection, it will offer to migrate your custom settings. Doing this ensures a seamless transition of your preferences from the time-limited copy to the new version of Reflection you are installing. Click Next. 11. If Setup detects Reflection settings files created prior to Reflection version 6.0, you can use the Reflection Settings Conversion Wizard to automatically convert your settings files (this Wizard opens the first time you run Reflection version 7.0). Make your selection and click Next. 12. If you are installing either Reflection for UNIX and Digital or Reflection for ReGIS Graphics, the next dialog box lets you configure Reflection for an OpenVMS, UNIX, or Unisys A Series host: select the host you will use most often. Choosing a preferred host now does not prevent access to other hosts this Reflection product supports, it just sets the defaults that are best for the selected host type. Click Next. 13. Setup lets you save profiled setting information to import later to the new copy of Reflection. If you want to retain the information, Setup will rename the old Reflection executable to the name shown in the dialog box. If you want to discard the profiled settings, select the Discard profiled settings check box. Doing this will overwrite the profiled executable with a new copy of Reflection, set to the factory defaults. 14. If you are installing either Reflection for UNIX and Digital or Reflection for ReGIS Graphics on a Windows NT machine and selected the LK450 Keyboard Support component, choose Yes to have Setup configure Reflection for this keyboard. If you choose No (the default), you can configure Reflection for this keyboard later (search for LK450 keyboard, configuring a PC for this keyboard in the emulator help file to see a procedure). Click Next to continue. 15. Setup is now ready to install Reflection. Click Finish to complete the installation of Reflection. 16. The final dialog box indicates that the Setup program successfully installed Reflection. If the Restart Windows button appears, click it now.
Installing Reflection 15
If you chose to create Reflection shortcuts in step 8, Windows Explorer displays the Reflection program group with the shortcuts that were added to the Start menu. This allows you to verify and make changes to the shortcut properties, such as their names.
Installing Reflection Using the Deployment Manager The Deployment Manager is a utility that helps system administrators install and maintain Reflection for multiple users. To install Reflection, the Deployment Manager will create: ·
a base installation of Reflection on a server (below)
·
an administrative installation on your PC (page 16)
·
an installation script for your users (page 16)
Creating a Base Installation of Reflection on a Server To create a base installation of Reflection on a server: 1.
In the initial Setup dialog box (described in step 4 on page 12), click Reflection (using Deployment Manager).
2.
After the introductory dialog boxes, the Deployment Server Path dialog box appears. Enter the server path where the Deployment Manager will copy or install Reflection. Keep the Convert mapped drive to UNC check box selected, or use a UNC (Universal Naming Convention) path in the Location of installation on the server box, such as: \\Luna\Vol2\Products\Reflection
Click Next. 3.
The next dialog box offers you two choices: ·
Disk images: A set of Reflection disk images is copied to the server. With these images, users can install Reflection on their PCs—either by clicking an icon on a web page or by running Setup from the Disk1 folder on the server.
·
Multi-user version: Reflection is installed on the server. Users will configure their local workstations to run Reflection from the server—either by clicking an icon on a web page or by running Setup from the Setup folder on the server.
Select an option and click Next.
16
Installing Reflection
4.
If you selected: ·
Disk images: The next dialog box confirms that disk images will be copied to the server. Click Next. The Deployment Manager copies disk images to the server.
·
Multi-user version: The next dialog box confirms that Reflection will be installed on the server. Click Next. The Deployment Manager launches Reflection Setup to install Reflection on the server. Accept the proposed defaults. For more information on a Setup dialog box, see the procedure that starts on page 13 or click Help in the dialog box.
Installing an Administrative Copy of Reflection After the Deployment Manager copies or installs Reflection to the server, it installs an administrative copy of Reflection on your PC: 1.
Accept the Deployment Manager’s default installation path and click Next.
2.
The Deployment Manager launches Reflection Setup. Follow the Setup program’s instructions. For more information on a Setup dialog box, see the procedure that starts on page 13 or click Help in the dialog box.
Creating an Installation Script After an administrative copy of Reflection has been installed on your PC, the Deployment Manager creates an installation script to automate workstation installations: 1.
In the Create Installation Script for Users dialog box, click Next.
2.
The Deployment Manager runs Reflection Setup again to record your responses. The Setup dialog boxes you see will be the same as those described starting on page 13, unless you selected Multi-user version in step 3 on page 15, in which case: ·
Setup will ask if you want to configure the PC (in other words, your users’ PCs) as a local workstation. Click Next.
·
The proposed User folder path will be a Reflection folder within the Windows 95, Windows 98, or Windows NT folder (for example, C:\Win98\Reflection) instead of Program Files\Reflection\User. Click Next.
Installing Reflection 17
When you make your responses, be careful about which paths you provide. For the User folder, for example, the drive letter and path you enter must be relevant for every workstation that will be using this script. 3.
If you select Custom installation, the Settings Shortcut Folder Option dialog box appears. Select where you want to place shorcuts for your host connections and settings and click Next.
4.
When Reflection Setup is complete, the End of Installation Wizard dialog box appears, indicating that Reflection is ready to be customized or deployed to your users from a default web page. Click Finish. The Customizations dialog box opens. This is where you can profile Reflection for your users, create web pages from which users can run Reflection, add files to your Reflection installation, or create shortcuts. For more information about these customization and maintenance options, click Help from this dialog box. To exit the Customizations dialog box, click Exit. Tip: To access the Customizations dialog box later, click your Start menu, point to Programs, then Reflection, then Utilities. Click Deployment Manager. à
Installing Reflection from a Deployment Manager Server Installation After you use the Deployment Manager to install Reflection or copy Reflection disk images to a server, your users can install Reflection just by clicking the Reflection icon on a web page you provide. A web page, Default.htm, is provided for this purpose in the server installation’s WebPage folder. You can also create your own web page for your users with the Deployment Manager’s Web Pages feature. For more information, see the Deployment Manager’s online help (Rdeploy.hlp). After users click the Reflection icon for the first time, Setup runs “silently” on their PCs or workstations, invisible to them. The installation script you created with the Deployment Manager determines which information is passed to Setup. If you do not use the web to deploy Reflection, the installation script you created is not run automatically. You can, however, instruct users to type the following at a DOS prompt to run it: Setup /q /f Silent.inf /f Rdeploy.inf
18
Installing Reflection
Tip: If you have only changed shortcuts or the list of installed files, your users do not need to install the full product again. Instead, they can perform an “update-only” installation by typing the following at a DOS prompt: Setup /q /f Silent.inf /f Rdeploy.inf /f Udepupd.inf
If you used the Deployment Manager to place Reflection on a server but do not want to use an installation script or a web page to deploy Reflection to your users, see “Installing Reflection from a Server” below.
Installing Reflection from a Server If you used Reflection Setup to install Reflection on a server, each workstation needs to be configured to run Reflection from the server: 1.
Log in to the network server and open the folder where Reflection is installed.
2.
Start the Setup program. You must run Setup from the Reflection product folder that is beneath the Reflection\Setup folder on the server (for example, Reflection\Setup\R2win32).
3.
Follow the Setup program’s instructions.
In general, configuring a workstation is similar to performing a single-user installation (described on page 13). If you copied Reflection disk images from the product CD to a server (see Copying the Reflection CD to the network in the Setup online help), your users can run Setup from the server by clicking Run on the Start menu, and entering the path to the Disk1 folder followed by Setup in the Open box. For example: W:\Products\Reflection\Disk1\Setup
Reflection Setup will start. The procedure starting on page 13 explains how to install Reflection.
Removing a Reflection Product from Your PC You can use the Reflection Add/Remove program copied to the Reflection folder to remove the product. Since each Reflection product shares files with other Reflection products, it is common for some folders and files to remain in place on your PC after running the Add/Remove program. Manually removing these folders and files is not recommended since it may disable another Reflection product or a different Windows application.
Installing Reflection 19
To use the Add/Remove program to remove Reflection: 1.
From Windows, start Control Panel and double-click the Add/Remove Programs icon.
2.
On the Install/Uninstall tab, double-click the name of the Reflection product you want to uninstall. A few moments will pass as you see the text “Initializing Setup. Please wait...”
3.
In the Welcome to Reflection Add/Remove dialog box, click Next.
4.
Click Full uninstall to remove the Reflection product, then click Next. Tip: If you have multiple Reflection products installed, the Uninstalling Reflection Networking Software dialog box opens. Leave the Save Reflection Networking Software Settings check box selected to ensure that other Reflection products retain their original configurations. à
5.
Add/Remove shows a list detailing the location and the actual files that will be removed. Click Finish to complete the removal. While Add/Remove is deleting files, do not start an existing copy of Reflection, and do not minimize or exit the windows that Add/Remove opens. à
Caution: â 6.
The final dialog box indicates that the Add/Remove program successfully uninstalled Reflection. Click Exit Add/Remove to quit the Add/Remove program.
Other Installation Topics Reflection provides Windows NT 3.51 support and the ability to create 3.5-inch installation disks.
Windows NT 3.51 Support Your Reflection product CD includes version 5.21 of Reflection for Windows NT 3.51 environments. To install this version, put the Reflection product CD in the CD-ROM drive and click Run on the Program Manager File menu. In the Command Line text box, type your CD-ROM drive letter (for example, D:) followed by \Nt351\Disk1\Setup. Follow the prompts to install Reflection. Because this is an earlier version of Reflection, the information in this User Guide does not entirely apply—see the Reflection online help for more information.
20
Installing Reflection
Creating 3.5-Inch Disks from the Product CD If you need to install Reflection to a PC that does not have a CD-ROM drive, use the 3.5" Disk Utility option, available when you run Setup from the original product CD (or from installed disk images on a shared network drive), or contact WRQ to request 3.5-inch installation disks.
Related Online Help Topics See the Reflection Setup online help file for information on these topics: ·
Seeing a list of components Setup installs.
·
Automating installation for SMS support.
·
Systems Management Server support.
S E CT ION
2
Starting Reflection and Getting Connected
C ha pt er
3
Setting Up the Host Connection Reflection gives you the flexibility to connect to host computers over a variety of networks; by an internal, external, or network modem; or over a direct serial connection. You can run multiple, concurrent sessions of one or more Reflection products and move between them from the Reflection menus—you can even launch FTP sessions directly from Reflection. This chapter helps you determine whether your PC has the proper software or equipment to establish a connection to the host.
Network Connection Setup Before you can use Reflection to connect to a host over a network, the appropriate networking software must be installed on your PC. Following is a list of 32-bit networking software products you can use with Reflection to make a LAT, Telnet, or NS/VT connection to a host. For a list that includes 16-bit networking software products, search for Supported networks in the online help.
LAT For Windows 95 and Windows 98, one of the following: ·
WRQ’s LAT protocol for Windows 95, which is provided in: – – –
·
Reflection LAT Connection for Windows 95 and Windows NT (version 6.2) Reflection Network Series 3000 Connection for Windows 95 (version 6.1) Reflection Network Series TCP/NFS Connection for Windows 95 (version 6.1)
PATHWORKS 32 for Windows 95 (version 6.0 or higher), SuperLAT for Windows 95, or TES32 (version 3.0 or higher)
Note: To connect with LAT under Windows 95 or Windows 98, you will need to take some additional steps. See page 25 for more information. à
23
Project Name • Chapter 3 • Setting Up the Host Connection • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\SETUP.FM • 8.24.98 • 11:18am
24
Setting Up the Host Connection
For Windows NT 4.0, one of the following: ·
WRQ’s LAT protocol for Windows NT 4.0, which is provided in: – –
·
Reflection LAT Connection for Windows 95 and Windows NT (version 6.2) Reflection Network Series LAT Connection for Windows NT 4.0 (version 6.01)
PATHWORKS 32 for Windows NT (version 7.0 or higher) or SuperLAT for Windows NT
TELNET One of the following: ·
Microsoft’s TCP/IP software for Windows 95, Windows 98, or Windows NT
·
Other Windows Sockets-compatible TCP/IP software
·
WRQ’s TCP/IP software for Windows 95, formerly available in: – –
Reflection Network Series 3000 Connection for Windows 95 (version 6.1) Reflection Network Series TCP/NFS Connection for Windows 95 (version 6.1) Both of these products include TCP/IP software for Windows 95 (but not for Windows 98 or Windows NT)
VT-MGR Reflection for HP with NS/VT or Reflection Suite for HP and one of the following: ·
Microsoft’s TCP/IP software for Windows 95, Windows 98, or Windows NT
·
Other Windows Sockets-compatible TCP/IP software
·
WRQ’s TCP/IP software for Windows 95, formerly available in: – –
Reflection Network Series 3000 Connection for Windows 95 (version 6.1) Reflection Network Series TCP/NFS Connection for Windows 95 (version 6.1) Both of these products include TCP/IP software for Windows 95 (but not for Windows 98 or Windows NT)
Setting Up the Host Connection 25
Enabling the LAT Protocol If you are making a LAT connection to a host under Windows 95 or Windows 98, you will need to take some extra steps to enable the LAT protocol: 1.
On the Setup menu, click View Settings.
2.
In the Reflection settings list, select Allow Legacy Communications. Tip: To quickly select this setting, type legacy in the Search text box. à
3.
Select As Needed in the Settings details text box.
4.
Click OK to exit the View Settings dialog box.
This change is saved in the Windows registry.
Modem Connection Setup You can use either an internal, external, or a network modem to connect your PC to a host computer. Windows usually identifies and configures your modem when this hardware is found on your PC. The configuration can be reset, if needed, using Windows Control Panel—do this if the baud rate seems low, or if the initialization string does not reset the modem. There are many types of modems and their operations can vary significantly, so be sure to read your modem’s documentation before using it with Reflection. If you access the host using network modem, you will probably need to add it to Windows list of recognized modems. To add your network modem to Reflection: 1.
Start Reflection. If you already have an active connection, click Disconnect on the Connection menu first (or click New Session on the File menu to start a new session).
2.
On the Setup menu, click View Settings to open the View Settings dialog box.
3.
Select Use Modem Dialer V5 from the list of Reflection settings, then click Yes in the Settings details box to make this setting active.
26
Setting Up the Host Connection
4.
Click OK.
5.
On the Connection menu, click Connection Setup to open the Connection Setup dialog box.
6.
Select the Modem option in the Connect using group box, and then click Add to open the Install Modem dialog box.
7.
Click Next.
8.
Select your network modem from the Modem box.
9.
Click OK. The Connection Setup dialog box reappears with your selected network modem.
10. To dial the host, type the telephone number in the Phone number box and click Dial.
Direct Serial Connection Setup You can establish a direct physical connection to a host using a cable and a serial port (for example, COM1) on your PC. Or if the host is located at a distance, you can use modular cabling, where installed. Modular cabling uses a telephone-type jack (which accepts a modular RJ-11 or RJ-45 plug, for example) on a wall plate. You will need an adapter to connect to this type of jack—see your system administrator for information about your cabling system. Usually, the COM ports on your PC look like this:
Setting Up the Host Connection 27
To use the PC’s serial port, you may need a standard 9-pin to 25-pin adapter. To connect to a host over a serial port: 1.
Start Reflection. If you already have an active connection, you must click Disconnect on the Connection menu (or click New Session on the File menu to start a new session).
2.
On the Connection menu, click Connection Setup to open the Connection Setup dialog box.
3.
Select the Serial port option in the Connect using group box, and then select the communications port on your PC that is physically connected to the host computer.
4.
Set the communication port’s values in the Baud rate and Parity boxes.
5.
After making your changes, click Connect and follow the host prompts to log in as you usually do.
C ha pt er
4
Starting Reflection and Connecting to the Host This chapter explains how to start Reflection and connect to the host. It also describes how to establish multiple sessions, change the terminal type, save your settings, and how to exit Reflection. If you would rather connect to a host using a wizard, see the chapter titled “Using the Reflection Wizards,” starting on page 37. The Reflection Connection Wizard can quickly set up Reflection and connect to a host without requiring you to follow the steps outlined in this chapter.
Starting Reflection To start Reflection and connect to the host: 1.
After installing Reflection, you start any Reflection product by clicking its icon in the Reflection folder. You’ll see the mountain startup screen for a few seconds, and then the Reflection terminal window opens. The terminal window is where you interact with the host computer; it acts like the screen of a terminal. See “Working in the Terminal Window,” starting on page 47, for more information.
2.
If you know the name of the host to which you want to connect, press n in the terminal window. If you are unsure of what host you’re connecting to, what connection method you’re using, and other connection-related information, use the Reflection Connection Wizard to connect. This is explained on page 42.
29
Project Name • Chapter 4 • Starting Reflection and Connecting to the Host • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\START.FM • 8.24.98 • 11:18am
30
Starting Reflection and Connecting to the Host
3.
The dialog box that opens next depends on which networking protocol is installed: ·
If Reflection finds Telnet, LAT, or VT-MGR * installed, the Connect to Host/Service dialog box opens. Type or select the name of the host or service you want to connect to in the Host/Service name list. If you are connecting to a Unisys A Series host, you will also need to provide a Station ID. This is known as connecting using the Best network option, described on page 143. Click OK.
·
If none of the above three protocols is found, the Connection Setup dialog box opens. Choose one of the Connect using options (Network, Serial port, or Modem), and enter the appropriate connection information. Click Connect.
4.
When your host or service prompt appears, follow the prompts and log in as you usually do.
Tip: You can create a Windows shortcut that can quickly connect you to a host and re-establish your Reflection configuration. Search for Shortcut, creating for Reflection settings files in the online help. à
Running Multiple Sessions of Reflection Reflection lets you establish multiple host connections that function independently. The New Session command lets you create another host session in a new Reflection window while maintaining your other active connections in their own windows. To make multiple host connections: 1.
Establish your first host connection following the steps above.
2.
Click New Session on the File menu to open the New Session dialog box. The options in this dialog box vary depending on which Reflection products are installed. This is also where you can launch the Reflection Connection Wizard.
* VT-MGR is only searched for if you’re using Reflection for HP with NS/VT.
Starting Reflection and Connecting to the Host
3.
Select the Reflection product you want to use to start the new session.
4.
Click OK. Reflection opens in its default state with an “Untitled” terminal window.
5.
In the new terminal window, establish another host connection.
31
Your active sessions are shown at the bottom of the Window menu (the current session is dimmed). You can switch between active connections by clicking them on the Window menu.
Changing the Terminal Reflection Emulates By default, Reflection for HP with NS/VT emulates an HP 700/92 terminal and Reflection for UNIX and Digital and Reflection for ReGIS Graphics emulate a VT400-series terminal. The type of terminal you are emulating, along with how you are connected, appears in the status bar at the bottom of Reflection’s terminal window. To change the type of terminal to emulate: 1.
On the Setup menu, click Terminal, then click the Terminal Type tab.
2.
Select a different option as the Terminal type, then click OK.
VT Emulation in Reflection for HP with NS/VT Reflection for HP with NS/VT provides emulation of the HP 700/92,* HP 700/94,* and HP 2392A terminals. If you need to work with a host program that must understand Digital control sequences, you can configure Reflection for HP with NS/VT to emulate a VT-series terminal by selecting a VT terminal type on the Emulation tab in the Terminal Setup dialog box. For more information on this topic, search for VT terminal topics, configuring Reflection for VT emulation in the online help. In HP VT mode, Reflection maps certain keys on your PC keyboard so that they perform VT terminal functions. If you don’t know which PC key is mapped to the VT function you need, you can send the keys by clicking on a picture of the terminal keyboard. Right-click in the terminal window and click Terminal Keyboard on the shortcut menu. Because you are emulating a VT terminal, this opens a VT keyboard. For more information about the terminal keyboard, see page 125. * The HP 700/96 and 700/98 terminals are later models than the HP 700/92 and 700/94 terminals. That is why these terminal types are paired together as options on the Terminal Type tab in the Terminal Setup dialog box.
32
Starting Reflection and Connecting to the Host
Unisys T27 Emulation Reflection for UNIX and Digital and Reflection for ReGIS Graphics can emulate Unisys T27 terminals. If you selected Unisys A Series in the Default System Option dialog box during Setup, Reflection will start with the appropriate settings for this type of emulation. If you selected a different emulation option during Setup and want to switch to emulating a Unisys T27 terminal, do the following: 1.
On the Setup menu, click Terminal.
2.
Click the Terminal Type tab.
3.
Select UNISYS T27.
4.
Click OK to exit the Terminal Setup dialog box.
5.
To save this change to your settings file, click Save on the File menu.
Other Emulation Types Reflection for UNIX and Digital and Reflection for ReGIS Graphics also allow you to emulate the following terminal types: BBS-ANSI, SCO-ANSI, ADDS VP2, WYSE 50+, WYSE 60, or DG 215 terminals.
BBS-ANSI or SCO-ANSI Emulation To emulate a BBS-ANSI or SCO-ANSI terminal, select one of these options as the Terminal type on the Terminal Type tab in the Terminal Setup dialog box: ·
Reflection’s support of BBS-ANSI emulation is often used for connecting to bulletin board services that use the standard ANSI escape sequences.
·
The SCO Console (included with SCO XENIX and SCO UNIX operating systems for PCs) provides a terminal interface for host programs. Reflection supports this with the SCO-ANSI Terminal type, which includes the SCO extension to the standard ANSI emulation. SCO ANSI specifications are also known as “ANSI console” or “ANSI 80×25.”
To see what values change when you switch to this type of emulation, search for BBS-ANSI or SCO-ANSI in the online help. If you are using Reflection to emulate a VT420 terminal and want ANSI color, search for ANSI, color support for VT (non-ANSI) emulation in the online help.
Starting Reflection and Connecting to the Host
33
Saving Your Settings A settings file is a permanent record of your current Reflection settings, such as the host connection, terminal type, file transfer protocol, and other setup preferences. By default, each time Reflection starts, it looks for a settings file. If no settings file is specified and you have created a default one (for example, Settings.r2w), Reflection automatically loads that file. If this file is not found, Reflection starts with its factory default settings and an untitled terminal window. To save your settings: 1.
Click Save As on the File menu to open the Save Settings dialog box.
2.
Enter a name for the settings file in the File name box. It is recommended that you save settings files in the Reflection User folder. You can save a variety of partial settings files, each identified with a unique file extension. Make a selection from the Save as type list box to save: ·
Keyboard mapping- or mouse mapping-only settings files (.rkm)
·
Toolbar-only settings files (.rtb)
·
Color-only settings files (.rcr)
·
Hotspot-only settings files (.rhs)
·
Connection-only settings files (.rco)
·
Menu-only settings files (.rmu)
3.
You can attach descriptive text to the settings file by clicking the Properties button. This is explained in the online help.
4.
Click Save. The Reflection terminal window title bar is updated with the name of the file.
34
Starting Reflection and Connecting to the Host
Restoring Reflection’s Default Settings Reflection offers many methods for restoring default settings: Caution: â
If your system administrator has specified a site defaults settings file, then the default settings in Reflection may not match those described in the online help. The only way to get back to factory defaults is to remove the site defaults file using the Profiler. à ·
If you need to restore Reflection’s factory default settings, click Defaults on the Setup menu. If you have an active connection, the Defaults command is dimmed—either log off of the host and perform the reset, or click New Session on the File menu. The New Session command starts another copy of Reflection with a new, untitled terminal window and the default factory settings.
·
Most Reflection dialog boxes have a Defaults button; click it to restore the default dialog box values. When you click the Defaults button in a tab dialog box, Reflection asks if you want to reset the default values on the active tab or all tabs.
Disconnecting from the Host To disconnect from a host: 1.
Log out of the host.
2.
Click Disconnect on the Connection menu.
If you want Reflection to exit after you disconnect from the host, select the Exit on disconnect check box in the More Settings dialog box. For more information, search for Exit, automatically on disconnect in the online help.
Reconnecting to Your Last Connection During a Reflection session, you can easily reconnect to your last host connection. Either press n or click Connect on the Connection menu. When disconnected, the name of the most recent connection appears alongside the Connect command as a placeholder until your next connection replaces it.
Starting Reflection and Connecting to the Host
35
Exiting Reflection To exit Reflection: ·
Click Exit on the File menu. Reflection disconnects from the active host connection and closes. To exit automatically when the host disconnects, use the Exit on disconnect check box in the More Settings dialog box. In either case, you are prompted to save changes (if any) to a settings file.
You may be prompted when you exit Reflection: ·
With an active connection: Reflection disconnects from the host and closes, unless the Allow exit while connected check box in the More Settings dialog box has been cleared (recommended for advanced users only). If the check box is cleared, you are prompted to log off of the host before Reflection can exit.
·
With unsaved changes: You can decide to save or discard your changes using options in the dialog box that appears.
You can customize how Reflection exits by changing settings values in the View Settings dialog box. For example, you can tell Reflection to discard or save your changes automatically (exit “silently”), or exit even when an active connection exists. For more information on configuring how Reflection exits, search for Exit, customizing how Reflection exits in the online help.
Related Online Help Topics See the Reflection online help for information on these topics: ·
Understanding partial settings files.
·
Running and setting up icons for multiple sessions.
·
Appending startup switches when you start Reflection from the Run command, or change the properties associated with the icon you click to start the program from the Windows desktop.
C ha pt er
5
Using the Reflection Wizards Included with Reflection version 7.0 are two wizards; the Reflection Settings Conversion Wizard and the Reflection Connection Wizard: ·
Reflection Settings Conversion Wizard: This wizard converts any settings and connection files created in Reflection version 5.21 and earlier products to the new format used in Reflection version 6.0 and higher. Converting files ensures that these settings files will be compatible with version 7.0.* This wizard converts your settings files the first time you start Reflection after installation. As the wizard converts each settings file, the old settings file is automatically backed up and can be restored at any time.
·
Reflection Connection Wizard: This wizard guides you through the actions required to connect to a host. The Connection Wizard takes the guesswork out of establishing a session with a host computer by asking a series of questions that do not require extensive computer knowledge or experience—just a little knowledge of your PC and host computer will do. The Connection Wizard is explained on page 42.
Starting the Reflection Settings Conversion Wizard To convert existing settings files and saved connection information, simply install Reflection and start the product: settings files that are incompatible with version 7.0 of Reflection are detected and converted automatically. If the wizard doesn’t start, it is because: ·
The conversion process has already been run.
·
Reflection was started as an OLE server.
·
No previous versions (and therefore no settings files) of Reflection were found during installation of Reflection.
You can always run the Settings Conversion Wizard manually by following the procedure on page 41. * Although version 7.0 can load most earlier version settings files without running the Conversion Wizard, it is still strongly recommended that you run the wizard to ensure complete compatibility.
37
Project Name • Chapter 5 • Using the Reflection Wizards • TEMPLATE: docs_v3 • D:\working\rwin\ug\online\WIZARD.FM • 8.24.98 • 11:18am
38
Using the Reflection Wizards
Converting Settings Using the Wizard To convert existing settings to the version 7.0 format: 1.
After the wizard starts, you’ll see the Introduction dialog box. If the wizard makes any changes to your existing files, it makes backup copies that can later be restored, as explained on page 41. Click Next to continue the conversion process.
2.
The wizard is designed to make the most logical conversion decisions for you. The default wizard options should convert the majority of settings successfully. The first time you use the wizard, you should accept the Let the wizard decide option. Click Next to continue the conversion process.
3.
If the wizard does not detect any old settings files, you’ll see a dialog box telling you so (go to the next step if this dialog box did not display). If you have old settings files that you want to convert, and Reflection did not detect them (they are in a remote folder), click Back to perform this conversion using the Let me make the decisions option. Otherwise, click Finish to close the wizard.
4.
If Reflection detected settings files to convert, the wizard shows the Finish the Conversion dialog box. Click Finish now to convert the detected settings files. If the wizard finds earlier settings files, it loads each one in turn and saves the settings to the new format. If you have settings files that contain values such as different terminal window positions or terminal window colors, you will notice a lot of window “hopping” and color changes as Reflection loads the settings files and saves them. If any errors occur during the conversion process (such as a missing version 6.0 or earlier connect script that is linked to a settings file), they are recorded to a conversion log explained on page 42. You will be given the option to view the log if any errors occur.
5.
When the conversion completes successfully, you’ll see a Conversion Complete dialog box. Click OK to exit the wizard and return to Reflection or click View to view the errors (if there were any). You can open a converted settings file using either Windows shortcuts or the Open command on the File menu.
Using the Reflection Wizards
39
Establishing a Connection After Converting In previous versions of Reflection, how you accessed saved connection information depended on which version you were using: ·
In versions 5.0, 5.1, and 5.2 of Reflection, you used the Connection Directory and Phone Directory commands on the Connection menu.
·
In versions 3.7, 4.0, 4.1, and 4.2 of Reflection, you used the Open command on the Connection menu.
To establish a connection using this same information in version 7.0 of Reflection, you can run the connection-only or complete settings file using either the Windows shortcut or the Open command on the File menu.
Establishing a Connection from an Icon or Shortcut You can establish a connection to a host using any new Reflection shortcut or any of the old icons (shortcuts) you created using older versions of Reflection. In either case, converted connection-only or complete settings files will successfully connect to the host. However, Reflection will act differently depending on whether you installed Reflection over an existing copy, or installed the product to a different folder: ·
If Setup is installed in the same folder as the older version: The conversion ensures that the icon or shortcut is updated, and will run both a shortcut linked to the Reflection executable and its associated settings file (for example, Settings.r2w), or any settings file that contains a configured connection. In either case, the new executable loads the converted files, and the host connection is made.
·
If Setup is installed in a different folder than the older version: In this case, if the icon opens the older version of the Reflection executable and its associated settings file (for example, Settings.r2w), it will continue to do so. However, if the icon opens a settings file, then the newer Reflection executable loads an older version of the settings file (from its original location) and prompts you to convert this settings file when you exit Reflection. If you decide to convert this older settings file, it will be converted permanently and you will no longer have a copy of it.
40
Using the Reflection Wizards
Establishing a Connection using the Open Command The Open command on the File menu provides an easy way to start a Reflection session. Using this command, you can select and load the settings file you want either over the current session and its loaded settings file (you are prompted to save changes, if any, to the current settings file), or in another window, by selecting the New window check box. To establish a connection using the Open command: 1.
Run the Settings Conversion Wizard, explained earlier in this chapter.
2.
In Reflection, click Open on the File menu.
3.
How you proceed in the Open Settings dialog box depends on the configuration of your earlier saved connection settings: ·
If the connection you converted was linked to a settings file, then the wizard created a complete settings file (with the same name as the directory or template). Therefore, leave the Files of type list set to its default value of Settings.
·
If the wizard converted a connection-only entry or template (that is, it was not linked to a settings file), select Connection (*.rco) in the Files of type list.
4.
To establish a connection, click the earlier Connection, Phone Directory, or template name from the list, then click Open.
5.
Follow the prompts and log in as you usually do.
Canceling the Conversion If you click Cancel at any time during the conversion, you’ll see a warning dialog box. If you want to ensure that the wizard runs the next time Reflection starts, select the Auto-run the wizard the next time you start Reflection check box. After reviewing the remaining information in this dialog box, click Yes to exit the wizard.
Using the Reflection Wizards
41
Running the Conversion Wizard Manually You can run the Settings Conversion Wizard manually by running the script file Convert.rbs. This file is located in the Reflection folder, and you can run the script file using this method: 1.
Press a+L to open the Reflection command line.
2.
Using the RunScript method, type the following (note use of quotes): .RunScript "C:\Program Files\Reflection\Convert.rbs"
If you are running the wizard manually to guide it to settings files it did not detect, and therefore did not convert, make sure you use the Let me make the decisions option in the Conversion Method dialog box. This lets you specify the settings files for the wizard to convert.
Restoring Converted Settings Before the wizard converts earlier settings files, it copies only the files it is replacing into a folder beneath the User folder called Restore (if you don’t have a User folder, the Restore folder is created beneath the Reflection folder). Each file placed in this Restore folder is renamed with the prefix “Old_.” For example, the contents of \Program Files\Reflection\User\Restore might look like this: Old_Favorite Settings.r2w Old_Compuserve Account.r2w Old_Unix Connection.r2w
To restore converted settings, start the wizard manually as explained in the procedure on page 41. Then follow this procedure: 1.
In the Introduction dialog box, click Next to display the Restore Your Old Settings dialog box.
2.
Click Finish. The wizard restores these archived settings files to their original configuration.
3.
After the earlier settings are restored, you’ll see the Restoration Complete message box. You have two choices: ·
Click Exit to return to Reflection—if you want to try the conversion again, you’ll need to repeat the procedure above.
·
Click Restart to rerun the conversion using the advanced conversion options in the Conversion Method dialog box.
42
Using the Reflection Wizards
Using the Conversion Wizard Log File The wizard records all of its conversion information to a file called Conv1log.txt (Reflection for HP with NS/VT), Conv2log.txt (Reflection for UNIX and Digital), or Conv3log.txt (Reflection for ReGIS Graphics). The log file is located with the original (old) settings in the \User\Restore folder, and contains infor mation such as the time and date of the conversion, and all files that were copied, created, or deleted during the conversion. If the wizard fails in any way, it also records the problem information to the log for troubleshooting purposes. If you have trouble with converted settings, open the log in a text editor and see if the problem is documented there.
Introducing the Reflection Connection Wizard The Reflection Connection Wizard takes the guesswork out of establishing a session with a host computer. The wizard guides you through the process by asking a series of questions. To answer the wizard’s questions, you need to know the following: ·
The connection method you are using, either over a network, using a modem, or directly through the PC’s serial port.
·
The type of host computer you want to connect to. A host computer is typically a mainframe, minicomputer, or other centrally administered computer system. Depending on which Reflection connectivity products are installed on your PC, you can establish a session with the following types of hosts: –
A Hewlett-Packard HP 3000 minicomputer
–
An IBM mainframe
–
An IBM AS/400 mid-range computer
–
A UNIX minicomputer
–
A Digital OpenVMS minicomputer
–
An electronic bulletin board service (BBS)
–
An X Windows client
–
A Unisys A Series host
Using the Reflection Wizards
·
43
The name or IP address of the host. The Internet address (or “IP address”) is a numeric value that identifies the host on a TCP/IP-based network. Each PC and host on the network must have a unique IP address. Your PC may be configured so that a non-numeric host name can be used to find the host IP address on your network. For example, your host computer may have an IP address of 152.183.13.6, but in your everyday work you refer to it by its host name of “Baldrick.”
·
Phone number (if you’re using a modem).
If you don’t know the answer to one of the wizard’s questions, contact your system administrator.
Starting the Connection Wizard To establish a host connection using the Connection Wizard: 1.
On the File menu, click New Session.
2.
Select Connection Wizard, then click OK.
3.
After you answer the questions on each of the wizard’s panels, click Next to continue to the next panel. If you want to go back to an earlier panel to change an answer, click Back. To exit the wizard before finishing, click Cancel. Help is available on each panel by clicking Help.
Note: You can also start the wizard by clicking the Connection Wizard icon in the Wizards program folder, available from the Start button. à
S E CT ION
3
Working in the Terminal Window
C ha pt er
6
Working in the Terminal Window The terminal window is where you interact with the host computer; it acts like the screen of a terminal. While it looks to the host like a standard terminal, Reflection takes full advantage of the Windows interface. The Reflection for UNIX and Digital terminal window looks like this:
47
Project Name • Chapter 6 • Working in the Terminal Window • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\TERMWIN.FM • 8.24.98 • 11:18am
48
Working in the Terminal Window
If you have questions about the functionality of any item in the window or commands in the menu bar, you can do any of the following to get the question mark icon pointer: ·
Click the question mark icon in the toolbar, or
·
Click What’s This on the Help menu.
Then click the item you need help with. System administrators can control access to specific menu commands using the Reflection Profiler; these commands still appear on Reflection’s menus, however, they are dimmed. When you highlight a command that has been disabled, the status line text at the bottom of the terminal window reads: Disabled by your system administrator
If you need to access a command that has been disabled, contact your system administrator (do not contact WRQ’s technical support; there is nothing they can do to reverse access to disabled features).
Changing the Terminal Window’s Title Bar Text By default, the terminal window title bar shows the name of the current settings file. The name in the title bar is also the text you see when you minimize Reflection. To change the title bar text: 1.
On the Setup menu, click Display, then click the Options tab.
2.
Enter a name in the Window title box.
3.
Click OK to accept this change and close the dialog box.
To retain your changes, click Save on the File menu.
Working in the Terminal Window
49
Reverting to Reflection’s Default Title Bar Text To restore Reflection’s title bar to the name of the active settings file: ·
On the Options tab in the Display Setup dialog box, clear all text from the Window title box.
·
If you want to have no text in the title bar, press the f once in the Window title box.
Including Variable Information in the Terminal Window’s Title Bar Text You can include special characters in the Window Title box: Character
Meaning
&c
Connected or not connected
&d
Date (in the format set by Windows)
&f
Settings file name or Untitled
&h
Host name
&i
Instance number of Reflection session (starting with 1)
&n
Product name
&r
Shows the name “Reflection”
&s
Session name (this is the same text that appears in Reflection’s status bar)
&t
Transport type (port name)
&&
Ampersand (that is, use two && to produce one &)
50
Working in the Terminal Window
Working with Text in the Terminal Window There are two terms used frequently in describing the terminal window in Reflection: The Display In Reflection, the display is like the screen of a terminal. The host can position the cursor anywhere on the display, and can write, erase, and alter characters at the cursor position. Display Memory Display memory contains both the information visible on the display and information that has scrolled off of the display. Display memory is a log of what has recently been sent from the host to the PC. Display memory stores only text; if you have graphics on the display, they are not scrolled into display memory. Note: The VT terminals Reflection emulates have no display memory. Because display memory is unique to Reflection, VMS hosts do not have access to it; the host cannot change the contents of display memory. This applies to running Reflection for UNIX and Digital and Reflection for ReGIS Graphics, and Reflection for HP with NS/VT emulating a VT-series terminal. à When you first start Reflection, there is nothing on the display or in display memory. Once you start working, data starts accumulating on the display. When the display is full and lines begin to scroll off the top, display memory starts to fill up.
Pausing Data that Scrolls onto the Display As text scrolls onto the display, either from the host or from a Reflection command, it often scrolls faster than you can read it. If you want to pause the data that scrolls onto the display, there are a couple of ways to do so: ·
Press l or use the keystroke c+S to pause scrolling, and the keystroke c+Q to resume scrolling.
Working in the Terminal Window
51
Reviewing Data in the Terminal Window To review the data in display memory: ·
Click in the vertical scroll bars.
When you use the scroll bars, the Stop (Reflection for HP with NS/VT) or Hold (Reflection for UNIX and Digital or Reflection for ReGIS Graphics) indicator in Reflection’s status bar is displayed. This temporarily freezes text sent by the host so you can view text in the display and display memory. If the terminal window is sized so that a portion of the display is obscured (for example, in 132-column mode with a narrow window), you can scroll by clicking in the horizontal scroll bar. If you are accustomed to using the keyboard instead of the scroll bars, see the online help for the corresponding keyboard shortcuts (search for Display memory, reviewing data).
Selecting Text in the Terminal Window The following procedures show some different ways to select text using the mouse in the terminal window (these procedures assume that you haven’t remapped the mouse). After releasing the mouse button, the s key can be used to extend the selection with subsequent clicks or drags. To select everything you see on the screen and that information which has scrolled off of it, click the Select All command on the Edit menu. For instructions on selecting graphics images in Reflection for ReGIS Graphics, see page 157. To select any portion of a line Point at the letter where you want to start the selection, then hold down the left mouse button and drag. To select a complete word Point at the word and double-click the left mouse button. To select a complete line When you move the mouse pointer to the left margin of the terminal window, the pointer changes into an arrow that points up to the right. This allows you to select a line by clicking the left mouse button, or to select multiple lines by dragging the pointer down in the left margin. Clicking and dragging extends the selection a whole line at a time. To select a rectangular portion of text Hold down the c key and drag the mouse pointer while holding down the left mouse button.
52
Working in the Terminal Window
Working with the Mouse Your mouse may have more than two buttons. For three-button mice, the middle button is used in conjunction with the c key for graphic input cursor operations in Reflection for ReGIS Graphics. For four-button mice, only the primary (left) and secondary (right) buttons are used in Reflection. In general, the left mouse button is used to select items in Reflection—if you have a one-button mouse, this always acts as the left mouse button. Reflection supports the Microsoft IntelliMouse wheel for scrolling purposes and as the center button of a three-button mouse device. You must select the Show 3 buttons check box in the Mouse Map Setup dialog box to enable this functionality. For instructions on mapping the mouse, see page 121. Using the Mouse icon in Control Panel, you can adjust the mouse speed. Left-handed users can switch the functionality of the right and left mouse buttons.
Using the Right Mouse Button The right mouse button performs special functions in Reflection’s terminal window: ·
Using the right mouse button to click in the terminal window opens the Reflection terminal window shortcut menu. Use this menu to simulate pressing the n key, copy and paste, show or hide toolbars or the Reflection terminal keyboard, or open the Display Setup dialog box.
·
Use the right mouse button to click on a word or string of text to transmit the string to the host, followed by a carriage return (CR). When you use the right mouse button to click on a blank, just a CR is sent to the host. If you do not want a CR automatically appended to the word, hold down s while you click with the right mouse button.
·
If you are using Reflection for HP with NS/VT, the feature described next requires that transmit functions be enabled (if you need to know how to enable this feature, search for Transmit functions check box in the online help). Clicking the right mouse button while holding down the c key sends a sequence of arrow keys to the host program, which moves the host cursor to the place where you clicked. For example, if you are in a host editor and want to move the editor’s cursor using the mouse, hold down c and use the right mouse button to click where you want the cursor to be. Note: You can only move the cursor to another position on the display; you cannot move it into display memory. à
Working in the Terminal Window
53
·
Using the right mouse button to click on the Minimize and Maximize buttons in the terminal window decreases and increases the size of the window in proportional increments.
·
Clicking the right mouse button on the toolbar displays a toolbar shortcut menu.
·
Clicking the right mouse button on Reflection’s title bar displays the system menu, which lets you move, resize, or close the terminal window.
Default Keyboard Shortcut for Copy/Paste Commands The default shortcut for the Copy command on Reflection’s Edit menu is c+(cursor pad) v. This is different from the standard Windows Copy command shortcut c+C. The Reflection default differs from the Windows standard because, by default, c+C sends the interrupt character to the host. Because of the Copy command variation from the default mapping, the default shortcut for the Paste command is s+(cursor pad) v. You can always map these keystrokes to the standard Windows default. For example: 1.
Click Keyboard Map on the Setup menu.
2.
Under PC keyboard, click CTRL, then click C.
3.
In the Action box, click Commands.
4.
Under Command type, select Menu Command.
5.
In the Categories list, click Edit.
6.
Under Commands, click EditCopy.
7.
Click Map to map c+C to the Copy command on the Edit menu.
8.
Click OK.
9.
Use a similar procedure to map c+V to the Paste command on the Edit menu. There is no Cut function because the display is controlled by the host.
54
Working in the Terminal Window
Related Online Help Topics See the Reflection online help for information on these topics: ·
Setting the scrolling speed of text in the terminal window.
·
Changing the amount of memory allocated for storing text in display memory (the area that stores text that has scrolled off of the terminal window).
·
Changing the shape of the cursor, and controlling whether it blinks or is visible.
·
Configuring user keys (user keys are available in Reflection for HP only).
·
Displaying a connection indicator (for modem connections) representing the state of one of the two RS-232 lines.
·
Showing or hiding the menu bar, title bar, status bar, terminal window frame, and the vertical scroll bar.
·
Controlling the information that is displayed in the status bar when it is visible.
C ha pt er
7
Using Events in Reflection Reflection’s Events feature, available from the Setup menu, is new in version 7.0. It lets you associate a predefined event in Reflection, such as transferring a file, with the execution of an action that you can define, such as logging off the host. By doing this, Reflection can automatically perform a variety of tasks, freeing your time for other work. Reflection includes 17 predefined events that you can associate with actions using options in the Event Setup dialog box (explained on page 56). Once you have created them, events are stored in Reflection settings files, and can be distributed among a group of Reflection users as host-specific settings files, for example, or as a single, site default settings file using the Reflection Profiler (see the Reflection System Administrator Guide for more information on the Profiler). You can define multiple events for execution during a Reflection session. Each event, in turn, can perform multiple actions. As you define events and add them to the Defined events list in the Event Setup dialog box, you can control both the order and activation of the event. Buttons on this dialog box let you create new events, duplicate and edit existing events, and remove unwanted events from the list.
Types of Events There are 17 predefined events that come with Reflection. For a complete list of the events, search for Events, list of supported events in the online help. You cannot add to the list of events shipped with Reflection, but the predefined events should include most of the events you might want to use. Each of the 17 predefined events falls into one of five categories: ·
Time-related: Requires definition of a time after which, or a specific time at which, the event should execute.
·
Keyboard-related: Requires definition of either a specific key or any keyboard key that, when pressed, will cause the event to execute.
·
Position-related: Requires definition of either a row or column coordinate, or both the row and column coordinate, in the terminal window that will cause the event to execute.
55
Project Name • Chapter 7 • Using Events in Reflection • TEMPLATE: docs_v4 • D:\working\rwin\ug\online\Events.fm • 8.24.98 • 11:18am
56
Using Events in Reflection
·
String-related: Requires definition of the exact characters and case, in sequence, that will cause the event to execute.
·
No definition is required: These events require no parameters to execute.
For more information on event types, search for Events, event types in the online help.
Defining a New Event Defining a new event in Reflection requires that you choose an event and define the action it will execute. If an event you want to create is similar to an existing event, simply copy and edit an existing event using the Duplicate Event dialog box (see “Viewing and Changing the Properties of an Event” on page 60 for more information). However, if you are defining a new event from scratch, you will need to first choose and configure the event, then associate it with an action:
Using Events in Reflection 57
Choosing and Defining an Event To choose and define the event: 1.
On the Setup menu, click Events.
2.
Click New on the Events Setup dialog box to display the New Event Properties dialog box.
3.
Choose an event from the Event type list. For a complete description of each event, search the online help index for Events, list of supported events.
4.
If the event requires further definition, configure these parameters using the controls provided in the Event details group box. For example, if you choose the At a specific time of day event, the Time box appears. Use this to specify the time at which the event should be executed. For a complete explanation of the controls you can use to define the event parameters, search for Events, control types in Event details box.
5.
Decide how often the event should run using options in the Run this event box: ·
Every time: Reflection executes the event every time the event is encountered. As an example, the When text appears on the screen event reacts depending on how the text is placed on the screen. When the host places text on the screen, it triggers the event every time this text appears. When the text appears on the screen by typing, the text must disappear and then reappear in the terminal window (display memory is excluded) before the event is triggered again.
·
Once per session: Reflection executes the event the first time it is detected only. The event executes again only when you reload the settings file.
·
Once, then delete it: Reflection executes the event once, then deletes the event from the Event Setup dialog box.
Now, associate the event with an action, explained next.
58
Using Events in Reflection
Associating an Event with an Action To associate an event with an action, you must first define the event using the procedure above. Once you have done this, follow these steps to create an action: 1.
With the New Event Properties dialog box open, and an event defined, choose the Action option that this event will execute: ·
Send text transmits text to the host. Use the Insert a special character list box to enter the characters you want to transmit. Or use the Insert special characters using the keyboard check box to show special keyboard characters you type directly in this box.
·
Macro runs a Visual Basic macro or Reflection Basic script. The dialog box will change according to what you select from the Type list. Provide either a Macro name (Visual Basic) or Script file name (Reflection Basic).
·
Commands performs a terminal command (such as transmitting a host keystroke) or menu command (such as toggling the state of the k key), or executes a Visual Basic command. If you chose Terminal Command or Menu Command, use the Categories and Commands list boxes to complete your selection.
For more information, see Mapping in the online help. 2.
Enter the information required of the action type. For example, if you select Send text as the action, enter the string in the Text to send box, using the Insert a special character list to add characters, such as a carriage return, as needed.
3.
Enable the event: the event is enabled by default (if the Enabled check box is not selected, do this now). See “Enabling and Disabling Events” on page 59 for more information.
4.
Click OK to close the New Event Properties dialog box. The new event is added to the bottom of the Defined events list in the Event Setup dialog box.
Using Events in Reflection 59
Ordering Events Once you have created the event, it is added to the bottom of the Defined events list in the Event Setup dialog box. Use the up or down arrow button to move a selected event in the Defined events list. This governs the order in which the event (and its associated actions) execute. To change the order of an event: 1.
On the Setup menu, click Events.
2.
In the Event Setup dialog box, select an event in the Defined events list.
3.
Click the up or down arrow to move the event up or down in the list.
4.
Click OK.
Note: The only time the order of events is bypassed is whenever one event must logically follow another. For example, the When a connection is made event will always precede the When a connection is terminated event regardless of the order in the Defined events list. à
Enabling and Disabling Events An event must be enabled in order to execute. In its disabled state, an event will not execute, but remains available in the Defined events list for reactivation at a later time. Note that, when enabled, an event can be configured to execute in three different ways using the options in the Run this event box. These options are explained on page 57, step number 5. To enable or disable an event: 1.
On the Setup menu, click Events.
2.
In the Event Setup dialog box, select an event in the Defined events list, then click Properties.
Tip: Or you can double-click an event to display it in the Event Properties dialog box. à 3.
4.
Disable or enable the event: ·
To disable the event, clear the Enabled check box.
·
To enable the event, select the Enabled check box.
Click OK to exit the Event Properties dialog box, then click OK to exit the Event Setup dialog box.
60
Using Events in Reflection
Creating a New Event from an Existing Event Whenever you want to create a new event that is similar to an existing event, simply copy the existing event and reconfigure the event as needed. To create a new event from an existing event: 1.
On the Setup menu, click Events.
2.
In the Event Setup dialog box, select an event from the Defined events list and click Duplicate.
Tip: Or you can double-click an event to display it in the Duplicate Event Properties dialog box. à 3.
Change the configuration of the event as needed. Refer to “Defining a New Event” on page 56 for details on configuring and enabling an event.
4.
Click OK to exit the Duplicate Event Properties dialog box, then click OK to exit the Event Setup dialog box.
Now, order the events in the Defined events list using the steps in “Ordering Events” on page 59.
Viewing and Changing the Properties of an Event If you want to check the configuration of an existing event, or if you want to edit the event, follow this procedure: 1.
On the Setup menu, click Events.
2.
In the Event Setup dialog box, select an event in the Defined events list.
3.
Click Properties.
Tip: Or you can double-click an event to display it in the Event Properties dialog box. à 4.
Change the configuration of the event as needed.
5.
Click OK to exit the Event Properties dialog box, then click OK to exit the Event Setup dialog box.
Using Events in Reflection 61
Deleting an Event Removing an event from the Defined events list deletes the event permanently. If you only want to disable the event but keep it for use later, see “Enabling and Disabling Events” on page 59. If you want to remove the event from the list, follow this procedure: 1.
On the Setup menu, click Events.
2.
In the Event Setup dialog box, select the event to delete in the Defined events list.
3.
Click the Remove button. The event is deleted from the Defined events list.
4.
Click OK.
Related Online Help Topics See the Reflection online help for information on these topics: ·
Examples of using events; see Events, examples.
·
Finding a row and cursor position; Events, finding a row and column coordinate in the terminal window.
·
Events, list of supported events for a list of defined events.
·
Events, event types for a list of the categories of events.
C ha pt er
8
Working with Settings Files A settings file is a record of your current Reflection settings, such as your host connection, display preferences, and file transfer settings. Any changes you make to Reflection settings are temporary; Reflection uses them only until you change them again or exit Reflection. To record changes permanently, save them to a settings file. Reflection lets you save and use two different kinds of settings files: ·
Complete settings files, which contain information specified in Reflection dialog boxes, as well as information provided by links to partial settings files (explained in the Reflection System Administrator Guide).
·
Partial settings files, which contain information limited to a particular set of settings. For example, you can save a partial settings file that contains only toolbar settings as a toolbar settings file. Then you can share this toolbar settings file (and any other partial settings file) among Reflection for Windows products.
Once you save a settings file, you can duplicate a Reflection session at a later time without having to re-enter your connection information or reset any options you have customized. In Reflection, settings files provide a variety of options: Launch other Reflection products using the Open Settings dialog box You can start other Reflection products (including Reflection X and Reflection for IBM) from the Open Settings dialog box, available using the Open command on the File menu. Save a set of settings in partial settings files A partial settings file contains information about specific Reflection settings. These can include keyboard map, mouse map, toolbar, color, hotspots, menus, or connection settings. You can open a partial settings file without altering any of the current settings except for those settings contained in the partial settings file.
63
Project Name • Chapter 8 • Working with Settings Files • TEMPLATE: docs_v3 • D:\working\rwin\ug\online\LINK.FM • 8.24.98 • 11:18am
64
Working with Settings Files
Link partial settings files to complete settings files You can create and save a link between a partial settings file and a complete settings file; this is recommended for advanced users only. Doing so lets you automatically establish a relationship between the two types of settings files so that whenever you load a complete settings file the partial settings file automatically loads as well. This is useful for a group of Reflection users who might share a toolbar as a toolbar settings file. The link becomes permanent when you save the complete settings file. View the contents of settings files The View Settings dialog box shows information from all of Reflection’s Setup dialog boxes, as well as other settings. You can use the View Settings dialog box to look at most of Reflection’s current settings, or only those settings that have changed from their defaults. You can also change Reflection settings from this dialog box. See page 163 for more information.
File Extensions Used by Reflection Products Complete settings files are product-specific, meaning they belong only to the Reflection product that created them. For example, if you open a complete settings file in Reflection for UNIX and Digital that was created in Reflection for HP with NS/VT, this will start a session of Reflection for HP with NS/VT using those settings (provided you have both products installed). You identify a complete settings file and the product it belongs to by its file name extension: Reflection Product Name
File Extension
Reflection for HP with NS/VT
.r1w
Reflection for UNIX and Digital
.r2w
Reflection for ReGIS Graphics
.r4w
Reflection FTP Client
.rfw
Reflection for IBM
.rsf
Reflection X
.rxc
Unlike a complete settings file, a partial settings file does not belong to a specific Reflection for Windows product. This means that, in some cases, you can use a partial settings file created in one product to change the settings for another Reflection product.
Working with Settings Files
65
You can identify a partial settings file by its file name extension: Type of Partial Settings
File Extension
Keyboard map
.rkm
Mouse map
.rkm
Toolbar
.rtb
Colors
.rcr
Menus
.rmu
Hotspots
.rhs
Connection
.rco
Note: If you’re accustomed to starting Reflection by clicking on a settings file name in Windows Explorer, note that Windows Explorer does not display file extensions by default. à
Creating and Opening Settings Files When creating a new settings file, start a new session of Reflection and change any settings you want to change from the factory defaults. Or start fresh by resetting a copy of Reflection to its factory defaults using the Defaults command on the Setup menu.
Creating a Settings File To create a new settings file: 1.
If you already have a settings file loaded, make any changes to customize your settings.
2.
On the File menu, click Save As to open the Save Settings dialog box.
3.
Select the type of settings file you want to save from the Save as type list; save either a complete settings file or one of the partial settings file types.
4.
Enter a name for the settings file in the File name box. It is recommended that you save settings files in the Reflection\User folder.
5.
Click Save.
66
Working with Settings Files
Opening a Settings File To open a settings file: 1.
On the File menu, click Open to display the Open Settings dialog box.
2.
Select the type of settings file you want to open from the Files of type list; select either a complete settings file or one of the partial settings file types.
3.
Select the name of the settings file you want to open:
4.
·
If you select a complete settings file that belongs to the Reflection product you are currently running, select the New window check box to open this settings file in a different window. Or clear this check box to open the settings file in your current copy of Reflection; this will drop an active host connection, if applicable.
·
If you select a complete settings file that belongs to another Reflection product, that product will start in its own window with these settings.
·
If you select a partial settings file, the settings contained in that file (regardless of which Reflection product the file belongs to) will temporarily replace the applicable set of settings currently active in Reflection.
Click Open.
Related Online Help Topics See the Reflection online help for information on these topics: ·
Starting Reflection with a settings file.
·
Working with a partial settings file.
·
Restoring Reflection factory settings to their defaults.
·
Settings file, creating Windows shortcut.
·
Converting a settings file to version 6.0 or higher format.
C ha pt er
9
Setting Up Colors Reflection lets you customize the color of your screen, the color of host attributes, and in Reflection for HP with NS/VT, the color of the function key labels and colors used under VT emulation (for example, SCO-ANSI or BBS-ANSI). For each item, you can select a color for text attributes and a color for the background. For plain text, the background consists of the entire window. In Reflection for ReGIS Graphics, which emulates a graphics terminal, you can also map colors for graphics and text. Once you’ve created an assortment of color selections you like, you can save them in a complete settings file, or to a color-only settings file.
Changing Colors and Saving Color Schemes To change the colors in your Reflection window: 1.
Ensure that the Terminal type is not set to an ANSI option.
2.
On the Setup menu, click Display, then click the Colors tab.
3.
Select an element from the Screen element list. To see more attributes in the list, select the Edit all attributes check box.
4.
In the Text and Background palette boxes, the current colors of the attribute are highlighted. To change the color of an attribute, click a new color—the highlight moves to the new color square. See page 68 for information on creating custom colors.
5.
Change the color of any other attributes until you are satisfied.
6.
If you are using Reflection for HP with NS/VT, to change the color of the function key labels select the sample screen labels f1–f8, and choose a different color.
7.
Select or clear the Enable blink, Enable underline, and Enable bold check boxes as needed. See the online help for descriptions of these items.
67
Project Name • Chapter 9 • Setting Up Colors • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\COLORS.FM • 8.24.98 • 11:18am
68
Setting Up Colors
8.
If you are using Reflection for ReGIS Graphics, there are two additional check boxes that control ReGIS graphics: Enable host color changes and Restore text colors. See the online help for descriptions of these items.
9.
To save the new color selections to a color scheme (that is, a color-only settings file), click the Save As button.
10. Name the settings file and click Save. 11. Click OK to close the Display Setup dialog box and view the new colors.
Creating Custom Colors On the Colors tab in the Display Setup dialog box, you can choose among 16 colors to assign colors to host attributes. You can change the color for any color square on the text/background grids by adjusting the values for hue (H), luminosity (L), and saturation (S), or by specifying the amounts of red (R), green (G), and blue (B). To create custom colors, click the Color Map button, or double-click any one of the color map squares, to open the Color Map Setup dialog box. The color map shows the 16 terminal colors used for graphics and text drawing. The color palette below the map displays an array of available colors. To change the color of one of the terminal color map entries: 1.
Select the map entry you want to change.
2.
You can use one of the following methods to select a new color: ·
Drag the arrow up or down the luminosity bar to adjust the luminosity of the color; as you do this, the values in the red (R), green (G), and blue (B), and luminosity (L) boxes change.
·
When the mouse is over the color palette, it changes to an upward pointing arrow. Use this arrow to click a color area: a black circle is drawn around the area you selected, and the six color values to the right are updated for the new color.
Setting Up Colors
69
·
The Hue (H) is the position of a color along the color spectrum (for example, yellow is a hue position between red and green). The Saturation (S) is the purity of a color’s hue, moving from gray to the pure color. As a pure hue is diluted by white, its saturation decreases. The Luminosity (L) is the brightness of a color on a scale from black to white.
·
You can create a color by defining the relative amounts of R, G, and B, which also affects the color’s H, S, and L values.
Whichever method you use to change the colors, your new selection can be seen in the color square to the right of the Color map box. 3.
When you arrive at colors you like, click OK. The text and background palettes are updated with each new color.
Restoring Colors Changed by Graphics Programs This section applies to Reflection for ReGIS Graphics only. The 16 colors you set in the Color Map Setup dialog box are temporarily saved by Reflection for ReGIS Graphics when all three of the following events occur: ·
Reflection is placed into ReGIS mode by a graphics program.
·
The program changes your colors.
·
A ReGIS or sixel image is drawn on the screen.
Your colors are then restored when either of the following occurs: CS C C I H , SI J , or SI 2J
·
The entire screen is cleared (with the sequence
·
The program exits ReGIS mode, and the entire image scrolls off the screen (for example, as the result of a series of LF characters).
).
Note: This behavior differs from an actual terminal, where your original colors are never restored when changed by a graphics program. à If the colors were changed in ReGIS but no graphics were drawn, then your original colors are not restored. This preserves the intent of some text programs that use ReGIS to change screen colors.
70
Setting Up Colors
VT340 Text Attribute Range A VT340 terminal does not allow the text attributes to be changed outside the range 0–7 for plain text, and 0–15 for bold text. Consequently, if you select colors outside of this range, your text may revert to a different color after running a graphics program. For example, a host program may only restore colors 0, 7, and 15. To reset the colors, you can either load the color scheme contained in a color-only settings file or a complete settings file, or manually adjust the colors using the Colors tab in the Display Setup dialog box.
Creating Custom Colors Under ANSI Emulation This section applies to Reflection for UNIX and Digital and Reflection for ReGIS Graphics only. You can configure Reflection’s ANSI color map in the Display Setup dialog box just as you can under other emulations. However, you are limited to the color choices available to you. Use the procedures below to configure ANSI colors from Reflection: 1.
On the Setup menu, click Terminal, then click the Terminal Type tab.
2.
Select either BBS-ANSI or SCO-ANSI, then click OK.
3.
On the Setup menu, click Display, then click the Colors tab. The color map at the top of this dialog box shows the 8 colors (for BBS-ANSI) or 16 colors (for SCO-ANSI) you can change. The color palette below the map shows an array of available colors. Now, to create a custom color:
1.
Highlight the ANSI map entry you want to change.
2.
Use any of the methods described on page 68 to choose a new color.
3.
Whichever method, or combination of methods, you use to change the colors, your new selection can be seen in the large color square to the right. The top half shows the new color and the bottom half shows your original color. You can click on this original (Old) color square at any time to reset the color value.
Setting Up Colors
71
4.
When you have chosen the ANSI colors you like, click OK. To save this change, you can save either a color scheme or your Reflection settings file.
5.
The color you selected to replace the ANSI color will be displayed instead of the standard ANSI color. For example, if you select Blue from the dialog box and change it to a green color, whenever a host program would display blue, the green color will be substituted for it.
Changing ANSI Colors During VT Emulation You can use Reflection to emulate a VT terminal (and retain its keyboard mapping) and also interpret ANSI colors without interpreting any other ANSI sequences. When you switch to an ANSI terminal type (BBS-ANSI or SCO-ANSI), the Colors tab in the Display Setup dialog box automatically shows ANSI colors. You can use a Reflection macro property to configure ANSI colors when you’re emulating a terminal other than ANSI by following these steps: 1.
Press a+L to open the Reflection command line.
2.
Type the following command and press n: Application.UseAnsiColor=True
3.
To retain this change, click Save on the File menu.
When you switch to ANSI emulation, the default value for this property is True. For non-ANSI emulation, the default is False, so you must make this change yourself.
Related Online Help Topics See the Reflection online help for information on these topics: ·
Display, customizing to configure Reflection’s terminal window.
·
Using sample color partial settings files shipped with Reflection.
·
Working with color in Reflection for ReGIS Graphics using ReGIS graphics, Tektronix graphics, and color mapping.
C hap ter
10
Changing the Display Font The display font in Reflection can be changed to any monospaced (also known as fixed-pitch) font. You can also choose from regular or bold text font formats, or change a font’s size. Reflection’s TrueType font support differs from that of other programs, such as word processors: because the host needs to be able to access characters on the screen (using row/column position coordinates), Reflection can only support TrueType fonts that are monospaced. For more information, see “Understanding TrueType Font Support in Reflection” on page 77. Reflection can use other display fonts, such as international fonts, as long as they are loaded and recognized by Windows.
Fonts Installed by Reflection’s Setup Program To use a font other than Reflection’s default display font, that font must already be installed under Windows and be in the registry. If you run Reflection Setup and choose the Typical installation option, Setup automatically installs Reflection’s TrueType fonts and modifies the registry for you. If, during Setup, you choose Custom installation and select the International Font Files check box, Setup also copies bitmap and TrueType fonts for international support. These fonts are also automatically copied when the Setup program detects Windows running in a specific language.
73
Project Name • Chapter 10 • Changing the Display Font • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\FONT.FM • 8.24.98 • 11:18am
74
Changing the Display Font
Examples of Supported Fonts Reflection supports monospaced fonts. Courier New is an example of a monospaced font. Arial is an example of a TrueType font that is not monospaced, and therefore is not supported by Reflection, which means that it won’t show up in the list of available fonts seen on the Fonts tab in the Display Setup dialog box. TrueType fonts are identified in a box with a symbol to the left of the font’s name that looks like this: . Reflection also supports bitmap fonts for international languages, such as Courier and Terminal.
Reflection’s Default Display Font Usually, Reflection uses a font called r_ansi that accurately emulates the terminal. If Reflection detects that you are running Windows in a language other than English, it may substitute a different font. When you resize the terminal window, Reflection chooses a new font size so the correct number of rows is displayed on the screen. If Reflection cannot accommodate the number of rows specified on the Screen tab in the Display Setup dialog box, then only a portion of these rows will be displayed at once. Use the vertical scroll bar to see the other rows. Reflection also tries to fit the number of columns on the screen. When Reflection cannot show all columns on the screen, a horizontal scroll bar appears in the terminal window. You can reverse this behavior and maintain the same font size when you change the size of the terminal window by clearing the Auto font sizing check box, which is on the Fonts tab of the Display Setup dialog box.
Changing the Display Font
Changing the Display Font To change the terminal window font, font style, or font size:* 1.
On the Setup menu, click Display, then click the Fonts tab:
2.
Select a new font and, if necessary, a new font style (regular or bold). The Sample box changes depending on which font, font style, and font size you have selected.
* In Reflection for HP with NS/VT, changing the display font also changes the font shown in the user key labels.
75
76
Changing the Display Font
3.
To change the font size, first clear the Auto font sizing check box (otherwise the Size box is dimmed). Then, enter a value in the Size box from 5 to 28, or choose a point size from the list. By default, the Auto font sizing check box is selected. This means whatever font you pick, Reflection adjusts the font size to fit all text in the terminal window.
4.
Click OK to accept your changes and close the Display Setup dialog box.
Where Reflection Looks for Its Fonts Reflection searches for the Reflection-specific font files in this order: ·
The Windows \Fonts folder (for example, Win98\Fonts)
·
The location specified in Windows registry
·
The Reflection folder
·
The current folder (as set in Startup)
·
The Windows \System folder (Windows 95 and Windows 98) or the Windows \System32 folder (Windows NT)
·
The Windows folder
·
Any remaining folders specified in the PATH environment
If Reflection cannot locate any of the files for r_ansi or r_control, the program will not run.
Changing the Display Font
77
Printing Text Using the Display Font Which font is used for printed output depends on three things: ·
The type of printer you have.
·
Whether the Use printer default font check box is selected in the Page Options dialog box (see page 85).
·
If the Use printer default font check box is cleared, the font used for printing is the one you have selected in the Font list in the Page Options dialog box.
Changing the display font has no effect on the font used for printing (and vice versa).
Understanding TrueType Font Support in Reflection Reflection’s support of TrueType fonts varies from other program’s support because Reflection only supports those TrueType fonts that are monospaced. Reflection’s default display font looks the best on the most standard PC monitors and on laptops. Typically, users who want TrueType fonts have large screen monitors or need to print nonstandard characters (such as line drawing characters). Unlike, for example, Microsoft Word where you can switch display fonts for any TrueType font you have installed, Reflection only supports monospaced fonts. To print Reflection’s monospaced TrueType fonts, Windows uses a font substitution option to replace them with more commonly used fonts, like Courier. See your Windows documentation for more information.
Related Online Help Topics Search under Font in the Reflection online help for information on these topics: ·
Copying and pasting TrueType and bitmap fonts.
·
Resolving the Fonts not found error message.
·
Installing international fonts.
C hap ter
11
Printing and Logging With Reflection, you can access the printing capabilities of your Windows printer through the Print command on Reflection’s File menu. You can also change print parameters within Reflection that will have no effect on printing from other Windows programs. Use the options in the Print, Print Setup, Page Setup, and Page Options dialog boxes to select what you want to print, and the format and destination of your print jobs. Another way to capture information in Reflection is to “log” the data to a file or a printer; see page 87.
How to Print from Reflection To print a copy of the screen, a selection, or the contents of display memory using Reflection’s default print settings: 1.
On the File menu, click Print to open the Print dialog box:
The default printer or disk file assigned under Windows is shown to the right of the printer or disk file icon.
79
Project Name • Chapter 11 • Printing and Logging • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\PRINT.FM • 8.24.98 • 11:18am
80
Printing and Logging
2.
Select a Print range option. Display memory prints the information visible on the display and information that has scrolled off of the display and is still in memory. Screen prints whatever you see in the terminal window.* If you are using Reflection for HP with NS/VT and have any function key labels showing, they do not print. If you are using Reflection for ReGIS Graphics and do not want graphics to print, see page 86. Selection prints the highlighted selection and is only available when you have text selected before choosing the Print command.
3.
To print multiple copies of the selected range, pick a value from the Copies box. You can print up to 99 copies.
4.
Click OK. The Now Printing dialog box opens (if you are printing the screen or a selection, this dialog box may open and close before you notice it). If you need to halt a large print job, click Cancel.
When the Now Printing dialog box closes, the information is sent to your default Windows printer. Output is printed in the same font used by the text in Reflection’s terminal window; changing the printer font is explained on page 84.
* If you’ve cleared the Auto font sizing check box (page 75) and have a font larger than that which can fit on the display, printing the screen also prints that information which has scrolled off the edge of the terminal window.
Printing and Logging 81
Changing the Print Setup You can open the Print Setup dialog box by clicking the Print Setup command on the File menu or, if the Print dialog box is already open, by clicking the Print Setup button. If you have questions about the functionality of an item in the Print Setup dialog box, click the Help button.
Selecting a Printer Other Than the Windows Default You can assign a different printer in Reflection without affecting the printer used by other programs, which is typically the default printer specified by Windows. This flexibility allows you to print host output to one printer without having to change the printer used by other applications. To change Reflection’s printer from the Windows default printer: ·
Select a printer from the list of available printers (only those printers already installed under Windows appear).
If you want to force Reflection to always use the Windows default printer specified under Windows, use the DefaultPrinter property. Search under DefaultPrinter in the Programming with Reflection online help (Rwinprog.hlp) for more information.
Printing to a File There may be times when you want to print data to a file rather than a printer. You may want to print to a file to: ·
Print at a later time
·
Edit the printed output in a text editor
·
Send the printed output to another user via electronic mail
When you capture printed output to a file, this bypasses the text formatting and printer driver sequences processed by a printer: the resulting file is a plain ASCII file created with the Windows character set.
82
Printing and Logging
The following example shows how to “print” all of display memory to a file: 1.
On the File menu, click Print Setup to open the Print Setup dialog box.
2.
Select the Print to file check box.
3.
Enter a file name and path in the Print output to box (or click Browse to pick an existing file).
4.
Click OK.
5.
On the File menu, click Print. The Print dialog box appears. The file name is shown to the right of the disk drive icon.
6.
In the Print range box, select Display memory.
7.
Click OK. The printed output is sent to the file name you indicated in step 3.
Bypassing Windows Management of Printing Select the Bypass Windows print driver check box in the Print Setup dialog box to: ·
Prevent Windows from handling fonts, font size, font style, characters-per-inch, and linesper-inch configuration. This allows you to send raw data (including printer control escape codes) directly to your printer. Output is sent to the printer immediately, instead of waiting for a whole page of information.
When you print to a file, the Bypass Windows print driver check box is dimmed.
Printing and Logging 83
If you are bypassing Windows printing to a PostScript printer, the results may not be as you expect. PostScript printers are controlled by PostScript commands, which are typically sent to the printer from a PostScript printer driver. When you bypass this driver, one of two things will happen: ·
Some printers have built-in PostScript codes that are used when no driver can be found; so your output prints in the font determined by the printer’s defaults.
·
If your printer depends on the driver for PostScript codes, then nothing (not even a blank page) will be printed when this check box is selected.
Batch Print Operations You can configure Reflection to accumulate output from a series of print events before you print. You might want to do this, for example, if you are connected to a network printer that is temporarily inoperative—you can collect all your printed output and print it all at once when the printer is again available. To configure Reflection to accumulate a series of print events before printing: 1.
On the File menu, click Print Setup to open the Print Setup dialog box.
2.
Choose Manually as the Close printer option.
3.
Clear the Auto formfeed check box. This prevents Reflection from ejecting the page after each print event—if you are printing to a printer this saves paper; if you are printing to a file, this prevents a page break from being inserted in the file.
4.
Click OK.
84
Printing and Logging
Changing the Page Options The options in the Page Setup and Page Options dialog boxes let you change how output looks on a printed page. To access these dialog boxes, click Page Setup on the File menu.
Changing the Font Used for Printing When you first start Reflection, any output you print will be printed using a TrueType font installed by Reflection called r_ansi (this is also the default font used to display text in the terminal window; changing the display font is explained on page 74). To change the printer font: 1.
On the File menu, click Page Setup to open the Page Setup dialog box.
2.
In the Page Setup dialog box, click the Page Options button. The Page Options dialog box opens:
Printing and Logging 85
3.
Select a new font name from the Font box. Only monospaced (also known as fixed-pitch) TrueType fonts, bitmap fonts, and those fonts supported by your printer are shown. Note: The fonts shown in this list are not necessarily representative of all the fonts in the Font list on the Fonts tab in the Display Setup dialog box. The choices you see depend on which printer driver you are configured for, as opposed to the display you are using. à
Optimizing How Much Text is Printed To make the best use of a page while still creating a legible printout, select the Auto row sizing option in the Page Options dialog box (see page 84). When this option is selected, Reflection prints the optimal number of rows that can fit onto a page, given the parameters you specified in the Page Setup and Page Options dialog boxes for Paper, Orientation, Margins, Text format, and Column dimensions. If you change the values for the above items after selecting the Auto row sizing option, Reflection will automatically calculate a new optimal number of rows to be printed per page. When the Auto row sizing option is cleared, Reflection prints the number of rows per page specified in the Rows per page box.
Speed Printing: Using Your Printer’s Default Font While the printed output of TrueType fonts may look nice, some printers take a long time printing these fonts. If you are more concerned with getting your printed output quickly than you are with the font it’s printed in, select the Use printer default font check box in the Page Options dialog box. This function does exactly what it says: your printer’s built-in font is used for printing. This is also called “fast text printing.”
86
Printing and Logging
Printing Graphics in Reflection for ReGIS Graphics If you are using Reflection for ReGIS Graphics and there are graphics on the display, the graphics are printed when you select Screen or Selection as the Print range option in the Print dialog box (see page 80). If you do not want graphics to print: 1.
On the Setup menu, click Terminal, then click the Graphics tab.
2.
Clear the Print graphics check box.
3.
Click OK.
Controlling the Background Printing of a Graphic The Print background check box on the Graphics tab in the Terminal Setup dialog box also affects graphics printing. It lets you print a graphic with or without the background color. By default, the background is printed. This setting applies to sixels generated as well as graphics printed on Windows printers; this includes saving display sixels in the Save Display As dialog box. In version 7.0 of Reflection, when you clear the Print background check box, the background color is not printed. This is different from earlier versions of Reflection, where clearing this check box and printing to a non-PostScript printer (a printer that can print only a black and white bitmap, and not shades of gray), would invert the colors of the screen image for printing and print light-colored graphics as black images on white paper. This functionality can be restored by changing the value of the Use Regis V6 setting to Yes in the View Settings dialog box.
Printing and Logging 87
Logging in Reflection One way of saving, printing, or copying Reflection data is to log it to a file or a printer. This is also known as “capturing” host information. How Reflection logs data is a little different from the way logging is implemented on a true terminal, where you select a destination device and log to it directly. Logging serves two different functions in Reflection: ·
It provides user-initiated logging of your terminal session.
·
It accommodates host printing, where a program turns on logging and starts sending data to either a printer or a file.
How to Log Data in Reflection Normally, logging is enabled by the host. To configure a user-initiated logging session: 1.
On the File menu, click Logging to open the Logging dialog box.
2.
Select the Logging on check box.
3.
By default, information is logged to the printer specified in the Print Setup dialog box (your default printer assigned under Windows). To change this, click Setup to open the Print Setup dialog box—this dialog box is the same as the one you see when you click Print Setup on the File menu; see page 81. You can either log to a printer or a file. To capture your output to disk, select the Disk check box and type in a file name (if you don’t specify a name, you are prompted for one when you click OK).
4.
Click OK.
When logging is turned on, lines are copied to the printer (or file) as they appear on the screen. This continues until you turn logging off. To stop logging: 1.
On the File menu, click Logging.
2.
Clear the Logging on check box.
3.
Click OK.
88
Printing and Logging
Creating a Button to Turn Logging On and Off Instead of opening and closing the Logging dialog box to change the logging state, you can add a button to the toolbar to perform this function: 1.
On the Setup menu, click Toolbar, then click the Predefined Buttons tab.
2.
From the Categories group, select File.
3.
Click and drag the button titled “Logging” to any position on the toolbar. (This button is defined with the ToggleLogging command.)
4.
Click Close to exit the Toolbar Setup dialog box.
5.
To save this change to your settings file, click Save on the File menu.
Now, each time you click this button, the logging state is turned on or off.
Related Online Help Topics Search under Printing in the Reflection online help for information on these topics: ·
Understanding the difference between printing and logging.
·
Closing the printer.
·
Preventing character translation.
·
Checking the printer status.
·
Sending escape sequences to the printer.
·
Closing the printer doesn’t stop logging (search under Logging).
C hap ter
12
Running Reflection from a Browser Reflection can be run within a web browser. This feature is available whenever you open a Reflection settings file (the object) within a browser (the container application). When run within any of the browsers Reflection supports, you can take advantage of selected Reflection features. For example, you can establish multiple host connections to Reflection and “page” between them, choose menu commands from Reflection’s menu structure within the browser, or record, save, and execute Reflection macros. You can also use the browser’s bookmark feature to save and start a Reflection settings file within the browser.
Supported Browsers Reflection can be opened from these supported browsers: ·
Microsoft Internet Explorer version 3.0 or higher
·
Netscape Communicator, all versions
·
Netscape Navigator version 2.2 Gold or higher
Note: There is a known problem with certain Beta version browsers. Search for Browser, file does not exist in the Reflection online help for more information. à
89
Project Name • Chapter 12 • Running Reflection from a Browser • TEMPLATE: docs_v3 • D:\working\rwin\ug\online\BROWSER.FM • 8.24.98 • 11:18am
90
Running Reflection from a Browser
Starting Reflection from a Web Browser Start a Reflection session from a browser by giving the browser the path (an address) to a Reflection settings file. To start Reflection from a web browser: 1.
Start a supported browser.
2.
Open a Reflection settings file from the browser. There are several ways to do this:
3.
·
Type the path to a settings file in the browser’s Address or Location box.
·
Drag and drop a Reflection settings file into the Address or Location box. Or, when viewing HTML, onto the page you are viewing.
·
Click a web page hyperlink that references a Reflection settings file.
·
Choose a bookmark if you have saved a Reflection session using this browser feature.
Choose to open the file if prompted (do not save it to disk).
After indicating a settings file name, the browser starts Reflection.
Starting the Reflection Browser Demonstration You can view how Reflection looks and operates within a browser by loading the demonstration file shipped with Reflection into a supported browser. When you do this, the WRQ home page shows with hypertext links that start demonstration copies of Reflection in the browser. To start the demonstration: 1.
Start a supported browser.
Running Reflection from a Browser 91
2.
Load the demonstration file Rdemo.htm. You can do this by: ·
Typing the path in the browser’s address box. For example, if you’re using Reflection for HP with NS/VT, the default path is: C:\Program Files\Reflection\Hp\Samples\R1demo.htm
·
Dragging and dropping the file into the Address or Location box.
3.
In the left frame, click a host selection.
4.
Choose to open the file if prompted (do not save it to disk). The demonstration begins. The WRQ web page in the right-hand frame is replaced by a Reflection session, complete with customized toolbars and hotspots.
Reflection Commands in the Browser’s Menu Bar When you start Reflection within a browser, you can use most Reflection commands. However, each browser has rules that determine support for Reflection menus and commands within the browser’s menu structure, and support for various functions each Reflection command executes. For example, most browsers reserve the File and Window menus, but provide Reflection commands from cascading or merged menus within the browser. As another example, there is no support for embedded online help shortcuts in Reflection help when run within the browser. Another difference of note is the Reflection title bar, which normally shows the name of the current host or settings file (you can customize the display). The title bar is not available (that is, it is hidden) when Reflection is run from a browser, however, this same connection information is available from Reflection’s status bar. Note: You can still create toolbar buttons to access some of the unavailable menu commands, such as File Transfer. à
92
Running Reflection from a Browser
Reflection Menu Structure in Netscape Navigator or Communicator Use this list to locate Reflection menus within a Netscape browser: Reflection Menu
Location in Navigator or Communicator
All Menus
Under Navigator’s Menu button, each command is available as a cascading menu item from a drop-down list.
Reflection Menu Structure in Microsoft Internet Explorer Use this list to locate Reflection menus within Internet Explorer: Reflection Menu
Location in Internet Explorer
File
Unavailable (some menus invoke the equivalent Reflection actions, such as File Save and File Print)
Edit
Edit menu
Connection
Connection menu
Setup
Setup menu
Macro
Macro menu
Window
Unavailable
Help
All commands are available from a cascading menu at the bottom of the Help menu
Paging Beyond the Page Limit of the Browser As you page away from a Reflection host connection in your browser, the browser will cause Reflection to deactivate, prompting an informational message. This is a normal action of a browser when run “in frame,” and the number of pages at which deactivation occurs depends on the browser. The connection still exists, but the Reflection session cannot be re-introduced into the browser window.
Running Reflection from a Browser 93
If you are not connected to a host session, Reflection will exit. If you are connected, Reflection displays the Confirm Exit message box where you can choose from two options: ·
Maintain Reflection’s host connection: Click Continue; this runs Reflection outside of the browser as a stand-alone application. Doing this restores the product’s full functionality.
·
Exit Reflection: Click Exit; Reflection closes. If you have not saved changes made during your Reflection session, you are prompted to save them.
Browser Frequently Asked Questions Following are some typical questions and answers when running Reflection from a browser.
How do I exit the browser with my current Reflection session intact? It is not possible to extract a Reflection session from a browser into a stand-alone state: the browser does not make the Exit command on the Reflection File menu available. However, you can exit the browser itself. Doing this causes Reflection to display the Confirm Exit message box which lets you maintain the Reflection session outside of the browser.
When I open a settings file from a non-Microsoft web server, my browser either tries to save the file or my display fills with binary or text characters; why? Some non-Microsoft servers, such as Appache, display unknown file types as text. To download Reflection settings files from these types of web servers, you need to define Reflection’s MIME (Multipurpose Internet Mail Extensions) in the web server. Following are the MIMEs for each Reflection product: Reflection Product
Extension
MIME
Reflection for HP with NS/VT
.r1w
application/x-reflection-hp
Reflection for UNIX and Digital
.r2w
application/x-reflection-vt
Reflection for ReGIS Graphics
.r4w
application/x-reflection-vt340
You won’t have this problem if you run the Reflection demonstration file from the WRQ home page locally (as opposed to copying the settings files up to the web server). For more information on defining MIME types, see the online help supplied with your web server or contact your system administrator.
94
Running Reflection from a Browser
What happens when I click New Session on the File menu? Opening a new Reflection session with the New Session command on the File menu does not open a new session within a browser. Reflection will start a new session outside of the browser.
Why doesn’t Reflection appear in my History list? Reflection does not pass its explicit name to the browser, but rather is represented as a path by the browser. This path is what you see wherever a browser references Reflection.
Why is Reflection moving to the background or foreground without my input? The browser can move Reflection to the background or foreground whenever it sees fit (for example, if you page away). There are many ways to return to a “hidden” Reflection browser session: ·
Click the browser’s Back and Forward buttons
·
Use the browser’s History folder to find and view the Reflection session
·
Re-enter the Reflection settings file into the address box
Are there any limitations to Reflection’s hotspots feature? If you want to create hotspots from a browser, you must select the text before you open the Hotspot Setup dialog box.
C hap ter
13
Customizing the Menu Bar Reflection allows you to customize its menu bar; you can add your own menus and menu commands or edit existing Reflection menus. Use the Reflection Menu Setup dialog box to: ·
Add your own custom menus to the menu bar, including support for keyboard shortcut key assignment, menu command separators, and status line help text.
·
Add commands to a menu.
·
Change the properties of menus and menu commands, for example, the menu or command name, status line help text, or action associated with a menu command.
·
Rearrange menus on the menu bar, or rearrange the commands that appear on the menus.
·
Delete selected menus from the menu bar or menu commands from a menu.
Note: Menu mapping is not available when Reflection is run from a browser. à After configuring the menu bar, you can save your changes to a menu map-only settings file that contains only the menu bar configuration. Other users can load this partial settings file and use the same customized menu bar when working in Reflection. To show or hide the Reflection menu bar: 1.
Right-click the Reflection title bar on the Reflection window.
2.
Click Hide Menu Bar to toggle the menu bar out of view, or click Show Menu Bar to display the menu bar.
95
Project Name • Chapter 13 • Customizing the Menu Bar • TEMPLATE: docs_v3 • D:\working\rwin\ug\online\MENUBAR.FM • 8.24.98 • 11:18am
96
Customizing the Menu Bar
Opening the Menu Setup Dialog Box To change the Reflection menus: ·
On the Setup menu, click Menu to open the Menu Setup dialog box.
To clarify the terminology of this interface: ·
A user-defined item is a command on a Reflection menu that you define.
·
A user-defined popup is a drop-down menu that you define containing one or more commands.
The Defined menu area on the left side of the Menu Setup dialog box represents your current menu bar configuration. You can customize either Reflection’s menu bar or right-click context menu—make your selection from the Defined menu list. On the right side of the dialog box, the Available options list contains default menu items available as predefined items for customizing the menu. These items allow you to create your own menu. You can also perform these tasks in the Menu Setup dialog box: ·
Reposition menus
·
Add a separator to divide commands on a menu
·
Change the keyboard shortcut (accelerator) associated with a menu or a menu command
·
Change the status line text that appears when a menu or menu command is highlighted
·
Remove menus
Customizing the Menu Bar
97
Adding a Menu to the Menu Bar You can add your own menu to Reflection’s menu bar. There are two ways you can configure menu behavior: ·
Configure a menu with multiple commands so that when you click on it, it drops down. Then, to this menu, you can add commands that execute actions (as described below). For example, if you have multiple login scripts, you can create a menu called “Login Scripts.” Click once on this menu to see all the commands you (or your system administrator) created for launching different connection macros, for example, commands named “UNIX Login” and “Email Login.”
·
Configure the menu with only one command so that when you click on it, it automatically performs an action. For example, create a menu called “Daily Login.” Click once on the menu to launch a Reflection login macro.
Adding a Menu Containing Two or More Commands to the Menu Bar A menu command can execute an action, such as sending a string of text, executing a Reflection macro or Reflection Basic script, or executing a Reflection terminal or menu command. If there is more than one command that you want to associate with a menu, you should create a drop-down menu. A drop-down menu contains menu commands arranged in a column. For an example of a typical drop-down menu, click any command on your default Reflection menu bar in the terminal window. To create a user-defined menu that will contain one or more commands: 1.
In the Defined menu list in the Menu Setup dialog box, decide where you want to position the menu on the current menu bar and highlight a menu name. For example, if you want the new menu to appear before or after the File menu, select File in the Defined menu list. Note: Do not double-click on a menu name to highlight it, since this causes the menu to expand and display its commands. If you do so, the remaining steps in this procedure will add the new command to the highlighted menu that you expanded (instead of adding the command directly to the menu bar). à
2.
In the Available options list, select User defined popup.
98
Customizing the Menu Bar
3.
Click Add After or Add Before, depending on the relation of the new menu to the menu selected. Using the same example as in step 1, click Add Before if you want the new menu to appear before the File menu. This means your custom menu will appear to the left of the File menu on the actual menu bar.
4.
The Menu Popup Properties dialog box opens when you click Add After or Add Before. Use this dialog box to enter a name for the menu in the Name box, up to 30 characters long. If you want to add a keyboard shortcut key (accelerator), type an ampersand (&) before the character that will activate the command.
5.
Enter the status line help text, up to 150 characters, in the Description box. (If you leave this item blank, Reflection uses the descriptive name for the status line text.)
6.
Click OK.
Now that you’ve added the new drop-down menu, you need to populate it with commands. To add commands to a menu: 1.
In the Defined menu list, highlight the new menu you just added.
2.
In the Available options list, select User defined item.
3.
Click Add After. This opens the Menu Item Properties dialog box.
4.
Enter a name for the menu command, up to 30 characters, in the Name box. If you want to add a keyboard shortcut key (accelerator), type an ampersand (&) before the character that will activate the command.
5.
Enter the status line help text, up to 150 characters, in the Description box. (If you leave this item blank, Reflection uses the descriptive name for the status line text.) To prevent display of status line help, press the spacebar once.
Customizing the Menu Bar
6.
99
Associate the menu command with an action by selecting one of the following: ·
Send text to transmit text to the host. Use the Insert a special character list or the Insert special characters using the keyboard check box to enter the characters you want to transmit.
·
Macro to run a Visual Basic macro or Reflection Basic script. The dialog box will change according to what you select from the Type list. Provide either a Macro name (Visual Basic) or Script file name (Reflection Basic).
·
Commands to perform a terminal command (such as transmitting a host keystroke) or menu command (such as toggling the state of the k key), or to execute a Visual Basic command. If you chose Terminal Command or Menu Command, use the Categories and Commands boxes to complete your selection.
7.
Click OK to close the Menu Items Properties dialog box. You’ll see the new command in the Defined menu area under the new menu.
8.
You can continue to add new commands to this menu by repeating steps 3 through 7. The only variation is the keyboard shortcut key (accelerator), and where you want to place the new commands on the menu; highlight the appropriate location and use Add After or Add Before.
9.
As an option, you can add separators to group menu commands visually by function and define keyboard shortcut keys.
10. Click OK to update the menu bar with your changes.
100
Customizing the Menu Bar
Adding a Menu Containing One Command to the Menu Bar If you want the menu command to react when you click on it (this is analogous to creating a toolbar button; the menu does not drop down like typical Windows menus), then follow this procedure: 1.
In the Defined menu list, decide where you want to position the menu command on the current menu bar and highlight a menu name. For example, if you want the new menu command to appear before or after the File menu, select File in the Defined menu list. Note: Do not double-click on a menu name to highlight it, since this causes the menu to expand and display its commands. If you do so, the remaining steps in this procedure will add the new command to the highlighted menu that you expanded (instead of adding the command directly to the menu bar). à
2.
In the Available options list, select User defined item.
3.
Click Add After or Add Before, depending on the relation of the new menu to the menu selected. Using the same example as in step 1, click Add Before if you want the new menu to appear before the File menu. This means your custom menu command will appear to the left of the File menu on the actual menu bar.
4.
In the Menu Item Properties dialog box, enter a name for the menu command, up to 30 characters, in the Name box. If you want to add a keyboard shortcut key (accelerator), type an ampersand (&) before the character that will activate the command.
5.
Enter the status line help text, up to 150 characters, in the Description box. (If you leave this item blank, Reflection uses the descriptive name for the status line text.) To prevent display of status line help, press the spacebar once.
Customizing the Menu Bar 101
6.
Associate the menu command with an action by selecting one of the following: ·
Send text to transmit text to the host. Use the Insert a special character list or the Insert special characters using the keyboard check box to enter the characters you want to transmit.
·
Macro to run a Visual Basic macro or Reflection Basic script. The dialog box will change according to what you select from the Type list. Provide either a Macro name (Visual Basic) or Script file name (Reflection Basic).
·
Commands to perform a terminal command (such as transmitting a host keystroke) or menu command (such as toggling the state of the k key), or to execute a Visual Basic command. If you chose Terminal Command or Menu Command, use the Categories and Commands boxes to complete your selection.
7.
Click OK. You’ll see the new command in the Defined menu area.
8.
Click OK to update the menu bar with your changes.
Adding an Item to the Terminal Window Shortcut Menu When you right-click on the terminal window, this displays the shortcut menu. To add an item to this shortcut menu: 1.
In the Menu Setup dialog box, select Terminal window context menu from the Defined menu list. The left side of the dialog box changes to show the commands available on the current menu.
2.
Decide where you want the item to appear and highlight a shortcut menu name.
3.
In the Available options list, select User defined item. Note: If you want to create a cascading menu on the shortcut menu that contains its own subset of commands, select User defined popup instead. The steps are the same for creating new menus and then adding commands to them. à
4.
Click Add After. This opens the Menu Item Properties dialog box.
102
Customizing the Menu Bar
5.
Enter a name for the menu command, up to 30 characters, in the Name box. If you want to add a keyboard shortcut key (accelerator), type an ampersand (&) before the character that will activate the command.
6.
Enter the status line help text, up to 150 characters, in the Description box. (If you leave this item blank, Reflection uses the descriptive name for the status line text.) To prevent display of status line help, press the spacebar once.
7.
Associate the menu command with an action by selecting one of the following: ·
Send text to transmit text to the host. Use the Insert a special character list or the Insert special characters using the keyboard check box to enter the characters you want to transmit.
·
Macro to run a Visual Basic macro or Reflection Basic script. The dialog box will change according to what you select from the Type list. Provide either a Macro name (Visual Basic) or Script file name (Reflection Basic).
·
Commands to perform a terminal command (such as transmitting a host keystroke) or menu command (such as toggling the state of the k key), or to execute a Visual Basic command. If you chose Terminal Command or Menu Command, use the Categories and Commands boxes to complete your selection.
8.
Click OK. You’ll see the new item in the Defined menu area.
9.
Click OK to update the shortcut menu with your changes.
Changing Menu Pop-up or Item Properties You can access the properties of each defined menu and change its unique characteristics, including the menu title and description (status line help text). To edit menu pop-up or command properties: 1.
In the Defined menu list in the Menu Setup dialog box, navigate to the location of the menu you want to edit, then select it.
2.
Click the Properties button.
3.
Change the menu name and description.
Customizing the Menu Bar 103
4.
Click OK to save your changes and close the Menu Popup or Menu Item Properties dialog box.
5.
Click OK to update the menu bar with your changes.
Defining a Keyboard Shortcut Key for a Menu or Menu Item When creating a custom menu, you should also assign a keyboard shortcut key (accelerator) to the menu title or menu command title. All default menus and menu commands provide a keyboard shortcut key. You should make the keyboard shortcut keys you define unique on a menu. You can change the keyboard shortcut key for a defined menu or menu command by editing its properties, or assign one when you add user-defined pop-ups and user-defined commands. To define a keyboard shortcut key: 1.
Open the Menu Item Properties or Menu Popup Properties dialog box.
2.
Assign a name for the menu or menu command if you haven’t done so.
3.
In the Name box, type an ampersand (&) before the character you’ve designated as the keyboard shortcut key.
4.
Click OK to save your changes and close the Menu Item Properties or Menu Popup Properties dialog box.
5.
Click OK to update the menu bar with your changes.
To access the menu or menu command with the keyboard shortcut key, press a + key on the keyboard, where key is the underlined character.
104
Customizing the Menu Bar
Rearranging the Menu Bar One of the ways you can configure your Reflection menu bar is to rearrange menus on the menu bar or menu commands that appear on menus: 1.
2.
Move items in the Menu Setup dialog box to achieve your custom design: ·
To move an entire menu (including its associated menu commands), select it in the Defined menu list, then click the Up or Down button.
·
To move a menu command, expand the associated menu tree by clicking the plus sign, select the menu command, then click the Up or Down button.
Every time you click the Up or Down button, the menu or menu command will move up or down by one in the tree.
Restoring a Default Menu or Menu Item If you only want to restore a single default menu or menu command, use this procedure instead of using the Defaults button, which restores the factory-installed menu bar configuration: 1.
In the Available options list, select the default menu or menu command that you deleted or changed. For example, if you deleted the Help menu from the Defined menu list, select Help in the Available options list.
2.
In the Defined menu list, determine where you want to add the menu or menu command and navigate to this location. For instance, assume you want to add Help back to its default location (after the Window menu). In the Defined menu list, you would select Window, then click Add After to insert the Help menu after the Window menu.
3.
Click OK to update the menu bar with your changes.
Customizing the Menu Bar 105
Restoring Version 6.x or 5.x Menu Items If you want to restore menus and menu commands that have been removed from version 7.0 of Reflection, you can use the Additional items option in the Available options list. When you expand the Additional items option, you will find: ·
Items from version 6.x: Includes the Script menu and its commands, replaced by the Macro menu in version 7.0 of Reflection.
·
Items from version 5.x: Includes the Connection menu, including the Connection Directory and the Phone Directory commands, as well as the DDE menu and its associated commands.
Use the example shown next to restore a menu from an earlier version of Reflection to the menu bar.
Example: Restoring the Script Menu This example restores the Script menu to a position directly to the right of the Macro menu: 1.
On the Setup menu, click Menu to open the Menu Setup dialog box.
2.
Click Macro under Defined menu to select this item.
3.
In the Available options box, open Additional items, open Items from version 6.x, then select Script.
4.
Click Add After. This adds the Script menu to the right of the Macro menu.
5.
Click OK to close the dialog box.
6.
On the File menu, click Save to save this change.
106
Customizing the Menu Bar
Guidelines for Adding and Editing Menus and Menu Items ·
Design your menu carefully. By default, Reflection provides a menu bar that meets Windows standards for ease of use and compatibility with other Windows applications. When designing a custom menu for other users, keep these concepts in mind when creating a custom menu, changing default menus, and rearranging commands on the menu bar. Use Reflection and other Windows applications as examples.
·
Manage the number of menus you add to the menu bar. The maximum number of menus you can add to the menu bar is 32. To a menu, you can add up to 32 menu commands. The Reflection menu bar supports a combination of up to 256 menus and menu commands.
·
Test your menu before distributing it as a menu map-only settings file to other users. Ensure you can execute the commands on the menu.
·
Add separators to drop-down menus where appropriate. Separators visually group similar menu commands for users.
·
Define a keyboard shortcut key for menus and associated command so you can use the keyboard as well as the mouse to access a drop-down menu or execute a command, terminal key, or script associated with a menu command.
C hap ter
14
Working with the Toolbar A toolbar is a panel of buttons you can configure to simplify tasks in Reflection. Reflection supports multiple toolbars, allowing you to open a toolbar or toolbars other than the default Standard toolbar.
The Reflection Predefined Toolbars Reflection comes with four predefined toolbars: ·
Standard: execute Reflection commands, such as Print, Connect, or Run Macro.
·
File Transfer: open file transfer-related dialog boxes.
·
Visual Basic: create, change, or execute a Visual Basic macro.
·
Setup: customize the terminal, toolbar, display, events, keyboard map, file transfer, and print characteristics of Reflection.
The Standard toolbar is the only toolbar displayed by default. To show or hide any custom or predefined toolbars, right-click on Reflection’s terminal window, point to Toolbars, then click a toolbar name to show or hide it.
107
Project Name • Chapter 14 • Working with the Toolbar • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\TOOLBAR.FM • 8.24.98 • 11:18am
108
Working with the Toolbar
The Reflection Toolbar Tabs To open the Toolbar Setup dialog box, click Toolbar on the Setup menu:
The Toolbar Setup dialog box has four tabs: Toolbars, Predefined buttons, Customize, and Settings.
Toolbars Tabs Use this tab to display a predefined or custom toolbar; create, rename, or remove a toolbar; or reset a predefined toolbar to Reflection’s factory defaults. To view or customize a toolbar, it must be selected in the Toolbar list.
Working with the Toolbar
109
Predefined Buttons Tab Use this tab to add a predefined button to a toolbar. All of Reflection’s menu and terminal commands exist as toolbar buttons. To move a predefined button to a displayed toolbar, click and drag the button to the toolbar.
Customize Tab Use this tab to create a custom button that will perform a Reflection task (click New Button to view all of the available options). The task can be, for example, running a macro or sending text to a host. For more information about creating custom buttons, see page 111.
Settings Tab Use this tab to change how the toolbar looks, where it is positioned, or to save or open a toolbar partial settings file. With the options under Location, you can attach the toolbar along any of the terminal window’s margins (just as you can by moving it with the mouse). Selecting Floating lets the toolbar move or remain motionless relative to the Reflection terminal window. When a toolbar is floating, the upper-right corner of the toolbar shows an icon that, when clicked, alternately looks like either a boat anchor or a four-way arrow. When the toolbar is anchored to the desktop, the anchor icon is displayed. It does not move with Reflection’s terminal window. When the toolbar is not anchored, the four-way arrow icon is displayed. The toolbar moves when you move the Reflection terminal window.
110
Working with the Toolbar
Working with the Toolbar This section describes procedures for working with the toolbar. The online help, however, is the most complete source of information.
Displaying and Hiding the Toolbar When you first start Reflection, the Standard toolbar is displayed. However, this or any toolbar can be either visible or hidden. To show or hide a toolbar, you can: ·
Right-click Reflection’s terminal window, point to Toolbars, and select the toolbar you want to hide or show.
·
Click Toolbar on the Setup menu and, on the Toolbars tab, select a toolbar.
·
Hide a displayed toolbar by right-clicking on it, then clicking Hide.
Layering Toolbars Reflection allows you to layer multiple toolbars in a single row, thus freeing up screen space while still providing easy access to your toolbars. To layer two or more toolbars, one on top of the other: 1.
Position your cursor over the “grab handles” on one of the toolbars you want to layer. The cursor becomes a two-headed arrow.
2.
Press your left mouse button down and slide the toolbar to the left. Then release it to place the toolbar over the adjacent one:
The toolbars are now layered, one on top of the other:
Working with the Toolbar
111
Adding a New Button to the Toolbar When you create a new toolbar button, it’s added to the toolbar that’s selected on the Toolbar list on the Toolbars tab. To create a new toolbar button: 1.
Click the Customize tab in the Toolbar Setup dialog box.
2.
Click New Button; the options on the Customize tab become available (that is, they are no longer dimmed). A blank button with a picture frame around it appears as the far right button on the toolbar after clicking New Button.
3.
Associate the button with an action by selecting one of the following: ·
Send text to transmit text to the host. Use the Insert a special character list or the Insert special characters using the keyboard check box to enter the characters you want to transmit.
·
Macro to run a Visual Basic macro, or Reflection Basic or RCL script. The dialog box will change according to what you select from the Type list. Provide either a Macro name (Visual Basic) or Script file name (Reflection Basic or RCL).
·
Commands to perform a terminal command (such as transmitting a host keystroke) or menu command (such as toggling the state of the k key), or to execute a Visual Basic or RCL command. If you chose Terminal Command or Menu Command, use the Categories and Commands boxes to complete your selection.
For more information, see Mapping in the online help. 4.
If you want a picture to appear on the button, select one from the Pictures box.
5.
Enter any text you want to appear on the button in the Label text box (as you type, the text appears in the toolbar button).
6.
Any text you enter for the ToolTip text appears beneath the button when the mouse is positioned over the button.
7.
Text you enter for the Help text appears in Reflection’s status bar when the mouse is positioned over the button.
8.
When you are through creating a button, click Close to add the button and close the Toolbar Setup dialog box.
112
Working with the Toolbar
Adding a Predefined Button to the Toolbar To add a predefined button to the toolbar: 1.
Click the Predefined Buttons tab in the Toolbar Setup dialog box.
2.
Click the button in the Functions area and drag it to the desired position on the toolbar. To see what function a button performs, highlight it on this tab and read the text in the Description box. The predefined buttons you see change depending on the category selected. All shows all predefined buttons—use the horizontal scroll bar to view them all.
Copying a Toolbar Button To copy a button that is already on the toolbar: ·
With the Toolbar Setup dialog box open, hold down the c key, and drag the button to the desired location.
Rearranging Buttons on a Toolbar To change a button’s position on the toolbar: ·
With the Toolbar Setup dialog box open, click and drag the button you want to move to its new location on the toolbar, then release the mouse button.
Changing the Spacing Between Buttons on a Toolbar You can add or remove a space (called a separator) between buttons. This is done by dragging the button to the right of the separator. With the Toolbar Setup dialog box open: ·
To add a separator, drag a button toward the button on its right (this creates a separator between the selected button and the button on its left).
·
To remove a separator, drag a button over the separator to its left.
Working with the Toolbar
113
Removing a Button from the Toolbar To remove a button from the toolbar: 1.
With the Toolbar Setup dialog box open, click and drag the button you want to delete anywhere off the toolbar (for example, you can drag it over to the Toolbar Setup dialog box), then release the mouse button.
2.
Reflection prompts you for confirmation. Click Yes. Buttons to the right of the deleted button will shift over to fill the space.
Tip: You can also remove a toolbar button by right-clicking the button and choosing Remove button on the shortcut menu. à
Adding Pictures to Toolbar Setup Reflection comes with an extensive library of toolbar button pictures. If you have your own pictures you want to place on a button, you can add them to the available library of pictures shown on the Customize tab in the Toolbar Setup dialog box. Use a bitmap editor (such as Microsoft Paint) to create your own pictures. Small button pictures can be up to 19 pixels wide by 17 pixels high, and large buttons can be up to 27 wide by 25 high. The files should be in 16- or 256-color format with a bitmap (.bmp) file extension. To add pictures to the Toolbar Setup dialog box: 1.
Click the Customize tab in the Toolbar Setup dialog box, then click Add Pictures.
2.
In the Browse for Pictures dialog box, go to the folder where your custom pictures are located.
3.
Select a Picture size: ·
Small pictures shows the pictures that are displayed on the toolbar by default.
·
Large pictures shows the pictures that are displayed when you select the Large buttons check box (on the Settings tab).
·
Show all pictures shows both large and small pictures, as well as bitmaps as big as 32 pixels by 32 pixels (icon-sized).
114
Working with the Toolbar
4.
You can add one picture at a time, or add all pictures in the current directory at once. To add one picture, click the picture with the mouse, then click Add One Picture. To add all pictures, click the Add All Pictures button. The pictures you are adding are moved from the Pictures box to the Customize tab—you are not deleting the picture’s actual .bmp file when this happens.
5.
Click OK to return to the Toolbar Setup dialog box.
Related Online Help Topics Search under Toolbar in the Reflection online help for information on these topics: ·
How to create a toolbar partial settings file.
·
Steps for customizing toolbars.
·
Using the troubleshooting toolbar.
C hap ter
15
Customizing the Keyboard Reflection allows you to associate keystrokes with actions. This process is known as keyboard mapping. Because Reflection uses a dialog box with drag-and-drop capability for keyboard mapping, you must use a mouse to map keystrokes.
Opening the Keyboard Map Setup Dialog Box The Keyboard Map Setup dialog box is where you map PC keystrokes to commands, or where you can look to see how your keyboard is currently mapped. To open the Keyboard Map Setup dialog box, click Keyboard Map on the Setup menu. You can change the PC or terminal keyboard shown in this dialog box by clicking the Keyboards button, explained on page 118. Different colors are used for different purposes in the Keyboard Map Setup dialog box. Initially, all keys are either light gray, teal, or dimmed: ·
Gray keys are not currently mapped.
·
Teal keys are currently mapped but their mappings can be changed.
·
Keys that fade out, or dim, when you choose a, c, or s are currently mapped (in combination with the selected modifier key) and this mapping cannot be changed.
·
If you want to see how a key on the PC is currently mapped, click the key to select it (now it is dark gray). If this PC key is mapped to a terminal key, a key on the terminal keyboard, below, turns dark gray at the same time. Some keys are mapped not to terminal keys but to Reflection commands.
115
Project Name • Chapter 15 • Customizing the Keyboard • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\KEYGUI.FM • 8.24.98 • 11:18am
116
Customizing the Keyboard
Mapping a Keystroke There are three things you need to do to map a keystroke: select a keystroke, choose an action, and then click Map to link the keystroke to the action:
Selecting a Keystroke To select a keystroke follow these steps: 1.
Click any modifier keys (a, c, or s) that you want to use in the keystroke. This step is optional: you can create keystrokes with no modifier keys (such as Ï), with a single modifier key, or with multiple modifiers (such as s+c+Ï).
2.
Select a primary key from the PC keyboard. This can be any key except those that are reserved, or dimmed (which indicates that they cannot be mapped).
Choosing an Action Associate the keystroke with an action by selecting one of the following: ·
Terminal keyboard to perform a terminal keystroke action. Click a terminal keyboard key in the lower part of the Keyboard Map Setup dialog box.
Customizing the Keyboard
117
·
Send text to transmit text to the host. Use the Insert a special character list or the Insert special characters using the keyboard check box to enter the characters you want to transmit.
·
Macro to run a Visual Basic macro, or Reflection Basic or RCL script. The dialog box will change according to what you select from the Type list. Provide either a Macro name (Visual Basic) or Script file name (Reflection Basic or RCL).
·
Commands to perform a terminal command (such as transmitting a host keystroke) or menu command (such as toggling the state of the k key), or to execute a Visual Basic or RCL command. If you chose Terminal Command or Menu Command, use the Categories and Commands boxes to complete your selection.
Tip: If you map one of the commands shown on a Reflection menu (for example, the Copy command on the Edit menu), the new keystroke that you assign is displayed on the menu. à These options are not mutually exclusive. You can build the Command string to include functions, macros, and multiple commands. See Mapping, to multiple actions the online help for more information. For general information about mapping, see Mapping, actions.
Linking a Keystroke to an Action Once you’ve identified a PC keystroke and an action to map it to, click the Map button.
Removing a Mapping If a PC keystroke is currently mapped and you want to clear the mapping (so that pressing the keystroke has no effect in Reflection), select the keystroke on the PC keyboard in the Keyboard Map Setup dialog box, then click Remove.
Restoring the Default Keyboard Mapping To restore a single keystroke to its default definition, select it, then click Default (the button to the right of the Remove button). To restore the entire default keyboard map—that is, to remove all customization of the keyboard map—click Defaults (the button beneath the Cancel button).
118
Customizing the Keyboard
Drag-and-Drop Options Once you know your way around the Keyboard Map Setup dialog box, you can use the following drag-and-drop options: ·
Select a PC keystroke and then, holding the left mouse button down, drag it down to the terminal keyboard. If the keystroke you are dragging is currently mapped, the mouse cursor becomes a small green rectangle; if the keystroke is not mapped, the cursor is a small gray rectangle. When you remap a keystroke that is already mapped, the prior mapping is lost when you map the new keystroke. When you move the rectangle over a key on the terminal keyboard, a black outline appears around this key, indicating correct positioning over the key. The rectangular mouse cursor either retains its form, indicating that you can map to this terminal key, or turns into a red circle with a line through it, indicating that you cannot map to this terminal key.
·
The same process works in reverse. Select a terminal keystroke and then drag it up to the PC keyboard.
·
To remove a key mapping, drag the key off the Keyboard Map Setup dialog box (or drag it over the Remove button until the rectangle is replaced with a garbage can).
Changing Your PC or Host Keyboard You can pick from several different PC and terminal keyboards by clicking the Keyboards button in the Keyboard Map Setup dialog box. The keyboards you select are then used in the Keyboard Map Setup dialog box. Changing the terminal keyboard here also changes the one you see when you right-click on the terminal window and select Terminal Keyboard (see page 125). Note: You can only select a keyboard for the terminal you are emulating. For example, if you’re emulating a VT terminal you’ll only see VT keyboard selections. The only exceptions are DG and ADDS emulation, which display VT keyboards (since there is no such thing as a DG or ADDSspecific keyboard). à If your foreign keyboard is not listed under the PC list, use one of the Current options as the keyboard choice (for example, scroll up through the list and select Current 101 Key Layout). The Current options cause Reflection to query Windows for the keyboard layout and create a representation of the foreign keyboard.
Customizing the Keyboard
Related Online Help Topics See the Reflection online help for information on these topics: ·
Finding the current mapping of a keystroke.
·
Creating a keyboard partial settings file.
·
Disabling a keystroke.
119
C hap ter
16
Mouse Mapping With Reflection, you can associate mouse chords (explained below) with Reflection actions, a process known as mouse mapping. This feature extends to both two- and three-button mouse devices, and includes limited support for Microsoft IntelliMouse. Use the Mouse Map Setup dialog box to map mouse chords to actions, or to find out what action your mouse is currently mapped to: a text string, a macro, or a terminal or menu command. There are 32 mouse chords that can be defined for a two-button mouse, and 48 for a threebutton mouse. You can save your mouse mapping to a settings file with other configuration information, or save only the mouse and keyboard mapping as a partial settings file with the extension .rkm.
Mouse Chords A mouse chord is defined by three factors: ·
Which button? A mouse can have one, two, or three buttons.
·
How many clicks? There are single-clicks and double-clicks.
·
Do you want modifier keys?
You can hold down the a, c, or s key, or any combination of these keys, as you click the mouse. So a mouse chord can be as simple as a single-click with the left button or as complicated as holding down s+a+c as you double-click the center button on a three-button mouse.
121
Project Name • Chapter 16 • Mouse Mapping • TEMPLATE: docs_v3 • D:\working\rwin\ug\online\MOUSE.FM • 8.24.98 • 11:18am
122
Mouse Mapping
Mapping a Mouse Chord There are two things you need to do in the Mouse Map Setup dialog box to map a mouse chord: ·
Identify a mouse chord, explained next.
·
Identify an action, explained on page 123.
Once you’ve selected a chord and a corresponding action, click Map; the mapping is established. You can continue to map different chords, or click OK to close the Mouse Map Setup dialog box. You can save mouse mapping information to a settings file with other configuration information, or save just mouse mapping information (as a mouse map-only settings file using the extension .rkm).
Identifying a Mouse Chord To identify a mouse chord, follow these steps: 1.
On the Setup menu, click Mouse Map.
2.
In the Mouse Map Setup dialog box, click any modifier keys that you want to include in the chord. The choices are a, c, or s, or any combination of these three.
3.
Select the Double click check box to define a double-click chord, or clear this check box to define a single-click chord.
4.
Select the Show 3 buttons check box if you have a three-button mouse.
5.
Click any combination of the left, right, and center (if a three-button mouse) buttons in the mouse image on the screen.
The next step is to identify an action to execute for the chord you just selected.
Mouse Mapping
123
Identifying an Action With the mouse chord defined, you can now identify an action to execute using options in the Action group box: 1.
On the Setup menu, click Mouse Map.
2.
In the Mouse Map Setup dialog box, associate the mouse chord with an action in the Action group box by selecting one of the following: ·
Send text to transmit text to the host. Use the Insert a special character list or the Insert special characters using the keyboard check box to enter the characters you want to transmit.
·
Macro to run a Visual Basic macro or Reflection Basic script. The dialog box will change according to what you select from the Type list. Provide either a Macro name (Visual Basic) or Script file name (Reflection Basic).
·
Commands to perform a terminal command (such as transmitting a host keystroke) or menu command (such as toggling the state of the k key), or to execute a Visual Basic command. If you chose Terminal Command or Menu Command, use the Categories and Commands boxes to complete your selection.
Mapping a Mouse Chord to Multiple Commands By separating menu or terminal commands with a single space in the Command box, Reflection will execute multiple commands in turn whenever you click the assigned mouse chord (click the Commands option to see this). For example, with the Command type list set to Menu Command, you can map a mouse chord to copy all of display memory by entering this text in the box: EditSelectAll EditCopy
124
Mouse Mapping
Disabling a Mouse Chord In Reflection, you can disable a mouse chord by either mapping it to the value Nothing, or by clicking the Remove button to clear the current mapping. To disable a mouse chord: 1.
On the Setup menu, click Mouse Map.
2.
Identify the mouse chord that you want to disable; the associated action in the Action group box is automatically displayed.
3.
Disable the mouse chord by: ·
Clicking Remove; the mouse chord is cleared of its mapping and can now be reassigned.
·
Typing Nothing in the Command box and clicking Map; the mouse chord is now mapped to this “command,” effectively disabling it.
Now, when this mouse chord is used, it has no effect.
C hap ter
17
Using the Graphical Terminal Keyboard When a host prompts you to press a key you can’t find or don’t recognize on your PC keyboard, you can use Reflection’s graphical terminal keyboard to send the keystroke. Tip: You need a mouse to use the graphical terminal keyboard. à
Displaying the Terminal Keyboard The graphical terminal keyboard can be either visible or hidden. Click the right mouse button in the terminal window and click Terminal Keyboard on the shortcut menu to display or hide the terminal keyboard. With the terminal keyboard visible, click a key once to see the key’s function in the status bar in the lower-left corner. The lower-right corner shows the keyboard type, which you can change in the Keyboard Setup dialog box (see page 118). You can still choose Reflection menu commands while the graphical terminal keyboard is open. The type, size, and location of the terminal keyboard is saved whenever you save your settings file.
When to Use the Terminal Keyboard It isn’t necessary to use the terminal keyboard exclusively—everything you can do on the terminal keyboard can be done on the PC keyboard. Reflection includes the graphical keyboard to ease the transition from a real terminal keyboard to the more commonly used PC keyboard. In addition, the graphical terminal keyboard also provides useful information about how the keys on your PC keyboard “map,” or relate to, the keys on a terminal keyboard.
125
Project Name • Chapter 17 • Using the Graphical Terminal Keyboard • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\TERMKEY.FM • 8.24.98 • 11:18am
126
Using the Graphical Terminal Keyboard
Moving and Attaching the Terminal Keyboard Initially the terminal keyboard is free floating. But, like the toolbar, it can be “attached” to one of the margins of the terminal window: 1.
Click the terminal keyboard with the left mouse button and then move it up toward the top of the terminal window. Some of the keys disappear from the keyboard (like the alphabet A through Z keys). The form the keyboard takes when attached to the top or bottom of the terminal window matches one of the four shapes it can take when it is free floating.
2.
You can attach the terminal keyboard to the top, bottom, or either side margin. Try dragging it over to the right side of the terminal window. When you reach the right margin, the shape of the outline changes to show the position of the keyboard as it would look if it were attached to the right margin. Release the mouse button to move the terminal keyboard. The form it takes when attached to the left or right margin of the terminal window matches one of the four shapes it can have when it is free floating.
3.
If you change your mind, move the outline back to the position of the current terminal keyboard before releasing the button. Once the keyboard has been attached to the terminal window, double-clicking the keyboard restores it to the last floating position (and vice versa—when the keyboard is not attached, double-clicking moves it back to the last attached window position).
Attaching the Terminal Keyboard This information is relevant only if the terminal keyboard is not attached to one of the margins of the terminal window. With the terminal keyboard detached from the margin of the terminal window, it moves with Reflection’s terminal window. However, you can attach the terminal keyboard to your PC’s screen by clicking the four-way arrow icon in the upper-right corner of the terminal keyboard. The terminal keyboard now shows the boat anchor icon and remains stationary whenever you move Reflection’s terminal window.
Using the Graphical Terminal Keyboard
127
Changing the Terminal Keyboard’s Appearance You can change how much of the terminal keyboard you want to show and you can change its size. Note: This information is relevant only if the terminal keyboard is not attached to one of the margins of the terminal window. à
Choosing How Much of the Keyboard to Show Reflection lets you display the terminal keyboard in any of four variations. If you use the left mouse button to click the down-arrow icon in the upper-right corner (the icon in the middle), the terminal keyboard changes to a different version; the letter and number keys have been eliminated, leaving only the keys that have a special meaning on a terminal keyboard. Keep clicking the down-arrow with the left mouse button to see all variations of the keyboard.
Resizing the Terminal Keyboard You can change the size of the terminal keyboard. To resize the terminal keyboard, move the mouse cursor to one of its corners until it turns into a two-way arrow. Then press the left button and move the cursor. Release the mouse button to resize the terminal keyboard. You can also resize the terminal keyboard by clicking the up-arrow or down-arrow icon in the upper-right corner with the right mouse button. Use these icons to toggle through a set of four predefined keyboard sizes. Double-clicking with the right mouse button on the title bar resets the default terminal keyboard size.
C hap ter
18
Configuring Hotspots Hotspots are buttons that appear over text in terminal sessions. Typically, clicking a hotspot transmits a terminal key or command to the host. As you work with host data in Reflection’s terminal window, anything that’s displayed in button format (that is, anything that looks like a button you can click) is a hotspot. Clicking Hotspot on the Setup menu displays the Hotspot Setup dialog box. From there, use the Defined Hotspots tab to define hotspots and the actions associated with them. To trigger a hotspot, click it with the left mouse button. Clicking hotspots allows you to issue commands with the mouse instead of the keyboard. Note: If you want to create hotspots by selecting text in the terminal window and you’re running Reflection from a container such as a browser, you must select the text before you open the Hotspot Setup dialog box. à
Enabling and Showing Hotspots Hotspots are only available when they are enabled. To enable hotspots: 1.
On the Setup menu, click Hotspot, then click the Settings tab.
2.
Select the Enable hotspots check box and click OK.
By default, the Enable hotspots check box is cleared; you must select it for hotspots to be activated. When this check box is cleared, you can still define and maintain your hotspot configuration, but hotspots won’t work or display on your screen. Hotspots are only visible when the Show hotspots check box is selected (this check box dims and is cleared when the Enable hotspots check box is cleared). You can still recognize and use hotspots when they’re not displayed: the cursor changes from an I-beam to an arrow when it’s over a hotspot. You can then click the mouse to invoke the hotspot. By default, the Show hotspots check box is selected when hotspots are enabled.
129
Project Name • Chapter 18 • Configuring Hotspots • TEMPLATE: docs_v3 • D:\working\rwin\ug\online\HOTSPOT.FM • 8.24.98 • 11:18am
130
Configuring Hotspots
Defining Hotspots To define a hotspot: 1.
On the Setup menu, click Hotspot, then click the Defined Hotspots tab.
2.
Click New to open the New Hotspot Properties dialog box:
3.
Type a text string, up to 80 characters, in the Hotspot text box to identify the hotspot. Reflection creates a hotspot wherever this text string is encountered in your host application.
4.
In the Help text box, enter the text that appears in the status bar.
5.
Select the Match case check box if you want the hotspot to be case sensitive. For example, if you define the hotspot “Login” and select the Match case check box, then “login” would not be a hotspot.
6.
Select the Match whole word only check box if you want to separate the hotspot from any surrounding text (the whole word is delimited by any non-alphanumeric character or spaces). For example, if you define the hotspot “host” and select the Match whole word only check box, then spaces are required on the front and back of the word “host.” Then the words “hostfile” and “unixhost” wouldn’t be hotspots, but “\host:” would be a hotspot.
7.
Select the Match until white space check box to define the end of a hotspot as the white space created by pressing the f key. This allows you to define hotspots that start with a common string, but vary. An example of this is the default hotspot for http:, which launches your browser and locates the web site indicated.
8.
To make the hotspot specific to a screen column, select the At position option and enter a column number.
Configuring Hotspots
9.
131
Associate the hotspot with an action by selecting one of the following: ·
Send text to transmit text to the host. Use the Insert a special character list or the Insert special characters using the keyboard check box to enter the characters you want to transmit.
·
Macro to run a Visual Basic macro or Reflection Basic script. The dialog box will change according to what you select from the Type list. Provide either a Macro name (Visual Basic) or Script file name (Reflection Basic).
·
Commands to perform a terminal command (such as transmitting a host keystroke) or menu command (such as toggling the state of the k key), or to execute a Visual Basic command. If you chose Terminal Command or Menu Command, use the Categories and Commands boxes to complete your selection.
For more information, see Mapping in the online help. Hotspot information is saved with all other configuration information to a settings file when you save the session with the Save command on the File menu. You can also save just hotspot configuration information in a partial settings file with the extension .rhs, making it possible to create a hotspot and import it into other sessions. See Hotspots, creating a partial settings file in the online help for more information.
132
Configuring Hotspots
Changing the Hotspot Mouse Click By default, the mouse chord to trigger a hotspot is a single click of the left mouse button. To change this: 1.
Click the Settings tab in the Hotspot Setup dialog box. This is where you configure the mouse chord to trigger the hotspot. By default, a single click of the left mouse button triggers a hotspot.
2.
To identify a mouse chord, follow these steps: ·
Select the Double click check box to define a double-click chord, or clear this check box to define a single-click chord.
·
Select the Show 3 buttons check box if you have a three-button mouse.
Related Online Help Topics Search under Hotspots in the Reflection online help for information on these topics: ·
Using defined hotspots.
·
Frequently asked questions.
·
Removing hotspots.
C hap ter
19
Transferring Files With Reflection, you can transfer any type of file to and from a host computer. The host computer can be an HP 3000 (including Classic, MPE/iX, and POSIX), OpenVMS (including Digital VAX and Alpha computers), ULTRIX, Unisys, or UNIX system, or any host or electronic service that supports FTP (File Transfer Protocol) or the Zmodem, Xmodem, or Kermit protocols. This chapter discusses: ·
file transfer protocols you can use with Reflection
·
how to prepare for a file transfer
·
how to transfer a file
File Transfer Protocols A file transfer protocol is a set of rules that two computers follow when transferring files. Reflection has five file transfer protocols to choose from: the public domain protocols FTP, Kermit, Xmodem, and Zmodem, and Reflection’s own proprietary protocol: WRQ/Reflection.
FTP If you’re transferring files with FTP, you can use either the Reflection FTP Client, an application that ships with WRQ products, or the file transfer program that’s part of the Reflection emulators.
133
Project Name • Chapter 19 • Transferring Files • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\FILEXFER.FM • 8.24.98 • 11:18am
134
Transferring Files
Reflection FTP Client Use the Reflection FTP Client if you only transfer files with FTP and do not need a terminal emulator. The FTP Client provides secure, encrypted FTP sessions when it’s used with a Kerberized server and Reflection Signature version 7.0, a security product from WRQ (for more information about Reflection Signature, contact WRQ). To start the FTP Client, click your Windows Start menu, point to Programs, then point to your Reflection folder and click FTP Client. For information on how to use the FTP Client, see its online help (Rftpc.hlp).
FTP and Reflection’s File Transfer Program Reflection’s file transfer program provides two different implementations of FTP: WRQ’s FTP and Microsoft’s FTP. Both FTP implementations are fully integrated with Reflection. Microsoft’s FTP supports file transfers to UNIX hosts; WRQ’s FTP supports file transfers to HP 3000, OpenVMS, UNIX, and Unisys hosts. Like the Reflection FTP Client, WRQ’s FTP has the added benefit of providing secure, encrypted FTP sessions when it’s used with a Kerberized server and Reflection Signature version 7.0.
Kermit, Xmodem, and Zmodem Kermit, Xmodem, and Zmodem are public domain file transfer protocols often used to retrieve files from bulletin board systems. Before transferring a file using a public domain protocol, you must start the remote side of the transfer manually if any of the following apply: ·
You are transferring the file using Xmodem.
·
You are transferring the file using Kermit, and Kermit is not in server mode.
·
You are transferring the file using Zmodem and you’ve cleared the Allow automatic downloading check box on the Zmodem tab in the File Transfer Setup dialog box (this is not the default state of the check box).
For more information on using the above protocols, search under Kermit, Xmodem, or Zmodem in the online help.
Transferring Files
135
WRQ/Reflection WRQ/Reflection is WRQ’s proprietary protocol. It is selected by default for file transfers and is recommended over the public domain protocols. With the WRQ/Reflection protocol you can: ·
Make fast file transfers over Ethernet connections. There are no additional options to set to perform fast file transfers; if the WRQ/Reflection protocol detects the appropriate hardware, fast file transfers occur automatically. Note: Fast file transfer is not available to UNIX hosts. à
·
Use “filters” for transferring files selectively based on their creation date and time.
·
Specify attributes and protection codes that files should have when received on the host. These codes can be stored with the file when it resides on your PC, and can later be used to create an exact copy of the original file on the host.
·
Transfer files over network or serial connections.
WRQ/Reflection requires that a host version of the file transfer program be installed. See “Host File Transfer Program” below for more information.
Preparing to Transfer Files While Reflection’s default settings are appropriate for most file transfers, you may need to take some additional steps before you transfer files, such as: confirming that the host file transfer program has been uploaded, choosing a preset configuration for your file transfer, and selecting the correct file transfer type.
Host File Transfer Program Before you can transfer files between your PC and a host system, a host version of the file transfer program must be available to work with Reflection. For transfers with the WRQ/Reflection protocol, host programs for transferring files to MPE, OpenVMS, and UNIX systems are provided. See Checking the host program’s version number and Uploading the host program in the system administrator online help for more information. For transfers with a public domain protocol, check with your system administrator to ensure that the correct host file transfer program has been uploaded.
136
Transferring Files
Preset Configurations Reflection supplies a collection of configuration settings for transferring files to different hosts in a variety of situations, saving you the trouble of having to know what values to set. 1.
If the File Transfer dialog box is already open, click Setup. Otherwise, click File Transfer on the Setup menu to open the File Transfer Setup dialog box.
2.
On the Protocol tab, select your file transfer protocol. The list of preset configurations changes depending on the protocol selected.
3.
After choosing a preset configuration name, click OK. If transfers work successfully, click Save on the File menu to save your settings file so the configuration will be available the next time you want to perform the same type of transfer.
File Transfer Types File transfer types help you transfer files in the most appropriate way. The Transfer types list box is available either in the File Transfer dialog box or on your protocol’s tab in the File Transfer Setup dialog box (click File Transfer on the Setup menu). There are five Transfer types: ASCII, Binary, Labels (Reflection for HP with NS/VT only), Image (VT emulation only), and Auto-Detect. Select a transfer type based on the kind of file you are transferring: Use this method...
When transferring files between...
ASCII
A PC and a host or between a PC and a Macintosh (text-only) via a host.
Binary
Two PCs via a host (preserves PC-specific information); use this method for transferring formatted files—this includes sharing files, such as Microsoft Word document files, between a PC and a Macintosh.
Labels
Two host computers via a PC (preserves HP-specific label information). This option is also used to transfer KSAM/XL (Sequential Access Method for XL machines) files.
Image
Two host computers via a PC (this transfer type should only be used when you need to preserve host attribute information).
Auto-Detect
Two computers and you want Reflection to automatically determine the file type and choose the transfer method for you.
Transferring Files
137
Transferring Files The following steps describe how to transfer a file to a VMS host using the WRQ/Reflection protocol: 1.
Start Reflection and log in to the host computer. Be sure to log in with the rights that allow you to read, write, and save files.
2.
Click Transfer on the File menu to open the File Transfer dialog box:
3.
This dialog box supports the drag-and-drop method of transferring files. Select one or more files from either the PC or host side (click Show Host Files to display a list of the files in the current directory on the host). Or you can type the name of the file to be transferred in the Local file names or Host file names text box.
4.
Drag a group of highlighted files over to the opposite half of the dialog box, or click the Transfer button.
138
Transferring Files
Tip: You can also transfer files by dragging them from Windows Explorer to the File Transfer dialog box. This procedure is explained in the online help; search for Drag and drop, file transfer. à Reflection begins the file transfer. You can monitor its progress using the File Transfer in Progress window. When the transfer is completed, you are returned to the File Transfer dialog box. If you receive an error message when you try to perform a transfer, you may need to change one (or more) of your file transfer settings. Before changing settings individually, try using one of the preset configurations explained on page 136.
Show Host Files The Show Host Files button only appears in the File Transfer dialog box when WRQ/Reflection or FTP is selected in the Protocol box. Before receiving files from the host using WRQ/Reflection, click Show Host Files in the File Transfer dialog box. This updates and displays the current list of files in the host directory; the host side of the dialog box then looks similar to the local file side:
Transferring Files
When the host directory information is added, the Show Host Files button changes to read Refresh Host Files. Tip: To automatically update the host file list after WRQ/Reflection or FTP file transfers, select the Auto refresh host directory check box on the General tab in the File Transfer Setup dialog box. à
Related Online Help Topics See the Reflection online help for information on these topics: ·
Transferring files using public domain protocols (Kermit, FTP, Xmodem, and Zmodem).
·
Advantages of the WRQ/Reflection protocol.
·
Support for long file names.
139
S E CT ION
Using Reflection’s Advanced Features
4
C hap ter
20
Advanced Host Connection Options The procedure on page 29 shows that connecting to the host is as easy as pressing n after starting Reflection. The methods you can use to establish host connections range from simple to complex—this chapter describes how to establish network and modem connections, make demonstration connections, and how to use a Hosts file.
Network Connections (Best Network) To establish a host connection after starting Reflection, press n in the terminal window. Reflection looks for the Telnet, LAT, and VT-MGR network protocols. If you have multiple protocols loaded, the order in which each available protocol attempts a connection to the host, service, or port you specify is shown in the Connection Setup dialog box. Reflection for HP with NS/VT (emulating an HP terminal) will initially attempt to connect using VT-MGR; if that fails, Reflection tries again with Telnet. Reflection for UNIX and Digital and Reflection for ReGIS Graphics (as well as Reflection for HP with NS/VT emulating a VT terminal) will attempt a Telnet connection, followed by LAT, then VT-MGR. Once a connection is made, that protocol is then listed first for subsequent connections. For example, if you have both LAT and Telnet installed, then Telnet is always detected by the Best network connection method first and will always be the protocol selected in Reflection for UNIX and Digital or Reflection for ReGIS Graphics. This does not mean you cannot connect using LAT if you have both protocols installed; use the Connection Setup dialog box to specify a different protocol. If you have a different type of network, or are connecting over a serial port, either directly or via modem, then you connect by selecting the proper options in the Connection Setup dialog box.
143
Project Name • Chapter 20 • Advanced Host Connection Options • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\CONNECT.FM • 8.24.98 • 11:18am
144
Advanced Host Connection Options
Modem Connections To dial a host from Reflection, you can dial the modem manually or automate the procedure by using a settings file.
Connecting by Dialing the Modem Manually If there’s a phone number that you call infrequently over your modem, you may want to dial the number yourself: 1.
Click Connection Setup on the Connection menu to open the Connection Setup dialog box.
2.
Select Modem in the Connect using box.
3.
If you have not already added a modem to Reflection (see page 25), click the Add button and install a modem using the Install New Modem Wizard.
4.
In the Phone number box, enter the telephone number of the host you want to connect to, then click Dial.
5.
The Dialing in Progress dialog box shows that Reflection is dialing your host. This dialog box closes when the modem connection is made. When your host prompt appears, log in as you usually do.
Connecting Over a Modem Using a Settings File Once you create a modem connection, you can save that connection as a settings file. Connecting to a host is then as simple as opening a file. To save a modem connection as a settings file: 1.
Click Connection Setup on the Connection menu to open the Connection Setup dialog box.
2.
Verify that your modem connection settings are correct.
3.
On the File menu, click Save As to open the Save Settings dialog box. Reflection proposes a name for your saved connection based on the telephone number you specified in the Connection Setup dialog box. If you do not want to use the proposed name, type or select another name in the File name box.
Advanced Host Connection Options 145
4.
In the Save as type list, select Connection (*.rco). Tip: To make your modem settings files easy to find, give them descriptive names and keep them in a unique folder under the Reflection folder. à
5.
Click OK to save your modem connection as a connection settings file.
6.
To establish a modem connection using a settings file, click Open on the File menu, select the settings file in the Open Settings dialog box, and click Open.
Demonstration Connections To see how Reflection operates without making an actual host connection, use Reflection’s demonstration mode to simulate an HP 3000, Digital, or UNIX host connection, or to simulate a modem connection to WRQ’s technical support BBS. Demonstration mode is useful for training users or giving demonstrations of hosts to which you don’t have access. To establish a demonstration host connection: 1.
Click Connection Setup on the Connection menu to open the Connection Setup dialog box.
2.
Under Connect using, select Network.
3.
Select DEMONSTRATION from the list of network connections.
4.
From the Host type list, select the type of demonstration connection you want to make: Digital, HP 3000, Modem, or UNIX.
5.
Click Connect.
6.
The demonstration host prompts you for a login name and password. For the Digital and UNIX options, enter any text you like, or just press n. For the HP 3000 option, enter a “Hello” command and press n.
7.
The host prompt for the demonstration host you selected appears in the terminal window. You can enter a command to see a directory listing, for example. You can also simulate transferring files by clicking Transfer on the File menu.
146
Advanced Host Connection Options
Following are valid host commands for demonstration connections: Host Type
Valid Commands
Digital
dir, dir /full, demodata, logout, lo
HP 3000
showjob, listf, demodata, bye
UNIX
ll, ls, demodata, exit
Modem
AT, ATDT, +++
Specifying a Hosts File The TCP/IP Hosts file is a simple list that maps recognizable names to Internet addresses, similar to using a domain name server. You can use a TCP/IP hosts file if there is no domain name server on your network (or even if there is). It is also convenient to place frequently used nameto-address mappings in this file. A TCP/IP hosts file can reside on your PC, or on a PC server. Reflection uses this file only to determine what names to show in the Host/Service name list when you attempt a connection. It is not Reflection’s job to “resolve” the hosts file name; this task is performed by your networking software. If a connection cannot be made, Reflection returns the error “Could Not Resolve Host Name.” To change the Hosts file: 1.
Click View Settings on the Setup menu.
2.
Under Reflection settings, highlight Hosts File. Tip: To quickly highlight this setting, type hosts in the Search box. à The path and file name of your current Hosts file appears in the Setting details box.
Advanced Host Connection Options 147
3.
4.
Enter the full path and file name of your new Hosts file in the Setting details box: ·
If you are using Windows 95 or Windows 98, your Hosts file is in your Windows folder, for example C:\Win95 or C:\Win98.
·
If you are using Windows NT 4.0, your Hosts file is in the Winnt40\System32\Drivers\Etc folder.
Click OK to close the View Settings dialog box. Unlike other Reflection settings, you do not need to save your settings file to retain Hosts file changes made in the View Settings dialog box; they are automatically saved in the Windows registry.
The Hosts file uses the names (not the aliases) from the file you specify here. The Hosts file name you specify is not associated with a particular settings file (that is, the name is a global setting used by all copies of Reflection).
Related Online Help Topics See the Reflection online help for information on these topics: ·
Using the Reflection Connection Wizard to automate the process of logging in to your host and starting a host program.
·
Using the Best Network connection option.
·
Changing the serial port for a direct connection.
·
Configuring a network modem.
C hap ter
21
Using Visual Basic and Macro Recording Reflection supports a complete programming language. Starting with version 7.0, Reflection uses Visual Basic for Applications for programming support. Using Visual Basic and the Reflection macro recorder, you can create macros that allow you to automate tasks you perform using Reflection. Earlier versions of Reflection used the Reflection Basic language and programming environment. Reflection continues to support scripts developed using Reflection Basic. The final sections of this chapter provide information for Reflection Basic users. This chapter describes how to create, modify, and use Reflection macros. See the Reflection Programming online help for more detailed information and examples.
Visual Basic for Applications Visual Basic for Applications (VBA) is a combination of a programming language and a program development environment supported by many different applications (including Reflection and Microsoft Office 97 products). You can use VBA to customize and enhance Reflection. You can also create macros that allow Reflection to interact with other applications (such as Word and Excel). VBA is a shared component, which means you have one copy of VBA for all applications on your system that use it. The core Visual Basic language consists of programming commands that are common to all implementations of Visual Basic. In addition to this core language, Reflection macros use Reflection-specific methods and properties that extend the core Visual Basic language. These methods and properties allow you to manipulate and configure Reflection sessions.
Using Reflection and Visual Basic Help This chapter provides a brief overview of the basics of recording and using macros. You can use the Reflection and Visual Basic Help menus to get more detailed information about how to create and edit macros. Two help systems are available: Reflection’s Programming online help and Microsoft’s Visual Basic online help.
149
Project Name • Chapter 21 • Using Visual Basic and Macro Recording • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\Vbasic.fm • 8.24.98 • 11:18am
150
Using Visual Basic and Macro Recording
Reflection’s online help includes information about how to use Visual Basic for Applications in Reflection. It also includes a complete reference to Reflection’s methods and properties, the commands you use to control Reflection programmatically. To open the Reflection Programming online help: 1.
On Reflection’s Help menu, click Help Topics and click the Contents tab.
2.
On the Contents tab, open the book called Reflection Programming Guide, then click Shortcut to Reflection Programming Help.
Microsoft’s Visual Basic online help provides information about how to use the Visual Basic Editor and about the programming language commands that are common to all Visual Basic implementations. Note: Microsoft’s Visual Basic online help is not available if you install Reflection using the Typical installation option (unless you have already installed VBA help with a different product that uses Visual Basic for Applications). To gain access to the Microsoft online help topics you must select the Custom installation option during Setup, and then select the VBA Online Help component. à To open the Microsoft Visual Basic online help: 1.
On Reflection’s Macro menu, click Visual Basic Editor.
2.
On the Visual Basic Editor’s Help menu, click Contents and Index.
Recording and Using Macros The Reflection macro recorder lets you capture the actions you perform in Reflection. While the recorder is on, Reflection records your actions as a set of commands known as a macro. When you run a recorded macro, the sequence of commands you recorded is repeated. Use the macro recorder to record actions as Visual Basic commands—you don’t have to do any writing or programming to create a macro that can be played back later. Macros can automate many sorts of tasks (for example, logging onto a host, navigating host screens, or transferring files). Macro recording can also simplify programming tasks and help you learn to program.
Recording a Macro To record a macro, follow these steps: 1.
On the Macro menu, click Start Recording to start the macro recorder.
Using Visual Basic and Macro Recording 151
2.
Perform whatever tasks you wish to record. Use the mouse, the keyboard, or both.
3.
To pause a macro to perform actions that you do not wish to record, click the button on the right side of the recording toolbar. When you are ready to record again, click the button again to resume.
4.
Click the Stop Recording button on the left side of the recording toolbar to turn the macro recorder off. The Stop Recording dialog box opens.
5.
In the Stop Recording dialog box, leave Destination set to Macro, enter a name for your macro in the Name box, enter an optional description for your macro in the Description box, then click OK.
6.
At this point, you can run and test your macro, but it is not yet saved. If the macro works as desired, save your settings file to save the macro.
For detailed information about the Stop Recording dialog box options, search for Stop Recording dialog box in Reflection’s online help.
Running a Macro To run a Reflection macro, follow these steps: 1.
On the Macro menu, click Macros.
2.
Type the name of the macro you want to run, or select it from the list.
3.
Click Run.
When a macro is running, most menu items are disabled. You can stop a running macro by clicking Stop Macro on the Macro menu.
Macros and Settings Files Macros are saved when you save your settings file, and are available each time you open the settings file. Either of the following actions saves both your macros and your current settings: ·
In Reflection, click Save or Save As on the File menu.
·
In the Visual Basic Editor, click Save on the File menu.
152
Using Visual Basic and Macro Recording
When you open the Macros dialog box, you see a list of macros that are available in the current settings file. If you want to use macros from a different settings file, you can use the Add Reference dialog box. When you add a reference to a file, all of the macros in that file are available to your current settings file. You can add a reference to any settings file created using the same Reflection product. Added references are saved as part of your settings file. This means that the macros in the referenced file will be available whenever you open your settings file. The reference link is dynamic; this means that if the macros in the referenced file are updated, you will have access to the most recent version of these macros when you open your settings file. To add a reference: 1.
On the Macro menu, point to Advanced, then click Add Reference.
2.
Select the settings file you want to add a reference to, then click Open.
3.
Save your settings file to save this change.
The Command Line Press a+L in the Reflection terminal window, or double-click on the status bar, and the status bar turns into a command line. The command line provides access to Reflection methods and properties. Any valid Visual Basic statement can be entered on the command line. For example, the following statement uses Reflection’s Help method to open the programming help file and look up “Introduction” in the index. On the command line, type the statement shown here: Help "Introduction","vbrwin.hlp"
Then press n; this executes the command you entered. After you execute a command, the command line is clear again. If you press :, the previous command reappears. This is because the command line is a simple editor in which you can store a series of commands; each command that you execute is added to a list of remembered commands. Note: To paste text from the Clipboard to the command line, you can use either c+V or the default Reflection mapping for Paste (s+cpv). These keystroke combinations are not affected by changes you make to your Reflection keyboard setup. à
Using Visual Basic and Macro Recording 153
Reflection Basic Support When you start Reflection, you will notice that a Macro menu has replaced the Script menu that was present in older versions of Reflection. Although the Script menu is no longer displayed by default, your existing scripts (*.rbs) can still run without any modification. If you attached scripts to custom features (such as toolbar buttons, or key strokes), you don’t need to make any changes to your settings file; your scripts will continue to run exactly as they did before. Similarly, scripts that run automatically (such as connection scripts) will continue to run as they did before. If you want to edit and update Reflection Basic scripts, you can use the procedure outlined below to restore the Script menu. For more detailed information about Reflection Basic support, search for Reflection Basic in the online help.
Restoring the Script Menu This example restores the Script menu to a position directly to the right of the Macro menu: 1.
On the Setup menu, click Menu to open the Menu Setup dialog box.
2.
Click Macro under Defined menu to select this item.
3.
In the Available options box, open Additional items, open Items from version 6.x, then select Script.
4.
Click Add After. This adds the Script menu to the right of the Macro menu.
5.
Click OK to close the dialog box.
6.
On the File menu, click Save to save this change.
C hap ter
22
Working with Host Graphics in Reflection for ReGIS Graphics This chapter applies only to Reflection for ReGIS Graphics. Reflection for ReGIS Graphics, in addition to emulating the same text terminals as Reflection for UNIX and Digital, supports Digital’s Remote Graphics Instruction Set, or ReGIS, and the Tektronix features of Digital’s VT340, VT330, VT241, and VT240 graphics terminals. Reflection for ReGIS Graphics supports the following ReGIS features: ·
Up to 16 colors
·
Shading with selected patterns and polygon fill
·
Rubber band cursors
·
Rotated and italicized characters
·
Mouse support
·
A scaled graphic showing the complete ReGIS screen (800 × 480 pixels) on the physical display
·
Dynamic resizing of graphics
·
TrueType font support
155
Project Name • Chapter 22 • Working with Host Graphics in Reflection for ReGIS Graphics • TEMPLATE: docs_v1 • D:\working\rwin\ug\online\GRAPHICS.FM • 8.24.98 • 11:18am
156
Working with Host Graphics in Reflection for ReGIS Graphics
Configuring Reflection for Graphics Emulation For accurate ReGIS and sixel graphics emulation using Reflection for ReGIS Graphics: ·
A 256-color display is recommended.
·
The Terminal type on the Graphics tab in the Terminal Setup dialog box should be set to one of the four graphics terminal types—host programs may need to determine the graphics capabilities of Reflection: –
The VT240 and VT330 are monochrome graphics terminals, providing up to four shades of gray at once.
–
The VT241 and VT340 are color graphics terminals; the VT241 provides up to four different colors at once, while the VT340 provides up to 16 different colors.
All four graphics terminals support ReGIS. Each terminal differs slightly in its implementation of ReGIS, and Reflection should be set for the type of terminal required by the host graphics program. ·
A host program may need to determine the graphics capabilities of Reflection; it does so by requesting the Terminal ID (on the Emulation tab of the Terminal Setup dialog box). For accurate graphics emulation, the Terminal ID should be set to the type of terminal the host expects to find: VT240, VT241, VT330, or VT340. The default Terminal ID value for Reflection for ReGIS Graphics is VT340.
Displaying a Sample ReGIS Graphic As you are going through this chapter, it’s helpful to have a graphic already in the terminal window: 1.
Press a+L to open the command line (explained on page 152).
2.
Type the following command (all on one line) and press n: .DisplayFile "C:\Program Files\Reflection\VT\Samples\Demo.pic"
The Demo.pic file paints a ReGIS graphic and shows a few of the graphics capabilities of Reflection.
Working with Host Graphics in Reflection for ReGIS Graphics 157
Selecting Graphics Reflection for ReGIS Graphics can detect when there are graphics on the display, and the mouse pointer then becomes a crosshair pointer for selecting graphics. The mouse is the only way to select graphics; you cannot use the Select All command on the Edit menu—this command selects only text. Use the following techniques to select graphics: ·
Drag the crosshair pointer using the left mouse button to make a selection. A solid line is drawn around the selection.
·
To select graphics when a host program is in control of the graphics input cursor, hold down the c key while making your selection using the left mouse button.
·
To highlight a rectangular section of text while there are graphics present on the screen, hold down c+a, then make your selection using the left mouse button. Note: This procedure is not available when running in Tektronix mode. à
·
If both text and graphics are on the display, but you want to select only the text, hold down the a key; the crosshair pointer changes back to a text pointer. Keep the a key down while you start your selection by dragging with the left mouse button; after you’ve started your selection, release the a key. If you have a three-button mouse, you can also use the middle button. To extend a selection made using this method, hold down a+s, then drag with the left mouse.
Once a graphic is selected, click Copy on the Edit menu to copy it to the Clipboard. Then, use another program’s Paste command to import it. If you want to select text to import into another program as a graphic, see “Saving Graphics,” next.
158
Working with Host Graphics in Reflection for ReGIS Graphics
Saving Graphics To save a graphic image to a disk file: 1.
On the File menu, click Save Display As to open the Save Display As dialog box.
2.
When Reflection detects graphics on the display, Sixel is selected as the Range option. Since you cannot save both text and graphics, all the other options are dimmed (since they only apply to saving text).
3.
Click OK.
When the display is cleared, or when graphics scroll off the display, graphics are not saved to display memory; display memory saves only text from the display. The above procedure shows how to preserve these graphic images.
Controlling the Printing of Graphics You can determine whether graphics print along with text or not, and you can specify whether to print the background image of the graphic: 1.
On the Setup menu, click Terminal, then click the Graphics tab.
2.
The state of the Print background and Print graphics check boxes also affects saving display sixels in the Save Display As dialog box.
By default when you print a graphic image, the background is printed. This setting applies to sixels generated as well as graphics printed on Windows printers. Since the default background color in Reflection for ReGIS Graphics is black, you can save a lot of printer toner by not printing this black background. Clear the Print background check box to do this. ·
If you have graphics on the display but only want to print the text, clear the Print graphics check box.
·
Click OK after making your changes.
Working with Host Graphics in Reflection for ReGIS Graphics 159
Changing the Terminal Window Color in ReGIS Mode When you enter ReGIS mode, the terminal window turns black. To change the color used by the terminal window when you enter ReGIS mode: 1.
On the Setup menu, click Display, then click the Colors tab.
2.
Clear the Enable host color changes check box.
3.
With the black square highlighted in the Background group, click Color Map (or just double-click on the black square).
4.
In the Color Map Setup dialog box, you first need to adjust the H (Hue), L (Luminosity), or S (Saturation) values. To change one of these values, you can either type in a number or click the arrows to the right of each box to increase or decrease the value. Or, simply drag the black circle in the color grid in the bottom left corner to a new position. For example, a blue color could show 8 in the H box and 90 in the S box.
5.
Now drag the arrow up or down the luminosity bar to adjust the luminosity of the color; as you do this, you’ll see the values in the R (Red), G (Green), B (Blue), and L (Luminosity) boxes change. The new color shows in the top half of the New box.
6.
Click OK (twice) to close both dialog boxes.
7.
Click Save on the File menu. Or click Save As and save this as a color-only settings file.
Now ReGIS applications use the new color for the terminal window background.
160
Working with Host Graphics in Reflection for ReGIS Graphics
Tektronix Graphics Reflection for ReGIS Graphics supports all the Tektronix 4010/4014 features available on VT terminals. The Tektronix screen uses vectors (lines) to display both alphanumeric characters and graphics. In most cases, the program software you are running automatically switches between the VT and Tektronix emulation.To manually begin Tektronix emulation: 1.
On the Setup menu, click Terminal, then click the Terminal Type tab.
2.
Select 401X as the Terminal type.
3.
Click OK.
If there was any text on the terminal window, it is cleared and the window appears blank with the cursor in the upper-left corner and the mouse pointer changing to a crosshair pointer. The text in Reflection’s status line always shows you which mode you are in. For example, if you are connected over COM1 using the default baud rate, the status line now looks like this: 401X - COM1(9600)
Changing the Color of Tektronix Graphics By default when Reflection draws Tektronix graphics, it uses Color Map 0 for the background and Color Map 7 for the foreground (just as a VT340 terminal does). If you want to change, or brighten, the color used for drawing Tektronix graphics: 1.
On the Setup menu, click Display, then click the Colors tab.
2.
Click the Color Map button to open the Color Map Setup dialog box.
3.
Select the Color map square number 7.
4.
Choose a new color from the color grid. For example, to brighten the color used, drag the vertical luminosity bar to the top.
5.
When you are through changing colors, click OK. To retain this new color, either save it to a color scheme or click Save on the File menu to save your settings file.
Working with Host Graphics in Reflection for ReGIS Graphics 161
Related Online Help Topics See the Reflection online help for information on these topics: ·
List of ReGIS Graphics commands.
·
List of Tektronix display modes.
·
Using a mouse in graphics mode.
·
Zooming and scrolling a Tektronix image.
·
Mouse buttons and graphics support.
C hap ter
23
Viewing Reflection Settings Reflection’s View Settings dialog box lets you see how all your settings are configured and allows you to change them. Use the View Settings dialog box to look at: ·
Individual Reflection settings (such as the current baud rate)
·
All settings that have changed from the site default values
·
All settings that are different from the factory default values
·
Online help for a detailed descriptive or syntactical description of each setting
You can view the settings in one of two formats: in a descriptive text format or the Reflection macro syntax.
Finding a Setting By typing the setting name in the Search box, or selecting the setting directly, you can quickly check the current value of a setting, change most settings values, find out what values can be used, or view descriptive or syntactical help for a setting. When you change a setting here, the corresponding setting in an associated Reflection dialog box changes as well (if there is one). For example, if you change the value of the Close Printer Manually setting from No to Yes, the Manually option in the Close printer group box in the Print Setup dialog box is selected. When you are using settings files, the View Settings dialog box is helpful because it shows how the information in a settings file differs from Reflection’s factory defaults. To check how a settings file has altered your default settings: 1.
Open a complete settings file.
2.
On the Setup menu, click View Settings.
3.
Click Changed from factory default to see which settings aren’t set to their original default values. (The Changed from site default option shows the same information unless your system administrator has changed the default value for a particular setting.)
163
Project Name • Chapter 23 • Viewing Reflection Settings • TEMPLATE: docs_v3 • D:\working\rwin\ug\online\VIEWSET.FM • 8.24.98 • 11:18am
164
Viewing Reflection Settings
Changing a Setting Value When you change a setting using options in the Setting details box, you revert the value of the Reflection setting to either its original factory default, or to the value the setting had as it is saved in the currently settings file or site default settings file. The Default button changes the setting value to the factory or settings file default. Click Reset to return the value of the setting to what it was before you opened the View Settings dialog box. In other words, the Reset button lets you reverse the setting change before you close this dialog box.
Site Defaults vs. Factory Defaults Select one of the options in the Display settings group box to specify which settings appear in the Reflection settings list: ·
All to display all settings.
·
Changed from site default to show settings that don’t match values contained in a site default settings file. The default value for a particular setting is built into the product but can be changed by your system administrator. The Changed from site default option only becomes available (undims) when you have a site default settings file, and the wording of the option also changes to “Changed from default.” For example, in Reflection for HP with NS/VT, if the site settings file is called Home Office.r1w, the option reads “Changed from Home Office Default.”
·
Changed from factory default to show settings that aren’t set to their original default values.
I nd ex
A ActiveX support (see the System Admin istrator Guide) ADDS emulation 32 ANSI color support 32 emulation 32 ASCII file transfer method 136 Auto font sizing 76 Automating multi-user installations 15 Reflection with events 55
B BBS-ANSI emulation 32 Best Network connection option 143 Binary file transfer method 136 Bitmap fonts 74 Blinking characters 67 Browser demonstration of Reflection running in Reflection menu commands in 91 running Reflection within 89 supported versions 89 Bulletin Board (BBS), phone number iii Buttons creating button to toggle logging 88 mapping action to mouse 122 toolbar 107 Bypass Windows printing 82
C Capturing or logging output 87 Character translation, disabling 88 Closing the printer 83 Color changing with color schemes 67 color mapping 20, 71
90
entering ReGIS mode changes colors 159 support under ANSI emulation 70 COM ports serial connection option 26 setting in Reflection 27 Command line using 152 Complete settings files defined 64 Configuring local workstations with the Deployment Manager 17 Connection Best Network connection option 143 Connection Wizard 42 Conversion Wizard 37 Demonstration connection option 145 how to connect 29 Modem connection option 144 multiple connections 30 Network connection option 23 reconnecting to the host 34 serial connection option 26 Context menu, adding an item to 101 Copy, why default keyboard shortcut is Ctrl+CpIns 53 Ctrl+S/Ctrl+Q keystrokes, pausing the display Cursor shape 54 Customizing display colors 67 help 5 title bar text 48
50
D Data General (DG) emulation 32 Defaults keyboard mapping 117 menus 104 resetting a single setting value 164
165
166
Index
resetting Reflection default values 34 site defaults vs. factory defaults 164 Demonstration connections 145 Deployment Manager creating a base installation 15 deploying Reflection 17 installing an administrative copy 16 installing Reflection with 15 recording an installation script 16 Disabling disabled menu commands 48 features (see the System Administrator Guide) Disconnecting from a host 34 Disk file logging output to 87 printing to 81 Disk space requirements 10 Display customizing colors in 68 defined 50 font, changing 75 pausing 50 Display memory changing the amount of 54 defined 50 Docking the terminal keyboard 126 Documentation description of available 4 electronic manuals 6 ordering manuals 6 Reflection Technical Set defined 4 Drag-and-drop file transfer 137 keyboard mapping 118 terminal keyboard 126
E Enabling features (see the System Administrator Guide) 4 Events creating 56 creating and disabling 59
definition of event types 55 overview 55 Exit customizing method of 35 on disconnect 34 Reflection 35
F 4
Fast text printing, default printer font 85 File extensions defined for Reflection products 64 defined for settings files 65 File transfer drag-and-drop 137 File Transfer dialog box 137 preset configurations 136 protocols, described 133 WRQ/Reflection 137 Files printing 81 saving settings files 33 transferring 133 Fonts bitmap fonts 74 changing the display font 73 changing the printer font 84 fixed-pitch fonts 73 international font support 73 TrueType fonts 73 FTP online help only source of documentation transferring files 137 WRQ’s FTP 134
G Graphics color of terminal window 159 introduction 155 mouse support 161 printing 158 printing background 86
7
Index 167
ReGIS, working with saving 158 selecting 157 Tektronix 160
156
with Reflection Setup 12 with the Deployment Manager 15 Internal commands, using on the command line International font files, installing 77 Internet Explorer, version required 10
H Hardware requirements 11, 19 Help changing color of window 71 customized help 5 description of online help files 3, 7 Hiding menu bar 95 terminal keyboard 125 toolbar 110 Host modem connection to 144 network connection to 23 requirements 11, 19 serial connection to 26 terminal type, changing 31 Hosts file 146 Hotspots defining 130 described 129 enabling and showing 129 HP emulation HP 700/96 and HP 700/98 support 31 HP character sets (see the System Administrator Guide) 5
K Keyboard changing PC or host 118 graphical terminal 125 Keyboard mapping drag-and-drop options 118 Keyboard Setup dialog box 118 mapping the keystroke 116 restoring defaults 117 selecting commands 116
L Labels 136 LAT enabling the LAT protocol 25 list of 32-bit products 23 Left mouse button functionality 51 Log file, using the Conversion Wizard 42 Logging creating a button to toggle logging 88 introduction 87
M I Image file transfer method 136 ImageWriter printer graphics printing 86 Initialization string how to set for modem 147 Installing Reflection configuring workstations 18 procedure 12
Macros overview 150 running 151 saving 151 settings files 151 Manuals, how to order 6 Mapping the keyboard 115 Menu bar adding to 97 hiding and showing 95
152
168
Index
Menus adding items to 97 customizing 95 restoring defaults 104 restoring the Script menu 153 setup 95 Microsoft Internet Explorer, version required MIME types in Reflection 93 Modem connecting using a settings file 144 connection option 144 dialing manually 144 modem indicator 54 quick connections 144 Modifier key, in keystroke definition 116 Monospaced fonts 73 Mouse buttons, right vs. left 52 chords, defined 121 mapping 121 selecting text 51 Multiple connections 30
P Passwords, saving or requiring (see the System Administrator Guide) 4 Paste, why default keyboard shortcut is Ctrl+CpIns 53 Phone numbers, WRQ, Inc. iii PostScript printers, effect of bypassing Windows printing 82 Printing bypassing Windows management of 82 changing the printer font 84 graphics 158 graphics background 86 logging (or capturing) output 87 page options 84 selecting a new printer 81 sending escape sequences to the printer 88 setup 81 to a file 81 using the default printer font 85 Product disks (media format) 10 Profiler (see the System Administrator Guide) 4 Protocol, WRQ/Reflection 137
10
N Netscape Navigator, version required 10 Network connections using Best Network 143 network modem 147 required software for connecting over 23 supported 32-bit networking products 23
Q Quitting Reflection
R
O OLE server settings, won’t run Conversion Wizard Online help changing color of window 71 description of online help files 7
35
37
R1w, Reflection for HP with NS/VT file extension 64 R2w, Reflection for UNIX and Digital file extension 64 R4w, Reflection for ReGIS Graphics file extension 64 Reconnecting to the host 34 Recording macros 150 Rectangular selection for text 51 for text with graphics on the screen 157
Index 169
Reflection controlling feature access 4 creating custom help 5 exiting 35 host control of 5 ordering manuals 6 running multiple sessions of 30 Setup, installing with 12 starting 29 uploading host program 135 Reflection Basic support 153 using the Command line 152 Refresh Host Files 139 ReGIS graphics color of terminal window 159 supported features 155 Restoring converted settings 41 previous version menus and commands Reflection’s factory defaults 34 Right mouse button functionality 52 Running macros 151
105
S Saving macros 151 settings files 33 using the Save As command 33 SCO-ANSI emulation 32 Script, restoring the Script menu 153 Scroll bar, hiding or showing the vertical scroll bar 54 Scrolling horizontally 51 vertically 51 Security issues, password protection (see the System Administrator Guide) 4 Selecting text 51 Serial port connection option 26
Sessions, running multiple 35 Settings Conversion Wizard 37 Settings file complete settings file 64 converting earlier versions 37 creating 65 defined 33 file extension definitions 65 opening 66 overview 63 restoring converted files 41 saving 33 Setup program installing Reflection 12 using Uninstall 18 Setup.hlp 9 Shortcuts defining shortcut key for menu item 103 icons converted to using Conversion Wizard specifying location of during Setup 13 Show host files, file transfer 138 Simulated connections 145 Start Recording, Macro menu command 150 Starting Reflection 29 Status bar cannot remove 54 hiding or showing 54 System Adminstrator online help file 7 System requirements 10
T TCP/IP Hosts file, specifying location of 146 Technical support, phone number iii Tektronix, introduction 160 Terminal frame, hiding or showing 54 Terminal key, mapping a PC key to 116 Terminal keyboard attaching 126 displaying 125 resizing 127
39
170
Index
Terminal window changing color of ReGIS mode 159 overview 47 setting text scrolling speed 54 title bar 48 working with text 50 Text printing using display font 77 selecting in Reflection 51 setting scrolling speed 54 transmitting to host using mouse 52 Title bar hiding or showing 54 text 48 Toolbar adding a button 112 hiding and showing 110 layering multiple 110 removing a button 113 Transferring files 133 TrueType fonts described 73 printing with 84 support in Reflection 77
U Uninstalling Reflection 18 Unisys T27 emulation, about 32 User keys, configuring 54 User-defined menu item 97 User-defined popup 97
V Vertical scroll bar, hiding or showing 54 View Settings changing a setting value 164 finding a setting 163 Visual Basic, introduction 149 VT character sets (see the System Administrator Guide) 5 VT emulation default mode for Reflection for ReGIS Graphics 31 default mode for Reflection for UNIX and Digital 31 using Reflection for HP for VT emulation 31
W Web browser demonstration of Reflection running in 90 supported versions when running Reflection in Window title, changing 48 Windows NT version 3.51 support 3 Wizards Connection Wizard 42 Settings Conversion Wizard 37 WRQ, Inc., phone numbers iii WRQ/Reflection file transfer 137 WYSE emulation 32
89
