DROPMAP subcommand — delete storage map records
- 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)
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
- Action
- 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
- Action