Input Parameters

Input parameters for the function routine are:

SSOB
SSIB
IAZSSST

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.

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 Filters
Filter (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.