3.1.1 Walkthrough: Set up and Customize a Session

The following example shows how to create a custom keyboard map file and set up a session document file to use this keyboard map. This keyboard map assigns the Ctrl+E key combination to the EraseEOF Send Key. The session is saved as a regular session file so you can see the additional work you need to perform to deploy it (as opposed to saving it as a compound session file).

To walk through the process for creating and deploying a compound session file, see Setting up a Basic Deployment.

First, create and save the session.

Create a session

  1. Open Reflection on your workstation.

  2. In the Create New Document dialog box, under Built-in Templates, choose a type of session (for our example, we will choose 3270 terminal) and click Create.

  3. In the Create New Terminal Document dialog box, in the Host name/IP address box, enter the host name (for example, IBM390 or 10.9.1.151).

  4. From the Reflection Quick Access toolbar, click the Save button and save the session as mySession.rd3x.

    This file is saved in the My Documents\Micro Focus\Reflection folder.

Then configure the session with a keyboard map.

Customize the session to reference a custom keyboard map

  1. With a session open in Reflection (for example, mySession.rd3x), on the Quick Access toolbar, click the Document Settings button .

  2. In the Settings dialog box, under Input Devices, click Manage Keyboard Map.

  3. In the Manage Keyboard Map dialog box, click Create a new keyboard map from an existing keyboard map file.

  4. In the Create a New Keyboard Map file dialog box, select a keyboard map file to use as a template for your new file (for example, Default 3270.xkb) and then select Use the new file in the current session document and click OK.

  5. In the Keyboard Mapper dialog box, click in the Press the key or key combination that you want to map box. Then hold down the Ctrl key and press the E key to enter Ctrl+E in this box.

  6. Click the Select Action button.

  7. In the Select Action dialog box, in the Action list, select Send Key.

  8. Under Action parameters, in the Key list, select Erase EOF and click OK. (The Ctrl+E key combination is displayed as a key combination in the Keyboard Mapper table.)

  9. Click OK. When prompted, save the new keyboard map in the Keyboard Maps folder as myKeyboardMap.xkb.

  10. If you are prompted that this is not a secure location, accept to save it in the default location. (The file is saved in your Documents\Micro Focus\Reflection\Keyboard Maps folder.)

  11. To “lock down” the settings to create a keyboard map, see Control Access to “Lock Down” Settings and Controls.

  12. To package the session file and the keyboard map, see Walkthrough: Create a Package with the Installation Customization Tool.