SUMMARY subcommand — summarize control block fields

Use the SUMMARY subcommand to display or print dump data associated with one or more specified address spaces. SUMMARY produces different diagnostic reports depending on the report type parameter, FORMAT, KEYFIELD, JOBSUMMARY, and TCBSUMMARY, and the address space selection parameters, ALL, CURRENT, ERROR, TCBERROR, ASIDLIST, and JOBLIST. Specify different parameters to selectively display the information you want to see.

Note: Installation exit routines can be invoked at the system, address space, and task level for each of the parameters in the SUMMARY subcommand.

Related subcommands
- LISTSYM
- RUNCHAIN
- SCAN
- SELECT
- STATUS

Syntax

  { SUMMARY }
  { SUMM    }

-------- Report Type Parameters ----------------------------

             [ KEYFIELD [REGISTERS | NOREGISTERS]  ]
             [ FORMAT ] [ DIALOG ] 
                        [ EXCLUDE(GLOBAL | JPQ | LOADLIST) ]
                        [ TCBADDR(address-list) ]
             [ TCBSUMMARY ]
             [ JOBSUMMARY ]

-------- Address Space Selection Parameters ----------------

             [ ALL ]
             [ CURRENT ]
             [ ERROR ]
             [ TCBERROR | ANOMALY ]
             [ ASIDLIST(asidlist) ]
             [ JOBLIST(joblist) | JOBNAME(joblist) ]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

              [ ACTIVE | MAIN | STORAGE          ]
              [ DSNAME(dsname) | DATASET(dsname) ]
              [ FILE(ddname) | DDNAME(ddname)    ]
              [ PATH(path-name)     ]
              [ FLAG(severity) ]
              [ PRINT | NOPRINT ]
              [ TERMINAL | NOTERMINAL ]
              [ TEST | NOTEST ]

Report Type Parameters

Use these parameters to select the type of report. If you omit a report type parameter, the default is KEYFIELD.

KEYFIELD

Presents the information in the ASCB, TCB, and RB key fields associated with the specified address space(s). Information included pertains to the fields listed in Table 1.

Table 1. ASCB, TCB, RB key fields associated with specified address spaces

ASCB fields:
	AFFN	FLG2
	ASID	FWDP
	ASSB	LOCK
	ASXB	SRBS
	CSCB	TSB
	DSP1
TCB fields:
	BITS	NDSP
	CMP	PKF
	DAR	RTWA
	DSP	STAB
	FBYT1	STCB
	JSCB	TSFLG
	LMP
RB fields:
	WLIC	OPSW
	LINK
CDE fields:
	NAME
	ENTPT

REGISTERS or NOREGISTERS

Specifies or suppresses display of the general purpose registers for each TCB/RB. Specify this parameter only when you specify KEYFIELD or default to KEYFIELD. If you specify FORMAT, JOBSUMMARY, or TCBSUMMARY and either REGISTERS or NOREGISTERS, IPCS processing ignores REGISTERS or NOREGISTERS.

REGISTERS specifies that registers are to be shown. The abbreviation REGS is accepted for this parameter. NOREGISTERS suppresses the registers. The abbreviation NOREGS is accepted for this parameter. If you omit both REGISTERS and NOREGISTERS, the default is NOREGISTERS.

FORMAT

Specifies a report containing the major control blocks associated with the specified address space or spaces. The blocks are, for example:

ASCB
ASSB
ASXB
Authorization table
CDE
DEB
EED
ENQ/DEQ suspend queue
Extent list (XLIST)
General CMS suspend queue
Global service manager queue
Job pack queue
Linkage stack
List of control blocks associated with open data sets
Load list
Local lock suspend queue
Local service manager queue
Local suspended SRB queue
Processor related work unit queues
RB
RSM suspended SRB deferred requests list
RSM suspended SRB I/O wait list
RSM suspended SRB cross memory deferred requests list
RSM suspended SRB cross memory I/O wait list
RTCT (only if CURRENT is specified or defaulted)
SMF CMS suspend queue
STCB
STKE
System work unit queue
TCB and TCBEXT2
TIOT
XSB

Note: For ASCBs, TCBs, CDEs, the extent list, and the load list, the bits in significant flag byte fields are explained (decoded).

After these items are formatted, IPCS invokes additional installation-supplied or other IBM-supplied exits to format control blocks.

If access registers are formatted, IPCS can identify the data space associated with the access register if the data space is accessible in the dumped environment; storage from the data space does not need to be dumped to enable the identification.

DIALOG

Directs the SUMMARY subcommand to present a data entry panel rather than accepting options in subcommand format.

EXCLUDE(GLOBAL | JPQ | LOADLIST)

Directs SUMMARY FORMAT to omit portions of the report that it normally produces.

EXCLUDE(GLOBAL) causes global SRB formatting to be omitted.
EXCLUDE(JPQ) causes job pack queue formatting to be omitted.
EXCLUDE(LOADLIST) cause load list formatting to be omitted.

TCBADDR(address-list)

Directs SUMMARY FORMAT to limit its formatting related to TCBs to those whose addresses are listed. You can enter TCB addresses using decimal, hexadecimal (X'xxx'), or binary (B'bbb') format. ADDRTCB is an alias of the TCBADDR keyword.

TCBSUMMARY

Specifies a report containing a summary of the task control blocks (TCBs) for each address space processed. Each TCB summary contains:

Job name
ASCB name and address
TCB name and address
CMP field
PKF field
TSFLG field

If the TCBRTWA field is nonzero, the following fields are also displayed for each TCB:

DAR field
RTWA field
FBYT1 field

JOBSUMMARY

Specifies a report containing a summary of the status of address spaces for a job. The report contains:

Active CPU list
For each CPU, one of the following values:
- NORMAL MODE
- SERVICE REQUEST MODE, which means SRB (Service Request Block) MODE
Scheduled services
For each address space specified:
- Jobname
- ASCB location
- ASID
- Status of the address space
- Local service manager queue
- Local service priority queue
- TCB locations, completion codes, and the active indicator
- A problem list of TCBs
- Local lock suspend queue
- Local suspended SRB queue

Address Space Selection Parameters
Use these parameters to obtain data from particular address spaces, which you specify by their address space identifiers (ASIDs). If you omit these parameters, the default is CURRENT. For more information, see the select ASID service in z/OS MVS IPCS Customization.

You can specify several address space selection parameters. An address space might meet more than one selection criterion. The selection criterion (or criteria) that is met for each address space appears in the output. No address space is processed more than once.

ALL

Specifies processing of all address spaces in the dump.

CURRENT

Specifies the processing of each address space that was active when the dump was generated.

ERROR

Specifies processing of control blocks for any address space with an MVS™ error indicator or containing a task with an error indicator.

TCBERROR or ANOMALY

Specifies processing of control blocks for any address space containing a task with an error indicator. Blocks for address spaces with an error indicator are not processed.

ASIDLIST(asidlist)

Specifies a list of ASIDs for address spaces to be processed. The asidlist can be a single ASID, a range of ASIDs, or a list of noncontiguous ASIDs. When you specify a range, separate the first and last ASIDs in the range with a colon. When you specify a list, separate the list members with commas.
The ASID can be 1 through 65535. An ASID can be expressed in the notation X'nnn', F‘nnn’, or B'nnn'. An unqualified number is assumed to be fixed.

This subcommand does not process summary dump records (ASID X‘FFFA’).

JOBLIST(joblist) or JOBNAME(joblist)

Specifies a list of job names whose associated address spaces are to be processed. Use commas to separate the job names in the list; do not enclose job names in apostrophes; and do not specify a range of job names.
Return Codes
See Standard subcommand return codes for a description of the return codes produced by the SUMMARY subcommand.

Example 1: Produce a KEYFIELD report.

Action: COMMAND ===> summary keyfield current

Result: IPCS produces the output shown in Figure 1.

Figure 1. Sample output from SUMMARY KEYFIELD CURRENT command

 1    * * * *   K E Y F I E L D S   * * * *
JOBNAME TC
 2    SELECTED BY: CURRENT ERROR

 ASCB: 00F6AD00
    FWDP..... 00F6E800  ASID..... 0021      CSCB..... 02DAE530
    TSB...... 00000000  AFFN..... FFFF      ASXB..... 007FE038  DSP1..... 00
    FLG2..... 00        SRBS..... 0000      LOCK..... 00000000
    ASSB..... 01A72280

 TCB: 007FE240
    CMP...... 00000000  PKF...... 00        LMP...... FF        DSP...... FF
    TSFLG.... 00        STAB..... 007FF6E0  NDSP..... 00000000
    JSCB..... 007FFDFC  BITS..... 00000000  DAR...... 00
    RTWA..... 00000000  FBYT1.... 00
    Task non-dispatchability flags from TCBFLGS4:
     Top RB is in a wait

PRB: 007FFF98
   WLIC..... 00020001  OPSW..... 070C1000  810234C0
   LINK..... 017FE240
   EP....... IEAVAR00  ENTPT.... 82B6CED0

TCB: 007FF3B8
   CMP...... 00000000  PKF...... 00        LMP...... FF        DSP...... FF
   TSFLG.... 00        STAB..... 007FF6B0  NDSP..... 00000000
   JSCB..... 007FFDFC  BITS..... 00000000  DAR...... 00
   RTWA..... 00000000  FBYT1.... 00
   Task non-dispatchability flags from TCBFLGS4:
    Top RB is in a wait

PRB: 007FF0A0
   WLIC..... 00020078  OPSW..... 070C2000  823E55D0
   LINK..... 017FF3B8
   EP....... IEAVTSDT  MAJOR.... IGC0005A  ENTPT.... 823E52D8

TCB: 007FF128
   CMP...... 00000000  PKF...... 80        LMP...... FF        DSP...... FF
   TSFLG.... 00        STAB..... 007FF620  NDSP..... 00000000
   JSCB..... 007FCC14  BITS..... 00000000  DAR...... 00
   RTWA..... 00000000  FBYT1.... 00
   Task non-dispatchability flags from TCBFLGS4:
    Top RB is in a wait

PRB: 007FCC30
   WLIC..... 00020001  OPSW..... 070C1000  80E11948
   LINK..... 017FCE30
   EP....... IEFSD060  ENTPT.... 80E08880

PRB: 007FCE30
   WLIC..... 00020006  OPSW..... 070C1000  80E1A706
   LINK..... 007FF128
   EP....... IEESB605  ENTPT.... 00E1A000

1: Indicates the report type.
2: Indicates the selection criteria that were met.

Example 2: Produce a FORMAT report.

Action: COMMAND ===> summary format current

Result: IPCS produces the output shown in Figure 2.

Figure 2. Sample output from SUMMARY FORMAT CURRENT command

 1     * * * *  F O R M A T  * * * *

 2     GLOBAL SERVICE MANAGER QUEUE
     QUEUE IS EMPTY

    LOCAL SERVICE MANAGER QUEUE
     QUEUE IS EMPTY

    SYSTEM WORK UNIT QUEUE
     WEB QUEUE IS EMPTY

    CMS SMF LOCK SUSPEND WEB QUEUE
     WEB QUEUE IS EMPTY

    CMS ENQ/DEQ LOCK SUSPEND WEB QUEUE
     WEB QUEUE IS EMPTY

    GENERAL CMS LOCK SUSPEND WEB QUEUE
     WEB QUEUE IS EMPTY

CPU = 01
    PROCESSOR RELATED WORK UNIT QUEUE
     WEB QUEUE IS EMPTY

RSM processing on a non-stand-alone dump may generate inconsistent
data and false validity check failures.
Data space information may be incomplete for RSM.  Storage not in
dump.

    RSM SUSPENDED SRB DEFERRED REQUESTS LIST
     SSRB LIST IS EMPTY

    RSM SUSPENDED SRB I/O WAIT LIST
     SSRB LIST IS EMPTY

    RSM SUSPENDED SRB CROSS MEMORY DEFERRED REQUEST LIST
     SSRB LIST IS EMPTY

    RSM SUSPENDED SRB CROSS MEMORY I/O WAIT LIST
     SSRB LIST IS EMPTY

ASXB: 007FE038
   +0000  ASXB..... ASXB      FTCB..... 007FE240  LTCB..... 007FC378
   +000C  TCBS..... 0004      R00E..... 0000      MPST..... 00000000
   +0014  LWA...... 00000000  VFVT..... 00000000  SAF...... 00000000
   +0020  IHSA..... 007FE598  FLSA..... FE0000D8  00F77500  00FD1770
   +0030            812ED762  00000040  012EE761  00F77500  812ED896
   +0044            00000000  00FFA848  000000D8  00F77508  00F77400
   +0058            7FFE44F0  81161DC2  7FFE493C  00000C60  812B0132
   +006C  OMCB..... 00000000  SPSA..... 007FEA68  RSMD..... 00000000
   +0078  RCTD..... 007FE480  DECB..... 807FF0A0  OUSB..... 7FFFD1C0
   +0084  CRWK..... 00000000  PRG...... 00000000  00000000  00000000
   +0094            00000000  PSWD..... 00000000  00000000
   +00A0  SIRB..... 007FE3D8  ETSK..... 007FE240  FIQE..... 00000000
   +00AC  LIQE..... 00000000  FRQE..... 00000000  LRQE..... 00000000
   +00B8  FSRB..... 00000000  LSRB..... 00000000  USER..... TC
   +00C7  SFLG..... 00        SENV..... 007FCF58  R0CC..... 00000000
   +00D0  NSSA..... 7FFFCDE0  NSCT..... 0000000D  CRB1..... 00
   +00D9  CRB2..... 00        CRB3..... 00        CRB4..... 00
   +00DC  PT0E..... 00000000  R0E0..... 00000000  JSVT..... 00000000
   +00E8  DIVW..... 00000000  R0EC..... 00000000
    .
    .
    .

1: Indicates the report type.
2: Shows the status of the various queues and SSRB lists.
3: Indicates the selection criteria that were met.

Example 3: Produce a TCBSUMMARY report.

Action: COMMAND ===> summary tcbsummary current

Result: IPCS produces the output shown in Figure 3.

Figure 3. Example output from SUMMARY TCBSUMMARY CURRENT

 1        * * * * T C B  S U M M A R Y * * * *

 2    JOB TC       ASCB021 AT 00F6AD00

 3        SELECTED BY: CURRENT ERROR


 4  TCB: 007FE240
    CMP...... 00000000  PKF...... 00        LMP...... FF        DSP...... FF
    TSFLG.... 00        STAB..... 007FF6E0  NDSP..... 00000000
    JSCB..... 007FFDFC  BITS..... 00000000  FBYT1.... 00

 TCB: 007FF3B8
    CMP...... 00000000  PKF...... 00        LMP...... FF        DSP...... FF
    TSFLG.... 00        STAB..... 007FF6B0  NDSP..... 00000000
    JSCB..... 007FFDFC  BITS..... 00000000  FBYT1.... 00

 TCB: 007FF128
    CMP...... 00000000  PKF...... 80        LMP...... FF        DSP...... FF
    TSFLG.... 00        STAB..... 007FF620  NDSP..... 00000000
    JSCB..... 007FCC14  BITS..... 00000000  FBYT1.... 00

TCB: 007FC378
   CMP...... 88522000  PKF...... 80        FLGS..... 84000000  00
   LMP...... FF        DSP...... FF        TSFLG.... 20
   STAB..... 007FF5F0  NDSP..... 00000000  JSCB..... 007FCA0C
   BITS..... 00000000  DAR...... 00        RTWA..... 7F6FE090  ABCUR.... 00
   FBYT1.... 88

1: Indicates the report type.
2: Provides the name of the job, the address space, and its address.
3: Indicates the selection criteria that were meet.
4: Provides the address of the first TCB in the chain.

Example 4

Produce a JOBSUMMARY report.

Action: COMMAND ===> summary jobsummary current

Result: IPCS produces the output shown in Figure 4.

Figure 4. Example output from SUMMARY JOBSUMMARY CURRENT

 1        * * * *  S Y S T E M  S U M M A R Y  * *
*** ACTIVE CPU LIST ***
CPU 0001 - SERVICE REQUEST MODE

*** SCHEDULED SERVICES ***

    GLOBAL SERVICE MANAGER QUEUE
     QUEUE IS EMPTY

    LOCAL SERVICE MANAGER QUEUE
     QUEUE IS EMPTY

    SYSTEM WORK UNIT QUEUE
     WEB QUEUE IS EMPTY

    CMS SMF LOCK SUSPEND WEB QUEUE
     WEB QUEUE IS EMPTY

    CMS ENQ/DEQ LOCK SUSPEND WEB QUEUE
     WEB QUEUE IS EMPTY

    GENERAL CMS LOCK SUSPEND WEB QUEUE
     WEB QUEUE IS EMPTY

CPU = 01
    PROCESSOR RELATED WORK UNIT QUEUE
     WEB QUEUE IS EMPTY

RSM processing on a non-stand-alone dump may generate inconsistent
data and false validity check failures.
Data space information may be incomplete for RSM.  Storage not in
dump.

    RSM SUSPENDED SRB DEFERRED REQUESTS LIST
     SSRB LIST IS EMPTY

     RSM SUSPENDED SRB I/O WAIT LIST
      SSRB LIST IS EMPTY

     RSM SUSPENDED SRB CROSS MEMORY DEFERRED REQUEST LIST
      SSRB LIST IS EMPTY

     RSM SUSPENDED SRB CROSS MEMORY I/O WAIT LIST
      SSRB LIST IS EMPTY

 2  *** JOB SUMMARY ***
 ---------------------------------------------------------------------

 3  SELECTED BY: CURRENT
 JOBNAME TC   ASCB 00F6AD00  NEXT 00F6E800  PREV 00F63D00  ASID 0021

 TCB 007FE240  NEXT 007FF3B8  PREV 00000000 COMP 00000000
 TCB 007FF3B8  NEXT 007FF128  PREV 007FE240 COMP 00000000
 TCB 007FF128  NEXT 007FC378  PREV 007FF3B8 COMP 00000000
 TCB 007FC378  NEXT 00000000  PREV 007FF128 COMP 88522000
 ----------------------------------------------------------------------
 *** PROBLEM LIST ***

    JOB  TC   ASID  0021  TCB  007FC378  ABEND CODE- 88522000  DAR  00
    JOB  TC   ASID  0021  TCB  007FC378  SET TEMPORARY NON-DISPATCHABLE
              FLGS4  00  FLGS5  00  SCNDY  00000000  DAR  00  STPCT  00
 4 NO MACHINE CHECKS IN PROCESS
         NO ABENDS DETECTED FOR ASCBS
         NO NON-DISPATCHABLE ASCBS DETECTED

1: Provides a summary of the system.
2: Indicates the report type.
3: Indicates the selection criteria that were meet.
4: Provides a problem list.