MSGLEVEL Parameter

MSGLEVEL Parameter

Note! MSGLEVEL parameter can be coded only at the job level.

MSGLEVEL parameter controls the printing of job messages in the output listing or job log (i.e., in the SPOOL by default). MSLEVEL is a keyword parameter and is optional.

MSGLEVEL parameter requests the system for the printing of below -

  • The JOB card and comments up to the first EXEC statement.
  • All JCL statements and JES2/JES3 statements.
  • In-stream or cataloged procedure.
  • Job control statement messages.
  • JES and operator JOB processing messages.

Syntax -

MSGLEVEL=([statements][,execution-status])
    or
MSGLEVEL=(M1,M2)
statements/M1 Specifies what JCL statements/messages to print in the output listing.
It also represents as M1, with valid values from 0 to 2.
M1 is optional. If not specified, the system installation default value is applied.

Parameter ValuesDescription
0Only JOB Statements (JOB statement, all comments before EXEC statement).
1All Statements (JCL statements, JES2 or JES3 control statements, the procedure statements, and symbolic parameter-related statements).
2Only JCL statements (JCL statements and JES2/JES3 control statements).
execution-status/M2 Specifies when to print the job related messages in the spool.
It is also represented as M2 with a valid value of 0-1.
M2 is optional. If not specified, the system installation default value is applied.

ValuesDescription
0Print allocation and termination messages only when JOB ended abnormally
1Print allocation and termination when JOB ended either normally or abnormally

Possible Combinations -

MSGLEVEL ParameterDescription
MSGLEVEL=(0,0)Only JOB Statements, its allocation and termination messages when JOB ended abnormally (unsuccessfully).
MSGLEVEL=(0,1)Only JOB Statements, its allocation and termination messages when JOB ended either normally or abnormally.
MSGLEVEL=(1,0)All Statements, its allocation and termination messages when JOB ended abnormally (Unsuccessfully).
MSGLEVEL=(1,1)All Statements, its allocation and termination messages when JOB ended either normally or abnormally. System Default.
MSGLEVEL=(2,0)Only JCL statements, its allocation and termination messages when JOB ended abnormally (unsuccessfully).
MSGLEVEL=(2,1)Only JCL statements, its allocation and termination messages when JOB ended either normally or abnormally.
Note: If the first parameter is alone coded, we can ignore the parentheses ().

Examples -

Scenario1 - With two values.

//MTHEXMP1 JOB (MTH123),'PAWAN Y',MSGLEVEL=(1,1)

System prints all statements, its allocation and termination messages when JOB completed either normally or abnormally.

Scenario2 - Only the first value.

//MTHEXMP2 JOB (MTH123),'PAWAN Y',MSGLEVEL=0

System prints only JOB statements, its allocation and termination messages when JOB completed either normally or abnormally.

Scenario3 - only second value.

//MTHEXMP1 JOB (MTH123),'PAWAN Y',MSGLEVEL=(,0)

System prints All Statements, its allocation and termination messages when JOB completed abnormally.