Locate command

Operands

loc_string

The leading characters of the field to be located. If the leading characters do not occur in the list, DSC positions the closest member at the top of the panel.

field_name

The name of a member selection list column heading. If omitted, the string is matched against the main sort field. (If you have not explicitly sorted the MSL, this is the member name field.)

text

The string to be found within a member. The search starts with the member that is currently at the top of the panel. If the string is not found, then the bottommost member is displayed at the top of the panel.

number

The row number to be displayed at the top of the panel (@ or #), or the number of rows to be skipped down (+) or up (-).

Usage notes

Locate is a main command only. It cannot be used as a line command.

A search is performed from the second member displayed on the screen to locate the first member in the displayed list for which the leading characters of the field specified (or implied) exactly match the string specified. If not found, the search starts again from the beginning of the list (that is, it wraps around). If not found again, the member closest to the locate string is selected.

The listing is positioned so that the member selected is the first member on the panel.

If the automatic preview option is on, Locate displays a preview window of the located member. To control this option, use the SET command.

Examples

LOCATE ACCTM
L ROGER USERID
L 87/02 CHANGED
L 10 @
L 2 +
L 'JCL'