NET/MASTER Network Control Language (NCL) Reference Manual

&SYS.PANEL.SKIP
System Variables
5–86 106126 Tandem Computers Incorporated
&SYS.PANEL.SKIP The &SYS.PANEL.SKIP system variable contains the next panel skip level in a panel
set (hierarchical group of panels). This variable is set because a PSKIP attribute has
been assigned to a panel input field. This variable can be assigned in an NCL
procedure. This allows direct panel skip information to be entered in the form
OPT1.OPT2.OPT3. and so on.
Each time a reference is made to &SYS.PANEL.SKIP in an NCL panel call, the current
skip level is cleared, provided that the panel being called has at least one field defined
as a skip field. After all skip levels have been cleared, NCL sets &SYS.PANEL.SKIP to
null.
When performing panel skips, only menus that do not require mandatory entry of
data can be skipped over. An attempt to skip over a menu that requires entry of one
or more data fields (other than menu selections) causes the NCL process to terminate.
By default, all fields on a panel must be of adequate length to support entry of a panel
skip request in the format =x.x. If you wish to restrict the use this facility, a panel
field can be defined with the #FLD statement PSKIP=NO operand. See Section 6,
“Panel Control Statements.”
You use &SYS.PANEL.SKIP to refer to panel skip data entered by the terminal
operator and to process it as though the actual menu entries had been entered by the
operator.
&SYS.PANEL.SKIP [ =
s
. … | = " =
s.
… "]
s. 
contains the value to be set in &SYS.PANEL.SKIP. If the optional panel skip
trigger (=) is included, then an automatic panel skip to the panel set (
s. s)
is
initiated. If you omit the equal (=) operator, the skip is from the current position
downward.
Omitting the panel skip trigger and skip data causes any current panel skip to be
cleared. The panel set
s.
is not validated at the time the &SYS.PANEL.SKIP
system variable is assigned a value. The panel set can include data of any type.
=
initiates an automatic panel skip to the panel set specified by
s. 
. If you include
the equal (=) operator, it indicates that the skip is from the top-level menu
downwards. As with any panel skip, the current NCL procedure is immediately
flushed. The skip begins as if the NonStop NET/MASTER MS primary menu is
currently displayed. Each subsequent value from
s. 
is used to determine the
next menu selection panel or function. When the final value in the set has been
processed, the panel associated with the last selection is displayed.