$D JOBCLASS(n) - Display job class characteristics
Function
- The default disposition of the JES data sets created by jobs in a specified job class.
- An execution batch monitor procedure that is to be used for jobs in a specified class.
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.
Syntax
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)
- 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.
- GDGBIAS{=JOB|STEP}
- Displays how relative references to a generation data
set in a DD JCL statement are resolved. This is processed by the z/OS converter.
- JOB
-
Relative references to a generation data set are resolved on a job basis. The system establishes the relationship between the relative generation number and the absolute generation number when the generation data set is first referenced in the job. This relationship is consistent throughout the job.
- STEP
-
Relative references to a generation data set are resolved on a job step basis. The system establishes the relationship between the relative generation number and the absolute generation number when the generation data set is first referenced in each job step. Each job step that references the generation data set establishes a new relationship.
- 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.)
- 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.
- PROMO_RATE
- Specifies how many positions a job can be moved up the execution queue in one STARTBY aging cycle (1 minute). PROMO_RATE=0 means that STARTBY function is disabled for the job class.
- 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.)
- 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.
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.
Examples
1 $D JOBCLASS(A)
$djobclass(a)
$HASP837 JOBCLASS(A)
$HASP837 JOBCLASS(A) MODE=JES,QAFF=(ANY),QHELD=NO,
$HASP837 SCHENV=,XEQCOUNT=(MAXIMUM=*,
$HASP837 CURRENT=0),
$HASP837 XEQMEMBER(IBM1)=(MAXIMUM=*,
$HASP837 CURRENT=0)
$djobclass(a),long
$djobclass(a),long
$HASP837 JOBCLASS(A)
$HASP837 JOBCLASS(A)
$HASP837 JOBCLASS(A) ACTIVE=YES,ACCT=NO,AUTH=(ALL),
$HASP837 BLP=NO,COMMAND=DISPLAY,COPY=NO,
$HASP837 DSENQSHR=ALLOW,DUPL_JOB=DELAY,
$HASP837 GROUP=,HOLD=NO,IEFUJP=YES,
$HASP837 IEFUSO=YES,JESLOG=(NOSPIN),
$HASP837 JOBRC=MAXRC,JOURNAL=YES,LOG=YES,
$HASP837 MODE=JES,MSGLEVEL=(0,1),
$HASP837 OUTDISP=(,),OUTPUT=YES,PERFORM=000,
$HASP837 PGMRNAME=NO,PROCLIB=00,QAFF=(ANY),
$HASP837 QHELD=NO,RESTART=NO,REGION=0001M,
$HASP837 SCAN=NO,SCHENV=,SWA=ABOVE,
$HASP837 SYSSYM=DISALLOW,TIME=(000030,00),
$HASP837 TYPE26=YES,TYPE6=YES,XBM=,
$HASP837 XEQCOUNT=(MAXIMUM=*,CURRENT=0),
$HASP837 XEQMEMBER(IBM1)=(MAXIMUM=*,
$HASP837 CURRENT=0)
2 $d jobclass(*),qheld=yes,qheld
$HASP837 JOBCLASS(A) QHELD=YES
$HASP837 JOBCLASS(E) QHELD=YES
$HASP837 JOBCLASS(I) QHELD=YES
$HASP837 JOBCLASS(O) QHELD=YES
$HASP837 JOBCLASS(U) QHELD=YES
JES2 displays the held status for all job classes which have been held by the $T JOBCLASS,QHELD=YES command.