NET/MASTER Network Control Language (NCL) Reference Manual

EMSSEND
Verbs
3–66 106126 Tandem Computers Incorporated
Considerations
The &SYS.FDBK system variable is set after execution with the following values:
Return Code Meaning
0 The message was sent successfully.
8 The specified link or domain was not found.
12 The ISR link was not enabled for solicited EMS traffic, or an attempt was
made to send to a system other than a NonStop NET/MASTER MS system.
16 Shortage of storage—message not sent.
20 ISR Queue overflow—message not sent.
28 The EMS collector (for either the local or the remote system) was not started,
insufficient tokens were supplied, or an SPI error was reported from EMS
operating system procedures.
The EMSSEND verb, as distinct from EMSALERT, passes its data through the EMS
collector (default $0).
See EMSALERT in this section for processing of local system EMS messages.
See also EMSALERT, EMSDEL, EMSCONT, and EMSREAD.
For more information on the Event Management Service (EMS) verbs, refer to the
NonStop NET/MASTER NCL Programmer's Guide, which also contains examples of
how to use these verbs.
Examples
The following example sends the text “This is a test” to the link TEST4:
EMSSEND TEXT=This is a test LINK=TEST4,
SSID=USER.50.50,
EVENTNUM=23
The following example is a complete NCL procedure (named SENDEMS) that sends a
message from an MDO variable &ABC.. It also includes a valid SSID and an event
number that must be present. The text of the message is “Hello world from
&SYS.USER.ID.” This message is an SPI type message:
SENDEMS: PROCEDURE
/* Sends a message to the EMS collector */
SAY "Sending a message to the EMS collector"
ASSIGN MDO=&ABC. MAP=$MSG
&ABC.SPI.TANDEM.ZSPI_TKN_SSID = TANDEM.NNM.D30
&ABC.SPI.TANDEM.ZEMS_TKN_SUBJECT_MARK = "ZEMS_TKN_TEXT"
&ABC.SPI.TANDEM.ZEMS_TKN_TEXT =,
"Hello world from " &SYS.USER.ID
&ABC.SPI.TANDEM.ZEMS_TKN_EVENTNUMBER.# = 9999
EMSSEND MDO=&ABC.
END SENDEMS