1
n
ALL

Specifies the maximum number of lines to find. The default is 1. Specifying 1 positions the first line at the top of the region with subsequent lines filling the region. Specify ALL to locate all lines. If you specify ALL or any value greater than 1, only the lines containing the string display. Use scrolling commands or function keys to view all occurrences if the display exceeds the size of the region.

INCLUDE

Default. Searches for lines that contain the specified string.

EXCLUDE

Searches for lines that do not contain the specified string.

FORWARD

Default. Searches beginning with the first line and processing through subsequent lines.

BACKWARD

Searches beginning with the last line and processing backward.

/

Character that delimits the search string. You must use the same character consistently in a command. You can use any special character except the currently defined command delimiter (installed default is a semicolon (;)) or comment character (installed default is a colon (:)), an asterisk (*), an at sign (@), a pound sign (#), or a dollar sign ($).

string

A character or string of characters used in the search. If you use the INCLUDE option, FIND searches for lines that contain this string. If you use the EXCLUDE operand, the command locates lines that do not contain this string. If you do not specify a string, the string specified on the previous FIND, INCLUDE, EXCLUDE, FIRST, NEXT, LAST, or PREVIOUS command is used as a default value.

The string cannot include the string delimiter character or the current command delimiter.

ERROR

(Procedure definition only.) Finds a line that the compiler marked as an error (using the MEL=YES operand of the COMPILE command and SET EDIT HIGHLIGHT ERRORS). You cannot specify column ranges.

start‑line

Line where the search for string‑a begins. You can specify it as:

num Sequence number of the start line. When you specify a single line with a sequence number, the keyword LINE is required.

TOP Indicates the first line of the member. If you do not specify a start line, TOP is the default.

CURSOR Indicates the position where the cursor is located.

offset Position relative to the top line displayed:

* Top line displayed.

*+ n Line n number of lines below the top line displayed.

*- n Line n number of lines before the top line displayed.

end‑line

Line where the search for string‑a ends. You can specify it as:

BOTTOM Default. Last line of the member.

num Sequence number.

CURSOR Indicates the position where the cursor is located.

offset Position relative to the top line displayed:

* Top line displayed.

*+ n Line n number of lines below the top line displayed.

*- n Line n number of lines before the top line displayed.

start‑column

Column where the search begins.

end‑column

Column where the search ends.

MAX

Default. Farthest right‑hand column.