Perform Other Common Tasks

You can perform these common tasks to make it easier to use Reflection or configure it to meet your requirements:

Add a Keyboard Shortcut That Sends Special Character Data (VT)

You can add an action that sends special characters to the host and then map it to a keyboard shortcut, a button, or another control.

To add a keyboard shortcut that sends special character data to the host

  1. Select Manage Keyboard Map.

  2. In the Keyboard map dialog box, select Modify the currently selected keyboard map file.

  3. Press the key combination you want to map (for example, CTRL+Q).

  4. Click Select Action and then select the Send Text action.

  5. In the Select a special character list, choose the character data to send.

    NOTE:If the Select a special character list doesn't have the character data you want to send, you can type in the string for the character data in the Text to send to host field. For example, type in <ESC>. Alternatively, you can hold down the ALT key and use the numeric keypad to enter the numeric code for the data. For example, to send <ESC>, enter 027.

Configure non-FTP File Transfer

You can manually configure file transfer settings in the Transfer Settings dialog box. Any configuration you perform is saved with your session document.

However, using an automated preset configuration is recommended.

To configure file transfer

  1. Open a terminal session.

  2. Configure the file transfer settings.

  3. For most situations, you can configure for file transfers by selecting a preset configuration in the Protocol tab (For example, AS/400).

Edit the Translation Table

Using the Translation Tables dialog box, you can:

  • Edit the tables Reflection uses to translate the PC's character set into the character set used by the host and vice versa.

  • Use currently unsupported character sets.

  • Customize Reflection for unique host environments.

Use the translation tables when:

  • You need to edit how characters are translated from the host to the PC, and vice versa. Typically, you'll use the tables to support a host character set that's currently unavailable in Reflection. The characters in the table are hexadecimal.

    - or -

  • You need to edit how EBCDIC characters are translated from the host to the PC, and vice versa for a Unisys T27 host. These translations are done in addition to the normal PC-to-host and host-to-PC translations performed by Reflection. The characters in the table are hexadecimal.

    NOTE:To use the translation tables, theDataStreamTranslation VBA property must be set to true (the default is false). When Reflection is emulating a Unisys T27 host, the DataStreamTranslation property is automatically set to true.

To open the Translation Tables dialog box

  1. Launch a Reflection VT session.

  2. From the Tools ribbon, select Visual Basic.

  3. In the VBA editor, right-click on Project Legacy and choose Insert and then Module.

  4. Copy and paste the following VBA code into the code window:

    Sub Translation()
         With Session
         .DataStreamTranslation = True
         .ExecuteBuiltInFunction "TranslationTables"
         End With
    End Sub
  5. Close the VBA editor.

  6. On the Tools ribbon, click Run Macro.

  7. In the Run Macro dialog box, select Legacy Reflection Macro in This File.

  8. Run the Translation Macro.

    The Translation Tables editor is displayed.

Print More Than One Screen per Page

You can set up printing to send multiple screen prints to a spool file and then print them all at once. You also have the option of inserting a form feed between the screen prints or letting Reflection fill each page with the maximum amount of text (regardless of where one screen ends and the next begins).

To configure Reflection to print more than one screen per page

  1. In the Print dialog box, click Setup.

  2. At the bottom of the Print Setup dialog box, in the Multiple screens per page box, select Close printer manually.

  3. (Optional) If you want Reflection to add a form feed between each screen print, select Auto formfeed.

  4. For each screen you want to print, go to the screen, and then on the Workspace Menu The Workspace menu contains layout options, application and document settings, and a list of recent documents. It is accessed by clicking the Reflection button (when using the Office 2007 look and feel) or the File menu (when using the Office 2010 look and feel). , choose Print.

    After you print the first screen, the Close Printer button appears on the status bar.

  5. When you are done printing, click Close Printer.

    NOTE:Each screen print you send to the printer is spooled to a file until you click Close Printer.

Set Up a Default Windows Printer

You can specify which Windows printer to use for the session.

To set up printing

  1. Under Printer Settings, select Configure Printer Settings.

  2. On the Print Setup dialog box, select the printer to use.

Use Customized Host Files

Reflection supports legacy Reflection custom host files. These files are used to specify the host names displayed in the Host name/IP address list in the Settings dialog box.

The path to the customized host file is specified in the value for the HKCU\Sofware\WRQReflection\Rwin\Global registry setting. This registry setting is only installed in legacy versions of Reflection. It is not part of the Reflection installation.

If the value of this setting is "" (the default) or if the setting is not in the registry, all of the names in the system local host file are displayed in the Host name/IP address list.

NOTE:Windows can resolve the host names in the custom host files only if these names are valid domain names or names that are in the local hosts file. Custom host files are not used by Windows to resolve IP addresses.

Host file format

The custom host file must have the following format:

<IPv4 or IPv6 address> <host name>

For Example: localhost

:: localhost

The host name information is used to populate the Host name/IP address list in the Settings dialog box.

The IP address information is not relevant unless the specified host file also happens to be the Windows system hosts file.

Generate a HLLAPI Trace

HLLAPI is a standard API for automating terminal tasks. A HLLAPI trace displays the HLLAPI calls the application is making, including return codes. You can use the trace for troubleshooting problems with a HLLAPI application and send the generated file to customer support.

To create a HLLAPI trace

  1. In the Reflection Workspace Settings dialog box, select Configure Workspace Attributes. Then select Enable HLLAPI logging and specify a HLLAPI log file name in a location where you have the appropriate permissions to create and save a file.

  2. In the Reflection Workspace, open or create a session document to connect to your IBM host, and start the HLLAPI application. Perform the actions you want to record in the trace.

  3. Close the HLLAPI application.

    The trace file is automatically saved as hllapi.log in the folder selected in the HLLAPI log file box.