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]