NET/MASTER Network Control Language (NCL) Reference Manual

WRITE
Verbs
3–230 106126 Tandem Computers Incorporated
DATA= rest-of-statement
specifies the text of the message you want to display at the terminal and/or write
to the activity log. If the message contains references to variables, NCL performs
normal variable substitution prior to sending the message. Text can be in
uppercase and lowercase. If no text is supplied, a blank line is displayed or
written. DATA can be specified only as the last keyword of the statement because
the data string is regarded as being everything to the right of DATA=, up to the end
of the WRITE statement.
Note DATA must be the last keyword in this verb.
Considerations
NCL truncates any output from the WRITE verb after 2047 characters.
Any undisplayable characters are replaced by a period (.). On Tandem 6530 or
compatible terminals only, null characters (x’00’) are an exception; they are
replaced by blanks.
Messages written using either WRITE or WRITE INTENS=HIGH are not logged to
the activity log, unless the statement is executed in an NCL process that is
associated with an internal virtual user ID. Messages written using WRITE
ALARM=YES and WRITE MON=YES are always logged unless the LOG operand
specifies NO.
Messages written from the EMSPROC NCL procedure, regardless of the means
used to generate the message, are sent to the terminals of all OCS users who have
monitor status. WRITE, WRITE INTENS=HIGH, or WRITE ALARM=YES
function as specified, but the generated message is sent to the terminals of all OCS
users who have monitor status, preceded by an “E” to indicate that they come
from the EMSP region. Similarly, messages written from the LOGPROC
procedure are preceded by an “L” to indicate that they come from the LOGP
region.
See the SAY core statement in Section 2, “Core Statements.” The SAY core
statement writes a message that is delivered to the execution environment of an
NCL process.
See also INTREAD, LOGREAD, and MSGREAD. These verbs are able to process
messages sent by using the WRITE verb.
Examples
The following example specifies that you want the text “TEST MESSAGE” to be
written to your OCS window. Default operands are to be used for the display of this
message:
WRITE DATA=TEST MESSAGE