SETKBDMAP (Set Keyboard Map)

SETKBDMAP Command syntax diagram

 

Purpose

The Set Keyboard Map (SETKBDMAP) command allows the user to override the PA (Program Attention) and PF (Program Function) key assignment defaults provided by the iSeries 400.

This command assigns the specified F-to-PF map to the device where the command was entered (if it is a 3270 display station device) or to the 3270 display station specified if the user has authority to that device.

 

Optional Parameters

DEV
Specifies a valid 3270 display station that is assigned this keyboard mapping function.

*REQUESTER: This mapping is assigned to the device where the command is entered.

device-name: Specify a device other than the device named in the *REQUESTER value. The user must have allocation authority to the specified device. In a program environment, the user should either acquire or allocate the specified device before entering this command.

Key Sequence
Each valid key or key sequence is a separate parameter which, except for restrictions noted below, may be assigned any function. If the user does not specify a function for a particular key or key sequence, the default value becomes the function for that key or key sequence. Following is a list of functions and restrictions:
*ATTN
Attention
*BCKSPC
Record Backspace
*CLEAR
Clear Screen
*DOWN
Roll Down
*DSPATR
Display Imbedded Attributes
*F1-*F24
F1 through F24 Function Keys
*HELP
5250 Help
*HLP3270
3270 Help Text (Display Active Keyboard Map)
*NONE
No Assignment
*PRINT
Print Screen
*RESET
Error reset
*SAME
No Change
*SYSREQ
System Request
*TEST
Test Request
*UP
Roll up

 

Notes

  1. *HELP, *HLP3270, and *RESET must be assigned to PF1 through PF12, PA1/PF1 through PF12, or PA2/PF1 through PF12. Because these functions are required for 3270 display station device support to function properly, and not all keyboards have 24 PF keys, *HELP, *HLP3270, or *RESET may not be assigned to keys PF13 through PF24, unless that function is also assigned to PF1 through PF12, PA1/PF1 through PF12, or PA2/PF1 through PF12.
  2. It is recommended that *F1 and *SYSREQ be assigned to PF1 through PF12, PA1/PF1 through PF12, or PA2/PF1 through PF12.
  3. The value *ATTN cannot be explicitly assigned to a 3270 remote attach display station. If the default value *ATTN is taken, the value *NONE is substituted. However, if the value *ATTN is explicitly chosen, a diagnostic message is sent.

Example for SETKBDMAP

SETKBDMAP   PF1(*F1)  PF2(*F2)  PF3(*F3)
  PF4(*F4)  PF5(*HLP3270)  PF9(*HELP)

This command reassigns the keyboard primarily for an application that makes frequent use of the 5250 CF keys F1, F2, F3, F4. All other PF key sequences are set to the default shown on the command prompt. The above command is started in the program that started the application (thus tailoring the display station to whatever application is run).

Error messages for SETKBDMAP

*ESCAPE Messages

CPF8701
Specified device &1 not a 3270 device type.
CPF8702
&1 function key not correctly defined.
CPF8703
Device &1 not ready.