The COREMAP command creates an analysis of memory layout and use.

The first time you use a COREMAP command (other than HELP or GLOBALS), DUMPANALYZER creates a disk file containing memory information. This file is called MEMDUMP/COREMAP/<date>/<time> (where <date> and <time> are the date and time of the dump). Creation of the file requires scanning ASD tables and memory links and can take a long time. Use the ?AX WHERE command to determine scan progress, and ?AX BRK to abort the scan.

DUMPANALYZER reuses the disk file in subsequent runs of DUMPANALYZER. You can analyze just the core map by label-equating the file COREMAP.

Syntax

── COREEMAP ─┬─ HELP ─────────────────────────┬─────────────────────────┤
             ├─ GLOBALS ──────────────────────┤
             ├─ LAYOUT ─┬─────────────────────┤
             │          └─<granularity>───────┤
             ├─ SUMMARY ─┬─┬──────────────────┤
             ├─ USAGE ───┘ ├─ STACK <number> ─┤
             │             └─ ALL ────────────┤
             ├─ DETAIL ─┬─┬───────────────────┤
             └─ HISTO ──┘ └─ STACK <number> ──┘

Explanation

The following text describes the meaning of each construct. Refer to “Basic Constructs” earlier in this section for information about the <number> construct.

COREMAP HELP

Displays a short description of the various subcommands.

COREMAP GLOBALS

Displays several MCP Memory Management global variables, a number of which are mapped in the COREMAP LAYOUT output.

COREMAP LAYOUT COREMAP LAYOUT <decimal granularity range 15 – 32>

Displays a map of memory showing the amount and location of save, overlay, and available memory. By default, each line of the chart represents 32K or 2**15 words, with each character denoting 512 words. The <granularity> number allows the number of words represented in the chart to be varied by applying the number as a power of 2. Thus, COREMAP LAYOUT 20 causes each line of the chart to represent 2**20 or 1 megaword of memory. Because there are 64 characters per line, each character, in this case represents 16384 words.

This option also displays a chart of the number of occurrences of adjacent areas by type and reports the values of MCP global variables that are included in the COREMAP GLOBALS command.

COREMAP SUMMARY

Displays the amount of save, overlay, code, and available memory for the system.

COREMAP SUMMARY STACK <number>

Displays save, overlay, and code memory for the specified stack.

COREMAP SUMMARY ALL

Displays save, overlay, and code memory for every stack.

COREMAP USAGE COREMAP USAGE STACK <number> COREMAP USAGE ALL

Display the number of areas and total words for each kind of memory area, such as array, stack, FIB, dope vector, and so forth, divided into save and overlay memory. Specifying a STACK number analyzes only the memory being used by that stack. Specifying ALL displays all stacks.

The type of memory area in the USAGE reports is the value of SPACEUSAGE with the following changes:

COREMAP DETAIL

COREMAP DETAIL STACK <number>

Display the number of areas and total words for each kind of memory area for each size range, such as 1 to 10 words, 10 to 20 words, and so forth, in a logarithmic progression. Specifying a STACK number analyzes only the memory being used by that stack.

The type of memory area in the DETAIL reports is the value of SPACEUSAGE except for some changes. See the preceding explanation of the COREMAP USAGE command for more information.

COREMAP HISTO

COREMAP HISTO STACK <number>

Display a histogram of the number of areas in each size range of save, overlay, code, and available memory. Specifying a STACK number analyzes only the memory being used by that stack.