DROPDUMP subcommand — delete source description data

Use the DROPDUMP subcommand to delete a source description or records in a source description from a dump directory. The 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 directory is 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.

Some reasons for using DROPDUMP are to:

Delete the description for a source that is no longer needed
Delete the description for a partially initialized dump
Delete source descriptions to free space in the directory
Delete translation records from one or more source descriptions

Related subcommands
- ADDDUMP
- LISTDUMP

Syntax

    {DROPDUMP } [RECORDS  {( ALL | ANALYSIS | TRANSLATION  } ]
    {DROPD
                [ SUMMARY | NOSUMMARY ]

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

                [ ACTIVE|MAIN|STORAGE            ]
                [ DSNAME(dslist)|DATASET(dslist) ]
                [ FILE(ddlist)|DDNAME(ddlist)    ]
                [ TEST | NOTEST ]

Parameters
RECORDS(ALL)

RECORDS(ANALYSIS)

RECORDS(TRANSLATION)
Designates the type of records to be deleted from a source description.
RECORDS(ALL) directs IPCS to delete all of the records in a source description.

RECORDS(ANALYSIS) directs IPCS to delete only analysis records.

RECORDS(TRANSLATION) directs IPCS to delete only records generated by an IPCS translation process. Translation records are generated by, for example, the simulation of System/390® prefixing or dynamic address translation.
The following are ways to use RECORDS(TRANSLATION):
- When IPCS first processes storage for a central processor in a stand-alone dump, IPCS locates the prefixed storage area (PSA) for the processor. IPCS constructs a central storage map using the absolute storage record map for the dump.
  If IPCS used an incorrect PSA, you may correct the definition of the PSAnn symbol in the symbol table. Then, you can run DROPDUMP RECORDS(TRANSLATION) to delete the incorrect translation records from your user dump directory. When IPCS next processes the storage in the dump, IPCS uses the corrected symbol to build a correct record map.
- When IPCS first processes an address space in a stand-alone dump, IPCS locates the segment table for the address space. IPCS constructs a virtual storage record map for the referenced page using the absolute storage record map or the central storage map for the dump.
  If IPCS used an incorrect segment table, you may correct the definition of the SGTnnnnn symbol in the symbol table. Then, you can run DROPDUMP RECORDS(TRANSLATION) to delete the incorrect translation records from your user dump directory. When IPCS next processes the address space in the dump, IPCS uses the corrected symbol to build a correct record map.
- When you first enter an ANALYZE or STATUS CPU CONTENTION subcommand, IPCS places the following contention records in the source description:
  The contention queue (CQ)
  
  The contention resource (CR)
  
  Program history (PH)
  
  These records are incorrect if the symbols for the control blocks are incorrect or if the ANALYZE exit routines specified by parmlib members embedded in the BLSCECT parmlib member have been redefined. If you determine that the contention records are incorrect, enter DROPDUMP RECORDS(TRANSLATION) to delete all contention records. Then you can run ANALYZE or STATUS CPU CONTENTION to have IPCS gather the contention records again.
DROPDUMP RECORDS(TRANSLATION) does not edit the symbol table or the storage map. For editing, use DROPMAP, DROPSYM, or EQUATE subcommands.
SUMMARY or NOSUMMARY

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

ACTIVE or MAIN or STORAGE

DSNAME(dslist) or DATASET(dslist)

FILE(ddlist) or DDNAME(ddlist)

Specifies storage or one or more data sets. IPCS is to delete the source description or records in the source description for the storage or data sets. If one of these parameters is not specified, IPCS deletes the source description or records from the source description for your current source data set.
ACTIVE, MAIN, or STORAGE specifies that the source description is for the active storage that was accessed.

DSNAME or DATASET specifies that the source description is for the cataloged data set or sets named in dslist. When specifying more than one data set name, separate the names with commas or blanks.

FILE or DDNAME specifies that the source description is for a data set or sets with the ddname or ddnames in ddlist. When specifying more than one ddname, separate the names with commas or blanks.
Return Codes
See Standard subcommand return codes for a description of the return codes produced by the DROPDUMP subcommand.
Example 1: Delete a source description for a specific dump.
- Action
```
COMMAND ===> dropdump dsname('sys1.dump.d930428.t110113.system1.s00000')
```
- Result
  IPCS deletes from your user dump directory the source description for the dump in the data set named sys1.dump.d930428.t110113.system1.s00000. IPCS issues the following summary output.
```
BLS18206I All records for 1 dump dropped
```
Example 2: Delete records generated by translation processes,
- Action
```
COMMAND ===> dropdump records(translation)
```
- Result
  The contention information from a STATUS CPU CONTENTION subcommand for the current dump data set appears to be incorrect. IPCS deletes this information, displays the following output, and permits the STATUS subcommand to be entered again to obtain new contention data.
```
BLS18206I Translation records for 1 dump dropped
```