The PRINTHEAP command causes data in a CC heap to be displayed in a specified format. The IDNAMES mode option and the CC mode option must be previously set for DUMPANALYZER to find the desired heap.

Syntax

──┬─ PRINTHEAP ─┬─┬──────────────────────────┬─┬─────┬─┬─ HA ──┬───────►
  └─ PH ────────┘ ├─ STACK ─┬─<stack number>─┘ └─ * ─┘ └─ SHA ─┘
                  └─ STK ───┘
►─┬─────┬─<heap address>── DT ─┬─────┬─<data type>─────────────────────┤
  └─ = ─┘                      └─ = ─┘

Explanation

The following text describes the meaning of each variable.

<stack number>

The stack number containing the descriptor of the heap. If you omit the <stack number> variable, the stack number used in the previous PH command is assumed.

<heap address>

The offset into the heap where the data to be displayed resides. If HA is used, then the heap address is considered to be a byte index into the heap. If SHA is used, the heap address will be either a byte or a word offset into the heap as determined by the data type, similar to heap address variables found on the stack. If the asterisk character (*) is used, the heap address is considered to be the address of a pointer which must be dereferenced first.

<data type>

──┬────────────┬─┬─ INT ──────────────────────────────────────┬────────┤
  ├─ SIGNED ───┤ └─ CHAR ─────────────────────────────────────┤
  ├─ UNSIGNED ─┘                                              │
  ├─ ASCII ──┬─ [ ──<length>── ] ─────────────────────────────┤
  ├─ EBCDIC ─┤                                                │
  ├─ HEX ────┘                                                │
  ├─ UINT ────────────────────────────────────────────────────┤
  ├─ UCHAR ───────────────────────────────────────────────────┤
  ├─ FLOAT ───────────────────────────────────────────────────┤
  ├─ DOUBLE ──────────────────────────────────────────────────┤
  ├─ POINTER ── [ ──<ndx>── : ──<off>── ] ────────────────────┤
  ├─ STRUCT ── [ ──<ndx>── : ──<off>── ] ─────────────────────┤
  └─ ARRAY ── [ ──<ndx>── : ──<off>── ] ─┬────────────────────┤
                                         │ ┌◄───────────────┐ │
                                         └─┴─ [ ──<ss>── ] ─┴─┘

By default, INT and CHAR are assumed to be SIGNED. CHAR can be a short (one byte) INT. To display characters in EBCDIC, ASCII, or HEX, specify that data type instead of INT or CHAR.

<ndx> : <off>

A tag that identifies the POINTER, STRUCT, or ARR data type as it is found in the __PDUMPINFO tables. The __PDUMPINFO tables supply additional information required to format these data types. These values are displayed each time a variable of that data type is shown by DUMPANALYZER.

<ss>

A subscript that specifies an array element. When no subscripts are specified, the entire ARRAY is displayed (limited by ARRAYLIMIT).