SDUMP - Execute form

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

If you code one or more of the SDATA parameters on the execute form of the macro, any SDATA parameters coded on the list form are lost.

Syntax

The execute form of the SDUMP macro is written as follows:

Syntax	Description

`name`	`name`: Symbol. Begin `name` in column 1.

␢	One or more blanks must precede SDUMP.

SDUMP

␢	One or more blanks must follow SDUMP.

HDR=`‘dump title’`	`dump title`: From 1 to 100 characters.
HDRAD=`dump title addr`	`dump title addr`: A-type address, or register (2) - (12).

,DCB=`dcb addr`	`dcb addr`: A-type address, or register (2) - (12).

,ASID=`ASID addr`	`ASID addr`: A-type address, or register (2) - (12).
,ASIDLST=`list addr`	`list addr`: RX-type address, or register (2) - (12).

,TYPE=`(type code)`	`type code`: Any of the following, separated by commas: XMEM, XMEME, NOLOCAL, FAILRC
	Note: XMEM and XMEME are mutually exclusive codes.

,PLISTVER=1	`decimal digit 1`: Use up to a 68-byte parameter list.
,PLISTVER=2	`decimal digit 2`: Use 128-byte parameter list.
	Default: PLISTVER=1, unless you specify SYMREC, ID, IDAD, PSWREGS, SDATA=DEFS, SDATA=NODEFS, or SDATA=IO, in which case the default is PLISTVER=2.

,SYMREC=`symrec addr`	`symrec addr`: RX-type address, or register (2) - (12).

,ID=‘`identifier`’	`identifier`: From 1 to 50 characters.
,IDAD=`identifier addr`.	`identifier addr`: RX-type address, or register (2) - (12).

,PSWREGS=`parm list addr`	`parm list addr`: RX-type address, or register (2) - (12).

,ECB=(`ecb addr`)	`ecb addr`: A-type address, or register (2) - (12).
,SRB=(`srb addr`)	`srb addr`: A-type address, or register (2) - (12).
	Note: SVC dump posts the ECB at the completion of the capture phase unless the DCB parameter is specified with the ECB parameter. If you specify both the DCB and ECB parameters, the ECB is posted at the completion of the writing phase. SVC dump schedules the SRB at the completion of the capture phase unless the DCB parameter is specified with the SRB parameter. If you specify both the DCB and SRB parameters, the SRB is scheduled at the completion of the writing phase.

,SDATA=`(sdata options)`	`sdata options`: Any combination of the following, separated by commas:
	ALLNUC, ALLPSA, CSA, GRSQ, LPA, LSQA, NOALLPSA/NOALL, NOSQA, NOSUMDUMP/NOSUM, NUC, PSA, RGN, SQA, SUMDUMP/SUM, SWA, TRT DEFAULTS/DEFS, NODEFAULTS/NODEFS, IO
	Note: Executing SDUMP causes ALLPSA, SQA, IO, and SUMDUMP storage areas to be dumped unless excluded by NOALLPSA, NOSQA, NODEFAULTS, or NOSUMDUMP. The PSA and IO options are not required unless NODEFAULTS is specified, because they are dumped as a default in all SVC dumps. DEFAULTS is not required. All SVC dumps include the default SDATA options unless NODEFAULTS has been specified.

,STORAGE=`(strt addr,end`	`strt addr`: A-type address, or register (2) - (12).
`addr)`	`end addr`: A-type address, or register (2) - (12).
,LIST=`list addr`	`list addr`: A-type address, or register (2) - (12).
,LISTA=`list addr`	Note: Specify one or more pairs of addresses, separated by commas.

,SUBPLST=`subpool id list`	`subpool id list addr`: RX-type address, or register (2) - (12).
`addr`

,KEYLIST=`storage key list addr`	`storage key list addr`: RX-type address, or register (2) - (12).
	Note: KEYLIST cannot be specified without SUBPLST.

,BUFFER=NO	Default: BUFFER=NO
,BUFFER=YES

,QUIESCE=YES	Default: QUIESCE=YES
,QUIESCE=NO

,BRANCH=NO	Default: BRANCH=NO
,BRANCH=YES	Note: If BRANCH=YES is specified, ASID or ASIDLST must also be specified.

,SUSPEND=NO	Default: SUSPEND=NO
,SUSPEND=YES

,SUMLIST=`list addr`	`list addr`: RX-type address, or register (2) - (12).
,SUMLSTA=`list addr`

,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 SDUMP macro, with the following exception:

,MF=(E, ctrl addr): Specifies the execute form of the SDUMP macro using a remote control program parameter list.

Example 1

The execute form is used to change SDATA areas, BUFFER, and QUIESCE options in the SDUMP parameter list. The list form of SDUMP was previously used to create the basic SDUMP parameter list located by register 1.

SDUMP SDATA=(SQA,LPA),BUFFER=NO,QUIESCE=NO,MF=(E,(1))

Example 2

Operation: This example shows a dump request from SUBSYSTEM1. This dump will be suppressed if the symptoms in the symptom record match a previous dump's symptoms, and if the installation has enabled dump suppression. The dump does not include the SDATA options specified on CHNGDUMP or the ALLPSA or SQA data areas. The dump does include the IO data areas and a summary dump which contains PSW/register data.

SDUMP ID='SUBSYSTEM1',SYMREC=(8),SDATA=(NODEFS,IO),PSWREGS=(9)