AREAS (Memory Areas)

The AREAS command prints the contents of memory areas. The command enables you to specify the areas of the dump to analyze and the information to be displayed.

Syntax

          ┌◄─────────────────────────────────────────┐
── AREAS ─┴─┬──────────────────────────────────────┬─┴─────────────────►
            ├─ AVAIL ──────────────────────────────┤
            ├─ DATA ───────────────────────────────┤
            ├─ CODE ───────────────────────────────┤
            ├─/1\─ SIZE ──<number>─────────────────┤
            ├─/1\─ SPACEUSAGE ──<spaceusage field>─┤
            └─/1\─ RANGE ──<multiple address>──────┘
►─<output selection>───────────────────────────────────────────────────┤

<output selection>

  ┌◄───────────────────┐
──┴─/3\─┬─ CONTENTS ─┬─┴───────────────────────────────────────────────┤
        ├─ LINKS ────┤
        └─ STATS ────┘

<spaceusage field>

──┬─ BUFFERHEADER ───────┬─────────────────────────────────────────────┤
  ├─ CODEAREA ───────────┤
  ├─ DCCMESSAGEAREA ─────┤
  ├─ DIRECTIOBUFF ───────┤
  ├─ DIRECTIOBUFFTOBE ───┤
  ├─ DETACHEDSEG ────────┤
  ├─ DIRTYAREA ──────────┤
  ├─ DIRTYSEG ───────────┤
  ├─ DOPEOREVENTAREA ────┤
  ├─ DOPEVECT ───────────┤
  ├─ EVENTAR ────────────┤
  ├─ EVENTCONTAINERAREA ─┤
  ├─ EVENTMESSAGEAREA ───┤
  ├─ EVENTSEG ───────────┤
  ├─ EVSTATEAREA ────────┤
  ├─ FIBMARK ────────────┤
  ├─ HEAPDOPE ───────────┤
  ├─ ICMMARK ────────────┤
  ├─ INSTACKAREA ────────┤
  ├─ IOCBAREA ───────────┤
  ├─ IOCDAREA ───────────┤
  ├─ IOCBMESSAGEAREA ────┤
  ├─ LOGICALIOBUFF ──────┤
  ├─ LOGICALIOMSGAREA ───┤
  ├─ MCBAREA ────────────┤
  ├─ MESSAGEAREA ────────┤
  ├─ MULTIAREABUFFER ────┤
  ├─ NORMALAREA ─────────┤
  ├─ PERMSAVEAREA ───────┤
  ├─ PIBMARK ────────────┤
  ├─ POISONEDSEG ────────┤
  ├─ RESERVEAREA ────────┤
  ├─ RESERVEEVENTAREA ───┤
  ├─ SEGDOPE ────────────┤
  ├─ SEGSEG ─────────────┤
  ├─ SHADOWAREA ─────────┤
  ├─ SHADOWSHAREDSEG ────┤
  ├─ SHAREDDOPE ─────────┤
  ├─ SHAREDSEG ──────────┤
  ├─ SIBMARK ────────────┤
  ├─ STACKMARK ──────────┤
  ├─ STRUCTUREDAREA ─────┤
  ├─ SUBSPACE_ARRAY ─────┤
  └─ TABMARK ────────────┘

Explanation

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

<output selection>

Designate at least one of the following output selections:

Specify . . .

To . . .

CONTENTS

Display the contents of all the selected areas.

LINKS

Display the links of all the selected areas.

STATS

Collect statistics regarding the memory areas and their associated stacks. DUMPANALYZER produces a memory usage summary that contains these statistics.

AREAS <output selection>

Analyzes all memory areas that contain data or code, or that are available.

AREAS AVAIL <output selection>

Analyzes all memory areas that are available.

AREAS DATA <output selection>

Analyzes all memory areas that contain data.

AREAS CODE <output selection>

Analyzes all memory areas that contain code segments.

AREAS SIZE <number> <output selection>

Analyzes all memory areas of the designated size.

AREAS SPACEUSAGE <spaceusage field> <output selection>

Analyzes all memory areas that contain the item designated in the spaceusage field.

SPACEUSAGE Field Items describes each spaceusage field item.

Table 10. SPACEUSAGE Field Items

If the item is...

The area...

BUFFERHEADER

Contains information about input/output (I/O) buffers.

CODEAREA

Contains code.

DCCMESSAGEAREA

Is a message area used for datacom.

DETACHEDSEG

Is used for POSIX shared memory.

DIRECTIOBUFF

Contains a direct array.

DIRECTIOBUFFTOBE

Is in transition. It will be DIRECTIOBUFF.

DIRTYAREA

Is an array containing odd tagged words.

DIRTYSEG

Is a segmented array containing odd tagged words.

DOPEOREVENTAREA

Contains dope vectors and/or events

DOPEVECT

Contains a dope vector; this dope vector includes mom descriptors.

EVENTARRAY

Contains an event array.

EVENTCONTAINERAREA

Contains events but is not an event array.

EVENTMESSAGEAREA

Is a message area that contains an event.

EVENTSEG

Is a segmented event array.

EVSTATEAREA

Contains event state.

FIBMARK

Contains a file information block (FIB).

HEAPDOPE

Is used for POSIX shared memory.

ICMMARK

Is a connection block.

INSTACKAREA

Is an in-stack array.

IOCBAREA

Contains an I/O control block (IOCB).

IOCDAREA

Is for direct I/O control block (IOCD) use.

IOCBMESSAGEAREA

Is an IOCB.

LOGICALIOBUFF

Is a nondirect I/O buffer.

LOGICALIOMSGAREA

Is a message area used for logical I/O.

MCBAREA

Is a message control block.

MESSAGEAREA

Is a message.

MULTIAREABUFFER

Is an array used by high-speed datacom.

NORMALAREA

Is a “normal” area that does not contain any of the structures indicated in the rest of the option list.

PERMSAVEAREA

Is a permanent save area allocated by GETITGOING.

PIBMARK

Contains a process information block (PIB) or task variable, or a segment dictionary pseudo PIB.

POISONEDSEG

Is used for POSIX shared memory.

RESERVEAREA

Is for the GETAREA reserve pool.

RESERVEEVENTAREA

Is space held in reserve for the task control unit (TCU). The TCP_INSTALL_EVENT_SPACE call passes the RESERVEEVENTAREA to the TCU when the TCU indicates it has no unused EVENTs during a TCP_ALLOCATE_EVENT call. The RESERVE_EVENT_AREA_MANAGER maintains a small pool of the areas.

SAVECODEAREA

Contains save code.

SEGDOPE

Contains the dope vector for a segmented (that is, “paged”) array.

SEGSEG

Is a page of a segmented array.

SHADOWAREA

Is used for POSIX fork().

SHADOWSHAREDSEG

Is used for POSIX shared memory.

SHAREDDOPE

Is used for POSIX shared memory.

SHAREDSEG

Is used for POSIX shared memory.

SIBMARK

Contains an Enterprise Database Server structure information block.

STACKMARK

Contains a stack or a segment dictionary.

STRUCTUREDAREA

Is a structure block.

SUBSPACE_ARRAY

Is a type of array subset that is treated as a complete unit for MASKSEARCH operations and primitive memory allocation routines.

TABMARK

Contains a task attribute block (TAB).


AREAS RANGE <multiple address> <output selection>

Restricts the analysis of memory areas to the specified address range. Areas partially or completely in the desired range are analyzed. Refer to “Multiple Addresses” earlier in this section.

Example

The following example shows the output from the AREAS command.

INPUT: AREAS RANGE 2100 TO 5000 LINKS
000020F5  INUSE AREA  DATA: LENGTH=01FB0(8112)MOM ADDR=0001B7A2 (THIS IS
       STACK 012) -------------------------(STACK)       ---------
LINKS: 6 E01FB4 000012    7 000000 000000    3 000000 000000   ... 3
       E01FB4 000000
          RESCODE_MEMORY
000040A9  INUSE AREA  DATA: LENGTH=03D93(15763)MOM ADDR=0000293B (D[0] +
       083B)-------------------------------(PERMSAVEAREA)---------
LINKS: 6 E03D97 0010D5    7 000000 000000    3 000000 000000   ... 3
       E03D97 000000