STRUCTURE

Displays the contents of the components of one or more structures.


>>-STRucture--+--------+--+-------------------+----------------><
              '-window-'  | .-;-------------. |   
                          | V               | |   
                          '---variable-name-+-'

window

An LSM Information window. Select by a Window Specification, or by placing the cursor in the window. If omitted and the cursor is not in a LSM Information window, uses or opens the first LSM Information window.

variable-name

The variable name. Each variable is:

The major component of a structure, in which case variables within the entire structure are visible.
A component (member) at an intermediate level within a structure, in which case only variables within that portion of the of the structure are visible.

Use dot-qualification to uniquely identify structure components with ambiguous names.

Simple structure components are defined by name only. You can define components within a based structure 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 used as STRUCTURE variable name arguments.

Display is not supported for:

embedded arrays within structures
arrays of structures

The STRUCTURE display is in the form of a list of the component variables of the structure, in order of definition.

The STRUCTURE display persists until:

A STRUCTURE command without arguments is issued
A UNION command without arguments is issued
The window is closed using a CLOSE command.
Another IDF Language command such as VARIABLE, ARRAY, CALLERS, PLOCATES, LANGUAGE STATUS, or MAP is issued. These commands update the LSM Information window with new information
The target program completes execution
Target program execution progresses beyond the structure's defined scope

If the contents of a variable within the structure 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 structure was respecified, the current basing specification is used.

Note: The display of the contents of the variables within a structure 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

Str struct1
Str addr(x'20000')->struct1
Str addr(12(R2))->ptr->struct1
Str ptr->ptr2->struct3
Str ptr(3)->ptr->struct1
Str struct1;struct2
Str struct1 ;ptr->struct1
Str struct1 ; struct4