ARRAY

Displays the contents of one or more variables which are array elements.


>>-ARRay--+--------+--+-------------+--------------------------><
          '-window-'  | .-;-------. |   
                      | V         | |   
                      '---element-+-'

window

The LSM Information window used to display the array element contents information. Select it by a Window Specification, or by placing the cursor in the window.

If supplied, the window must be an LSM Information window. If omitted, the first LSM Information window is used. If no LSM Information window is open, one is opened.

element

A variable name.

Simple variables are defined by name only. You can define based variables by name only, in which case the declared basing is used by IDF, or you can specify an explicit locating expression.

See Variable expressions for a complete description of the syntax of the expressions which may be used for ARRAY variable name arguments.

The array element display persists until:

An ARRAY command without arguments is issued
The window is closed with a CLOSE command.
Another IDF Language command such as VARIABLE, STRUCTURE, TYPE, CALLERS, PLOCATES, LANGUAGE STATUS, or MAP is issued, which directs IDF to update the LSM Information window with new information
The target program completes execution
Target program execution progresses beyond the variable's defined scope

If the contents of the array element change while the program is running to a breakpoint, the changed data is shown on the screen when the breakpoint is reached.

You can change the displayed data by overtyping it.

In EBCDIC display mode, character data equal to X'FF' or below X'40' is displayed as a period character.

In ASCII display mode, character data which does not correspond to a displayable EBCDIC character is displayed as a period character.

If a based variable was respecified, the current active USINGs will be used to locate the variable.

The display of the contents of the variables may be incorrect if the PSW indicates that execution is in the middle of a statement. This is because the variable may be in a transitional state, not having yet achieved its new value. Variable contents are only certain at the start and end of a statement.

Examples

array stuff(15)
array addr(x'20000')->stuff(20)
array addr(12(r2))->ptr->stuff(2)
array ptr->ptr2->stuff
array ptr(3)->ptr->stuff
array array1(10);array2(-5)
array chrarray(15,1:10);chrarray(15,1::10)
array chrarray[15,0:9];chrarray[15,0::10]