EMSG

Notes:

¹ If text is not specified, a blank message is displayed.

Purpose

The EMSG subcommand displays a message at the terminal and sounds the alarm. You can use it in macros and modules that interface with XEDIT and whose messages follow the rules for z/VM messages (see the appropriate messages book for details). The severity of the message determines whether the alarm is sounded.

Operands

text

is the text of the message to be displayed. If text is not specified, a blank message is displayed.

mmmnnns

mmmnnnns

is the message identification.

mmm

are three characters indicating which macro or module generated the message.

nnn or nnnn

is the three- or four-digit message number. You can use it to find additional information in the appropriate messages book.

s

indicates the severity and is one of the following:

R - response

E - error

I - information

S - severe error

W - warning

T - terminal (irrecoverable) error

With a severity of R, I, or W, the alarm is not sounded. With a severity of E, S, or T, the alarm is sounded when the message is displayed.

The message is prefixed by DMS before being displayed.

Usage Notes

The SOS ALARM subcommand can sound the alarm without displaying any message.
Messages are displayed according to the SET MSGMODE setting (ON or OFF).
The message identification is processed according to the CP EMSG setting and CMS processing by severity (see z/VM: CP Commands and Utilities Reference). However, messages with the severity code of R also respect the CP EMSG setting. In addition, the message is processed according to the SET MSGMODE setting (LONG or SHORT).
The message identification must not contain imbedded blanks. It must be preceded by only one blank delimiter.
The EMSG subcommand can also display messages on a typewriter terminal.
If you are in a GUI environment, messages that do not fit in the message area are displayed in the XEDIT Messages window.

Responses

The message is displayed in the message area of the logical screen.

Messages and Return Codes

This subcommand issues no messages, but it issues return codes as follows:

0: Normal
5: Invalid operand
6: Subcommand rejected in the profile due to LOAD error, or QUIT subcommand has been issued in a macro called from the last file in the ring