Customizing through the SNAP or SNAPX macro

The parameters on the SNAP or SNAPX macro determine the dump contents. The macro can specify any or all of the areas listed in Table 1.

Note that the parameters cannot request that a Hiperspace™ be included in the dump. To include Hiperspace data in a SNAP dump, read the data from the Hiperspace into address space storage that is being dumped. See z/OS MVS Programming: Extended Addressability Guide for more information about manipulating data in Hiperspace storage.

Table 1. Customizing dumps using through the SNAP or SNAPX macro
Parameter Dump Contents
ALLPA All link pack areas, as follows:
  • Job pack area (JPA)
  • Link pack area (LPA) active for the task being dumped
  • Related supervisor call (SVC) modules
ALLVNUC The entire virtual control program nucleus
CB Control blocks for the task being dumped
DM Data management control blocks for the task being dumped:
  • Data control block (DCB)
  • Data extent block (DEB)
  • Input/output block (IOB)
ERR Recovery termination manager (RTM) control blocks for the task being dumped:
  • Extended error descriptor (EED) for RTM
  • Registers from the system diagnostic work area (SDWA)
  • RTM2 work area (RTM2WA)
  • Set task asynchronous exit (STAE) control block (SCB)
IO Input/output supervisor (IOS) control blocks for the task being dumped:
  • Execute channel program debug area (EXCPD)
  • Unit control block (UCB)
JPA Job pack area (JPA): module names and contents
LPA Link pack area (LPA) active for the task being dumped: module names and contents
LSQA Local system queue area (LSQA) allocated for the address space (that is, subpools 203 - 205, 213 - 215, 223 - 225, 229, 230, 233 - 235, 249, 253 - 255)
NUC Read/write portion of the control program nucleus (that is, only non-page-protected areas of the DAT-on nucleus), including:
  • Communication vector table (CVT)
  • Local system queue area (LSQA)
  • Prefixed save area (PSA)
  • System queue area (SQA)
PCDATA Program call information for the task
PSW Program status word (PSW) when the dump is requested
Q Global resource serialization control blocks for the task being dumped:
  • Global queue control blocks
  • Local queue control blocks
REGS Registers when the dump is requested:
  • Access registers
  • Floating-point registers
  • General registers
  • Vector registers, vector status register, and vector mask register for a task that uses the Vector Facility
SA or SAH Save area linkage information, program call linkage information, and backward trace of save areas
SPLS Storage allocated in user subpools 0 - 127, 129 -132, 244, 251, and 252 for the task being dumped
SQA System queue area (SQA) allocated (that is, subpools 226, 239, 245, 247, 248)
SUBTASKS Storage for the task being dumped and program data for all of its subtasks
SWA Scheduler work area (SWA) (that is, subpools 236 and 237)
TRT System trace and generalized trace facility (GTF) trace, as available
— One or more data spaces identified on the SNAPX macro
— One or more storage areas, identified by beginning and ending addresses on the SNAP or SNAPX macro
— One or more subpools, identified by subpool number on the SNAP or SNAPX macro
Parent topic: Customizing SNAP dump contents