LISTDUMP subcommand — list dumps in dump directory

Use the LISTDUMP subcommand to:

Display the names of the sources described in a dump directory
Produce a dumped storage summary report

A source description is for an unformatted source that IPCS can format, for example, an SVC dump, a stand-alone dump, an SYSMDUMP dump, a trace data set, a data set, or active storage. The source descriptions are in the dump directory allocated with ddname IPCSDDIR and is your current dump directory. The current dump directory is your user dump directory or, for users with write access authority, might be the sysplex dump directory.

Related subcommands
- COPYDUMP
- DROPDUMP
- EVALDUMP
- SUMMARY

Syntax

  { LISTDUMP } [ SUMMARY | NOSUMMARY ]
  { LDMP     }

               [ SELECT [ (ATTRIBUTES  ) ] ]
               [        [ (BACKING     ) ] ]
               [        [ (DUMPED      ) ] ]
               [        [ (TRANSLATION ) ] ]
               [                           ]
               [ NOSELECT                  ]
               [ SYMPTOMS | NOSYMPTOMS ]
               [ INDATASET(dsname) | INFILE(ddname) ]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

               [ ACTIVE | MAIN | STORAGE          ]
               [ DSNAME(dsname) | DATASET(dsname) ]
               [ FILE(ddname) | DDNAME(ddname)    ]
               [ PATH(path-name)     ]
               [ PRINT | NOPRINT ]
               [ TERMINAL | NOTERMINAL ]
               [ TEST | NOTEST ]

Parameters
SUMMARY or NOSUMMARY

SUMMARY indicates that a processing summary (a final total line) is to be produced. NOSUMMARY suppresses the processing summary. The NOSUMMARY parameter is useful for turning summary messages off when the subcommand is invoked within a CLIST or a REXX exec.

SELECT[(options)]

NOSELECT
Specifies whether dumped storage is to be provided.
SELECT provides dumped storage; NOSELECT provides only a list of the sources for the source descriptions and the number of storage locks and bytes for the source.
The options control the amount of information included in the summary. When specifying more than one option, separate options with a blank and enclose the list of options in parentheses. The options are:
ATTRIBUTES

Requests that the attributes of each range of storage in the report be included on the output line for that range. Where applicable, one or more of the following attributes appear in the generated report:
ABSOLUTE

Represents a storage frame that was in processor storage when a stand-alone dump was requested.

COMMON

Represents common virtual storage.

MISSING

Represents storage not available in the dump.

PREFIXED

Represents storage to which access is affected by central storage prefixing.

RECLAIMED

Represents storage that was marked not valid in the page table but was located in a reclaimable storage frame.

SUMLIST

Represents storage recorded in response to the summary dump options (SUMLIST, SUMLISTA, and so on) of the SDUMP macro.

TRANSLATED

Represents storage located using an IPCS translation algorithm and retained in the dump directory to avoid repeated translation. These translation processes use the following mechanisms:
Simulation of dynamic address translation when IPCS processes a stand-alone dump.

Simulation of central storage prefixing when IPCS processes a stand-alone dump.

Simulation of the page reclamation process performed by the RSM component.

BACKING

Specifies that the dump storage summary report indicate where the dumped information is backed in the dump records. In other words, it provides record numbers of, and offsets into, the records where the storage can be found.
For example, the following portion of a line of the report output indicates that 4096 consecutive dump records, beginning with RECORD(5), each contain 4096 bytes of consecutive storage:
RECORD(5:4100) POSITIONS(48:4143)

This option is most useful for diagnosing problems within the dump records.
Note: For data sets that are not RECFM=F or RECFM=FBA, the relative track address (TTR) will appear instead of RECORD.

DUMPED

Requests that the storage summary report include storage explicitly described by the dumping program.

TRANSLATION

Specifies that the storage summary report include translation results that IPCS retained in the dump directory. TRANSLATION suppresses the output from the DUMPED option unless both options are explicitly specified.
Note: IPCS can record storage that cannot be accessed in the dump. In the report output for requests that produce only storage ranges — such as LISTDUMP SELECT (DUMPED TRANSLATION) — the only way to distinguish accessible storage from missing storage is by checking the separators between the first and last addresses in the range. Accessible storage ranges use colons as separators:
00F0C000:00F0EFFF
while missing storage range addresses are separated by a dash:
```
00F0C000-00F0EFFF
```
SYMPTOMS

NOSYMPTOMS
Specifies whether LISTDUMP is to add two lines of information to that displayed for each dump selected:
- The first line shows the dump title (symbol TITLE) or indicates that none is available from the dump directory.
- The second line show symptoms in addition to the title or indicates that none are available from the dump directory. The symptoms chosen are indicated by the caption and are, in order of preference:
  - Trap — SLIP trap text (symbol SLIPTRAP)
  - Psym — Primary symptom string (symbol PRIMARYSYMPTOMS)
  - Ssym — Secondary symptom string (symbol SECONDARYSYMPTOMS)
If an output medium is selected that is too narrow to display the dump directory data available for either line, as much data is shown as will fit on one line.

The default NOSYMPTOMS keyword suppresses this output.
INDATASET(dsname)

INDSNAME(dsname)

Requests allocation of directory dsname and use of the contents of that directory by the subcommand.

INFILE(ddname)

INDDNAME(ddname)

Requests use of a directory that the IPCS user has allocated to ddname and use of the contents of that directory by the subcommand.

ACTIVE or MAIN or STORAGE

DATASET(dsname-list) or DSNAME(dsname-list)

FILE(ddname-range-list) or DDNAME(ddname-range-list)

Specifies the source or sources of the source descriptions to be selected from the dump directory. Use these parameters with the SELECT parameter. If these parameters are omitted, the report is for all sources in the user dump directory.
ACTIVE, MAIN, or STORAGE specifies central storage as the source.

DSNAME or DATASET specifies the names of one or more data set as the sources.

FILE or DDNAME specifies one, several, or a range of ddnames for data sets as the sources.

When specifying more than one data set name or ddname, separate the names with commas or blanks. When specifying a range of ddnames, separate the first and last ddname with a colon.
Return Codes
See Standard subcommand return codes for a description of the return codes produced by the LISTDUMP subcommand.

Example 1: List the dump sources described in the dump directory.

Action
```
COMMAND ===> listdump
```
This command has the defaults of SUMMARY, NOSELECT, and NOSYMPTOMS.

Result

The following output is produced. Notice that the last line, which is produced by the SUMMARY parameter, provides a total number of the displayed dump data sets.

Source of Dump                                Blocks            Bytes
ACTIVE   . . . . . . . . . . . . . . . . . . . .   2  . . . . . 8,208
FILE(CLIC)   . . . . . . . . . . . . . . . . . .  10  . . . . . 2,640
FILE(MENUS)  . . . . . . . . . . . . . . . . . .  10  . . . . . 2,640
DSNAME('D46RLW1.LOG.MISC')   . . . . . . . . . .  79  . . . . 187,809
DSNAME('D46RLW1.RLW.CLIST')  . . . . . . . . . .  25  . . . . . 6,600
DSNAME('D46RLW1.SYSMDUMP')   . . . . . . . .   1,218  . . . 4,998,672
DSNAME('D46RLW1.XMIT.NAMES')   . . . . . . . . .   2  . . . . . 3,520
DSNAME('D46RLW1.THIS.IS.A.LONG.DSNAME.FOR.TESTING(TESTMEMB)')
                                               1,040  . . . .  31,200
DSNAME('D83DUMP.DUMPC.PB06511')  . . . . . .   1,346  . . . 5,523,984
DSNAME('D83DUMP.DUMPC.PB07251')  . . . . . .  24,142  . .  99,078,768
10 Dumps described

Example 2: Obtain a dumped storage summary report with retained translation data, attributes, and storage described by the dumping program for a particular dump data set, MY.DUMP.

Action

COMMAND ===> listdump select(dumped attributes translation) dsname(my.dump)

Result

The following output is produced.

 Source of Dump                             Blocks              Bytes
 DSNAME('RLW.HBB5520.SAMPLE.SVCDUMP')    . .   994  . . . . 4,135,040
   ABSOLUTE
     00A95000:00A95FFF ABSOLUTE
     00CD3000:00CD3FFF ABSOLUTE
     010A7000:010A7FFF ABSOLUTE
     012A8000:012A8FFF ABSOLUTE
     01539000:01539FFF ABSOLUTE
     01756000:01757FFF ABSOLUTE
     0175A000:0175CFFF ABSOLUTE
   40,960, X'0000A000', bytes described in ABSOLUTE

   ASID(X'0001')
     00000000:00000FFF COMMON PREFIXED TRANSLATED
     006F6000:006FBFFF
     00AF2000:00B0CFFF COMMON TRANSLATED
     00F4A000:00F4DFFF COMMON TRANSLATED
     00F8B000:00F90FFF COMMON TRANSLATED
     00F9C000:00FA0FFF COMMON TRANSLATED
     00FA6000:00FA6FFF COMMON TRANSLATED
     00FBF000:00FC9FFF COMMON TRANSLATED
     00FCF000:00FD2FFF COMMON TRANSLATED
     00FD3000-00FD5FFF COMMON MISSING TRANSLATED
     00FD6000:00FD6FFF COMMON TRANSLATED
         .
         .
         .
     020F6000:02106FFF COMMON TRANSLATED
   1,589,248, X'00184000', bytes described in ASID(X'0001')

   ASID(X'0004')
     7F735000:7F745FFF
   69,632, X'00011000', bytes described in ASID(X'0004')

   ASID(X'0015')
     00000000:00000FFF COMMON PREFIXED
     006D4000:006D5FFF
     006DC000:006DCFFF
     006E2000:006E3FFF
     006EA000:006FFFFF
     00AF2000:00B0CFFF COMMON
     00F0C000:00F4DFFF COMMON
         .
         .
         .
     7FFFB000:7FFFEFFF
   3,928,064, X'003BF000', bytes described in ASID(X'0015')

   HEADER
     00000000:0000103F
   4,160, X'00001040', bytes described in HEADER

   COMPDATA(IARCDR01)
     00000000:00000FFF
   4,096, X'00001000', bytes described in COMPDATA(IARCDR01)

   DOMAIN(SUMDUMP)
     00001000:00006FFF
   24,576, X'00006000', bytes described in DOMAIN(SUMDUMP)

   ASID(X'0015') SUMDUMP
     01E8CDD8:01E8CDF3 COMMON SUMLIST
     01EB9000:01EB91FF COMMON SUMLIST
     7F702F80:7F702FFF SUMLIST
     7F704000:7F708FFF SUMLIST
     7FFFB040:7FFFB07F SUMLIST
     7FFFC008:7FFFC037 SUMLIST
   21,260, X'0000530C', bytes described in ASID(X'0015') SUMDUMP

 1 Dump described

Example 3: List the dump sources described in the dump directory with additional title and symptom information.

Action
```
COMMAND ===> listdump symptoms
```
This command has the defaults of SUMMARY and NOSELECT.

Result

The following output is produced.

 Source of Dump                                      Blocks               Bytes
 ACTIVE                                                   2               8,320
   No title
   No symptoms

 Source of Dump                                      Blocks               Bytes
 DSNAME('C89.BLSRMVCL.SOC4DUMP')                     26,544         110,423,040
   Title=JOBNAME C89      STEPNAME SMPROC  SMPROC   SYSTEM 0C4
   Psym=RIDS/BLSRVEC3#L RIDS/BLSRMVCL PIDS/5752SC132 AB/S00C4 RIDS/BLSUSTAI#R V

 Source of Dump                                      Blocks               Bytes
 DSNAME('H44IPCS.R38A.PMR00137.B379.EH603')          12,762          53,089,920
   Title=COMPON=COMPONENT TRACE,COMPID=SCTRC,ISSUER=ITTAWRIT
   Psym=RIDS/NUCLEUS#L RIDS/ITTAWRIT PIDS/5752SCTRC AB/S001D RIDS/ITTAWRIT#R VA

 Source of Dump                                      Blocks               Bytes
 DSNAME('H44IPCS.R38A.PMR00137.B379.EH603A')        573,996       2,387,823,360
   Title=SLIP DUMP ID=0005
   Trap=SLIP SET,COMP=01D,NUCMOD=IARDS,DN=(3.*,15.SYSLOGR0),SD=(ALLNUC,PSA,SQA,

 Source of Dump                                      Blocks               Bytes
 DSNAME('H44IPCS.R38A.PMR00218.B677.DUMP1')          10,574          43,987,840
   Title=SLIP DUMP ID=X05C
   Trap=SLIP SET,C=05C,ID=X05C,A=SVCD,RE=308

 Source of Dump                                      Blocks               Bytes
 DSNAME('NHAN.FBS29K.DUMP')                         438,123       1,822,591,680
   Title='MVSPROD1 02/27/97'
   No symptoms

 6 Dumps described
 IPCS

The output medium to which the preceding output was directed was 78 characters wide. This caused the lines beginning “Psym=RIDS/BSLRVEC3#L”, “Psym=RIDS/NUCLEUS#L”, and “Trap=SLIP” to be truncated.