DO ADJMSG: Action Parameter

Suppresses Control-M JCL Verify messages or changes their severity in a dynamic manner.

Note: If a static adjustment of messages is sufficient, with no need to set conditions for message adjustments, you can use the alternative CTJEMSG member. For more information, see Adjusting messages. If you set up both types of message adjustments, dynamic message adjustments take precedence over static message adjustments.

The DO ADJMSG parameter is relevant for site standards only.

DO ADJMSG is available for the following ON statements: DD, EXEC, INIT, JOB, and JCLLIB. Message adjustments are put into effect according to the scope of the ON statement:

• For an ON DD statement, message adjustment is in effect only until the end of the DD that triggers the rule.
• For an ON EXEC statement, message adjustment is in effect only until the end of the step.
• For an ON JOB, ON INIT, or ON JCLLIB statement, message adjustment is in effect until the end of the job.

If two rules trigger adjustments to the same message, precedence is determined according to the following criteria:

• Type of rule - DD rules have the highest priority, followed by EXEC, JCLLIB, JOB, and INIT.
• (For rules of the same type) Values set in the general parameters and common selection parameters of the rule, as discussed in Rule search criteria. For example, message adjustments will be performed according to the rule with the higher priority and higher level of detail in the selection fields.

The valid format is

ADJMSG MSGID msgid  SUPPRESS _ (y/n)  SEVERITY _ (E/W/I)

where

• msgid is the 7-character message ID for the Control-M JCL Verify message that you want to adjust. The message ID must begin with CTJ*.
• SUPPRESS - whether to suppress the message, either Y (yes) or N (no)
• SEVERITY - adjusted level of severity for the message: E (error), W (warning), or I (information)

  Note: When SUPPRESS is set to Y, SEVERITY is ignored.

This parameter is optional. To activate it, use the following steps:

1. Type ADJMSG in the DO field, and press Enter.

   Several additional fields are displayed (MSGID, SUPPRESS, and SEVERITY).

2. In the MSGID field, enter the message ID for the message that you want to adjust.

   Note: Certain messages are restricted and cannot be adjusted. For a list of messages that you cannot adjust, see Restricted Messages.

3. In the SUPPRESS field, enter either Y or N.
4. In the SEVERITY field, enter a new severity for the message - E, W, or I.
5. Press Enter.