Previous Topic: How to Map a Function Key to the Exit Key Defined for a E107 ApplicationNext Topic: Configuring Distributed Processing for the NonStop Server


How to Map Various Keyboard Keys to Specific Keys Defined for a NonStop Application

The IT lets you map the function keys on a keyboard to the function keys defined for the application through a Keyboard Mapping Table. The Keyboard Mapping Table lets you map 42 possible 6530 function keys to twenty-nine 3270 function keys supported by CA Gen. You can map more than one 6530 function key to the same 3270 function key.

If the 6530 function key is not used by the application, then set its map to 0 or set it to some other 3270 function key that is not used. Unmapped 6530 function keys (map entries that are 0) will simply unlock the keyboard and wait for you to press a mapped 6530 function key.

The Keyboard Mapping Table can use any of the following function keys:

The Keyboard Mapping Table is shipped with the 16 function key, Keyboard Mapping Table enabled.

More information:

How to Use 12 Function Key Keyboard Mapping Table

How to Use 12 Function Key Keyboard Mapping Table

Follow these steps:

  1. Remove the comment character (* or --) from lines corresponding to the second set of maps (KEYBOARD-MAP or fkey^map).
  2. Add the comment character (* or --) to all lines corresponding to the first set of maps (KEYBOARD-MAP or fkey^map).

Map 6530 Devices Emulating 3270 Devices

There is only one keyboard mapping scheme for 6530 devices emulating 3270 devices. This is shown in the files T3270NS and T3270ES. You can find these files in the subvolume where the IT is located.

For existing applications that use the T3270NS or T3270ES requester, you must edit the call to IEFREQ (in the Procedure Division) to add the parameter KEYBOARD-MAP.

Following is the format of the call command:

CALL iefreq
   USING context-session, configuration-parameters, error-link, Keyboard-map
   ON ERROR PERFORM 9999-Exit

Map 6530 Devices to Non-TCP Requesters

To map 6530 devices to non-TCP requesters, use the files NTCPR1S or NTCPR2S supplied with the IT as a template for non-TCP requesters. Edit this file by removing the comment character in the section of the Keyboard Mapping Table that is applicable.

Note: Only one keyboard configuration can be supported per requester.

Map 6530 Devices to TCP Requesters

You can use T6530NS or T6530ES files to map 6530 devices to TCP requesters. You can find these files in the subvolume where the IT is located as templates for TCP requesters. You can change the mapping to suit a particular keyboard-application combination.

The following is a sample T6530NS Keyboard Mapping Table, which illustrates standard mapping configurations for a 6530 keyboard.

* 6530 Function Key Table Offset

* F1-F16 1-16

* SF1-SF16 17-32

* Roll Down (Alt-down-arrow) 33

* Roll Up (Alt-up-arrow) 34

* Page Down (Next Page) 35

* Page Up (Prev Page) 36

* Enter 37

* Shift Roll Down (Alt-shift-down-arrow) 38

* Shift Roll Up (Alt-shift-up-arrow) 39

* Shift Page Down (Shift Next Page) 40

* Shift Page Up (Shift Prev Page) 41

* Shift Enter 42

*

* 3270 Function Key Map Value

* UNMAPPED 0

* PF1-PF24 1-24

* PA1 25

* PA2 26

* PA3 27

* CLEAR 28

* ENTER 29

*

* This is the Current IEF Keyboard Map. There are 42 Entries.

* THERE MUST be 42 Entries!!!!

*

* 6530 Function Key 3270 Function Key

*

* F1-F16 PF1-PF16

* SF1-SF3 PA1-PA3

* SF7-SF14 PF17-PF24

* SF15 0 (UNMAPPED)

* SF16 0 (UNMAPPED)

* Roll Down (Alt-down-arrow) 0 (UNMAPPED)

* Roll Up (Alt-up-arrow) 0 (UNMAPPED)

* Page Down (Next Page) 0 (UNMAPPED)

* Page Up (Prev Page) CLEAR

* Enter ENTER

* Shift Roll Down (Alt-shift-down-arrow) 0 (UNMAPPED)

* Shift Roll Up (Alt-shift-up-arrow) 0 (UNMAPPED)

* Shift Page Down (Shift Next Page) 0 (UNMAPPED)

* Shift Page Up (Shift Prev Page) 0 (UNMAPPED)

* Shift Enter 0 (UNMAPPED)

*

*

01 KEYBOARD-MAP.

* F1 THRU F16 (1-16)

03 FILLER PIC 9(4) COMP VALUE 1.

03 FILLER PIC 9(4) COMP VALUE 2.

03 FILLER PIC 9(4) COMP VALUE 3.

03 FILLER PIC 9(4) COMP VALUE 4.

03 FILLER PIC 9(4) COMP VALUE 5.

03 FILLER PIC 9(4) COMP VALUE 6.

03 FILLER PIC 9(4) COMP VALUE 7.

03 FILLER PIC 9(4) COMP VALUE 8.

03 FILLER PIC 9(4) COMP VALUE 9.

03 FILLER PIC 9(4) COMP VALUE 10.

03 FILLER PIC 9(4) COMP VALUE 11.

03 FILLER PIC 9(4) COMP VALUE 12.

03 FILLER PIC 9(4) COMP VALUE 13.

03 FILLER PIC 9(4) COMP VALUE 14.

03 FILLER PIC 9(4) COMP VALUE 15.

03 FILLER PIC 9(4) COMP VALUE 16.

* SF1 THRU SF16 (17-32)

03 FILLER PIC 9(4) COMP VALUE 25.

03 FILLER PIC 9(4) COMP VALUE 26.

03 FILLER PIC 9(4) COMP VALUE 27.

03 FILLER PIC 9(4) COMP VALUE 0.

03 FILLER PIC 9(4) COMP VALUE 0.

03 FILLER PIC 9(4) COMP VALUE 0.

03 FILLER PIC 9(4) COMP VALUE 17.

03 FILLER PIC 9(4) COMP VALUE 18.

03 FILLER PIC 9(4) COMP VALUE 19.

03 FILLER PIC 9(4) COMP VALUE 20.

03 FILLER PIC 9(4) COMP VALUE 21.

03 FILLER PIC 9(4) COMP VALUE 22.

03 FILLER PIC 9(4) COMP VALUE 23.

03 FILLER PIC 9(4) COMP VALUE 24.

03 FILLER PIC 9(4) COMP VALUE 0.

03 FILLER PIC 9(4) COMP VALUE 0.

* ROLL DOWN OR ALT-DOWN ARROW (33)

03 FILLER PIC 9(4) COMP VALUE 0.

* ROLL UP OR ALT-UP ARROW (34)

03 FILLER PIC 9(4) COMP VALUE 0.

* PAGE DOWN OR NEXT-PAGE (35)

03 FILLER PIC 9(4) COMP VALUE 0.

* PAGE UP OR PREV-PAGE (36)

03 FILLER PIC 9(4) COMP VALUE 28.

* ENTER (37)

03 FILLER PIC 9(4) COMP VALUE 29.

* SHIFT ROLL DOWN OR ALT-SHIFT-DOWN ARROW (38)

03 FILLER PIC 9(4) COMP VALUE 0.

* SHIFT ROLL UP OR ALT-SHIFT-UP ARROW (39)

03 FILLER PIC 9(4) COMP VALUE 0.

* SHIFT PAGE DOWN OR SHIFT NEXT-PAGE (40)

03 FILLER PIC 9(4) COMP VALUE 0.

* SHIFT PAGE UP OR SHIFT PREV-PAGE (41)

03 FILLER PIC 9(4) COMP VALUE 0.

* SHIFT ENTER (42)

03 FILLER PIC 9(4) COMP VALUE 0.

*

* Alternate Keyboard Mapping (Similar to EM3270)

*

* To use this Keyboard Mapping Table remove * from lines

* corresponding to KEYBOARD-MAP below. Then add an * to all

* lines corresponding to KEYBOARD-MAP above.

*

* 6530 Function Key 3270 Function Key

*

* F1-F12 PF1-PF12

* F13 PA1

* F14 PA2

* F15 PA3

* F16 ENTER

* SF1-SF12 PF13-PF24

* SF13 0 (UNMAPPED)

* SF14 CLEAR

* SF15 0 (UNMAPPED)

* SF16 0 (UNMAPPED)

* Roll Down (Alt-down-arrow) 0 (UNMAPPED)

* Roll Up (Alt-up-arrow) 0 (UNMAPPED)

* Page Down (Next Page) 0 (UNMAPPED)

* Page Up (Prev Page) 0 (UNMAPPED)

* Enter 0 (UNMAPPED)

* Shift Roll Down (Alt-shift-down-arrow) 0 (UNMAPPED)

* Shift Roll Up (Alt-shift-up-arrow) 0 (UNMAPPED)

* Shift Page Down (Shift Next Page) 0 (UNMAPPED)

* Shift Page Up (Shift Prev Page) 0 (UNMAPPED)

* Shift Enter 0 (UNMAPPED)

*

* 01 KEYBOARD-MAP.

** F1 THRU F16 (1-16)

* 03 FILLER PIC 9(4) COMP VALUE 1.

* 03 FILLER PIC 9(4) COMP VALUE 2.

* 03 FILLER PIC 9(4) COMP VALUE 3.

* 03 FILLER PIC 9(4) COMP VALUE 4.

* 03 FILLER PIC 9(4) COMP VALUE 5.

* 03 FILLER PIC 9(4) COMP VALUE 6.

* 03 FILLER PIC 9(4) COMP VALUE 7.

* 03 FILLER PIC 9(4) COMP VALUE 8.

* 03 FILLER PIC 9(4) COMP VALUE 9.

* 03 FILLER PIC 9(4) COMP VALUE 10.

* 03 FILLER PIC 9(4) COMP VALUE 11.

* 03 FILLER PIC 9(4) COMP VALUE 12.

* 03 FILLER PIC 9(4) COMP VALUE 25.

* 03 FILLER PIC 9(4) COMP VALUE 26.

* 03 FILLER PIC 9(4) COMP VALUE 27.

* 03 FILLER PIC 9(4) COMP VALUE 29.

** SF1 THRU SF16 (17-32)

* 03 FILLER PIC 9(4) COMP VALUE 13.

* 03 FILLER PIC 9(4) COMP VALUE 14.

* 03 FILLER PIC 9(4) COMP VALUE 15.

* 03 FILLER PIC 9(4) COMP VALUE 16.

* 03 FILLER PIC 9(4) COMP VALUE 17.

* 03 FILLER PIC 9(4) COMP VALUE 18.

* 03 FILLER PIC 9(4) COMP VALUE 19.

* 03 FILLER PIC 9(4) COMP VALUE 20.

* 03 FILLER PIC 9(4) COMP VALUE 21.

* 03 FILLER PIC 9(4) COMP VALUE 22.

* 03 FILLER PIC 9(4) COMP VALUE 23.

* 03 FILLER PIC 9(4) COMP VALUE 24.

* 03 FILLER PIC 9(4) COMP VALUE 0.

* 03 FILLER PIC 9(4) COMP VALUE 28.

* 03 FILLER PIC 9(4) COMP VALUE 0.

* 03 FILLER PIC 9(4) COMP VALUE 0.

** ROLL DOWN OR ALT-DOWN ARROW (33)

* 03 FILLER PIC 9(4) COMP VALUE 0.

** ROLL UP OR ALT-UP ARROW (34)

* 03 FILLER PIC 9(4) COMP VALUE 0.

** PAGE DOWN OR NEXT-PAGE (35)

* 03 FILLER PIC 9(4) COMP VALUE 0.

** PAGE UP OR PREV-PAGE (36)

* 03 FILLER PIC 9(4) COMP VALUE 0.

** ENTER (37)

* 03 FILLER PIC 9(4) COMP VALUE 0.

** SHIFT ROLL DOWN OR ALT-SHIFT-DOWN ARROW (38)

* 03 FILLER PIC 9(4) COMP VALUE 0.

** SHIFT ROLL UP OR ALT-SHIFT-UP ARROW (39)

* 03 FILLER PIC 9(4) COMP VALUE 0.

** SHIFT PAGE DOWN OR SHIFT NEXT-PAGE (40)

* 03 FILLER PIC 9(4) COMP VALUE 0.

** SHIFT PAGE UP OR SHIFT PREV-PAGE (41)

* 03 FILLER PIC 9(4) COMP VALUE 0.

** SHIFT ENTER (42)

* 03 FILLER PIC 9(4) COMP VALUE 0.

*******************************************************************************