MSG_LEVEL

The MSG_LEVEL keyword specifies whether to display only exception messages, display messages that concern a rule definition match, or display all messages.

Syntax

Notes:

¹ Although you can specify both ALL and EXCEPTIONS, the two options contradict one another. If you specify ALL and EXCEPTIONS, only the EXCEPTIONS option is honored.

MSG_LEVEL=(EXCEPTIONS, ALL, RULEDEF)

Operands

ALL: Display exception messages and informational messages that are related to successful completion of certain functions by Advanced Allocation Management.
Note: MSG_LEVEL=ALL does not include the RULEDEF option. When only MSGLEVEL=ALL is specified, rule definition match messages are not displayed.
EXCEPTIONS: Display only exception messages.
RULEDEF: When you specify MSG_LEVEL=RULEDEF, Advanced Allocation Management displays a message that concerns a rule definition match each time that it checks for a matching rule definition and finds a match. Advanced Allocation Management does not display a message if it does not find a rule definition match.
Note: Checks for a matching rule definition can occur many times during the processing of a data set, and therefore can increase the number of messages that are output to the message destination.

Default

EXCEPTIONS

Usage and processing considerations

The MSG_LEVEL keyword is associated with the MESSAGES keyword. You must specify MESSAGES=ENABLE to implement this function.

Environments

ACS, ALLOCATE, CATCHECK, EXTEND, STOW, and UNALLOCATE.

Related keywords

MESSAGES and MSG_DESTINATION.

Example: MSG_LEVEL=RULEDEF

In the following example, MSG_LEVEL is set to RULEDEF:

INCLUDE JOBNAME=MSGLEVEL 
        STEPNAME=CREATE0 
        MSG_LEVEL=RULEDEF

The resulting job log shows the line number of the matching rule definition statements:

GLO2188I MATCHING INCLUDE RULEDEF LINE NUMBER = 17 - Q31V
GLO2188I MATCHING INCLUDE RULEDEF LINE NUMBER = 17 - Q31V 
IEF236I ALLOC. FOR MSGLEVEL CRESTEP CREATE0
IGD100I 2105 ALLOCATED TO DDNAME DD1 DATACLAS ( )
GLO2188I MATCHING INCLUDE RULEDEF LINE NUMBER = 17 - Q31V

Next, MSG_LEVEL is set to EXCEPTIONS when an attempt is made to allocate a data set with the duplicate data set name (STEP CREATE2) and use the NOTCAT function to resolve the situation:

INCLUDE JOBNAME=MSGLEVEL 
        STEPNAME=CREATE2 
        MSG_LEVEL=EXCEPTIONS 
        NOTCAT2=RE 
        NOTCAT2_C=A 
        NOTCAT2_Q=NSMS 
        NOTCAT2_QUALIFIER_P=1

No RULEDEF messages are present in the job log.

Finally, when MSG_LEVEL=ALL is specified:

INCLUDE JOBNAME=MSGLEVEL 
        STEPNAME=CREATE4 
        MSG_LEVEL=ALL 
        NOTCAT2=RE 
        NOTCAT2_C=A 
        NOTCAT2_Q=NSMS 
        NOTCAT2_QUALIFIER_P=1

The resulting job log shows the following messages:

GLO2087I DATA SET ON VOLSER NSL200 RENAMED AT ALLOCATION TIME -Q31V
GLO2086I NEW NAME: NSMS.NSMS.RSTEST.GLO.ORL12.MSGALL -Q31V
GLO2123I MSGLEVEL,CREATE4,CRESTEP,DD1,NSMS.RSTEST.GLO.ORL12.MSGALL -Q31V

Note: When MSG_LEVEL=ALL is specified, no MSG_LEVEL messages are displayed in the job log (as they are when MSG_LEVEL=RULEDEF is specified).

Example: MSG_LEVEL=ALL

In the following example, MSG_LEVEL is set to ALL. Therefore, exception messages and informational messages that are related to successful completion of certain functions by Advanced Allocation Management, are displayed:

MSG_LEVEL=ALL

Example: MSG_LEVEL=(ALL, RULEDEF)

In the following example, MSG_LEVEL is set to ALL,RULEDEF:

INCLUDE JOBNAME=AAMTEST1
    MSG_LEVEL=(ALL,RULEDEF)
    SPACE_RELEASE=ENABLE

The resulting job log shows the following messages:

GLO2188I MATCHING INCLUDE RULEDEF LINE NUMBER = 17 - Q31V
GLO2188I MATCHING INCLUDE RULEDEF LINE NUMBER = 17 - Q31V
IEF236I ALLOC. FOR AAMTEST1 CRESTEP CREATE0
IGD100I 2105 ALLOCATED TO DDNAME SYSUT2 DATACLAS ( )
GLO2188I MATCHING INCLUDE RULEDEF LINE NUMBER = 17 – Q31V
GLO2125I SPACE RELEASE RECOVERED 9 TRACKS -Q31V
GLO2123I AAMTEST1,CREATE0,CRESTEP,SYSUT2,RSQA.AAMTEST1.GLO.TEST.DATA –Q31V