PLOCATES

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

Read syntax diagramSkip visual syntax diagramPLOcateswindow;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