The PRINTARRAY command prints an entire array or part of an array, depending on the setting of the ARRAYLIMIT (Array Limit) command. To print a present array, use either version of the PRINTARRAY command. To print an overlayed array from a program dump file, use the VIA attribute. The FLAT option allows greater control over printing arrays.
You can print an array by three different routes:
-
Set the ARRAY attribute of the MODE command to TRUE; arrays are printed in the normal course of printing a stack.
-
Use the PRINTVALUE command to print present arrays.
-
Use the PRINTARRAY command to print both present and overlayed arrays.
Note: Overlayed arrays are available only when a program dump to a disk file is being analyzed. The arrays are not dumped during memory dumps. For more information, see the discussion of the following commands in this section:
-
ARRAYLIMIT
-
MODE
-
PV
Syntax
── PRINTARRAY ─┬──────┬─<simple address>─┬─┬────────┬──────────────────┤
├─ AT ─┘ │ └─ FLAT ─┘
└─ VIA ──<ASD index>──────┘Explanation
The following text describes the meaning of each construct. Refer to “Basic Constructs” earlier in this section for information about the <simple address> construct.
PRINTARRAY <simple address> PRINTARRAY AT <simple address>
Print all or part of an array at the specified memory location.
PRINTARRAY VIA <ASD index>
Prints all or part of an array at the stack location indicated by the ASD index.
PRINTARRAY VIA <simple address> FLAT PRINTARRAY STK <ASD index> FLAT
When the FLAT option is specified, the array is displayed as requested, but any descriptors encountered are NOT expanded as is the default.
This allows the user to see information later in a dope vector without the intervening array rows being shown. That later entry may then be the target of a PRINTARRAY command directly.
