NET/MASTER Network Control Language (NCL) Reference Manual

MSGREAD
Verbs
3–136 106126 Tandem Computers Incorporated
For the interpretation of Message Profile Variables contained in MDOs, see
Section 7, “Message Profile Variables.”
For more information on the MSGREAD verb, refer to the NonStop NET/MASTER
NCL Programmer's Guide, which also contains examples of the use of the
MSGREAD verb.
Examples
In the following example, a message is read, and the enclosed MDO is placed in the
variables &A through &J:
MSGREAD VARS=(&A, &B, &D, &E, &F, &G, &H, &I, &J)
In the following example, a message is read, and the text is placed into automatically
generated variables in the range &4 through &55. Excess variables, which occur if you
specify a range that exceeds the number of words or segments in the message, are
given no value—they are set to the null string:
MSGREAD ARGS RANGE=(4,55)
The following example reads a message and places the enclosed MDO into a newly
created MDO variable &XXXXMDO.:
MSGREAD MDO=&XXXXMDO. WAIT=YES
In the preceding example, it is assumed that a message has been previously created by
using the WRITE verb in the following manner:
…
ASSIGN MDO=&USERMDO. MAP=$MSG
&USERMDO.TEXT= X Y Z
WRITE MDO=&USERMDO. DATA=A B C
The result, after executing the preceding two code segments in two separately
executing NCL procedures, is that the variable &XXXXMDO.TEXT contains the string
“X Y Z”, the variable &$MSG.TEXT contains the string “A B C,” and the map name is
$MSG.