&EMSG STATEMENT                                                  EXEC statement

Use the &EMSG control statement to display a line of tokens as a CMS error
message.  The format of the &EMSG control statement is:
+-----------+-----------------------------------------------------------------+
| &EMSG     | mmmnnns [tok1 ...  [tokn]]                                      |
+-----------+-----------------------------------------------------------------+
where:

mmmnnn   is a six-character identification you may supply for the error
         message.  Standard CMS messages are coded using a three-character
         module code (mmm) and a three-character message number (nnn).

s        indicates the severity code. The following codes qualify the message
         for error message editing:
            Code    Message Type
            I       Information
            E       Error
            W       Warning
            R       Response

tok1 ... [tokn]
         is the text of the message to be displayed.


Usage Notes:

1.  When the severity code is I, E, or W, the message is displayed in
    accordance with the CP EMSG setting (ON, OFF, CODE, or TEXT).  You can
    change the setting with the CP SET command.

2.  When an &EMSG code is displayed, it is prefixed with DMS.  For example, the
    statement:
       &EMSG ERROR1E Houston, we have a problem!
    displays as follows when the EMSG setting is ON:
       DMSERROR1E Houston, we have a problem!

3.  To display an error message with unsubstituted data, or to display a line
    with words of more than eight characters, use the &BEGEMSG control
    statement.