DROPMAP subcommand — delete storage map records

Use the DROPMAP subcommand to delete records from the storage map in a source description for a dump. The source description is 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
- LISTMAP
- SCAN

Syntax

    {DROPMAP } [RANGE (address:address)] [data-descr]
    {DROPM   }
               [ SUMMARY | NOSUMMARY ]

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

               [ TEST | NOTEST ]

Parameters
RANGE(address:address)

Specifies that the range of addresses in the dump for which map records exist are to be deleted. The range can be specified as an address and a length or as a range of addresses.
If you omit the range parameter, the subcommand deletes all map record s for the dump.

If a map record describes an address within the range, the subcommand deletes the map record.

data-descr
Specifies the data description parameter, which consists of five parts:
- An address (required with the RANGE parameter and when data-descr is explicitly specified on the subcommand)
- Address processing parameters (optional)
- An attribute parameter (optional)
- Array parameters (optional)
- A remark parameter (optional)
Data description parameter explains the use and syntax of the data description parameter.
If you specify address processing parameters (which are optional) but omit the address (which is required), the subcommand deletes all map records for the address space.
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.
Return Codes
See Standard subcommand return codes for a description of the return codes produced by the DROPMAP subcommand.
Example 1: Delete all storage map records.
- Action
```
COMMAND ===> dropmap
```
- Result
  DROPMAP produces the following summary output.
```
BLS18114I 42 RECORDS ERASED
```
Example 2: Delete storage map records within an address range for the same ASID.
- Action
```
COMMAND ===> dropmap range(005d4980.:005d4c88.) asid(x'000b')
```
- Result
  DROPMAP produces the following summary output.
```
BLS18114I 7 RECORDS ERASED
```