Previous Topic: The $CA7CMD MacroNext Topic: The $DMSGEND Macro


The $DMSG Macro

The $DMSG macro defines error messages to CA JCLCheck. The text of all messages is in the JCLMSG member of the OPTION library. This member consists of a series of $DMSG macros, each defining a message.

This macro has the following format:

#nnn $DMSG    -text1-,text2-,...---
              SEV=value/SUPPRESS
#nnn

Specifies the CA JCLCheck message number.

CA JCLCheck requires the pound sign (#). You do not need to specify leading zeros. You must define $DMSG macros in ascending sequence by message number.

text1-,text2-,...--

Specifies constant message text segments.

If there is more than one text segment, CA JCLCheck assumes the message contains variable message text. CA JCLCheck must provide these variables when it issues the $JCLERR macro for the message. CA JCLCheck inserts variable message text units between text segments when it constructs the message. Indicate the presence of multiple consecutive variables by specifying null text segments. See the $JCLERR macro description for information about variable message text units.

If you omit the text parameter, you must supply the entire message as a single variable parameter.

SEV

Specifies the severity of the message:

-1        Suppress the message
00 - 03   Informational severity
04 - 07   Warning severity
08 - 11   Error severity
12 - 15   Serious error severity

SEV value must range between 0 and 15. All CA JCLCheck messages have severities of 0, 4, 8, or 12.

You can use other values to have CA JCLCheck selectively suppress messages using the runtime SEV option. SEV=SUPPRESS causes CA JCLCheck to suppress the message, regardless of the setting of the SEV runtime option.

While processing a message, the following order of precedence is used to establish the message severity:

  1. JCLMSG (out of the box or as modified by USERMOD MZ2C023)
  2. JCLCheck program that issues the message
  3. MCOSYS (if option specified)
  4. MCOUSR (if option specified)
  5. CAZ1REXX or REXX EXEC specified in the STDREXX option (if REXXMSG option is specified)
  6. CAZ1XERR (if option specified; out of the box retains all messages or as modified by USERMOD MZ1C030)