LOCATE—Locate a Line

The LOCATE primary command allows you to scroll up or down to a specified line. The line then appears as the first line on the panel. There are two forms of LOCATE: specific and generic.

Syntax


Specific LOCATE syntax

>>-LOCATE--+-label---+-----------------------------------------><
           '-linenum-'

The specific form of the LOCATE command positions a particular line at the top of the panel. You must specify either a line number or a label.

label: A previously assigned label.
linenum: An edit line number. If that line number exists, it appears at the top. If the line number does not exist, the line with the next lower number appears at the top of the data area.
The linenum operand is a numeric value of up to 8 digits. You do not need to type leading zeros. If the operand contains 6 or fewer digits, it refers to the number in the line command field to the left of each line. If linenum contains 7 or 8 digits, it refers to the sequence numbers in the data records. For NUMBER ON STD, the editor refers to the modification flag. For NUMBER OFF, it refers to the ordinal line number (first=1, fifth=5, and so on). For NUMBER ON COBOL, it refers to the number in the line command field, which is the data sequence number. See Sequence number format and modification level for more information.


Generic LOCATE syntax

           .-NEXT--.                .-.ZFIRST--.ZLAST-.   
>>-LOCATE--+-------+--+-CHANGE---+--+-----------------+--------><
           +-FIRST-+  +-COMMAND--+  '-labela--labelb--'   
           +-LAST--+  +-ERROR----+                        
           '-PREV--'  +-EXCLUDED-+                        
                      +-LABEL----+                        
                      +-SPECIAL--+                        
                      +-INFOLINE-+                        
                      +-MSGLINE--+                        
                      '-NOTELINE-'

The generic LOCATE command positions the panel to the first, last, next, or previous occurrence of a particular kind of line.

FIRST

Searches from the first line, proceeding forward.

LAST

Searches from the last line, proceeding backward.

NEXT

Searches from the first line of the page displayed, proceeding forward.

PREV

Searches from the first line of the page displayed, proceeding backward.

CHANGE

Searches for a line with a change flag (==CHG>).

COMMAND

Searches for a line with a pending line command.

ERROR

Searches for a line with an error flag (==ERR>).

EXCLUDED

Searches for an excluded line.

LABEL

Searches for a line with a label.

SPECIAL

Searches for a special non-data (temporary) line:

Bounds line flagged as =BNDS>
Column identification lines flagged as =COLS>
Information lines flagged as ======
Mask lines flagged as =MASK>
Message lines flagged as ==MSG>
Note lines flagged as =NOTE=
Profile lines flagged as =PROF>
Tabs line flagged as =TABS>

INFOLINE

Searches for information lines flagged with ======

MSGLINE

Searches for message lines flagged with ==MSG>

NOTELINE

Searches for note lines flagged with =NOTE=

labela, labelb

Labels identifying the start and end of the group of lines to be searched.

For more information about using labels to identify a group of lines, see Labels and line ranges.

Examples

To find the next special line, type:

LOCATE SPE

To find the first error line (==ERR>), type:

LOCATE ERR FIRST

To find the next line with a label, type:

LOC NEXT LABEL

To find the next excluded line between .START and .END, type:

LOC X .START .END

To find the first excluded line between .E and .S, type:

L FIRST .E .S X

To find the first message line, type:

LOCATE FIRST MSGLINE