z/OS MVS Using the Subsystem Interface
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Use information for verbose requests

z/OS MVS Using the Subsystem Interface
SA38-0679-00

With version 4 of the IAZSSST macro, you can request verbose information for both jobs and SYSOUT.
Note: If you are running on JES3, the JES3 release of the global must be z/OS® V1R7 or higher.
In general, verbose JOB or SYSOUT data can be obtained for a single job in three ways;
  1. jobid
  2. token
  3. or to expand data obtained previously by a terse address (STATTRSA or STATTRSA_64, with no intervening STATMEM call).
  • Obtaining verbose job level data
    Set STATTYPE to STATVRBO and also set one of the following input fields:
    • Set STATTRSA and STATTRSA_64 to zeros and ensure that the job ID filters specified by STATSJBI refer to the same job ID in STATJBIL and STATJBIH (or that STATJBIH is set to zero). Both terse and verbose job data are returned.
    • Set STATTRSA and STATTRSA_64 to zeros and STATSCTK has STATCTKN set to the SYSOUT token you want verbose data for. Both terse and verbose data are returned.
    • Set STATTRSA or STATTRSA_64 to a STATJQ or STATSE (obtained previously with no intervening memory management call). The related STATJQ will chain to a verbose element (STATVE). If the terse area is returned in 64-bit storage (STATO164 is set), use STATTRSA_64 instead of STATTRSA. For broadcast SSIs, if STATO164 is on, it is possible to have both 31-bit chained elements anchored from STATJOBF and 64-bit chained elements anchored from STATJOBF_64. In this case, the caller should set STATTRSA if the job is chained to STATJOBF, and STATTRSA_64 if the job is chained to STATJOBF_64. For directed SSIs, a test of STATO164 is adequate to determine which field to set.
  • Obtaining verbose SYSOUT level data
    Set STATTYPE to STATOUTV and also set one of the following input fields:
    • Set STATTRSA and STATTRSA_64 to zero and ensure that the job ID filters specified by STATSJBI refer to the same job ID in STATJBIL and STATJBIH (or that STATJBIH is set to zero). Both terse and verbose data are returned. Verbose data is also returned for all valid SYSOUT data sets (chained into the STATJQ). If the job is still executing, STATVOs for data sets that are still open may also be returned. Lastly, terse SYSOUT data is returned. The STATVOs are chained into the STATSEs with which they are associated.
    • Set STATTRSA and STATTRSA_64 to zero and STATSCTK has STATCTKN set to the SYSOUT token of the SYSOUT group for which you want verbose data. Both terse and verbose job and SYSOUT data are returned (only for the data sets represented by the token passed).
    • Set STATTRSA or STATTRSA_64 to a STATJQ (obtained previously with no intervening memory management call). Similar to the case in which STATSJBI is set, verbose job data will be chained into the STATJQ, STATVOs will be obtained for all valid SYSOUT data sets, and STATSEs will be obtained for all SYSOUT groups for the job. If the terse area is returned in 64-bit storage (STATO164 is set), use STATTRSA_64 instead of STATTRSA. For broadcast SSIs, if STATO164 is on, it is possible to have both 31-bit chained elements anchored from STATJOBF and 64-bit chained elements anchored from STATJOBF_64. In this case, the caller should set STATTRSA if the job is chained to STATJOBF, and STATTRSA_64 if the job is chained to STATJOBF_64. For directed SSIs, a test of STATO164 is adequate to determine which field to set.
    • Set STATTRSA or STATTRSA_64 to a STATSE (obtained previously with no intervening memory management call). Similar to the case in which STATSCTK is set, verbose job data will be obtained for the job, and all the STATVOs related to the STATSE. If the terse area is returned in 64-bit storage (STATO164 is set), use STATTRSA_64 instead of STATTRSA. For broadcast SSIs, if STATO164 is on, it is possible to have both 31-bit chained elements anchored from STATJOBF and 64-bit chained elements anchored from STATJOBF_64. In this case, the caller should set STATTRSA if the job is chained to STATJOBF, and STATTRSA_64 if the job is chained to STATJOBF_64. For directed SSIs, a test of STATO164 is adequate to determine which field to set.
    Note: Additional SYSOUT filters can be set (bits in STATSSLx) when STATTRSA or STATTRSA_64 is set to STATJQ or STATSJBI. The STATSE are built that match the SYSOUT filters and then STATVOs are built that correspond to each of the STATSEs. If the terse area is returned in 64-bit storage (STATO164 is set), use STATTRSA_64 instead of STATTRSA. For broadcast SSIs, if STATO164 is on, it is possible to have both 31-bit chained elements anchored from STATJOBF and 64-bit chained elements anchored from STATJOBF_64. In this case, the caller should set STATTRSA if the job is chained to STATJOBF, and STATTRSA_64 if the job is chained to STATJOBF_64. For directed SSIs, a test of STATO164 is adequate to determine which field to set.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014