SNAP and SNAPX—Execute form

A remote control-program parameter list is referred to and can be modified by the execute form of the SNAP or SNAPX macro.

If you code only the DCB, ID, MF, or TCB parameters in the execute form of the macro, the bit settings in the parameter list corresponding to the SDATA, PDATA, LIST, and STORAGE parameters are not changed. However, if you code the SDATA, PDATA, or LIST parameters, the bit settings for the coded parameter from the previous request are reset to zero, and only the areas requested in the current macro are dumped.

Parent topic: SNAP and SNAPX — Dump virtual storage and continue

Syntax

The execute form of the SNAP or SNAPX macro is written as follows:

Syntax Description
   
   name name: Symbol. Begin name in column 1.
   
␢ One or more blanks must precede SNAP.
   

SNAP
SNAPX

  
   
␢ One or more blanks must follow SNAP.
   
DCB=dcb addr dcb addr: RX-type address, or register (2) - (12).
Note: The DCB parameter is not required in all cases. See the parameter description for details.
   

   ,TCB=tcb addr
   ,TCB=‘S’

 tcb addr: RX-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 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 parentheses.
   
  
PSW
REGS
SA or SAH
JPA or LPA or ALLPA
SPLS
SUBTASKS
   

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

strt addr:  RX-type address, or register (2) - (12).
end addr:  RX-type address, or register (2) - (12).
list addr:  RX-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)
   ,STRHDR=hdr list addr

 hdr addr: RX-type address, or register (2) - (12).
Note: hdr addr is one or more addresses separated by commas. If you specify only one header address as an RX-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 STRHDR=(hdr addr) is specified, then STORAGE must also be specified.
  hdr list addr: RX-type address, or register (2) - (12).
Note: If STRHDR=hdr list addr is specified, then LIST must also be specified.
   
   ,SUBPLST=sbp list addr sbp list addr: RX-type address, or register (2) - (12).
   
   ,DSPSTOR=list addr list addr: A-type address or register (2) - (12).
   
,MF=(E,ctrl addr) ctrl addr: RX-type address, or register (1) or (2) - (12).
   

Parameters

The parameters are explained under the standard form of the SNAP and SNAPX macros, with the following exceptions:

,TCB=‘S’
Specifies the task control block of the active task.
Note: TCB=‘S’ causes a dump of the active task if this is the first use of the list form of the SNAP or SNAPX macro or if the TCB specified on a previous execute form of the SNAP or SNAPX macro was the current TCB or TCB=‘S’.
,MF=(E,ctrl addr)
specifies the execute form of the SNAP or SNAPX macro using a remote control program parameter list.