z/OS ISPF User's Guide Vol II
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


LOCATE—locate lines

z/OS ISPF User's Guide Vol II
SC19-3628-00

Use the LOCATE command to bring a particular line to the top of the display. You can identify the line by either its relative line number or a previously defined label.

During Browse, the current position of the screen window is shown by the line/column numbers in the upper-right corner of the screen. The line number refers to the first line of data following the two header lines, and shows the relative position of that line in the data. The Top of Data message is treated as relative line zero. You must enter either a line number or a label as an operand.

Read syntax diagramSkip visual syntax diagram
>>-LOCATE--+-line-number-+-------------------------------------><
           '-label-------'   

where:
line-number
A numeric value of up to 8 digits that shows the position of the line from the beginning of the data. The line number is displayed in the upper-right corner.
label
Defined by scrolling to the top of the screen the line with which you want to associate the label. You then type the label on the command line in the form:
.ccccccc

For example, to find line 18463, you could enter this command:

LOCATE 18463

ISPF then moves line 18463 to the top of the screen. You can assign a label to it by entering:

.label

The label is a period followed by up to seven characters that can be displayed, except the comma and the space. It is treated as an internal symbol and is equated to the top line on the screen. You are required to specify the period when you define the label. The next time you want to find this line, you can enter:

LOCATE .label

The period is usually optional when you use it as an operand in a LOCATE command. However, if the first character in the label is a number, you must specify the period to distinguish the label from a line number.

The latest assignment of a label overrides any previous assignments. You can assign several labels to the same line. Labels are not retained when you leave the Browse option.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014