Retro1.org codex

&BEGEMSG STATEMENT                                               EXEC statement

Use the &BEGEMSG control statement to display one or more unscanned lines as
CMS error messages.  The list of lines to be displayed must be terminated by an
&END control statement, which must appear beginning in column 1.  The format of
the &BEGEMSG control statement is:
+-----------+-----------------------------------------------------------------+
| &BEGEMSG  | [ALL]                                                           |
+-----------+-----------------------------------------------------------------+
where:

ALL      specifies, for fixed-length EXEC files, that the entire line (to a
         maximum of 130 characters) is to be displayed.


Usage Notes:

1.  To qualify for error message editing, the first data item on each line
    following the &BEGEMSG control statement must be seven characters long, in
    the format:
       mmmnnns
    where:

    mmmnnn   is a six-character message identification you can supply for the
             error message.  Standard CMS error messages use 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       Informational
                E       Error
                W       Warning
             When the severity code is E, I, or W, the message is displayed in
             accordance with the CP EMSG setting (ON, OFF, CODE, or TEXT).  You
             can change this setting with the CP SET command.

2.  When you use the &BEGEMSG control statement to display error messages, the
    character string "DMS" is inserted in front of the seven-character message
    identification.  For example, if the EMSG setting is ON, the lines:
        &BEGEMSG
        TEST01E Houston, we have a problem!
        &END
    result in the display:
        DMSTEST01E Houston, we have a problem!

    Note:  Since the maximum length of a line that you can display at your
    terminal is 130 characters, the insertion of the characters DMS will cause
    lines greater than 127 characters long to be truncated.

3.  Messages that are displayed as the result of an &BEGEMSG control statement
    are not scanned by the EXEC interpreter.  Therefore, no variable
    substitution is performed and no data items are truncated.  To display
    variable data, use the &EMSG control statement.