SNAPX — Dump virtual storage and continue

The SNAPX macro performs the same function as SNAP: it enables you to obtain a dump of some or all of the storage assigned to the current job step. SNAPX is intended for use by programs running in access register (AR) mode. Programs running in primary mode can also use SNAPX.

Note: The SNAPX macro has the same environment specifications, register information, programming requirements, restrictions and limitations, performance implications and return codes as the SNAP macro. However, IBM® recommends that programs in AR ASC mode use SNAPX. All parameters on SNAP are valid on SNAPX.
Parent topic: SNAP and SNAPX — Dump virtual storage and continue

Syntax

The standard form of the SNAPX macro is written as follows:

Syntax Description
   
   name name: Symbol. Begin name in column 1.
   
␢ One or more blanks must precede SNAPX.
   
SNAPX  
   
␢ One or more blanks must follow SNAPX.
   
DCB=dcb addr dcb addr: A-type address, or register (2) - (12).
   
   ,TCB=tcb addr tcb addr: A-type address, or register (2) - (12).
   
   ,ID=id nmbr

id nmbr:  Symbol, decimal digit, or register (2) - (12).
Value range:  0-255
   
   ,SDATA=ALL  
   ,SDATA=(sys data code) sys data code: Any combination of the following, separated by commas. If you specify only one code, you do not need the parentheses.
   
  
NUC       CB        ERR
SQA       Q         IO
LSQA      TRT       ALLVNUC
PCDATA
SWA       DM        SUM
   
   ,PDATA=ALL  
   ,PDATA=(prob data code) prob data code: Any combination of the following, separated by commas. If you specify only one code, you do not need the parentheses.
   
  
PSW
REGS
SA or SAH
JPA or LPA or ALLPA
SPLS
SUBTASKS
   

   ,STORAGE=(strt addr,end
    addr)
   ,LIST=list addr

strt addr:  A-type address, or register (2) - (12).
end addr:  A-type address, or register (2) - (12).
list addr:  A-type address, or register (2) - (12).
  Note: One or more pairs of addresses may be specified, separated by commas. For example: STORAGE=(strt addr,end addr,strt addr,end addr)
   ,STRHDR=(hdr addr) hdr addr: A-type address, or register (2) - (12).
   ,STRHDR=hdr list addr Note: hdr addr is one or more addresses separated by commas. If you specify only one header address as an A-type address, you do not need the parentheses. If you specify one or more registers, then you must code double parentheses (one set enclosing each register and one set enclosing the list of registers). If you specify STRHDR=(hdr addr), you must also specify STORAGE.
  hdr list addr: A-type address, or register (2) - (12).
  Note: If you specify STRHDR=hdr list addr, you must also specify LIST.
   
   ,SUBPLST=sbp list addr sbp list addr: A-type address, or register (2) - (12).
   
   ,DSPSTOR=list addr list addr: A-type address or reg (2) - (12).
   

Parameters

Parameters for the SNAPX macro are the same as those for the SNAP macro, except for the DSPSTOR parameter, which is valid only on SNAPX. SDATA=SUM has a different function for callers in AR mode. These two parameters are described as follows:

,SDATA=SUM
The SUM option is valid for an abending task or on a list form of the SNAPX macro pointed to by the DUMPOPX parameter of the ABEND or SETRP macro. For the contents of the summary dump, see the description of the SDATA parameter in the SNAP macro.
,DSPSTOR=list addr
Specifies the address of a list of data space storage areas to be dumped. Use this parameter to dump data that is in a data space.

Each entry in the parameter list you create describes an area to be dumped; the entry must contain a start address, end address, and STOKEN. The list must begin on a fullword boundary, and the high order bit of the fullword containing the last end address in the list must be set to 1. The system dumps storage from any data space to which the caller has authority; it does not dump storage to which the caller does not have authority.

You can specify the DSPSTOR parameter for SNAPX parameter lists that are identified by the DUMPOPX parameter on the ABEND or SETRP macro.