Explanation of dump tailoring options

This section provides an explanation for each of the dump tailoring options.

RANGE(xxxxxxxx:yyyyyyyy,xxxxxxxx:yyyyyyyy...)

Specifies one or more ranges of storage that you want dumped. xxx and yyy are hexadecimal addresses from 0 to X'7FFFFFFF'

RANGE(ALL)

Specifies dumping of all storage from 0 to X'7FFFFFFF'

SP(ddd)

Causes stand-alone dump to dump subpool ddd. ddd is a decimal integer from 0 to 255.

SP(ddd:eee)

Causes stand-alone dump to dump all subpools from ddd to eee, inclusive.

SP(ddd:eee,ddd:eee,...)

Causes stand-alone dump to dump the combination of subpools that you specify.

SP(ALL)

Causes stand-alone dump to dump all subpools, from 0 to 255 inclusive.

LSQA

Causes stand-alone dump to dump the LSQA.

HIGH VIRTUAL

Causes stand-alone dump to dump all allocated storage above 2G.

ASID(xxxx:yyyy)

Causes stand-alone dump to dump storage for the range of address spaces whose ASIDs begin at xxx and end at yyy, inclusive. xxx and yyy are hexadecimal numbers from X'1' to X'FFFF'.

ASID(‘jjj’)

Causes stand-alone dump to dump storage for the address space that jobname jjj identifies. Note that you must enclose the jobname in single quotation marks.

You can use wildcard characters to identify multiple jobnames. The valid wildcard characters are:

*: Zero or more characters, up to the maximum length of the string. An asterisk can start the string, end it, appear in the middle of the string, or appear in several places in the string. A single asterisk for the jobname indicates that all jobnames match.
?: One character. One or more question marks can start the string, end it, appear in the middle of the string, or appear in several places in the string. A single question mark indicates all jobnames consisting of one character.

ASID(SYSKEY)

Causes stand-alone dump to dump storage for all address spaces whose active TCB has an associated storage key of 0 to 7.

ASID(combination)

You can combine any of the above specifications. An example of a valid combination is ASID(2,‘IMSJOB’,SYSKEY).

ASID(PHYSIN)

Causes stand-alone dump to dump storage for physically swapped-in address spaces.

ASID(ALL)

Causes stand-alone dump to dump storage for all address spaces. Note that you cannot specify ASID(ALL) in combination with any of the other ASID specifications.

DATASPACES OF ASID(qualifier)

When you specify the DATASPACES OF ASID(qualifier) keyword, stand-alone dump dumps all data spaces owned by the specified address space. For each requested data space, stand-alone dump:

Dumps pages backed by central storage during the central storage dump
Copies into central storage and dumps every page that is not a first reference page and not backed by central storage

PAGETABLES OF DATASPACES

When you specify the PAGETABLES OF DATASPACES keyword, stand-alone dump dumps paged-out virtual storage that contains the page tables for all data spaces.

When stand-alone dump dumps the storage that you specify, stand-alone dump dumps all listed subpools and address ranges in all specified address spaces for each specification of dump options. However, stand-alone dump does not merge your specifications across the dump options that you specify. For example, to cause stand-alone dump to dump subpools 0 and 1 in address space A, and subpools 0 and 1 in address space B, enter:

DUMP SP(0,1) IN ASID(A,B)

To cause stand-alone dump to dump subpool 0 in address space A and subpool 1 in address space B, enter:

DUMP SP(0) IN ASID(A) ALSO SP(1) IN ASID(B)

Figure 1 shows other examples of valid specifications.

Figure 1. Example of valid specifications

DUMP SP(0:7,15),RANGE(0:10000000) IN ASID(SYSKEY),ASID(8)
DU  (SP(0 TO 7 OR 15),SP(255)) IN AS(‘TCAM’)
DUMP RANGE(ALL) IN ASID(1) ALSO SP(0) IN ASID(SYSKEY,8)
DU DAT OF AS(ALL)
DUMP ( SP(0:127) IN ASID(‘GENER’) ALSO SP(0) IN ASID(‘IMS’) )
DUMP LSQA IN AS('MYJOB',14)
DU SP(128),LS IN ASID(C,PHYSIN)
DUMP DATASPACES OF ASID('MYJOB??')
DUMP DATASPACES OF ASID('MY*')
DUMP HIGH VIRTUAL IN ASID(C)
ADDSUMM ASID(3F),ASID(‘DEBBIE’)
ADDSUMM ASID(’MYDB*’,40,46:48)
AD AS(’MYJOB?’),AS(26,'REPORT')