NET/MASTER Network Control Language (NCL) Reference Manual

WRITE
Verbs
3–228 106126 Tandem Computers Incorporated
MSGCODE=
xx
contains a two-character hexadecimal message delivery code. The message is
received only by those OCS users whose user profile message code gives a
nonzero result after a Boolean AND operation with the value specified by
xx
.
This facility provides the installation with the means to develop and control
delivery of messages in a variety of classes designed to meet the needs of the
installation. A value of 0 (zero) is a special case and is the default; it allows all
users to receive the message, regardless of their user profile message code.
NCLID=
nclid
specifies that the message is to be delivered to the NCL process identified by the
NCLID operand. The TYPE operand specifies the type of queue to which the
message is to be delivered. The target NCL process must be executing using the
same USERID as the NCL procedure that issues this version of the WRITE verb,
unless the SYSPARMS NCLXUSER option is YES. On completion, the
&SYS.RETCODE system variable is set as follows:
Return
Code
Description
0 Message queued to target NCL process.
16 Specified NCL process is not executing, or is owned by a different user.
NRD
specifies the message type of the non-roll-delete (NRD) message.
NO
specifies that the message is a standard message (not a NRD message).
OPER
specifies that the message is classified as a NRD message but no DOM ID is
assigned to it. The message is never deleted by any means except the NRD
cursor deletion method—even when the originating NCL process terminates.
See the NRDDEL verb in this section for a definition of the NRD cursor
deletion method.
YES
specifies that the message is assigned a delete operator message identifier
(DOM ID). The value of the DOM ID is returned on completion of the WRITE
in the &SYS.DOM.ID system variable. If the message is to be deleted at some
future time, this DOM ID must be specified as an operand on a NRDDEL
statement. The NRD message is also deleted when the NCL process that
issued the WRITE statement terminates.