B. Defining Function and Control Keys : Mapping File Syntax : Mapping Statements
 
Share this page                  
Mapping Statements
A mapping statement has the following syntax:
mapping_object = pfN|controlX|uparrow|downarrow|leftarrow|rightarrow [(label)]
mapping_object
Specifies a menu item, FRS command, or FRS key, designated through mapping.
pfN
Designates a function key. N must be in the range 1 to 40. (Note that the maximum number of definable keys set in the termcap file for your terminal can be less than 40. You must raise this limit to set additional keys.)
controlX
Designates a control key. X can be any single letter of the alphabet, or the designations del to indicate the Delete key as in controldel or esc to indicate the Escape key as in controlesc (if the Escape key is not reserved on your terminal). This guide designates control keys in user instructions as Control‑X, where X is the key used in combination with the Control key.
On most keyboards, pressing Control‑I is equivalent to pressing the Tab key, and pressing Control‑M is equivalent to pressing the Enter key in Windows or the Return key in UNIX or VMS.
Uparrow, Downarrow, Leftarrow, Rightarrow
Designates the up arrow, down arrow, left arrow, and right arrow keys.
label
Designates any alphanumeric string. It appears in place of the default label for a menu item. It also appears in the Keys operation of the Help facility.
A single mapping object cannot be mapped to be invoked by pressing either two different function, control, or arrow keys on the same screen. Each function or control key (and each arrow key in UNIX or VMS) can correspond to only a single mapping object at a time. If you map one mapping object to more than one physical key, or multiple mapping objects to the same key, one mapping overrides the others.
If the conflicting mappings occur within the same mapping file, only the first mapping within the file is considered to be valid. If the conflict occurs between different mapping files, the key mapping in the file of higher precedence overrides the other mappings. For a discussion of precedence in key mapping, see the Key Mapping Overview section specific to your environment.
The appearance of an exception to this rule occurs when both of the following conditions exist:
A menu item is mapped to a function or control key (or arrow key in UNIX or VMS) by the menu item's position
A FRS key that has the same function as the menu item is mapped to a different function or control key (or arrow key in UNIX or VMS)
This only appears to be an exception, because the two mapping objects (the menu item and the FRS key) perform the same function although they are actually separate FRS objects that are mapped to two different function, control, or arrow keys.