$D JOBDEF - Display characteristics assigned to jobs

Function

To display the characteristics that are assigned to jobs entering the system.

Syntax

Read syntax diagramSkip visual syntax diagram$DJOBDEF,ACCTFLD,BAD_JOBNAME_CHAR,CISUB_PER_AS,CNVT_ENQ,CNVT_SCHENV,DEF_CLASS,DUPL_JOB,INTERPRET,JNUMBASE,JNUMFREE,JNUMWARN,JOBFREE,JOBNUM,JOBRBLDQ,JOBWARN,LOGMSG,NFY_SUBJECT,PRTYHIGH,PRTYJECL,PRTYJOB,PRTYLOW,PRTYRATE,RANGE,RASSIGN,SUP_EVENTLOG_SMF

Parameters

JOBDEF
The $HASP835 message displays the characteristics that are assigned to jobs entering the JES2 system.
ACCTFLD
Displays the JES2 form of the accounting information (the job accounting number and room number).
BAD_JOBNAME_CHAR
Displays the character that is used in place of invalid characters in a jobname. This translation is used for JES2 commands and displays, including RACF® entity names.
CISUB_PER_AS=nn
Displays the nn number of subtasks (converter/interpreter subtasks) that are run in each of the jesxCIxx address spaces when INTERPRET=JES is specified. Valid values are 1-25 (25 being the maximum number of converter PCEs that can be specified on PCEDEF).
CNVT_ENQ
Displays action that is taken if the data set ENQ for a data set specified on a DD statement cannot be obtained.
CNVT_SCHENV=HONOR|IGNORE
Displays whether the availability of a scheduling environment that is associated with a job controls which member a job converts on. If CNVT_SCHENV=HONOR is specified, then a job can only convert on a system where the scheduling environment that is associated with the job is available.
DEF_CLASS=class|A
Displays the default class that JES2 uses if a non-valid class is discovered during processing. The default class must be a defined and active batch job class. The default class cannot be set to ACTIVE=NO, and cannot be deleted. The following examples show when the default class would be used:
  • When a job is submitted with a CLASS= value that is not valid. The job is failed, but this class is associated with the job for later processing.
  • When a job class is deleted that is associated with the INTRDR statement as CLASS=. The INTRDR CLASS value is set to this value.
  • During initialization processing, when the CLASS= value that is specified for a reader (INTRDR, local or remote) is not valid and the operator continues initialization.
The default class value is A.

Modification: $T JOBDEF operator command or a JES2 all-member warm start.

Scope: MAS-wide

DUPL_JOB
Displays whether JES2 is allowed to concurrently execute batch jobs with the same name in the same MAS.
DELAY
Do not allow JES2 to execute batch jobs with the same name in the same MAS at the same time.
NODELAY
Allow JES2 to execute batch jobs with the same name in the same MAS at the same time.
INTERPRET=JES|INIT
Displays when JES2 calls the z/OS interpreter to process a job. INIT specifies that the interpreter is called when the job is selected for execution by an initiator. JES specifies that it is called by JES2 at the end of conversion processing. When INTERPRET=JES is specified, conversion and interpretation processing occurs in a subtask in a new address space named jesxCIxx. Invoking the interpreter in the initiator is the traditional way that JES2 processing works. However, the following functions are available if processing is done under JES (after conversion):
  • Earlier detection of JCL errors that are detected by the z/OS interpreter. This allows errors to be detected even if the job never executes for TYPRUN=.
  • Processing of JESDS OUTPUT statements to control the attributes of JES data sets, even if the job never executes.
JNUMBASE
The last job number that was assigned to a job.
JNUMFREE
The number of available job numbers.
JNUMWARN
Displays the percentage (1-99) of assignable job numbers that have been used for jobs submitted at the local node.
JOBFREE
The number of available job queue elements.
JOBNUM
Displays the maximum number (10-400000) of jobs that can be in the JES2 job queue at any time.
JOBRBLDQ
Displays Yes if there are jobs on the rebuild queue.
JOBWARN
Displays the percent (0-99) usage threshold of available job queue elements (JQEs).
LOGMSG
Displays whether the messages issued by JES2 and written at job JCL converter time are set to mixed-case (ASIS) or uppercase (FOLD).

Scope: MAS-Wide.

NFY_SUBJECT=string
Displays the optional character string that is used by JES2 as a subject line in email messages that are sent as a result of processing the NOTIFY JCL statement. If no specific string is specified, JES2 uses the default subject line of: z/OS job event notification.
Note: By default, the NFY_SUBJECT is not displayed when using the $D JOBDEF command. To receive the information, the command must explicitly request it by issuing:
$DJOBDEF,NFY_SUBJECT

Scope: Single Member.

PRTYHIGH
Displays the upper priority limit (0-15) to be associated with the JES2 job priority-aging feature.
PRTYJECL
Displays whether the JES2 /*PRIORITY control statement is supported.
PRTYJOB
Displays whether the priority that is specified on the JCL JOB statement is supported.
PRTYLOW
Displays the lower priority limit (0-15) to be associated with the JES2 job priority-aging feature.
PRTYRATE
Displays the number (0-1440) of time periods into which a 24-hour day is to be divided for use increasing a job's priority by the JES2 priority-aging feature.
RANGE
Displays the range of number (1-999,999) which JES2 assigns as JOBIDs to jobs which originated on the local node.
RASSIGN
Displays whether job numbers outside of the RANGE= range can be used when jobs are received from NJE or spool reload.
SUP_EVENTLOG_SMF=NO|YES
Specifies whether the writing of SMF records to the job's EVENTLOG data set should be suppressed (YES) or not (NO). The default is NO and SMF records are written to the EVENTLOG data set.

Scope: MAS-Wide.

Scope

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

Messages

The $HASP835 message displays the keywords that are defined and their current values.

Example

 1   $D JOBDEF
                 $djobdef
$HASP835 JOBDEF 
$HASP835 JOBDEF  ACCTFLD=OPTIONAL,BAD_JOBNAME_CHAR=?,  
$HASP835         CNVT_ENQ=FAIL,INTERPRET=INIT,CISUB_PER_AS=5, 
$HASP835         CNVT_SCHENV=IGNORE,JNUMBASE=12,JNUMFREE=9988, 
$HASP835         JNUMWARN=80,JOBFREE=489,JOBNUM=500,JOBWARN=80, 
$HASP835         PRTYHIGH=10,PRTYJECL=YES,PRTYJOB=NO,PRTYLOW=5, 
$HASP835         PRTYRATE=0,RANGE=(1,9999),RASSIGN=YES, 
$HASP835         JOBRBLDQ=NONE,DUPL_JOB=DELAY