Job information elements

For each job that matches specified filter requirements, an information element is added to the chain pointed to by STATJOBF or STATJOBF_64. Each element is composed of the following:

A variable-sized prefix (mapped by the STATJQ DSECT)
A fixed-size job queue element header (mapped by the STATJQHD DSECT)
One or more variable-sized data sections

Information Element Prefix: Each job information element starts with a prefix area. This area is mapped by the STATJQ DSECT in the IAZSSST macro. STATJOBF or STATJOBF_64 points to the start of the first prefix area. Subsequent areas are chained using the STJQNEXT field. Because the size of the prefix area can vary as a result of service being applied, do not use the equate STJQSIZE to access the data that follows the prefix. To obtain the address of subsequent fields, add the field STJQOHDR to the start of the prefix.

The fields in the STATJQ prefix are:

Field Name: Description
STJQEYE: Eycatcher C‘SJQE’.
STJQOHDR: Offset from the start of the STATJQ to the first job information data section.
STJQNEXT: 31-bit address of the next STATJQ area on the STATJOBF chain.
STJQNEXT_64: 64-bit address of the next STATJQ area on the STATJOBF_64 chain.
STJQOSS: Name of the subsystem that created this entry.
STJQSE: If SYSOUT data is requested, this is the 31-bit head of the SYSOUT information elements (STATSE) for this job.
STJQSE_64: If SYSOUT data is requested, this is the 64-bit head of the SYSOUT information elements (STATSE) for this job.
STJQVRBO: 31-bit address of STATVE for this job.
STJQVRBO_64: 64-bit address of STATVE for this job.
STJQVSRB: 31-bit address of first STATVO for this job.
STJQVSRB_64: 64-bit address of first STATVO for this job.

Information Element Data Sections: The variable data sections, which contain information about the job, follow the STATJQ prefix. Each section starts with a 2-byte length, a 1-byte section type, and a 1-byte section modifier. The data length can be from 1 through 65535 bytes. The type and modifier are used to determine the mapping needed to access the data in the section. The first section after the STATJQ prefix is a special 4-byte section which describes the length and type of all sections that follow. The DSECTs that map each section are in the IAZSSST macro.

Job Queue Element 1st Section: This section is mapped by the STATJQHD DSECT and is identified by a type of STHD1HDR (0) and a modifier of STHD1MOD (0). This is the only fixed-size section with a length of STHDSIZE (4 bytes). The length in this section is the total length of all sections that follow.

The fields in the STATJQHD section are:

Field Name: Description
STHDLEN: Length of all sections which follow (including this section)
STHDTYPE: Section type identifier of STHD1HDR (0)
STHDMOD: Section type modifier of STHD1MOD (0)
STHDSIZE: Length of this section (4 bytes)

Job Queue Element Terse Section: This section is mapped by the STATJQTR DSECT and is identified by a type of STTRTERS (1) and a modifier of STTRTMOD (0). All job information elements have at least one section of this type. This section contains information common to all types of jobs.

The fields in the STATJQTR section are:

Field Name

Description

STTRLEN

Length of this section

STTRTYPE

Section type identifier of STTRTERS (1)

STTRMOD

Section type modifier of STTRTMOD (0)

STTRNAME

Job name

STTRJID

Job ID

STTROJID

Original job ID. This might be different from STTRJID if the job was sent using NJE.

STTRCLAS

Job execution class.

In JES2, started tasks (STCs) have a job class of ‘$’ and time sharing users (TSUs) have a job class of ‘@’.

STTRONOD

Job's origin node. Whether or not the local node name appears in the destination depends on the setting of the STAT1LCL option bit.

STTRXNOD

Job's execution node. Whether or not the local node name appears in the destination depends on the setting of the STAT1LCL option bit.

STTRPRND

The default print node for the job. Whether or not the local node name appears in the destination depends on the setting of the STAT1LCL option bit.

STTRPRRE

The default print remote or user ID for the job. Whether or not the local node name appears in the destination depends on the setting of the STAT1LCL option bit.

STTRPUND

The default punch node for the job. Whether or not the local node name appears in the destination depends on the setting of the STAT1LCL option bit.

STTRPURE

The default punch remote for the job. Whether or not the local node name appears in the destination depends on the setting of the STAT1LCL option bit.

STTROUID

The user ID currently assigned as the owner of the job by the security product.

STTRSECL

The SECLABEL currently assigned to the job by the security product.

STTRSYS

MVS™ system name where the job is active (blank if the job is not active).

STTRMEM

JES member name where the job is active (blank if the job is not active).

STTRDEVN

JES device name on which the job is active (blank if the job is not active on a device).

STTRPHAZ

Current job phase. See STATPHAZ for a list of possible values.

STTRHOLD

Current hold state for the job.

Field Value: Description
STTRJNHL: Job is not held
STTRJHLD: Job is held
STTRJHLD: Job is held for duplicate job name

STTRJTYP

Type of job

Field Value: Description
STTRSTC: Started task
STTRTSU: Time sharing user
STTRJOB: Batch job
STTRAPPC: APPC initiator

STTRPRIO

Job's priority

STTRARMS

Job's automatic restart manager status

Bit Value: Description
STTRARMR: Job is automatic restart manager registered
STTRARMW: Job is awaiting automatic restart manager restart

STTRMISC

Miscellaneous indicators

Bit Value: Description
STTRMSPN: JESLOG for this job is spinable
STTRPEOM: Indicates job is being process for End of Memory
STTRJCLD: JESJCLIN dataset available
STTRSYSL: MVS SYSLOG job

STTRMXRC

The status of job execution. While the job is executing, the STTRMXCC value (if set) is dependent on the JOBRC= value that is specified for the job. By default, STTRMXCC is set to the highest return code of any executed step; however, STTRMXCC can be the return code of a specific step or the last step that executed. The STTRXREQ bit is set to on if the STTRMXCC value is affected by JOBRC processing.

Field Name

Description

STTRXIND

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

Bit Value: Description
STTRXAB: If this bit is on, STTRMXCC contains an ABEND code.
STTRXCDE: If this bit is on, STTRMXCC contains a completion code.
STTRXREQ: The JOBRC completion code was set.
STTRXUNK: 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.
STTRXNRM: Job executed and ended normally. (+)
STTRXCC: Job executed and ended by completion code. (+)
STTRXJCL: Job had a JCL error.
STTRXCAN: Job was canceled before execution completed.
STTRXABN: Job ABENDed during execution. (+)
STTRXCAB: Converter ABENDed while processing the job.
STTRXSEC: Job failed input processing security checks.
STTRXEOM: Job failed during execution and was processed in end-of-memory. (+)
STTRXCNV: Job did not execute due to a converter error.
STTRXSYS: Job was executing when a system failed.

STTRMXCC

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

STTRQPOS

Job's position on its queue. This is only returned when the input flag STATSQPS is set. In JES3, when the job has not been selected for main, but has at least reached the converter/interpreter phase, the job queue position is determined relative to jobs in the same Generalized Main Scheduling (GMS) group that are ahead of the job in question.

STTRJNUM

Binary job number.

STTRSPUS

Percent SPOOL utilization. The format is xxx.xxxx. Value is ***.**** if unknown.

STTRSLOG

If this is a SYSLOG job (STTRSYSL is on) MVS system name log is for

STTRJCOR

Job correlator. Refer to z/OS JES Application Programming for more information on the job correlator.

STTRSPAC

Number of track groups of SPOOL space used by the job. A value of -1 indicates that the count is not available.

Job Queue Element JES2 Terse Section: This section is mapped by the STATJ2TR DSECT and is identified by a type of STJ2TERS (2) and a modifier of STJ2TMOD (0). This section is present if the job information came from a JES2 subsystem. This section contains JES2-specific information common to all types of jobs.

The fields in the STATJ2TR section are:

Field Name

Description

STJ2LEN

Length of this section

STJ2TYPE

Section type identifier of STJ2TERS (2)

STJ2MOD

Section type modifier of STJ2TMOD (0)

STJ2FLG1

General flag byte

Bit Value: Description
STJ21PRO: Job is protected
STJ21IND: Job is set to independent mode
STJ21SYS: Job represents a system data set
STJ21CNW: Job can only be processed by a converter that can wait for OS resources
STJ21RBL: Job is on the JES2 rebuild queue

STJ2JKEY

The JES2 job key for the JOB

STJ2SPOL

The SPOOL token associated with the job

STJ2SPAC

In z/OS 2.1 and later versions, STTRSPAC replaces STJ2SPAC.

STJ2DPNO

Binary default print node

STJ2DPRM

Binary default print remote

STJ2DPUS

Default print user ID

STJ2INPN

Binary input node

STJ2XEQN

Binary execution node (if job has completed execution).

STJ2JQEI

Index of JQE

STJ2OFSL

Offload status mask

STJ2BUSY

Binary busy byte

Job Queue Element Member Affinity Section: This section is mapped by the STATAFFS DSECT and is identified by a type of STAFFIN (3) and a modifier of STAFTMOD (0). This section is present if the job has affinities to a subset of members. This section is not present if the job can run on any member.

The fields in the STATAFFS section are:

Field Name: Description
STAFLEN: Length of this section
STAFTYPE: Section type identifier of STAFFIN (3)
STAFMOD: Section type modifier of STAFTMOD (0)
STAFNUM: Number of members for which the job has affinity
STAFMEMB: First member for which job has affinity. Other member names follow after this member name. The number of member names present is in field STAFNUM.