NET/MASTER Network Control Language (NCL) Reference Manual
LOGREAD
Verbs
106126 Tandem Computers Incorporated 3–123
LOGREAD The LOGREAD verb reads the next NonStop NET/MASTER MS activity log message.
This verb must be used within a LOGPROC NCL procedure. It requests that
processing of the LOGPROC NCL process be suspended until the log message is
available. You can conveniently place the LOGREAD verb in a DO loop within the
LOGPROC NCL procedure. Each message can then be inspected and appropriate
action can be taken.
The LOGREAD verb can split the incoming log message into variables in a variety of
forms, to simplify the analysis and interpretation of the message by the LOGPROC
procedure logic. On completion of the LOGREAD verb, the &SYS.VARCNT system
variable is set to the number of variables created or modified by the operation. When
the LOGREAD verb reads a message, it automatically places the text and the attributes
of the message, such as color and intensity, into an MDO variable beginning with the
&$LOG. stem. The LOGREAD verb can also store an enclosed MDO (for example,
from the WRITE verb) into a specified MDO variable.
If a LOGREAD verb is used within an NCL procedure other than a LOGPROC NCL
procedure, a run-time error is issued.
LOGREAD [ ARGS [ PARSE={ NO | YES } ]
[ RANGE=(
start
,
end
) ]
[ SEGMENT=
n
] |
VARS={
input-vars-list
|
variable*
}
[ PARSE={ NO | YES } ]
[ RANGE=(
start
,
end
) ]
[ SEGMENT=
n
] |
MDO=&
mdo-name
|
SET ]
[ WAIT={ NO | YES |
nnnn
} ]
ARGS
specifies a range of generated variables for receiving the message. If too few
variables are specified, data is missing. Excess variables are given no value—they
are set to the null string. If the message contains an enclosed MDO mapped by
$NCL and PARSE=YES, NCL places the data in that MDO into variables, rather
than parsing the text.
PARSE
See “Frequently Occurring Operands,” at the beginning of this section, for
more information.
RANGE=(
start
,
end
)
determines the range of variables specified by the ARGS operand. See
“Frequently Occurring Operands,” at the beginning of this section, for more
information.