NET/MASTER Network Control Language (NCL) Reference Manual

Frequently Occurring Operands
Verbs
3–4 106126 Tandem Computers Incorporated
Frequently Occurring
Operands
Five operands are used by many verbs: ARGS, PARSE, RANGE, SEGMENT, and
VARS. For your convenience and to avoid unnecessary repetition, this subsection
describes common usage. Individual variations in usage appear in the description of
the relevant verb. See also Section 11, “Verb Syntax and Variable Access Methods,” for
more information on these operands. The ALIAS panel control statement also uses
VARS and RANGE.
The description of the five operands follows:
ARGS
specifies a range of variables from &
start
through &
end
, where
start
and
end
are positive integers that indicate the numeric suffixes of the first and last
variables, respectively. You can use RANGE, described later, to designate the start
and end numbers of the range. By default, ARGS specifies a range of variables
from &1 through &64.
PARSE
specifies the type of parsing NCL performs on the message. The setting of PARSE
affects the value for SEGMENT, described later.
NO
specifies that the text is to be treated as a string of characters and placed in the
variables based on the size of SEGMENT.
YES
specifies that the message is to be split into separate words, delimited by
spaces, and each word is to be placed in a variable.
RANGE=(
start
,
end
)
determines the range of variables specified by ARGS or VARS. Both
start
and
end
are positive integers, the end value must be greater than or equal to the start
value. Omitting this operand is equivalent to specifying RANGE=(1,64). When
this operand is present, the start and end values must be in the range 1 through
65535. The maximum range difference is 64 if the RNGLIM operand of the
CONTROL verb is specified.
SEGMENT=
n
specifies the amount of data (in bytes) to be put into the variables specified. You
can specify a value for
n
from 1 through 32000. The default is affected by the
setting of the PARSE operand in verbs that use both PARSE and SEGMENT. If
you specify PARSE=YES, the default value for SEGMENT is 32000. If you specify
PARSE=NO, or if PARSE is not available with this operand, the default value for
SEGMENT is 256.