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.