Job Dependency Block Elements
For each Job Information Element (STATDB) returned, additional Job Dependency Block Elements (STATDBs) may be attached to it, if requested.
Each Job dependency Block Element describes a parent/dependent relationship or a concurrent relationship between two jobs.
- Use the STAT2DEP option. If a job participates in a Job Group Dependency Network, all dependencies the job is involved in will be returned via the STJQDEP8/STJQDEP4 STATDB chain in the STATJQ.
- Use the STAT2ZDN option. If a job is being returned that represents a Job Group Dependency Network, and dependencies exist in the network, STATDBs for ALL the dependencies in the network are returned via the STZNDEP8/STZNDEP4 chain in the STATJZDN subsection of the STATJQ.
Job Dependency Block Element Prefix: Each Job Dependency Block Element starts with a prefix area. This area is mapped by the STATDB DSECT in the IAZSSST macro.
Depending on options, STJQDEP8/STJQDEP4 or STZNDEP8/STZNDEP4 may point to the start of the first prefix area in a chain of Job Dependency blocks. Subsequent areas are chained using the STDBNXT8/STDBNXT4 field. Because the size of the prefix area can vary as a result of service being applied, do not use the equate STDSIZE to access the data that follows the prefix. Instead, to obtain the address of subsequent fields, add the field STDBOHDR to the start of the prefix.
- Field Name
- Description
- STDBEYE
- Eycatcher C'SDEP'.
- STDBOHDR
- Offset from the start of the STATDB to the first job dependency block data section.
- STDBNXT8
- If STAT1B64 is ON, the 64-bit address of the next STATDB area in the current STATDB chain.
- STDBNXT4
- If STAT1B64 is OFF, the 31-bit address of the next STATDB area in the current STATDB chain.
Job Dependency Block Element Data Sections: The variable data sections, which contain information about the dependency, follow the STATDB 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 Dependency Block Element 1st Section: This section is mapped by the STATDBHD DSECT and is identified by a type of STDB1HDR (8) and a modifier of STDH1MOD (0). This is the only fixed-size section and has a length of STDHDSIZ (4 bytes).. The length in this section is the total length of all sections that follow.
- Field Name
- Description
- STDHLEN
- Length of all sections which follow (including this section)
- STDHTYPE
- Section type identifier of STDB1HDR (8)
- STDHMOD
- Section type modifier of STDH1MOD (0)
- STDHDSIZ
- Length of this section (4 bytes)
Job Dependency Block Element Terse Section: This section is mapped by the STATDBTE DSECT and is identified by a type of STDBTERS (9) and a modifier of STDTTMOD (0). All job dependency block (STATDB) elements have one section of this type.
- Field Name
- Description
- STDTLEN
- Length of this section.
- STDTTYPE
- Section type identifier of STDBTERS (9).
- STDTMOD
- Section type modifier of STDTTMOD (0).
- STDTDTYP
- Dependency type.
- Value (Decimal)
- Meaning
- STDTDEP (1)
- Parent/Dependent relationship.
- STDTCON (2)
- Concurrent relationship.
- STDTSTAT
- Dependency status. All dependencies start out as PENDING and end
up as COMPLETE.
- Value (Decimal)
- Meaning
- STDTPEND (0)
- Dep Status = PENDING
- STDTCOMP (1)
- Dep Status = COMPLETE
- STDTUDEF (2)
- Dep Status = UNDEFINED (can only exist in JES2 NET (DJC) networks).
- STDTCSTA
- Dependency completion status. Once a dependency is COMPLETE, this
value is set to the result of evaluating the WHEN= expression and
the resulting ACTION= or OTHERWISE= action.Note: This field is not meaningful for concurrent (STDTCON) dependencies.
- Value (Decimal)
- Meaning
- STDTCSAT (0)
- The completed dependency is SATISFY.
- STDTCFLU (1)
- The completed dependency is FLUSH.
- STDTCFAI (2)
- The completed dependency is FAIL.
- STDTCDEF (3)
- The completed dependency is DEFER (maps to RETAIN for JES2 NET (DJC) networks).
- STDTWHFL
- WHEN= output text flag byte.Note: This field is not meaningful for concurrent (STDTCON) dependencies.
- Bit Value
- Description
- STDTWPTR
- If ON, STDTWHEN was not large enough to contain the WHEN= printable text. Instead, STDTWHEN contains a pointer (STDTWHE8/STDTWHE4) to a larger buffer. Following the pointer is a two byte value denoting the length of printable text.
- STDTWHEN
- WHEN= expression text buffer if STDTWPTR is OFF.
- STDTACTN
- Defined ACTION= value. STDTCSTA is set to this value when the
WHEN= expression evaluates to TRUE.
- Value (Decimal)
- Meaning
- STDTASAT (0)
- ACTION=SATISFY
- STDTAFLU (1)
- ACTION=FLUSH
- STDTAFAI (2)
- ACTION=FAIL
- STDTADEF (3)
- ACTION=DEFER (maps to RETAIN for JES2 NET (DJC) networks).
- STDTOTHR
- Defined OTHERWISE= value. STDTCSTA is set to this value when the
WHEN= expression evaluates to FALSE.
- Value (Decimal)
- Meaning
- STDTOSAT (0)
- OTHERWISE=SATISFY
- STDTOFLU (1)
- OTHERWISE=FLUSH
- STDTOFAI (2)
- OTHERWISE=FAIL
- STDTODEF (3)
- OTHERWISE=DEFER (maps to RETAIN for JES2 NET (DJC) networks).
- STDTPJBN
- Parent job name or concurrent 'job 1' name.
- STDTPJID
- Parent job ID or concurrent 'job 1' ID.
- STDTDJBN
- Dependent job name or concurrent 'job 2' name.
- STDTDJID
- Dependent job ID or concurrent 'job 2' ID.
- STDTSIZE
- Length of this section.