LISTMAP subcommand — list storage map entries

Use the LISTMAP subcommand to produce output using the storage map:

Generate dump displays of blocks within a range of addresses (VERIFY option).
Repeat diagnostic messages pertaining to blocks within a range of addresses (RESCAN option).

The storage map is part of a source description. 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 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.

For information about using the storage map, see the z/OS MVS IPCS User's Guide.

Related subcommands
- DROPMAP
- SCAN

Syntax

  { LISTMAP }  [ RANGE(address:address)] [data-descr ]
  { LMAP    }
               [ RESCAN | NORESCAN ]
               [ SUMMARY | NOSUMMARY ]

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

               [ DISPLAY[(display-options)]   ]
               [ NODISPLAY[(display-options)] ]
               [ FLAG(severity) ]
               [ PRINT | NOPRINT ]
               [ TERMINAL | NOTERMINAL ]
               [ TEST | NOTEST ]
               [ VERIFY | NOVERIFY ]

Parameters
RANGE(address:address)

Specifies a range of addresses in the dump for which map entries are to be listed.

data-descr
Specifies the data description parameter, which consists of five parts:
- An address (specified with the RANGE parameter and required 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 lists all map records for the address space.

If you omit the range parameter, the subcommand lists all map records for the dump.
RESCAN or NORESCAN

Requests or suppresses retransmission of diagnostic messages pertaining to blocks in the range selected, subject to the restriction imposed by the FLAG parameter.
RESCAN requests retransmission.

NORESCAN suppresses retransmission.

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 LISTMAP subcommand.
Example: Display storage map entries for a range of addresses.
- Action
```
listmap range(5000.:10000.) terminal noprint
```
- Result
  The subcommand requests a display, at the terminal only, of the storage map entries that originate between the addresses X'5000' and X'10000'.