NET/MASTER Network Control Language (NCL) Reference Manual

EMSREAD
Verbs
3–60 106126 Tandem Computers Incorporated
EMSREAD The EMSREAD verb reads the next Event Management Service (EMS) message. An
EMSPROC NCL procedure uses the EMSREAD verb to receive the next available EMS
message. EMSREAD requests that processing of the EMSPROC procedure be
suspended until the message is available.
If an EMSREAD verb is used within an NCL procedure other than an EMSPROC NCL
procedure, a run-time error is issued.
The EMSREAD verb can split the text of the incoming EMS message into variables in a
variety of forms, to simplify the analysis and interpretation of the message by the
EMSPROC NCL procedure logic.
You can conveniently place the EMSREAD verb in a DO loop within the EMSPROC
NCL procedure. Each message can then be inspected and appropriate action taken.
When EMSPROC terminates for any reason, standard EMS processing is resumed. No
EMS messages are lost.
EMSREAD [ ARGS [ PARSE={ NO | YES } ]
[ RANGE=( start , end ) ]
[ SEGMENT= n ] |
VARS={ input-vars-list | variable* }
[ PARSE={ NO | YES } ]
[ RANGE=( start , end ) ]
[ SEGMENT= n ] |
SET ]
[ WAIT={ NO | YES | nnnnn } ]
ARGS
specifies a range of generated variables to contain the message. See “Frequently
Occurring Operands,” at the beginning of this section, for more information. If
insufficient variables are provided, some data is not available. Excess variables are
given no value—they are set to the null string.
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.