|
|
|
The output is stored in an output variable. The default output variable name is OPSJESX. You can change the default name by specifying a varStem value on the STEM keyword.
There are two kinds of output variables:
The number of jobs in the output is returned to the variable named varStem.0. The OPSJESX function returns the same value that is contained in varStem.0.
varStem_SeNa.n
Specifies the section name, which can be the following: JQTR, J2TR, AFFS, SCHD, SCHS, SCLF, J3TR
Identifies the output number of the corresponding job (n=1 for 1st returned job, n=2 for 2nd returned job, and so on).
The sections returned correspond to the sections requested by keycode value on the input SECTIONS keyword. The JQTR section is always returned.
If a section is empty (does not exist) for a job, the variable for that section is not created for that job.
The individual pieces of job information in each section are Words in the section variable. The mapping of the WORDs in each section is provided in Section Variable Output Mappings.
These sections correspond to the Job Information Elements for the Extended Status Function Call (SSI 80) as described in the IBM guide z/OS MVS Using the Subsystem Interface. To determine the name of the Job Information Element that corresponds to a keycode, add the prefix STAT to the keycode. For example, STATJQTR is the name of the Job Information Element that corresponds with keycode JQTR.
The Words returned for each section correlate to fields provided in the IBM mapping for each Job Information Element in IAZSSST macro. The fields are also described under Job Information Elements for the Extended Status Function Call in the IBM guide z/OS MVS Using the Subsystem Interface. In the descriptions below, the correlating IBM field name is given in parenthesis.
This section contains common fields, which are common for all job types.
Length: 8
Contains: Job name (STTRNAME)
Length: 8
Contains: Job id (STTRJID)
Length: 8
Contains: Original Job id (STTROJID)
Length: 8
Contains: Job class (STTRCLAS)
Length: 8
Contains: Origin Node (STTRONOD)
Length: 8
Contains: Execution Node (STTRXNOD)
Length: 8
Contains: Default Print Node (STTRPRND)
Length: 8
Contains: Default Print Remote Name (STTRPRRE)
Length: 8
Contains: Default Punch Node (STTRPUND)
Length: 8
Contains: Default Punch Remote (STTRPURE)
Length: 8
Contains: Owner User ID (STTROUID)
Length: 8
Contains: SECLABEL (STTRSECL) – will show INACTIVE if job is not active
Length: 8
Contains: MVS system (STTRSYS) – will show INACTIVE if job is not active
Length: 8
Contains: JES2 member (STTRMEM) – will show INACTIVE if job is not active
Length: 18
Contains: Name of device for job (STTRDEVN) – will show N/A if job is not active
Length: 6
Contains: Job Phase (STTRPHAZ) – in IBM mapping this is a one byte field. For OPSJESX, it is translated into text for the Phase. The possible values are the same as listed for the PHASE keycode above.
Length: 9
Contains: Job Hold indicator (STTRHOLD) – in IBM mapping this is a one byte field. For OPSJESX, it is translated into text for the hold status. The possible values are: NOTHELD, HELD, or DUPLICITY.
Length: 4
Contains: Job type (STTRJTYP) – in IBM mapping this is a one byte field. For OPSJESX, it is translated into text for the job type. The possible values are: STC, TSU, JOB, or APPC.
Length: 3
Contains: Job priority (STTRPRIO)
Length: 2
Contains: Job ARM status (STTRARMS). It contains 2 hexadecimal numbers.
Length: 2
Contains: Job miscellaneous indicators (STTRMISC). It contains 2 hexadecimal numbers.
Length: 8
Contains: Job completion indicator (STTRXIND) – in IBM mapping this is a one byte field. For OPSJESX, it is translated into text for the job completion indicator. The possible values are: N/A, NORMAL, CC, JCLERR, CANCELED, ABEND, CABEND, SECERR, or EOM.
Length: 7
Contains: Max return code (STTRMXCC) – in IBM mapping this is a 4 byte field. For OPSJESX, it is translated into a 7 byte field formatted as:
SAC:UAC
Length: 11
Contains: Job position on class or phase queue (STTRQPOS)
Length: 8
Contains: Binary job number (STTRJNUM)
Length: 7
Contains: Percent SPOOL Utilization (STTRSPUS) – format x.xxxx%
Length: 8
Contains: MVS system name for log if SYSLOG job (STTRSLOG)
This section is created only if the job came from a JES2 subsystem. It contains JES2 specific information common for all job types.
Length: 2
Contains: IBM mapping field (STJ2FLG1). It contains 2 hexadecimal numbers.
Length: 8
Contains: The JES2 job key for the job (STJ2JKEY). It contains 8 hexadecimal numbers.
Length: 16
Contains: The spool token associated with the job (STJ2SPOL). It contains 16 hexadecimal numbers.
Length: 11
Contains: The number of track groups of SPOOL space used by the job (STJ2SPAC). Possible value -1 indicates the count is not available.
Length: 4
Contains: Default print node (STJ2DPNO). It contains 4 hexadecimal numbers.
Length: 4
Contains: default print remote (STJ2DPRM). It contains 4 hexadecimal numbers.
Length: 8
Contains: Default print user ID (STJ2DPUS)
Length: 4
Contains: Input node (STJ2INPN). It contains 4 hexadecimal numbers.
Length: 4
Contains: Execution node (STJ2XEQN). It contains 4 hexadecimal numbers.
Length: 8
Contains: Index of JQE (STJ2JQEI). It contains 8 hexadecimal numbers.
Length: 2
Contains: Offload status mask (STJ2OFSL). It contains 2 hexadecimal numbers.
Length: 2
Contains: Busy byte (STJ2BUSY). It contains 2 hexadecimal numbers.
This section is created if the job has affinities to a subset of members.
Length: 5
Contains: The number of members for which the job has affinity (STAFNUM)
where n = (number of members from Word 1) + 1 to a maximum of n = 65
Length: 8
Contains: Each Word contains a member from the list of members (STAFMEMB).
Note: If the number of members is greater than 64, then only first 64 members are in the output variable, but the number of members remains unchanged.
This section is created if the job is scheduled for execution. This section cannot be returned by JES3 subsystem.
Length: 2
Contains: Reasons why the job will not run (STSCAHLD). It contains 2 hexadecimal numbers.
Length: 3
Contains: Job class mode (STSCFLG1). Possible values are: JES or WLM.
Length: 4
Contains: ASID where job is executing (STSCASID). It contains 4 hexadecimal numbers.
Length: 8
Contains: Service class (STSCSRVC)
Length: 11
Contains: Estimated time to execute in seconds for the job. (STSCESTT). It is available only if the job is awaiting execution or is scheduled to WLM class or is not held or can currently run. -1 is possible value.
Length: 16
Contains: Scheduling environment required by the job (STSCSENV)
Length: 11
Contains: Position of the job on a WLM service class queue (STSCQPOS)
Length: 11
Contains: Number of jobs on this WLM service class queue (STSCQNUM)
Length: 11
Contains: Number of active jobs on this WLM service class queue (STSCQACT)
Length: 11
Contains: Average queue time for jobs in the WLM service class (STSCAVGQ). -1 is possible value.
Length: 11
Contains: Actual queue time for the job (STSCQTIM). -1 is possible value.
This section is created if the job is scheduled for execution, requires a scheduling environment (environment is available on at least one system). This section cannot be returned by JES3 subsystems.
Length: 5
Contains: The number of systems which have required scheduling environment (STSSNUM)
where n = (number of systems from Word 1) + 1 to a maximum of n = 65
Length: 8
Contains: Each Word contains a system from the list of systems (STSSSYS)
Note: If the number of systems is greater than 64, then only first 64 systems are in the output variable, but the number of systems remains unchanged.
This section is created if the SECLABEL by system RACF option is enabled and the job is queued for conversion processing or execution. This section cannot be returned by JES3 subsystems.
Length: 5
Contains: The number of systems where the SECLABEL is active. (STSLNUM)
where n = (number of systems from Word 1) + 1 to a maximum of n = 65
Length: 8
Contains: Each Word contains a system from the list of systems (STSLSYS).
Note: If the number of systems is greater than 64, then only first 64 systems are in the output variable, but the number of systems remains unchanged.
This section is created only if the job is owned by a JES3 subsystem.
Length: 16
Contains: Spool data token (STJ3SPOL). Token contains 16 hexadecimal numbers.
Length: 64
Contains: List of reasons, why job is waiting to run (STJ3JSTT). Each reason contains 2 hexadecimal numbers. Reasons are concatenated. The maximum number of reasons is 32.
where n = (number of reasons) + 2 to a maximum of n = 34
Length: 8
Contains: Each Word contains a system from the list of systems (STJ3JSTM). Each system name corresponds to the reason.
Note: Additional examples are provided in the topic OPSJESX Function Examples.
The following OPSJESX call returns job information for all class A jobs. For each job, the JQTR and J2TR sections are returned.
rtvl = OPSJESX("S","CLASS(A) SECTION(J2TR)”)
If there are 3 class A jobs returned in the output, the output variables are:
number of jobs returned
JQTR section for 1st job returned
WORDS 1 -27 contain job information as documented for JQTR above
JQTR section for 2nd job returned
WORDS 1 -27 contain job information as documented for JQTR above
JQTR section for 3rd job returned
WORDS 1 -27 contain job information as documented for JQTR above
J2TR section for 1st job returned
WORDS 1 –12 contain job information as documented for J2TR above
J2TR section for 2nd job returned
WORDS 1 –12 contain job information as documented for J2TR above
J2TR section for 3rd job returned
WORDS 1 –12 contain job information as documented for J2TR above
Note: If a section does not exist for a job, the section variable for that job will not be created. For example, if a J2TR section did not exist for job 2, the OPSJESX_J2TR.2 variable would not be created.
| Copyright © 2012 CA. All rights reserved. | Tell Technical Publications how we can improve this information |