MSGCLASS parameter - IBM-JCL

Parameter Type

Keyword, optional

Purpose

Use the MSGCLASS parameter to assign the job log to an output class. The job log is a record of job-related information for the programmer. Depending on the JOB statement MSGLEVEL parameter, the job log can consist of:

  • Only the JOB statement.
  • All job control statements.
  • In-stream and cataloged procedure statements.
  • Job control statement messages.
  • JES and operator messages about the job.

Note: In a JES3 environment, a job can complete processing before all of its messages have been written to the job log. When this occurs, the job’s output is incomplete. For this reason, do not use the contents of the job log as an automation or as a programming interface.

Considerations for an APPC Scheduling Environment

The MSGCLASS parameter has no function in an APPC scheduling environment. If you code MSGCLASS, the system will check it for syntax and ignore it.

1.Syntax

MSGCLASS=class

2.Subparameter Definition

class
Identifies the output class for the job log. The class is one character, A through Z or 0 through 9, and must be a valid output class specified at JES initialization.

NJE Note: If you specify an output class that is a held class in an NJE environment, the system does not hold the data set until it reaches its ultimate destination node.

3.Defaults
The default is based on the source of the job: The system places the job log in the same output class as the installation-specified default class for the particular card reader, work station, or time-sharing user that submitted the job. The installation default is specified at JES initialization.

4.Significance of Output Classes
To print the job log and any output data sets on the same output listing, code one of the following:

  • The same output class in the DD SYSOUT parameter as in the JOB MSGCLASS parameter.
  • DD SYSOUT=* to default to the JOB MSGCLASS output class.
  • DD SYSOUT=(,) to default to one of the following:
    1. The CLASS parameter in an explicitly or implicitly referenced OUTPUT JCL statement. In this case, the OUTPUT JCL CLASS parameter should specify the same output class as the JOB MSGCLASS parameter.
    2. The JOB MSGCLASS output class, if no OUTPUT JCL statement is referenced or if the referenced OUTPUT JCL statement contains either CLASS= or CLASS=*.

5.Examples of the MSGCLASS Parameter

Example

//EXMP1 JOB ,GEORGE,MSGCLASS=F

In this example, the JOB statement specifies output class F for the job log.

Example

//EXMP2 JOB ,MENTLE,MSGLEVEL=(2,0)

This JOB statement does not specify an output class. In this case, the output class defaults to the installation default output class for the device from which the job was submitted.

Example

//A1403 JOB ,BLACK,MSGCLASS=L //STEP1 EXEC PGM=PRINT //OUTDD1 DD SYSOUT=L

In this example, the JOB statement and sysout DD statement OUTDD1 both specify the same output class. Consequently, the job log and data set OUTDD1 are written on the same output listing.

Example

//B209 JOB ,WHITE,MSGCLASS=M //STEPA EXEC PGM=PRINT //OUTDDX DD SYSOUT=*

In this example, the JOB statement specifies that the system route the job log to output class M. The system also routes sysout data set OUTDDX to class M because SYSOUT=* is specified.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM-JCL Topics