PLOCATES

Displays the variables that may be located with a given locator (pointer) variable.


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

The PLOCATES command determines the variables which may be located with a given locator (pointer) variable, and displays an entry for each in the LSM Information window.

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.

Only the variable name is relevant in determining the located variables. Extra information such as:

Locating expressions for based variables
array index values
substring ranges

is not needed, and should not be specified.

The Pointer Locates information display persists until:

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

Examples

ploc base@
ploc DSA_ptr
plocates ptr1;ptr2