NET/MASTER Network Control Language (NCL) Programmer's Guide

The Standard Map $MSG
Standard and User-Defined Maps
106160 Tandem Computers Incorporated 11–5
The Standard Map
$MSG
The standard map $MSG is used by the message verbs. The message verbs—EMS*,
INT*, LOG*, and MSG*—control the flow of messages traveling to, from, and within
NonStop NET/MASTER MS. The map used by these verbs to interpret the data in an
MDO variable that contains a message is $MSG. (Section 2, “NCL Summary,”
discusses the meaning of the asterisk (*) following the letters EMS, INT, LOG, and
MSG.)
Note Some MDO variables mapped by the map $MSG may contain the NonStop NET/MASTER MS equivalent
of Subsystem Programmatic Interface (SPI) tokens. The map $SPI is used to interpret the portion of the
data in an MDO variable that contains the NonStop NET/MASTER MS equivalent of SPI tokens. The
map $SPI is discussed later in this section.
Figure 11-2 shows the structure of the map $MSG. An actual MDO variable containing
a message does not have all the elements shown in this figure. For example: if the
entire text of a message is displayed with the same attributes, the MDO variable does
not contain the FLD element; if the message does not contain SPI tokens, the MDO
variable does not contain the SPI element; if the message is not a PPO message, the
MDO variable does not contain the PPO element; and so on.
The name of the MDO variable that contains the message data depends on the name of
the verb that reads the message. This is summarized in the following table:
Verb MDO Variable Example Containing Base Color Attribute
EMSREAD &$EMS. &$EMS.MSGATTR.DISPLAY.COLOR
INTREAD &$INT. &$INT.MSGATTR.DISPLAY.COLOR
LOGREAD &$LOG. &$LOG.MSGATTR.DISPLAY.COLOR
MSGREAD &$MSG. &$MSG.MSGATTR.DISPLAY.COLOR
The MDO variables listed in the preceding table are automatically created by the
EMSREAD, INTREAD, LOGREAD, and MSGREAD verbs. You do not have to create
these variables using the ASSIGN verb before reading a message.
Data is automatically assigned to these variables when a verb reads a message. You
can refer to element, group, and field names to obtain the contents of a message as the
following examples show:
&$EMS.MSGATTR.DISPLAY.COLOR /* Base COLOR field */
&$EMS.MSGATTR.DISPLAY.HLITE /* Base HLITE field */
&$EMS.MSGATTR.DISPLAY.INTENS /* Base INTENS field */
&$INT.MSGATTR.FLD{1}.OFFSET /* 1st OFFSET field */
&$INT.MSGATTR.FLD{1}.LENGTH /* 1st LENGTH field */
&$INT.MSGATTR.FLD{1}.COLOR /* 1st COLOR field */
&$INT.MSGATTR.FLD{1}.HLITE /* 1st HLITE field */
&$INT.MSGATTR.FLD{1}.INTENS /* 1st INTENS field */
The message verbs are discussed in more detail in Section 16, “Environments and
Command Processing,” and Section 17, “Developing System-Level NCL Procedures.”