Editing Data Sets › Edit Commands › Primary Commands › LOCATE

LOCATE

Jumps directly to a record.

Syntax:

   LOCATE     lnum | label  | key-value KEY | kwd
              [FIRST|LAST|NEXT|PREV|KEY]

Syntax Description:

lnum

Displays the numeric line number.

label

Displays a previously defined label.

key value

Displays a full or partial VSAM key field value. Hex values (X'value') and UTF-16 character values (UC'value') are also supported.

KEY

Jumps to the record with a key value GTEQ the key_value. The KEY parameter is only valid for keyed files.

kwd

Specify one of the following commands:

CHANGE

Jumps to record with line CHANGE attribute

COMMAND

Jumps to record with line COMMAND attribute

ERROR

Jumps to record with ERROR attribute

FIRST

Jumps to the first record with the requested attribute with kwd.

LAST

Jumps to the last record with requested attribute with kwd.

NEXT

Jumps to the next record with the requested attribute with kwd.

PREV

Jumps to the previous record with the requested attribute with kwd.

Alias: L, LOC