VARIABLE

Displays the contents of one or more variables.


>>-VARiable--+--------+--+-------------------+-----------------><
             '-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

A variable name.

Define simple variables 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 used for VARIABLE variable name arguments.

If you supply no variable name, the nominated window is closed.

The variable display persists until:

A VARIABLE command without arguments is issued
The window is closed with a CLOSE command.
Another IDF Language command such as STRUCTURE, ARRAY, TYPE, 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 variable's defined scope

If the contents of the variable 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' are displayed as a period character.

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

If a based variable was respecified, the current basing specification is used.

Note: 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

var stuff
var addr(x'20000')->stuff
var addr(12(R2))->ptr->stuff(2)
var ptr->ptr2->stuff
var ptr(3)->ptr->stuff
var stuff(-5)
var stuff(1:10)
var stuff(1::25)
var var1;var2
var var1 ;ptr->stuff
var stuff(1:10) ; stuff(30:40)
var chrarray(15,1:10);chrarray(15,1::10)
var chrarray[15,0:9];chrarray[15,0::10]