NET/MASTER Network Control Language (NCL) Reference Manual

&SYS.NATIVE.INKEY
System Variables
106126 Tandem Computers Incorporated 5–57
&SYS.NATIVE.INKEY The &SYS.NATIVE.INKEY system variable contains the natural (untranslated) name
of the function key that terminates user input in the last displayed panel.
&SYS.NATIVE.INKEY is from two through four characters long: for example, F1 or
SF16.
If a synchronous panel has been defined with the #OPT panel control statement and a
time interval (specified on the INWAIT operand) has elapsed, &SYS.INKEY is set to
null.
&SYS.NATIVE.INKEY
Considerations
Take care when using IF statements that refer to &SYS.NATIVE.INKEY; if this
variable has a null value, NCL causes a syntax error.
See also &SYS.INKEY, which contains the translated name of the last function key
that terminated user input in the last displayed panel.
Example
The following example shows a panel definition named PANEX01. An NCL
procedure called SHOW_KEYS is listed. This procedure displays the &SYS.INKEY
and &SYS.NATIVE.INKEY system variables after displaying the panel:
#NOTE
#NOTE THIS IMPLEMENTS PANEX01
#NOTE
% ------------------- &SYS.PANEL.ID -------------------------
+
+ PANEL OK Y or N ===>_pnlyn
+ Enter Y if you like this panel display
+ or N if you don’t
+ &INVAR
SHOW_KEYS: PROCEDURE
PANEL NAME=PANEX01
SAY “&SYS.INKEY = “ &SYS.INKEY
SAY “&SYS.NATIVE.INKEY = “ &SYS.NATIVE.INKEY
END SHOW_KEYS
In the previous example, if the user pressed the function key F7, the
&SYS.NATIVE.INKEY system variable would contain the value F7, and &SYS.INKEY
would contain PF07. The latter is the translated value of the natural or native key
used.