|
Input parameters for the function routine are:
SSOB Contents: The caller sets the following fields
in the SSOB control block on input: - Field Name
- Description
- SSOBID
- Identifier ‘SSOB’
- SSOBLEN
- Length of the SSOB (SSOBHSIZ) control block
- SSOBFUNC
- SSI function code 80 (SSOBESTA)
- SSOBSSIB
- Address of an SSIB control block or zero (if this field is zero,
the life-of-job SSIB is used). See Subsystem Identification Block (SSIB) for
more information on the life-of-job SSIB.
- SSOBINDV
- Address of the function-dependent area (IAZSSST control block).
Set all other fields in the SSOB control block to
binary zeros before issuing the IEFSSREQ macro.
SSIB Contents: If you do not use the life-of-job
SSIB, the caller must provide an SSIB and set the following fields
in the SSIB control block on input: - Field Name
- Description
- SSIBID
- Identifier ‘SSIB’
- SSIBLEN
- Length of the SSIB (SSIBSIZE) control block
- SSIBSSNM
- Subsystem name — name of the subsystem to which this extended
status function call is directed (or MSTR if it is to be broadcast).
Set all other fields in the SSIB control block to binary zeros
before issuing the IEFSSREQ macro.
IAZSSST Contents: The caller must set the following
fields in the IAZSSST control block on input: - Field Name
- Description
- STATLEN
- Length of the IAZSSST (STATSIZE) control block. For STATVER, set
to STATV010 or STATV020, a length of at least STATSIZ1 or STATSIZ2
is required. For STATVER set to STATV030 or greater, a length of at
least STATSIZ3 is required. STATSIZE is always equated to the largest
length of the IAZSSST control block and in general should be used
to obtain storage for the IAZSSST and to set STATLEN.
- STATEYE
- Eyecatcher for the control block (set to C'STAT')
- STATVER
- Input version of the IAZSSST control block (set to STATV010 for
the initial version of the control block, STATV020 for OS/390® Version 2 Release 4, STATV030 for OS/390 Version 2 Release 5, STATV040
for z/OS® V1R7, STATV050 for z/OS V1R9, STATV060 for z/OS V1R10, STATV070
or STATV071 for z/OS V1R11, or STATV080 for z/OS V2R1).
- STATTYPE
- Function to be performed on this request. Valid functions are:
- Field Value
- Description
- STATTERS
- Requests obtaining terse job level data. The data returned on
this call does not require large amounts of system overhead.
- STATVRBO
- Requests obtaining verbose job level data. The data returned on
this call includes that returned for the terse job level call. STATVER
must be set to at least STATV040 for this request to be valid. The
request requires system overhead for I/O to obtain the data.
- STATMEM
- Return memory from a previous request. After one or more requests
for data, the memory obtained must be returned using this function.
- STATOUTT
- Requests obtaining terse SYSOUT level data (including job level
information). Data returned on this call does not require large amounts
of system overhead. STATVER must be set to at least STATV030 for
this request to be valid.
- STATOUTV
- Requests obtaining verbose SYSOUT level data. The data returned
on this call includes that returned for the terse SYSOUT level call.
STATVER must be set to at least STATV040 for this request to be valid.
The request requires system overhead for I/O to obtain the data. Terse
and verbose output for running jobs is also returned.
- STATDLST
- Requests data set list for a job. This request obtains verbose
type information for all data sets associated with a job. It includes
information on SYSIN and other internal data sets. It is only valid
for STATV060 and above callers.
The caller can also set the following fields in the IAZSSST control
block on input to limit (or select) the jobs for which data will be
returned: - STATSEL1
- Flag byte which describes the filters to use to select jobs.
Each bit corresponds to a filter field which must match any job returned.
- Bit Name
- Description
- STATSCLS
- Apply job class filter in STATCLSL or STATCLSP. Only
one class needs to match. If only specifying one class it must be
specified in STATCLSL.
- STATSDST
- Apply default destination filter in STATDEST or STATDSTP.
Only one destination needs to match. If only specifying one destination
it must be specified in STATDEST.
- STATSJBN
- Apply job name filter in STATJOBN or STATJBNP. Only
one job name needs to match. If only specifying one job name it must
be specified in STATJOBN. STATSJBN cannot be specified with STATSJIL.
- STATSJBI
- Apply job ID filters in STATJBIL and STATJBIH. STATSJBI
cannot be specified with STATSCTK, STATSJIL or STATSCOR.
- STATSOJI
- Apply original job ID filter in STATOJBI. Not supported in JES3.
- STATSOWN
- Apply current owner filter in STATOWNR.
- STATSSEC
- Apply current SECLABEL filter in STATSECL.
- STATSSUB
- Apply submitter filter in STATSUBR (only supported by JES3).
- STATSEL2
- Flag byte which describes the type of jobs for which data is requested.
All type bits set on (STATSTYP) or all bits set off select
all job types.
- Bit Name
- Description
- STATSSTC
- Started tasks are selected.
- STATSTSU
- Time sharing users are selected.
- STATSJOB
- Batch jobs are selected.
- STATSAPC
- APPC initiators are selected. Because APPC initiators are also
started tasks they are also returned if STATSSTC is specified. Use
only STATSAPC to select only APPC initiators.
- STATSEL3
- Flag byte which describes the filters to use to select jobs.
Each bit either corresponds to a filter field which must match any
job returned or is a criteria for selecting jobs to return.
- Bit Name
- Description
- STATSPRI
- Apply JES job priority filter in STATPRIO.
- STATSVOL
- Apply SPOOL volume filters in STATVOL (this is valid only when
requesting data from a JES2 subsystem).
- STATSPHZ
- Apply current job phase in STATPHAZ.
- STATSHLD
- Select jobs that are currently held. Setting both STATSHLD and
STATSNHL on is the same as setting both bits off.
- STATSNHL
- Select jobs that are not currently held. Setting both STATSNHL
and STATSHLD on is the same as setting both bits off.
- STATSSYS
- Only jobs active on the system listed in STATSYS are returned.
- STATSMEM
- Only jobs active on the JES member listed in STATMEMB are returned.
(Only supported by JES2.)
- STATSPOS
- Include jobs queue position information for jobs awaiting execution
on WLM service class queues. Setting this bit causes the fields STSCQPOS,
STSCQNUM, and STSCQACT to be set if available. Calculating queue position
will increase the processing overhead associated with a request.
STATVER must be set to STATV020 or greater to use this filter.
Note: - In a JES2 environment, WLM service class queue information is
always returned regardless of the setting for STATSPOS.
- In a JES3 environment, WLM service class queue information is
returned only if STATSPOS is specified.
- Be aware that there is a performance penalty in a JES3 environment
when STATSPOS is set and there is a large number of jobs in a service
class queue along with a request that selects a large number of those
jobs.
- STATSEL4
- Flag byte which describes the filters to use to select jobs.
Each bit corresponds to a filter field which must match any job returned.
- Bit Name
- Description
- STATSORG
- Apply origin node filter in STATORGN. Only supported by JES2.
- STATSXEQ
- Apply execution node filter in STATXEQN. Only supported by
JES2.
- STATSSRV
- Apply WLM service class filter in STATSRVC. When filtering by
service class and not filtering by job number (STATSJBI) nor job phase
(STATSPHZ), only jobs on the service class queue specified in STATSRVC
are returned. When filtering on job number or job phase, any job
assigned the service class specified in STATSRVC is returned (even
if the job is not in a WLM-managed job class). Service classes are
only available if the job has completed conversion processing and
has not completed execution processing. This filter is only supported
by JES2 subsystems. STATVER must be set to STATV020 or greater to
use this filter.
- STATSSEN
- Apply scheduling environment filter in STATSENV.
- STATSCLX
- Apply job class filter in STATCLSL and STATCLSP only to jobs in
STAT-SELECT or STAT-ONMAIN phases.
- STATSOJD
- Do not apply job name filter in STATJOBN and STATJBNP and job
id filters in STATJBIL and STATJBIH to jobs that created OUTPUT with
STST1APC on. STATSOJD cannot be specified with STATSJIL. (Only supported by JES2.)
- STATSQPS
- Always return current job position in the queue (even if a special
queue scan is necessary).
- STATSJIL
- Use STATJBNP as a list of 8 character JES JOBIDs for which information
is to be returned. The complete list is specified using STATJBNP.
JOBIDs cannot be specified using STATJBIL and STATJBIH when STATSJIL
is specified. STATSJIL cannot be specified with STATSJBN, STATSJBI,
STATSCTK, STATSTPI, STATSTPN, STATSOJD or STATSCOR.
- STATSSL1
- Flag byte which describes the SYSOUT filters to use to select
data to return. Each bit corresponds to a filter field which must
match for data to be returned. If JOB data is requested (STATTERS)
then only jobs with SYSOUT that match the specified filters are returned.
If SYSOUT data is requested, then data for SYSOUT that matches these
filters is returned along with the corresponding job level data. STATVER
must be set to STATV030 or greater to use these filters.
- Bit Name
- Description
- STATSCTK
- Use the SYSOUT token in STATCTKN as a filter. SYSOUT tokens can
be obtained from dynamic allocation or field STSTCTKN from a previous
extended status request. STATSCTK cannot be specified
with STATSJBI or STATSCOR.
- STATSSOW
- Apply the SYSOUT owner filter in STATSCRE.
- STATSSDS
- Apply the SYSOUT destination filter in STATSDES.
STATSDSP also contains additional SYSOUT destination filters. Mutually
exclusive with STATSSLC or STATSSNT.
- STATSSCL
- Apply the SYSOUT class filter in STATSCLA. STATSCLP
also contains additional SYSOUT class filters.
- STATSSWR
- Apply the SYSOUT external writer filter in STATSWTR.
- STATSSHL
- Select SYSOUT that is currently held. This is the
type of hold created by specifying HOLD=YES on the DD statement or
OUTDISP=HOLD on the output card. It also includes SYSOUT that is held
by an operator command or by the system due to a processing error.
Setting both STATSSHL and STATSSNH on is the same as setting both
bits off.
- STATSSNH
- Select SYSOUT that is not currently held. Setting both STATSSHL
and STATSSNH on is the same as setting both bits off.
- STATSSL2
- Flag byte that describes the SYSOUT filters to use to select verbose
data to return. If JOB data is requested (STATVRBO), then only jobs
with SYSOUT that match the specified filters are returned. If SYSOUT
data is requested (STATOUTV), then data for SYSOUT that matches these
filters is returned along with the corresponding job level data. STATVER
must be set to STATV040 or higher and the JES processing the request
must be at the z/OS V1R7 level
or higher to use these filters. On JES3, the global must be at the z/OS V1R7 level or higher.
- Bit name
- Description
- STATSSFR
- Apply the SYSOUT forms name filter in STATSFOR. STATVER
must be set to STATV040 or higher and the JES processing the request
must be at the z/OS V1R7 level
or higher to use these filters. On JES3, the global must be at the z/OS V1R7 level or higher.
- STATSSPR
- Apply the SYSOUT PRMODE filter in STATSPRM. STATVER
must be set to STATV040 or higher and the JES processing the request
must be at the z/OS V1R7 level
or higher to use these filters. On JES3, the global must be at the z/OS V1R7 level or higher.
- STATSSSP
- Apply the Select SPIN output only filter in STATSSSP.
STATVER must be set to STATV040 or higher and the JES processing the
request must be at the z/OS V1R7 level or higher to use these filters. On JES3, the global must
be at the z/OS V1R7 level or
higher.
Note: STATSSSP and STATSSNS are mutually exclusive. If STATSSSP
and STATSSNS are both ON or both OFF, then the spin state of the output
will not be considered.
- STATSSNS
- Apply the non-SPIN output only filter in STATSSNS.
STATVER must be set to STATV040 or higher and the JES processing the
request must be at the z/OS V1R7 level or higher to use these filters. On JES3, the global must
be at the z/OS V1R7 level or
higher.
Note: STATSSSP and STATSSNS are mutually exclusive. If STATSSSP
and STATSSNS are both ON or both OFF, then the spin state of the output
will not be considered.
- STATSSIP
- Select SYSOUT elements that are routed to an IP address. STATVER
must be set to STATV050 or higher and the JES processing the request
must be at the z/OS V1R9 level
or higher to use these filters.
- STATSSNP
- Select SYSOUT elements that are not routed to an IP address. STATVER
must be set to STATV050 or higher and the JES processing the request
must be at the z/OS V1R9 level
or higher to use these filters.
- STATSSOD
- When on with STATSSOW, it indicates to match if SYSOUT is destined
to STATSCRE on the local node. STATVER must be set to STATV050 or
higher and the JES processing the request must be at the z/OS V1R9 level or higher to use these filters.
- STATSSJD
- This is a JES2 only bit.
- If JES2 is running with checkpoint mode z2 in
R11 and STATSJBN is on, it indicates to match if SYSOUT is destined
to STATJOBN or STATJBNP on the local node (ignored if STATSJBN is
off).
- If JES2 is running with checkpoint mode z11
in R11 and STATSJBN and STATSTPN are on, it indicates to match
if SYSOUT is destined to STATJOBN, STATJBNP or transaction job name
on the local node (ignored if STATSJBN is off).
- STATJOBN
- Job name filter (used if STATSJBN is set). The name is 1-8 characters,
left justified, and padded on the right with blanks. The generic
characters ‘*’ and ‘?’ are allowed.
- STATJBIL
Low job ID value (used if STATSJBI is set). The job ID is left
justified and padded on the right with blanks. When STATJBIL is 2-8
characters and starts with one of the prefixes ’J’, ’JO’, ’JOB’, ’T’,
’TS’, ’TSU’, ’S’, ’ST’, ’STC’, ’I’, ’IN’, 'INT’, or '*', then the
suffix is converted to a binary value. Job IDs with a suffix matching
the STATJBIL suffix are returned. The prefix character '*' is not
allowed for verbose requests.
When STATJBIL contains 1-8 characters
with one or more generic characters '*' and '?', and EBCDIC characters
A-Z; 0-9; or national characters @, #, $, then job IDs, as returned
in STTRJID, that match a 1-8 character EBCDIC comparison with STATJBIL
are returned. A single character STATJBIL with '*' or '?' is not allowed.
STATJBIH must be blank. Generics characters '*' or '?' are not allowed
for verbose requests.
When STATSTPI is set and STATJBIL is 2-8
characters starting with the prefix '*', then the suffix is converted
to a binary value. Transaction job IDs with a suffix matching the
STATJBIL suffix are also returned.
When STATSTPI is set and
STATJBIL contains 1-8 EBCDIC characters A-Z; 0-9; national characters
@, #, $; or generic characters '*' and '?', then transaction job IDs,
as returned in STSAJID, that match a 1-8 character EBCDIC comparison
with STATJBIL are also returned. A single character STATJBIL with
'*' or '? is not allowed. When generic characters are used, STATJBIH
must be blank.
Note: INT and IN are valid only in JES3.
- STATJBIH
High job ID value (used if STATSJBI is set). If this field
is not specified, then information is only returned using the filter
specified in STATJBIL. When STATJBIH is 2-8 characters and starts
with one of the prefixes ’J’, ’JO’, ’JOB’, ’T’, ’TS’, ’TSU’, ’S’,
’ST’, ’STC’, ’I’, ’IN’, or 'INT’, then the suffix is converted to
a binary value. Job IDs with a suffix within the range from the STATJBIL
suffix through the STATJBIH suffix are returned. Generics characters
'*' or '?' are not allowed.
When STATSTPI is set, EBCDIC characters
A-Z; 0-9; and national characters @, #, $ are allowed. Job IDs, as
returned in STTRJID, and transaction job IDs, as returned in STSAJID,
within the 1-8 character EBCDIC range from STATJBIL through STATJBIH,
are returned. Generics characters '*' or '?' are not allowed.
Note: INT and IN are valid only in JES3.
The following table
describes examples of jobs returned for STATJBIL when STATJBIH is
blank. Numeric matches are in normal font, EBCDIC matches are in
italicized font. Table 1. Examples of jobs returned for STATJBIL
when STATJBIH is blank.STATJBIL |
Examples of standard job ID matches |
Examples of transaction job ID matches if STATSTPI
is on |
---|
JOB00100 |
Numeric match(es): JOB00100 or TSU00100, and
so on. EBCDIC match(es): not applicable. |
Numeric match(es): not applicable. EBCDIC match(es):JOB00100 |
J100 |
Numeric match(es): JOB00100 or TSU00100, and
so on. EBCDIC match(es): not applicable. |
Numeric match(es): not applicable. EBCDIC match(es):J100. |
A100 |
Numeric match(es): not applicable. EBCDIC match(es):
not applicable. Error if STATSTPI is not on. |
Numeric match(es): not applicable. EBCDIC match(es):A100 |
*0000100 |
Numeric match(es): JOB00100 or TSU00100, and
so on. EBCDIC match(es): no additional matches. |
Numeric match(es): JOB00100, A0000100, Z100,
ZZZZZ100, and so on. EBCDIC match(es): no additional matches. |
*100 |
Numeric match(es): JOB00100 or INT00100, and
so on. EBCDIC match(es): JOB09100, T9999100, and so
on. |
Numeric match(es): JOB00100, A0000100, Z100,
and so on. EBCDIC match(es): JOB09100, T9999100, Z99100, and so on. |
*5555555 |
Numeric match(es): J5555555 or T5555555, and
so on. EBCDIC match(es): no additional matches. |
Numeric match(es): J5555555, A5555555, Z5555555,
and so on. EBCDIC match(es): 55555555 |
*555555 |
Numeric match(es): JO555555 or ST555555 and
so on. EBCDIC match(es), T9555555, J8555555, and so
on. |
Numeric match(es):JO555555, ZZ555555, and so
on. EBCDIC match(es): Z5555555, 55555555, and so on. |
J* |
Numeric match(es): not applicable. EBCDIC match(es): JOB00100, JO123456, J7654321. |
Numeric match(es): not applicable. EBCDIC match(es):JOB00100, JO123456, J7654321, J9, JAMES, and so on. |
?OB00100 |
Numeric match(es): not applicable. EBCDIC match(es) JOB00100. |
Numeric match(es): not applicable. EBCDIC match(es):JOB00100, ZOB00100, and so on. |
?0000100 |
Numeric match(es): not applicable. EBCDIC match(es):
not applicable. |
Numeric match(es): not applicable. EBCDIC match(es):A0000100, Z0000100, and so on. |
?11 |
Numeric match(es): not applicable. EBCDIC match(es):
not applicable. |
Numeric match(es): not applicable. EBCDIC match(es):A11, 911, and so on. |
?1? |
Numeric match(es): not applicable. EBCDIC match(es):
not applicable. |
Numeric match(es): not applicable. EBCDIC match(es):A1A, B11, and so on. |
*0001?0 |
Numeric match(es): not applicable. EBCDIC match(es):
not applicable. |
Numeric match(es): not applicable. EBCDIC match(es):A0000110, Z00001A0, K0001J0, KT0001P0, and
so on. |
10* |
Numeric match(es): not applicable. EBCDIC match(es):
not applicable. |
Numeric match(es): not applicable. EBCDIC match(es):10000000, 10A, and so on. |
ZZ#00100 |
Numeric match(es): not applicable. EBCDIC match(es):
not applicable. Error if STATSTPI is not on. |
Numeric match(es): not applicable. EBCDIC match(es):ZZ#00100 |
- STATOJBI
- Job ID value originally assigned to the job (used if STATSOJI
is set). The original job ID can differ from the current job ID if
the job was sent using NJE. The job ID is 2-8 characters, left justified,
and padded on the right with blanks. The JOBID must start with either
the character ‘J’ or ‘JOB’ a is followed by the original job number.
Not supported in JES3.
- STATOWNR
- Current user ID that the security product has assigned as owner of the job
(used if STATSOWN is set). The owner is 1-8 character, left justified,
and padded on the right with blanks. The generic characters ‘*’ and
‘?’ are allowed.
- STATSECL
- Current SECLABEL that the security product has assigned to the job (used
if STATSSEC is set). The SECLABEL is 1-8 character, left justified,
and padded on the right with blanks. The generic characters ‘*’ and
‘?’ are allowed.
- STATDEST
- Default print or punch destination assigned to the job (used if
STATSDST is set). The destination 1-18 character, left justified,
and padded on the right with blanks. The format of the destination
is the same as that allowed on DEST= on the OUTPUT statement.
In
JES2, the user ID portion of the destination can contain the generic
characters ‘*’ and ‘?’. This can match jobs with a default print
route code that contains a corresponding user ID routing. However,
destinations of the format ‘R*’, ‘RM*’, ‘RMT*’, ‘U*’, and ‘N*’ will
not match jobs with a default print route code of remote, special
local, or NJE.
- STATORGN
- NJE node where the job originated (used if STATSORG is set). The
origin node is 1-8 character, left justified, and padded on the right
with blanks. Only supported by JES2.
- STATXEQN
- NJE node where the job is to, or was, executed (used if STATSORG
is set). The execution node is 1-8 character, left justified, and
padded on the right with blanks. Only supported by JES2.
- STATCLSL
- The job class associated with the job (used if STATSCLS is set).
The job class is 1-8 character, left justified, and padded on the
right with blanks.
In JES2, the job class can be only 1 character
long. The special job classes of ‘$’ for started tasks (STCs) and
‘@’ for time sharing users (TSUs) are also supported.
- STATVOL
- This keyword is supported when requesting information from a JES2
subsystem only. This field contains a list of up to four VOLSERs
associated with SPOOL. A job is selected only if it has space on
at least one of the specified SPOOL volumes (used if STATSVOL is set).
The SPOOL VOLSERs are each 1-6 character, left justified, and padded
on the right with blanks. Unused entries can be set to blanks or
zero.
- STATSYS
- The name of the MVS™ system
on which the job must be active (used if STATSSYS is set). The job
can be actively executing or active on a device on that system. The
system name is 1-8 character, left justified, and padded on the right
with blanks. The generic characters ‘*’ and ‘?’ are allowed.
- STATMEMB
- This keyword is supported when requesting information from
a JES2 subsystem only.The name of the JES member on which the
job must be active (used if STATSMEM is set). The job can be actively
executing or active on a device on that member. The member name is
1-8 character, left justified, and padded on the right with blanks.
The generic characters ‘*’ and ‘?’ are allowed.
- STATPRIO
- The 1-byte binary priority associated with the job (used if STATSPRI
is set). The job's priority must match exactly to be selected.
In JES2, valid priorities are 0 to 15.
- STATPHAZ
- The current job processing phase (used if STATSPHZ is set).
In JES2, the valid values for STATPHAZ are: - Phase Value
- Description
- STAT_INPUT
- Job is active in input processing
- STAT_WTCONV
- Job is queued for conversion
- STAT_CONV
- Job is actively converting
- STAT_VOLWT
- Job is queued for SETUP (not currently used by JES2 code)
- STAT_SETUP
- Job is active in SETUP (not currently used by JES2 code)
- STAT_SELECT
- Job is queued for execution
- STAT_ONMAIN
- Job is actively executing
- STAT_SPIN
- JES2 is processing SPIN data sets for the JOB
- STAT_WTBKDN
- Job is queued for output processing
- STAT_BRKDWN
- Job is active in output processing
- STAT_OUTPT
- Job is on the hard copy queue
- STAT_WTPURG
- Job is queued for purge
- STAT_PURG
- Job is currently being purged
- STAT_RECV
- Job is active on an NJE SYSOUT receiver
- STAT_WTXMIT
- Job is queued for execution on another NJE node
- STAT_XMIT
- Job is active on an NJE JOB transmitter
- STAT_EXEC
- Job has not completed execution (combines multiple states in one
phase request)
- STAT_POSTEX
- Job has completed execution (combines multiple states in one phase
request)
In JES3, the valid values for STATPHAZ are: - Phase Value
- Description
- STAT_NOSUB
- No subchain exists
- STAT_FSSCI
- Job is active in conversion/interpretation in an FSS address space
- STAT_PSCBAT
- Job is awaiting postscan (batch)
- STAT_PSCDSL
- Job is awaiting postscan (demand select)
- STAT_FETCH
- Job is awaiting volume fetch
- STAT_VOLWT
- Job is awaiting start setup
- STAT_SYSSEL
- Job is awaiting or active in MDS system select processing
- STAT_ALLOC
- Job is awaiting resource allocation
- STAT_VOLUAV
- Job is awaiting unavailable volume(s)
- STAT_VERIFY
- Job is awaiting volume mount(s)
- STAT_SYSVER
- Job is awaiting or active in MDS system verification processing
- STAT_ERROR
- Job encountered an error during MDS processing
- STAT_SELECT
- Job is awaiting selection on main
- STAT_ONMAIN
- Job is scheduled on main
- STAT_BRKDWN
- Job is awaiting breakdown
- STAT_RESTART
- Job is awaiting MDS restart processing
- STAT_DONE
- Main and MDS processing complete for job
- STAT_OUTPT
- Job is awaiting output service
- STAT_OUTQUE
- Job is awaiting output service writer
- STAT_OSWAIT
- Job is awaiting rsvd services
- STAT_CMPLT
- Output service complete for job
- STAT_DEMSEL
- Job is awaiting selection on main (demand select job)
- STAT_EFWAIT
- Ending function request waiting for I/O completion
- STAT_EFBAD
- Ending function request not processed
- STAT_MAXNDX
- Maximum request index value
- STATSRVC
- The name of the WLM service class assigned to the job (used if
STATSSRV is set). Jobs only have service classes assigned to them
if they have completed conversion processing and have not completed
execution processing. The service class is 0-8 characters, left justified,
and padded on the right with blanks.
- STATSENV
- The name of scheduling environment (SCHENV= from the JOB statement)
required by a job. (used if STATSSEN is set). Jobs only have scheduling
environments assigned to them if they have completed conversion processing
and have not completed execution processing. The scheduling environment
is 0-16 characters, left justified, and padded on the right with blanks.
The generic characters '*' and '?' are allowed.
- STATOPT1
- Option byte
- STAT1RAC
- If on, requests that the RACF® authorization checks be made whether or not the caller of the SSI
is APF authorized. This bit has no effect if the caller is not APF
authorized. The RACF check
that is made if the SECLABEL class is active is a dominance check
of the seclabel of the job/SYSOUT compared to the seclabel of the
requestor. This check is a JES2 only check.
- STAT1LCL
- Specifies that the destination information returned
in fields STTRONOND, STTRXNOD, STTRPRRE/STTRPRND, STTRPURE/STTRPUND,
and STSTDEST should suppress the local node name. If the destination
is the local node, and there is no secondary routing information,
the LOCAL is returned (instead of the local node name). If the destination
is a secondary routing at the local node, then only the secondary
routing is returned (for example, R1 is returned if the destination is remote at the local node). This option does not affect destinations information returned
for the destinations other than the local node.
The setting of the JES2 parameter DESTDEF SHOWUSER= will influence
what is returned if this bit is on.
- STAT1WSI
- Specifies that for a STATOUTT request, JES3 will consolidate the
SYSOUT elements (STATSE) within a job. One STATSE is returned for
each Work Selection Identifier within a job. Each returned STATSE
consolidates the information that would normally be returned in multiple
SYSOUT elements with identical output characteristics. The STAT1WSI
bit is ignored for any STATTYPE that is not equal to STATOUTT. This
bit applies to JES3 only.
- STAT1LMT
- Limits the number of STATJQ elements returned using the value
set in STATJQLM. Once the limit is reached, processing stops and control
is returned to the caller. An SSOBRETN return code of STATRTOK (0)
with a STATREAS reason code of STATRLMT (4) indicates processing ended
due to this limit. The request cannot be restarted.
- STAT1NDP
- Suppresses duplicate data sets being returned by a DSLIST request.
- STAT1B64
- Specifies whether returned areas are permitted to be obtained
by 64-bit storage.
- STAT1WMS
- Waits for latest MAS level information (JES2 only).
- STAT1WMB
- Wait for latest member information (JES2 only).
- STATSSL3
- More SYSOUT selection criteria. This is supported if STATVER is
STATV050 or higher and the corresponding JES2 is z/OS V1R9 or higher.
- STATSSLC
- Select SYSOUT that is destined to the local node. If STATSSLC
and STATSSNT are both on or both off, then the destination of the
output will not be considered. However, either bit being on is mutually
exclusive with STATSSDS being set.
- STATSSNT
- Select SYSOUT that is not destined to the local node. If STATSSLC
and STATSSNT are both on or both off, then the destination of the
output will not be considered. However, either bit being on is mutually
exclusive with STATSSDS being set.
- STATSSNJ
- For selection purposes, treat SYSOUT destined to an NJE node as
OUTDISP of WRITE regardless of the actual OUTDISP. This has no effect
if STATSWRT, STATSHOL, STATSKEP and STATSLVE are all on or all off.
- STATSWRT
- Select output hat has an OUTDISP of WRITE.
- STATSHOL
- Select output that has an OUTDISP of HOLD.
- STATSKEP
- Select output that has an OUTDISP of KEEP.
- STATSLVE
- Select output that has an OUTDISP of LEAVE.
Note: Setting STATSWRT, STATSHOL, STATSKEP
and STATSLVE all on has the same effect as setting them all off.
- STATSSL4
- STATSSL4 is used to support filtering of information returned
based on transaction name, transaction job id, or
transaction owner.
- STATSTPN
- Transaction job name filtering. STATSTPN cannot
be specified with STATSJIL.
If this bit is on,
information about jobs and SYSOUT associated with a transaction job
name that matches STATJOBN or STATJBNP is returned.
The STATSTPN
bit is ignored if one of the following situations occurs: - STATSJBN is not set.
- Requesting verbose information
- STATSOJD is not set for JES2.
- JES2 is used but JES2 is not running with checkpoint
mode z11.
- STATSTPI
- Transaction job ID filtering. STATSTPI cannot
be specified with STATSJIL.
- If STATSTPI is not set, only jobs and SYSOUT that has a job id
in the range specified by STATJBIL and STATJBIH are returned.
- If STATSTPI is set, jobs and SYSOUT associated with a SYSOUT data
set with a transaction job id are also selected. The job id is in
the range specified by STATJBIL and STATJBIH.
The STATSTPI bit is ignored if one of the following situations
occurs: - STATSJBI is not set.
- Requesting verbose information
- STATSOJD is not set for JES2.
- JES2 is used but JES2 is not running with checkpoint
mode z11.
- STATSTPU
- SYSOUT owner filtering.
If this bit is on, jobs
and SYSOUT that are associated with a SYSOUT data set whose transaction
owner matches STATOWNR are returned.
The STATSTPU bit is ignored if one of the following situations occurs: - STATSOWN is not set.
- Requesting verbose information
- JES2 is used but JES2 is not running with checkpoint
mode z11.
- STATSSJ1
- If SYSOUT is destined to STATJOBN or STATJBNP on the local node,
STATSSJ1 indicates to match using the first jobname supplied in STATJOBN
in the following situations:
- If STATSSJ1 is on with STATSJBN
- If STATSTPN is on with STATSJBN
STATSSJ1 is ignored if STATSJBN is off.
- STAT1CHR
- One byte value that indicates a one character wild card.
- STATZOMO
- One byte value that indicates a zero or more characters wild card.
- STATSEL5
- Flag byte that describes the filters to use to select jobs. Each
bit corresponds to a filter field which must match any job returned.
- STATSCOR
- Use STATJCRP as a pointer to a job correlator filter. STATSCOR
cannot be specified with STATSJBI, STATSCTK or STATSJIL. If specified
on a JES3 request, no results will be returned.
- STATJQLM
- Limit on how many STATJQs can be returned on this call (used if
STAT1LMT is set).
- STATTRSA
- Pointer to a STATJQ or STATSE (or zero) for which verbose 31-bit
data is to be obtained. If non-zero, use this terse address to expand
data obtained previously through a terse JOB or SYSOUT extended status
call (with no intervening STATMEM call). Only valid when both STATVER
and JES2 are at a STATV040 level or higher. On JES3, the calling system
must be at the z/OS V1R10 level
or higher and the global system must be at the z/OS V1R7 level or higher.
- STATTRSA_64
- Pointer to a STATJQ or STATSE (or zero) for which verbose 64-bit
data is to be obtained. If non-zero, use this terse address to expand
data obtained previously through a terse JOB or SYSOUT extended status
call (with no intervening STATMEM call). Only valid when both STATVER
and JES2 are at a STATV040 level or higher.
- STATCTKN
- Pointer to the SYSOUT token to be used for selection (used if
STATSCTK is set). The token can only be obtained from dynamic allocation
or from a previous extended status request.
- STATSCRE
- The user ID that was in control when the SYSOUT data set was allocated
(used if STATSSOW is set). The user ID is 1-8 characters, left justified,
and padded on the right with blanks. The generic characters '*' and
'?' are allowed.
- STATSDES
- Destination to which the SYSOUT is routed (used if STATSSDS is
set). The destination is 1-18 characters, left justified, and padded
on the right with blanks. The format of the destination is the same
as that allowed on DEST= on the OUTPUT statement. IP addresses are
not allowed.
In JES2, the user ID portion of the destination can
contain the generic characters '*' and '?'. This can match SYSOUT
with a route code that contains a corresponding user ID routing.
However, destinations of the format 'R*', 'RM*', 'RMT*', 'U*', and
'N*' will not match SYSOUT with a route code of remote, special local,
or NJE.
- STATSCLA
- The class associated with the SYSOUT (used if STATSSCL is set).
The class is 1-8 characters, left justified, and padded on the right
with blanks.
Currently, only 1 character SYSOUT classes are valid.
- STATSWTR
- The external writer name associated with the SYSOUT (used if STATSSWR
is set). The external writer name is 1-8 characters, left justified,
and padded on the right with blanks. The generic characters '*' and
'?' are allowed.
- STATSFOR
- The SYSOUT forms name for selection (used if STATSSFR is set).
The forms name is 1-8 characters, left justified, and padded on the
right with blanks. The generic characters '*' and '?' are allowed.
On JES3, the global must be at the z/OS V1R7 level or higher.
- STATSPRM
- The process mode name for selection (used if selection (if STATSSPR
is set). The process mode name is 1-8 characters, left justified,
and padded on the right with blanks. The generic characters '*' and
'?' are allowed. On JES3, the global must be at the z/OS V1R7 level or higher.
- STATSUBR
- The submitting user ID for selection (used if STATSSUB is set).
The submitting user ID is 1-8 characters, left justified, and padded
on the right with blanks. The generic characters '*' and '?' are allowed.
This filter is available in JES3 only. On JES3, the global must be
at the z/OS V1R7 level or higher.
Set all other fields in the IAZSSST control block to binary zeros
before issuing the first in a series of IEFSSREQ macro calls. A memory
management call (STATTYPE set to STATMEM) is required before updating
output fields.
There are fields that relate to the additional input
filters. Each filter is a count followed by a pointer to a list of
values. Any one value that matches is considered passing. You must
place the first value in the base field. Failure to do so will result
in an invalid parameter error. For example, to filter on the job classes
A, B, C, or D you would set the following: STATCLSL = C'A'
STATCLSN = F'3'
STATCLSP = A(CLASSLST)
CLASSLST = CL8'B',CL8'C',CL8'D'
Table 2. SSI Function Code 80 FiltersFilter (base field) |
Selection Bit |
Flag Byte (contains selection bit) |
Array Pointer |
Array Count |
Description |
---|
STATCLSL |
STATSCLS |
STATSEL1 |
STACLSP |
STATCLSN |
Job class filters |
STATJOBN |
STATSJBN |
STATSEL1 |
STATJBNP |
STATJBNN |
Job name filters |
STATDEST |
STATSDST |
STATSEL1 |
STATDSTP |
STATDSTN |
Job destination filters |
STATPHAZ |
STATSPHZ |
STATSEL3 |
STATPHZP |
STATPHZN |
Job phase filters |
STATSCLA |
STATSSCL |
STATSSL1 |
STATSCLP |
STATSCLN |
SYSOUT class filters |
STATSDES |
STATSSDS |
STATSSL1 |
STATSDSP |
STATSDSN |
SYSOUT destination filters |
The new fields are as follows: - Field Name
- Description
- STATCLSN
- Additional job class count
- STATCLSP
- Pointer to STATCLSL extension containing additional job class
filters
- STATJBNN
- Additional job name count when STATSJBN is specified,
and a count of job IDs when STATSJIL is specified
- STATJBNP
- Pointer to STATJOBN extension containing additional 8 character
job name filters when STATSJBN is specified. A list of 8 character
job IDs to return when STATSJIL is specified.
- STATDSTN
- Additional job destination count
- STATDSTP
- Pointer to STATDEST extension containing additional job destination
filters
- STATPHZN
- Additional job phase count
- STATPHZP
- Pointer to STATPHAZ extension containing additional job phase
filters
- STATSCLN
- Additional SYSOUT class count
- STATSCLP
- Pointer to STATSCLA extension containing additional SYSOUT class
filters
- STATSDSN
- Additional SYSOUT destination count
- STATSDSP
- Pointer to STATSDES extension containing additional SYSOUT destination
filters.
- STATJCRP
- Pointer to the job correlator to be used for selection (used if
STATSCOR is set).
These new filters are only honored if STATVER is STATV050
or higher and JES2 is z/OS V1R9
or higher or JES3 is z/OS V1R10
or higher.
|