Function

This command has parameters you can use as a filtering technique to limit the type of information to search, or the amount of information to display. See Using filtering to control and display information for additional information.

Parameters

jobclass

The subscript defining the job classes to be displayed by this command. Valid class specifications are any existing job class, "STC", "TSU", and the wild cards "*" and "?". The subscript can specify a specific job class or a range of job classes.

ACCT={No|Yes}

Displays whether an account number is required (YES) or not required (NO) on a JCL JOB statement.

ACTIVE={No|Yes}

Displays classes that are active (YES) or inactive (NO).

AUTH{=ALL|CONS|INFO|IO|SYS}

Displays the MVS™ operator command groups that are to be executed. The display will be one of the following:

• ALL (to include all operator command types)
• CONS (console commands)
• INFO (information commands such as display)
• IO (input/output commands)
• SYS (system commands)

For an explanation of operator command groups and the relationship of JES2 to MVS command groups, refer to z/OS MVS System Commands, SA38-0666.

BLP{=No|Yes}

Displays that either the bypass label processing parameter in the label field of a DD statement is to be ignored (NO) and processed as no label, or that bypass label processing is performed as requested (YES) and the label parameter is processed as it appears.

COMMAND[=IGNORE|DISPLAY|EXECUTE|VERIFY]

Displays the disposition of commands read from the input stream as follows.

IGNORE

The command is ignored.

DISPLAY

The command is displayed and scheduled for execution.

EXECUTE

The command is scheduled for execution.

VERIFY

Specifies that the system displays the command, asks the operator whether the command should be executed and, if the operator replies “YES”, schedules the command for execution.

CONDPURG

Specifies whether (Yes) or not (No) system data sets (such as JESMSG and SYSMSG) in this jobclass are to be displayed.

COPY{=No|Yes}

Displays whether (Yes) or not (No) jobs in this job class are to be queued for output processing as though TYPRUN=COPY was specified on the JOB statement for these jobs.

DSENQSHR{=ALLOW|AUTO|DISALLOW}

Indicates how the system will treat changes in data set disposition between job steps. When a step includes a DD statement with OLD, NEW or MOD on the DISP (disposition) keyword, and a later step requests the same data set as SHR, this parameter controls whether the system can change the serialization on the data set to shared control, allowing other jobs to also share that data set. The values specified here interact with the value specified for DSENQSHR on the JOB card to determine the behavior:

ALLOW

The system is allowed to change the serialization on the data set to shared control if the JOB card specifies ALLOW.

AUTO

The system is allowed to change the serialization on the data set to shared control if the JOB card specifies ALLOW or USEJC.

DISALLOW

The system is not allowed to change the serialization on the data set to shared control.

DUPL_JOB{=DELAY|NODELAY}

Displays whether (DUPL_JOB=NODELAY) or not (DUPL_JOB=DELAY) JES2 is allowed to concurrently execute batch jobs with the same name in the same MAS.

GROUP=name

Displays job classes that match the specified job class group name.

HOLD{=No|Yes}

Displays whether (Yes) or not (No) jobs in this job class are to be held until a RELEASE command is issued by the operator.

IEFUJP{=No|Yes}

Displays whether (Yes) or not (no) the IEFUJP installation exit is to be taken when a job is purged.

IEFUSO{=No|Yes}

Displays whether (Yes) or not (No) the IEFUSO installation exit is to be taken when the SYSOUT limit is reached for a job in this job class.

JESLOG{=SPIN|NOSPIN|SUPPRESS}

Displays the default processing for the JESLOG data sets (JESMSGLG and JESYSMSG).

SPIN

JESLOG is spin-eligible.

NOSPIN

JESLOG will not be spun.

SUPPRESS

JESLOG will be suppressed.

JOBRC

Displays the method that JES2 uses to determine the return codes for jobs that are submitted in this class. If MAXRC is displayed, JES2 is using the highest return code of any executed step as the job return code. If LASTRC is displayed, JES2 is using the return code of the last executed step as the job return code. The default value is MAXRC.

JOURNAL{=No|Yes}

Displays whether (Yes) or not (No) job-related information is to be saved in a job journal.

Job journaling limits the scope of RESTART=YES. If the JOURNAL=Yes parameter is specified:

• JES2 restarts interrupted jobs from the beginning only if the MVS system is unable to restart the job from a step or checkpoint.
• RESTART=NO has no effect; all jobs are requeued for execution. (Specifying RD=R|RNC on the JCL JOB statement has the same effect.)

If the jobs are not journaled (JOURNAL=No), JES2 always attempts to restart interrupted jobs in this class from the beginning.

LOG{=No|Yes}

Displays whether (Yes) or not (No) the JES2 job log is to be printed for this job class.

LONG

Specifies whether an abbreviated list of characteristics is provided. An abbreviated display of characteristics is provided unless LONG is requested. The abbreviated list includes the following characteristics:

• MODE
• QAFF
• QHELD
• SCHENV
• XEQCOUNT
• XEQMEMBER

MODE={JES|WLM}

Displays whether jobs in this class are to be run under JES-mode or WLM-mode initiators.

MSGCLASS

Specifies the message class (A-Z,0-9) for started tasks or time-sharing users.

MSGLEVEL

Displays the message level value. The first value specifies the kinds of JCL listed:

0

JOB statement only

1

Input statements, cataloged procedure statements, and symbolic parameter substitution values

2

Input statements only, including instream procedures.

The second value specifies the kinds of allocation/termination messages listed:

0

No messages are to be listed, except in the case of an abnormal termination, in which case allocation/termination messages are listed.

1

Allocation/termination messages are listed.

NAME=name

Specifies a job class name to be used in selecting jobs from the job class.

OUTDisp=[=HOLD|KEEP|LEAVE|PURGE|WRITE]

Displays the default output disposition for JES data sets created for jobs in this class.

Output dispositions are:

HOLD

Hold the output. JES2 does not process the output until you either change the disposition to WRITE or KEEP, or release the output. When the output is released, the disposition changes to WRITE.

KEEP

Process the output and then keep a copy of it on spool. After processing, the disposition of this output becomes LEAVE.

LEAVE

JES2 does not process the output until you change the disposition to WRITE or KEEP, or release the output. When the output is released, the disposition changes to KEEP.

PURGE

Purge the output immediately.

WRITE

Process the output then purge it.

OUTPUT{=No|Yes}

Displays whether (Yes) or not (No) SYSOUT data is to be written for jobs executed in this job class.

PERFORM[=nnn|000]

Displays the default performance group number for this job class. This number is used as the performance-group number on the JCL EXEC statement when a performance-group number is not specified on the JCL JOB or EXEC statement for a job of this job class.

Note: The performance-group value specified on the EXEC card (step level) has no effect if running in WLM goal mode.

The parameter default is 000, which indicates that no performance-group processing will be performed by JES2. A default value of 1 is assigned for all steps in a job.

PGMRNAME{=No|Yes}

Displays whether a programmer name is required (YES) or not required (NO) on a JCL JOB statement.

PROCLIB[=proclib]

Displays the default procedure library number which is to be used for this job class. Any integer (0-99) can be specified.

QAFF=sysaff

Displays which members a particular job class is active on (not held).

QHELD[=No|Yes]

Displays whether (Yes) or not (No) jobs in this class are not selected for execution (meaning, they are held) on this member until the class is released from held status by operator command.

REGION[=region]

Displays the default region size assigned to each job step, in the form [=nnnnx]. The nnnn value indicates the number of units in the default region size; the x value indicates the unit of measure – K for Kilobytes or M for Megabytes.

RESTART[=No|Yes]

Displays whether (Yes) or not (No) JES2 is to requeue for execution any job of this job class that had been executing before the IPL of the system was repeated and a JES2 warm start was performed.

Job journaling limits the scope of RESTART=YES. If the JOURNAL=Yes parameter is specified:

• JES2 restarts interrupted jobs from the beginning only if the MVS system is unable to restart the job from a step or checkpoint.
• RESTART=NO has no effect; all jobs are requeued for execution. (Specifying RD=R|RNC on the JCL JOB statement has the same effect.)

If the jobs are not journaled (JOURNAL=No), JES2 always attempts to restart interrupted jobs in this class from the beginning.

SCAN[=No|Yes]

Displays whether (Yes) or not (No) jobs in this job class are to be queued for output processing immediately after JCL conversion, as though TYPRUN=SCAN was specified on the JOB statement for these jobs.

SCHENV=xxxxx

Displays the default SCHENV for this job class and xxxxx is a 1 to 16 character SCHENV. The SCHENV must be defined to WLM. If it is not, the setting will be ignored.

SWA{=ABOVE|BELOW}

Displays whether all eligible schedule work area (SWA) control blocks created for jobs in this job class will be placed above or below 16 megabytes in virtual storage.

SYSSYM[=ALLOW|DISALLOW]

Specifies whether system symbols are substituted in batch jobs that are submitted in this JOBCLASS. Symbols are substituted when the job is processed by the z/OS converter using the system symbols that are set on the system where the conversion occurs.

Note: You can choose the system that converts a job using SYSAFF on the JOB or JOBPARM JCL/JECL card or SYSTEM on the JOB card. If CNVT_SCHENV= is set to HONOR on the JOBDEF statement, then you can also choose the system that converts a job by associating a system with the job scheduling environment.

TIME

Displays the default for the maximum processor time that each job step may run.

TYPE6[=No|Yes]

Displays whether (Yes) or not (No) JES2 is to produce type 6 SMF records for jobs in this job class.

TYPE26[=No|Yes]

Displays whether (Yes) or not (No) JES2 is to produce type 26 (job summary) SMF records for jobs in this job class.

XBM=xbm

Displays the procedure name JES2 uses as the target of an EXEC statement. The procedure names a program that processes the input submitted to this job class.

XEQCount=(CURrent|MAXimum)

Displays the current number of jobs that are executing, or the maximum number of jobs that can execute concurrently in the class.

XEQMember(name)=(CURrent|MAXimum)

For the member name specified, displays the current number of jobs that are executing, or the maximum number of jobs that can execute concurrently in the class on the member.

Authority Required

This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS system command group is assigned.

This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

MAS-wide. This command displays information about the entire MAS.

Messages

The $HASP837 message displays the current job class characteristics for the specified job classes.

JES2 displays the held status for all job classes which have been held by the $T JOBCLASS,QHELD=YES command.