Technical Notes

Follow the steps in this technical note to map keys in Reflection 2011 or Reflection 2008. An example of how to map an escape sequence is also included in the note.

Mapping a Key

1. Connect to your host.
2. Click the Tools tab. In the Input group, click Keyboard Mapper.
3. You can select the key to map one of two ways:

• In the Map Keys section, place your cursor in the field and press the key or key combination that you want to map, and then click the Select Action button. Or,
• In the Keyboard Mapper section, scroll to and select the Key Combination, and then click Modify.

View Full Size

Figure 1: Select the key to map under Map Keys or Keyboard Mapper.

4. In the Select Action dialog box, there are several Map To options to choose from in the left pane:

Select an action, such as Open URL, in the left pane and make the selections or provide the information required in the right pane.

View Full Size

Figure 2: Select the action and configure it. In this example, the F5 key is being mapped to open a URL.

Mapping Control Characters in Reflection 2011

In Reflection 2011 there are several ways you can map a control character using Send Text. Use the "Text to send to host" text box to map a control character using one of the following methods:

• ALT+nnn -- Generate a control character by holding down the ALT key and pressing the three digit ASCII number using the numeric keypad. The symbolic text for the control character is placed into text box (<ESC> for ALT+027, for example). Using this method, Reflection 2011 can generate control characters for ASCII 1 (Start of Header) through ASCII 31 (Unit Separator).
• CTRL+x -- Generate a control character by holding down the CTRL key and pressing the letter corresponding to the control character. The symbolic text for the control character is placed into text box (<ESC> for CTRL+{, for example). Using this method, Reflection 2011 can generate control characters for ASCII 1 (Start of Header) through ASCII 29 (Group Separator).
• Symbolic Text -- Directly enter the symbolic text of the control character. All control characters from ASCII 0 (Null) through ASCII 31 (Unit Separator) can be entered using this method.

Use the following table to identify the value for each control character for each entry method.

The example below shows how to map an escape sequence. The F4 key is mapped to send the text Escape 4.

View Full Size

Figure 3: Map keystroke F4 to send the text Escape 4.

Mapping Control Characters in Reflection 2008 R1 SP1

Beginning in Reflection 2008 R1 SP1, you can map a control character using Send Text. In the "Text to send to host" text box, generate a control character by holding down the ALT key and pressing the three digit ASCII number using the numeric keypad. Reflection 2008 can generate control characters for ASCII 1 (Start of Header) through ASCII 31 (Unit Separator).

The example below shows how to map an escape sequence (ALT+027 = Escape). The F4 key is mapped to send the text Escape 4.

View Full Size

Figure 4: Map keystroke F4 to send the text Escape 4.

Creating an Action Sequence

Follow these steps to map a series of actions to a keystroke.

1. To map an action sequence, select Action Sequence in the left pane.

2. In the right pane, click the Add button.

View Full Size

3. In the right pane, under Action category, select an action, such as Send Key, from the list.

View Full Size

4. Action parameters vary depending on the action selected. If required, you will be prompted for the needed information for each parameter to the right of the Action. Select or provide the Action parameter.

5. Repeat steps 3 and 4 for each action in the sequence until the sequence is complete.
6. Click OK.

An Example – Mapping an Escape Sequence in Reflection 2008 R1

Action sequences are commonly used to send a control character followed by string of printable characters. For example, follow these steps to map F4 to Escape 4 in a VT session.

Note: If you do not have SP1 applied to your Reflection 2008 R1 installation, you must follow the steps below to map an escape sequence.

1. To map an action sequence, select Action Sequence in the left pane.
2. Click Add.
3. In the Action category section of the screen, select Send Key from the Action list, (not from the left pane).
4. To the right of the Action list, Action parameters now displays “Key:” Select the Escape key from the Key drop-down list.
5. Click Add.
6. In the Action category section of the screen, select Send Text from the Action list, (not from the left pane).
7. To the right of the Action list, Action parameters now displays “Text to send to host:” Type 4 in the "Text to send to host" field.

The following graphic shows the Select Action dialog box mapping F4 to Escape 4:

View Full Size

8. Click OK.

9. When you are finished mapping all keys, click OK to close the Keyboard Mapper.

Troubleshooting

If you are using non-VT terminal types such as Linux Console, Wyse, SCO ANSI or BBS-ANSI, and have trouble mapping a key, contact Technical Support (http://support.attachmate.com/contact/) for the latest update,.