NET/MASTER Network Control Language (NCL) Reference Manual

LOGREAD
Verbs
106126 Tandem Computers Incorporated 3–125
SET
specifies that the message text is not to be transferred into variables. The
LOGREAD statement returns only the message profile.
If SET is not specified, use other LOGREAD operands to control the way a
message is handled. The absence of any operands implies SET, which is the
default.
WAIT
specifies what NCL is to do if no message has arrived.
NO
specifies that if no message has arrived, control is to return to the LOGPROC
NCL process immediately, with all specified variables (if any) set to null
values.
YES
specifies that the LOGPROC NCL process is to be suspended until a message
arrives.
nnnnn
specifies the number of seconds that the LOGPROC NCL process is to be
suspended, while waiting for a message to arrive. After this time interval,
control is returned to the NCL process. WAIT=0 (zero) has the same effect as
WAIT=NO. The &SYS.RETCODE system variable is set to 12 if the time interval
expires and no message has arrived; otherwise, it is 0 (zero).
Considerations
Messages generated from within, or by, the LOGPROC NCL procedure itself are
not seen by the LOGREAD verb. Such messages are displayed at Monitor-class
terminals and are prefixed by an “L” rather than the standard “M” for monitor
messages. If these messages are to be logged, they go directly to the log.
If a new MDO is created by using the operand MDO=& mdo-name , &SYS.VARCNT
is set to 1.
NCL sets the &SYS.LOOPCTL system variable to 1000 each time the LOGREAD
verb is executed, unless the user explicitly sets it to 0 (zero).
The LOGREAD verb creates the MDO variable with the &$LOG. stem. This
variable (mapped by $MSG) contains the profile of the message—the text and all
of its attributes. See Section 7, “Message Profile Variables,” for a complete list of
these variables. The message profile (which includes attributes such as color,
highlighting, and source information) provides a complete description of all the
LOG message attributes, in addition to the message text. For more information on
MDO variables, refer to the NonStop NET/MASTER NCL Programmer's Guide.