Reflection. Reflection. Reflection. User Guide WRQ WRQ WRQ. for HP with NS/VT. for UNIX and Digital. for ReGIS Graphics. Version 7.

Transcription

1 Version 7.0 for WINDOWS NT 4.0 for WINDOWS 98 for WINDOWS 95 User Guide WRQ WRQ WRQ Reflection for HP with NS/VT Reflection for UNIX and Digital Reflection for ReGIS Graphics

2 Copyright 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.

3 Customer Service WRQ Corporate Headquarters 1500 Dexter Avenue North Seattle, WA USA FAX European Headquarters The Netherlands FAX S.E. Asian Headquarters Singapore FAX Technical Support in the USA WWW: support.wrq.com Reflection Technical Notes (24-hour automated fax request line): Bulletin Board (BBS): BBS Telnet Gateway: bbs.wrq.com Anonymous FTP Server: ftp.wrq.com Technical Support: Technical Support Fax: Technical Support Outside the USA Please contact your International Business Partner: visit or call WRQ for the name of the Business Partner nearest you. You can also send an to Technical Documentation Visit the following web site to download the PDF (Portable Document Format) version of this and other WRQ manuals: We welcome suggestions on how to improve our printed and online documentation. Send your comments to At WRQ we are comm itted to using products that conserve the world s resources. Therefore, the printed version of this manual uses recyc led, elemental chlorine-free paper with 20% pos t-cons umer waste and soy-based inks. Printed in the USA

4

5 T a b l e o f C o n t e n t s 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 Installing Reflection Installing Reflection from a Server Removing a Reflection Product from Your PC Other Installation Topics Related Online Help Topics SECTION 2 Starting Reflection and Getting Connected Chapter 3 Setting Up the Host Connection Network Connection Setup Modem Connection Setup Direct Serial Connection Setup v

6 vi Table of Contents Chapter 4 Starting Reflection and Connecting to the Host Starting Reflection Running Multiple Sessions of Reflection Changing the Terminal Reflection Emulates Saving Your Settings Disconnecting from the Host Reconnecting to Your Last Connection Exiting Reflection Related Online Help Topics Chapter 5 Using the Reflection Wizards Starting the Reflection Settings Conversion Wizard Restoring Converted Settings Using the Conversion Wizard Log File Introducing the Reflection Connection Wizard Starting the Connection Wizard SECTION 3 Working in the Terminal Window Chapter 6 Working in the Terminal Window Changing the Terminal Window s Title Bar Text Working with Text in the Terminal Window Working with the Mouse Default Keyboard Shortcut for Copy/Paste Commands Related Online Help Topics Chapter 7 Using Events in Reflection Types of Events Defining a New Event... 56

7 Table of Contents vii Ordering Events Enabling and Disabling Events Creating a New Event from an Existing Event Viewing and Changing the Properties of an Event Deleting an Event Related Online Help Topics Chapter 8 Working with Settings Files File Extensions Used by Reflection Products Creating and Opening Settings Files Related Online Help Topics Chapter 9 Setting Up Colors Changing Colors and Saving Color Schemes Creating Custom Colors Creating Custom Colors Under ANSI Emulation Related Online Help Topics Chapter 10 Changing the Display Font Fonts Installed by Reflection s Setup Program Reflection s Default Display Font Changing the Display Font Where Reflection Looks for Its Fonts Printing Text Using the Display Font Understanding TrueType Font Support in Reflection Related Online Help Topics Chapter 11 Printing and Logging How to Print from Reflection Changing the Print Setup Changing the Page Options Printing Graphics in Reflection for ReGIS Graphics... 86

8 viii Table of Contents Logging in Reflection Related Online Help Topics Chapter 12 Running Reflection from a Browser Supported Browsers Starting Reflection from a Web Browser Starting the Reflection Browser Demonstration Reflection Commands in the Browser s Menu Bar Paging Beyond the Page Limit of the Browser Browser Frequently Asked Questions Chapter 13 Customizing the Menu Bar Opening the Menu Setup Dialog Box Adding a Menu to the Menu Bar Defining a Keyboard Shortcut Key for a Menu or Menu Item Rearranging the Menu Bar Restoring a Default Menu or Menu Item Restoring Version 6.x or 5.x Menu Items Example: Restoring the Script Menu Guidelines for Adding and Editing Menus and Menu Items Chapter 14 Working with the Toolbar The Reflection Predefined Toolbars The Reflection Toolbar Tabs Working with the Toolbar Adding Pictures to Toolbar Setup Related Online Help Topics Chapter 15 Customizing the Keyboard Opening the Keyboard Map Setup Dialog Box Mapping a Keystroke Removing a Mapping Restoring the Default Keyboard Mapping

9 Table of Contents ix Drag-and-Drop Options Changing Your PC or Host Keyboard Related Online Help Topics Chapter 16 Mouse Mapping Mouse Chords Mapping a Mouse Chord Identifying a Mouse Chord Identifying an Action Disabling a Mouse Chord Chapter 17 Using the Graphical Terminal Keyboard Displaying the Terminal Keyboard When to Use the Terminal Keyboard Moving and Attaching the Terminal Keyboard Changing the Terminal Keyboard s Appearance Chapter 18 Configuring Hotspots Enabling and Showing Hotspots Defining Hotspots Related Online Help Topics Chapter 19 Transferring Files File Transfer Protocols Preparing to Transfer Files Transferring Files Related Online Help Topics

10 x Table of Contents SECTION 4 Using Reflection s Advanced Features Chapter 20 Advanced Host Connection Options Network Connections (Best Network) Modem Connections Demonstration Connections Specifying a Hosts File Related Online Help Topics Chapter 21 Using Visual Basic and Macro Recording Visual Basic for Applications Using Reflection and Visual Basic Help Recording and Using Macros The Command Line Reflection Basic Support Restoring the Script Menu Chapter 22 Working with Host Graphics in Reflection for ReGIS Graphics Configuring Reflection for Graphics Emulation Displaying a Sample ReGIS Graphic Selecting Graphics Saving Graphics Controlling the Printing of Graphics Changing the Terminal Window Color in ReGIS Mode Tektronix Graphics Related Online Help Topics Chapter 23 Viewing Reflection Settings Finding a Setting Changing a Setting Value Site Defaults vs. Factory Defaults Index

11 S E C T I O N1 Introducing Reflection

12

13 Introducing Reflection 1 C h a p t e r 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

14 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.

15 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.

16 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.

17 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 (R<n>win.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 (R<n>win.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 (R<n>winsys.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.

18 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.

19 2 C h a p t e r 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

20 10 Installing Reflection System and Product Requirements To install Reflection you need: The Reflection product CD. An based, 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 Minimal Typical Custom Approximate Disk Space Needed 30 MB 46 MB 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 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.

21 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 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.

22 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 " 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.

23 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 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.

24 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.

25 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.

26 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.

27 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

28 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.

29 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 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. Caution: â 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. à 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.

30 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.

31 S E C T I O N2 Starting Reflection and Getting Connected

32

33 3 C h a p t e r 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

34 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)

35 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.

36 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:

37 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.

38

39 4 C h a p t e r 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

40 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.

41 Starting Reflection and Connecting to the Host 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. 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.

42 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 T 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 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.

43 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.

44 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.

45 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.

46

47 Using the Reflection Wizards 5 C h a p t e r 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

48 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.

49 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.

50 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.

51 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.

52 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 information 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

53 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 , 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. à

54

55 S E C T I O N3 Working in the Terminal Window

56

57 Working in the Terminal Window 6 C h a p t e r 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

58 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.

59 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 &c &d &f &h Meaning Connected or not connected Date (in the format set by Windows) Settings file name or Untitled Host name &i Instance number of Reflection session (starting with 1) &n &r &s &t && Product name Shows the name Reflection Session name (this is the same text that appears in Reflection s status bar) Transport type (port name) Ampersand (that is, use two && to produce one &)

60 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.

61 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.

62 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 ( C R). When you use the right mouse button to click on a blank, just a C R is sent to the host. If you do not want a C R 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. à

63 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.

64 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.

65 Using Events in Reflection 7 C h a p t e r 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

66 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:

67 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.

68 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.

69 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. Disable or enable the event: To disable the event, clear the Enabled check box. To enable the event, select the Enabled check box. 4. Click OK to exit the Event Properties dialog box, then click OK to exit the Event Setup dialog box.

70 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.

71 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.

72

73 Working with Settings Files 8 C h a p t e r 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

74 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 Reflection for HP with NS/VT Reflection for UNIX and Digital Reflection for ReGIS Graphics Reflection FTP Client Reflection for IBM Reflection X File Extension.r1w.r2w.r4w.rfw.rsf.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.

75 Working with Settings Files 65 You can identify a partial settings file by its file name extension: Type of Partial Settings Keyboard map Mouse map Toolbar Colors Menus Hotspots Connection File Extension.rkm.rkm.rtb.rcr.rmu.rhs.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.

76 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: 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. 4. 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.

77 Setting Up Colors 9 C h a p t e r 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

78 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.

79 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: The entire screen is cleared (with the sequence C S IH, C SIJ, or C SI2J ). The program exits ReGIS mode, and the entire image scrolls off the screen (for example, as the result of a series of L F 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.

80 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.

81 Setting Up Colors 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.

82

83 10 C h a p t e r 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

84 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.

85 Changing the Display Font 75 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.

86 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.

87 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.

88

89 11 C h a p t e r 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

90 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.

91 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.

92 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.

93 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.

94 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:

95 Printing and Logging 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.

96 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.

97 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.

98 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).

99 12 C h a p t e r 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

100 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: 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. 3. 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.

101 Running Reflection from a Browser Load the demonstration file R<n>demo.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. à

102 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 All Menus Location in Navigator or Communicator 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 File Edit Connection Setup Macro Window Help Location in Internet Explorer Unavailable (some menus invoke the equivalent Reflection actions, such as File Save and File Print) Edit menu Connection menu Setup menu Macro menu Unavailable 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.

103 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.

104 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.

105 13 C h a p t e r 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

106 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

107 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 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.

108 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.

109 Customizing the Menu Bar 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.

110 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.

111 Customizing the Menu Bar 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.

112 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.

113 Customizing the Menu Bar 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.

114 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. 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. 2. 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.

115 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.

116 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.

117 14 C h a p t e r 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

118 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.

119 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.

120 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:

121 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.

122 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.

123 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).

124 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.

125 15 C h a p t e r 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

126 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.

127 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).

128 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.

129 Customizing the Keyboard 119 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.

130

131 16 C h a p t e r 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

132 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.

133 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

134 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.

135 17 C h a p t e r 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

136 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.

137 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.

138

139 18 C h a p t e r 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

140 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 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.

141 Configuring Hotspots 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.

142 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.

143 19 C h a p t e r 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

144 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.

145 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.

146 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... ASCII Binary Labels Image Auto-Detect When transferring files between... A PC and a host or between a PC and a Macintosh (text-only) via a host. 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. 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. Two host computers via a PC (this transfer type should only be used when you need to preserve host attribute information). Two computers and you want Reflection to automatically determine the file type and choose the transfer method for you.

147 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.

148 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:

149 Transferring Files 139 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.

150

151 S E C T I O N4 Using Reflection s Advanced Features