Job queue element sections

Job Queue Element Execution Scheduling Section: This section is mapped by the STATSCHD DSECT and is identified by a type of STSCHED ('04'x) and a modifier of STSCTMOD ('00'x). This section is present if the job is scheduled for execution.

The fields in the STATSCHD section are:

Field Name

Description

STSCLEN

Length of this section.

STSCTYPE

Section type identifier of STSCHED ('04'x)

STSCMOD

Section type modifier of STSCTMOD ('00'x)

STSCAHLD

Reasons why the job will not run. Also refer to STSCAHL2.

Bit Value: Description
STSCJCLS: Job class is held
STSCJCLM: Job class limit has been reached
STSCJSCH: Scheduling environment is not available
STSCJAFF: Systems for which the job has affinity are not available
STSCJSPL: Spool volumes needed by the job are not available
STSCJBSY: Job is busy on a device
STSCJSCF: The RACF® SECLABEL by system option is in effect. The SECLABEL associated with the job (STTRSECL) is not available on any active system
STSCNOSY: No system(s) with the correct combination of resources is available

STSCFLG1

General flag byte

Bit Value: Description
STSC1JCM: JOBCLASS mode: Off is JES mode; On is WLM mode.

STSCASID

ASID where job is executing (zero if not active).

STSCSRVC

Service class associated with the job

STSCESTT

Estimated time to execute (in seconds) for the job. This is only available if the job:

Is awaiting execution
Is scheduled to a WLM-managed job class
Is not held
Can currently run (STSCAHLD is zero)

If the estimated time is not available, this field is set to negative 1 (-1). The time is calculated on the average queue time for a job in this job class (STSCAVGQ) and the amount of time this job has been queued (STSCQTIM). If the job has been waiting longer than average, STSCESTT will be set to negative 1 (-1).

STSCSENV

Scheduling environment required by the job.

STSCQPOS

Position of this job on a WLM service class queue (if STATSPOS is on)

STSCQNUM

Number of jobs on this WLM service class queue (if STATSPOS is on)

STSCQACT

Number of active jobs on this WLM service class queue (if STATSPOS is on)

STSCAVGQ

Average queue time for jobs in this WLM service class. STSCAVGQ is one component of STSCESTT. If STSCESTT is not available, this field is zero (0). If the job has already waited more than the average wait time, this field (and STSCQTIM) is set to negative 1 (-1).

STSCQTIM

Actual queue time for this job. STSCQTIM is one component of STSCESTT. If STSCESTT is not available, this field is zero (0). If the job has already waited more than the average wait time, this field (and STSCAVGQ) is set to negative 1 (-1).

STSCPSEQ

The minimum z/OS level required for this job to run (in the format used for ECVTPSEQ system field)

STSCAHL2

Reasons why the job will not run. Also refer to STSCAHLD.

Bit Value: Description
STSCMLEV: No system is available with the minimum required z/OS system level (see STSCPSEQ).

STSCSIZE

Length of basic section

Job Queue Element Schedulable Systems Section: This section is mapped by the STATSCHS DSECT and is identified by a type of STSCHED ('04'x) and a modifier of STSSTMOD ('01'x). This section is present if the job is scheduled for execution, requires a scheduling environment, and that environment is available on at least one system. This section lists the MVS™ system names where the scheduling environment is available. This section is not returned by JES3 subsystems.

The fields in the STATSCHS section are:

Field Name: Description
STSSLEN: Length of this section.
STSSTYPE: Section type identifier of STSCHED ('04'x)
STSSMOD: Section type modifier of STSSTMOD ('01'x)
STSSNUM: Number of systems that have the required scheduling environment.
STSSSYS: Name of first system that has the required scheduling environment. Other system names follow after this system name. The number of system names present is in field STSSNUM.
STSSSIZE: Length of the scheduling systems section.

Job Queue Element SECLABEL Availability Section: This section is mapped by the STATSCLF DSECT and is identified by a type of STSECLAF ('05'x) and a modifier of STSLTMOD ('00'x). This section is present if the the SECLABEL by system RACF option is enabled and the job is queued for conversion processing or execution. This section lists the MVS system names where the SECLABEL associated with the job (STTRSECL) is active (available). This section is not returned by JES3 subsystems.

The fields in the STATSCLF section are:

Field Name: Description
STSLLEN: Length of this section
STSLTYPE: Section type identifier of STSECLAF ('05'x)
STSLMOD: Section type modifier of STSLTMOD ('00'x)
STSLNUM: Number of systems where the SECLABEL is active
STSLSYS: Name of first system where the SECLABEL is active. Other system names follow after this system name. The number of system names present is in field STSLNUM.
STSLSIZE: Length of the SECLABEL affinity section.

Job Queue Element JES3 Terse Section: This section is mapped by the STATJ3TR DSECT and is identified by a type of STJ3TERS and a modifier of STJ3MOD (X'0'). This section is present only if the job is owned by a JES3 subsystem.

The fields in the STATJ3TR section are:

Field name: Description
STJ3LEN: Length of this section
STJ3TYPE: Section type identifier of STJ3TERS
STJ3MOD: Section type modifier of STJ3TMOD (X'0')
STJ3SPOL: Spool data token or zero
STJ3JSTT: List of reasons, by system, why job is waiting to run (RQJSTAT)
STJ3JSTM: List of system names corresponding to STJ3JSTT, terminated by zero

Job Queue Element Verbose Prefix: This section is mapped by the STATVE DSECT.

The fields in the STATVE prefix are:

STVEEYE: Eye catcher C'SJVE'
STVEOHDR: Offset from the start of the STATVE to the first information section.
STVEJOB: 31-bit address of the associated job queue data element.
STVEJOB_64: 64-bit address of the associated job queue data element.
STVESIZE: Size of the prefix.

Job Verbose Element 1st Header Section: This section is mapped by the STATJVHD DSECT and is identified by a type of STJV1HDR and a modifier of STJV1MOD (X'0').

Field name: Description
STFVLEN: Length of entire Job verbose header (Maximum value is 65535)
STJVTYPE: Header type identifier of STJV1HDR
STJVMOD: Section type modifier of STJV1MOD (X'0')
STJVSIZE: Size of 1st Header Section

Job Queue Element Verbose Section: This section is mapped by the STATJQVB DSECT and is identified by a type of STVBVRBO (X'') and a modifier of STVBVMOD (X'0'). Data in this section requires disk I/O and a STATVER=STATV040.

Field name

Description

STVBLEN

Length of this section

STVBTYPE

Section type identifier of STVBVRBO

STVBMOD

Section type modifier of STVBVMOD (X'0')

STVBFLG1

Section flag byte

Bit value: Description
STBB1ERR: Error returning verbose data (terse data section returned)

STVBJCPY

Job copy count

This value is meaningful in JES2 only. JES3 always returns 1.

STVBLNCT

Job line count

This value is meaningful in JES2 only. JES3 always returns 0.

STVBIDEV

Input device name

STVBISID

Input system/member

Note: In JES3, for a TSO or INTRDR submission job, STVBISID is set to the system name on which the submitting user or job is active. For all other submissions, STVBISID is set to the JES3 global. Also, for a TSO or INTRDR submission from a user or job that was active on a system running a JES3 release lower than z/OS® V1R7, STVBISID is set to the JES3 global.

STVBJCIN

Job input count

STVBJLIN

Job line count

STVBJPAG

Job page count

STVBJPUN

Job card (output) count

STVBRTS

Input start time/date

Field name: Description
STVBRSTS: Input start time. This is in hundredths of seconds since midnight.
STVBRTSD: Input start date. This is in the form 0cyydddF.

STVBRTE

Input end time/date

Field name: Description
STVBRTET: Input end time. This is in hundredths of seconds since midnight.
STVBRTED: Input end date. This is in the form 0cyydddF.

STVBSYS

Execution MVS system name.

STVBMBR

Execution JES member name.

STVBXTS

Execution start time/date:

Field name: Description
STVBXTST: Execution start time. This is in hundredths of seconds since midnight.
STVBXTSD: Execution start date. This is in the form 0cyydddF.

STVBXTE

Execution end time/date:

Field name: Description
STVBXTET: Execution end time. This is in hundredths of seconds since midnight.
STVBXTED: Execution end date. This is in the form 0cyydddF.

STVBJUSR

JMRUSEID field

STVBMCLS

Message class (Job card)

STVBNOTN

Notify Node

STVBNOTU

Notify user ID

STVBPNAM

Programmer's name (from Job card)

STVBACCT

Account number (from Job card)

STVBDEPT

NJE department

STVBBLDG

NJE building

STVBROOM

Job card room number

In JES3, the values STVBACCT, STVBDEPT, STVBBLDG, and STVBROOM are filled in from the ACCT=, DEPT=, BLDG=, and ROOM= parameters on the //*NETACCT statement.

STVBJVDT

JDVT name for job

STVBSUBU

Submitting user ID

STVBSUBG

Submitter's security group name. In JES3, this field contains the owner's security group name.

STVBMLRC

The maximum LRECL of the JCLIN stream

STVBMXRC

The status of job execution. This field is not affected by JOBRC processing.

Field Name

Description

STVBXIND

Job completion indicator. The first four bits indicate how to interpret STVBMXCC. The remaining four bits identify the completion type.

Bit Value: Description
STVBXAB: If this bit is on, STVBMXCCcontains an ABEND code.
STVBXCDE: If this bit is on, STVBMXCC contains a completion code.
STVBXUNK: No completion information is available. This can occur if the job has not completed, or if the job completed but the completion information was not saved.
STVBXNRM: Job executed and ended normally. (+)
STVBXCC: Job executed and ended by completion code. (+)
STVBXJCL: Job had a JCL error.
STVBXCAN: Job was canceled before execution completed.
STVBXABN: Job ABENDed during execution. (+)
STVBXCAB: Converter ABENDed while processing the job.
STVBXSEC: Job failed input processing security checks.
STVBXEOM: Job failed during execution and was processed in end-of-memory. (+)
STVBXCNV: Job did not execute due to a converter error.
STVBXSYS: Job was executing when a system failed.

STVBMXCC

ABEND or completion code for (+)-marked completion types. If STVBXAB is on, then the field contains an ABEND code–either the first 12 bits of STVBMXCC are set to the System ABEND code, or the last 12 bits are set to the User ABEND code. If STVBXCDE is on, then the field contains a return code in the last 12 bits.

STVBSIZE

Size of verbose information

Job Queue Element Security Section (mapped by SAF token): This section is mapped by the STATJQSE DSECT and is identified by a type of STSESEC and a modifier of STSESMOD(X'0').

Field name

Description

STSELEN

Length of this section

STSETYPE

Section type identifier of STSESEC

STSEMOD

Section type modifier of STSESMOD (X'0')

STSEFLG1

Security Section flag byte

Bit value: Description
STSE1ERR: Error obtaining verbose data (terse data returned)
STSE1JB: Token represents a job

STSEOFFS

Offset to SAF token

STSETOKN

Mapped SAF token

Job Queue Element Accounting Section: This section is mapped by the STATJQAC DSECT and is identified by a type of STACACCT and a modifier of STACAMOD (X'0').

Note: If the job does not have job accounting strings:

In the case of JES2, the Job Information Element section will be truncated after the Job Queue Element Security section. There will be no Job Queue Element Accounting section.
In the case of JES3, the Job Queue Element Accounting section will have the accounting length of 145, number of sub string zero and substring will contain all zeroes.

Field name

Description

STACLEN

Length of this section

STACTYPE

Section type identifier of STACACCT

STACMOD

Section type modifier of STACAMOD (X'0')

STACFLG1

Security Section flag byte

Bit value: Description
STAC1ERR: Error obtaining verbose data (terse data returned)
STAC1OVJB: Accounting string can be overlaid by other than originating node

STACOFFS

Offset to beginning of accounting information

STACFLEN

Length of fixed portion