NET/MASTER Network Control Language (NCL) Reference Manual
INTREAD
Verbs
3–110 106126 Tandem Computers Incorporated
INTREAD The INTREAD verb retrieves the next message from the dependent response or
request queue associated with an NCL process. The dependent response queue holds
the results of NonStop NET/MASTER MS commands executed by an NCL process
using the INTCMD verb. The dependent request queue holds messages sent from
another NCL process by using the WRITE verb, the INTQ command, or an OCS
operator using the INTQ command.
Commands and NCL procedures issued by an INTCMD verb execute in the
dependent processing environment of the issuing process. The results of the
command are returned to the dependent response queue associated with the
dependent environment. The INTREAD verb can be used by the originating NCL
procedure to retrieve the command results, line by line, from the response queue.
The INTQ command may also be used to place messages from other processes, or from
the OCS command line, onto either the dependent response queue or the dependent
request queue of any NCL process. The INTREAD verb is used to read these messages
as well. As a result, the NCL procedure can be written to correlate messages that
appear on the dependent queues and to react intelligently to those messages.
When the INTREAD verb reads a message, it creates an MDO variable (mapped by
$MSG) with the stem &$INT.. The INTREAD verb places the text and the attributes of
the message, such as color and intensity, into the MDO. INTREAD has the option of
placing the text (but not the attributes of the message) into ordinary variables by using
keywords such as ARGS, VARS, RANGE, SEGMENT, and PARSE.
This $INT. MDO variable contains the profile of the message—the text and all of its
attributes. See Section 7, “Message Profile Variables,” for a complete list of message
profile variables. The INTREAD verb can also store an enclosed MDO (for example,
from the WRITE verb) into a specified MDO variable.
INTREAD [ 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 ]
[ TYPE={ ANY | REQ | RESP } ]
[ WAIT={ NO | YES |
nnnn
} ]
ARGS
specifies a range of generated variables for receiving the message. See “Frequently
Occurring Operands,” at the beginning of this section, for more information. 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