Previous Topic: FIRST CommandNext Topic: Components Used with the FIRST Command


Operand Definitions

Operand

Description

1
n
ALL

Specifies the maximum number of occurrences of the string to find. The default is 1. Specifying 1 position the first line containing the string to the top of the region with subsequent lines filling the region. Use ALL to locate all occurrences of the string. 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.

/

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

Character or string of characters to find. If you do not specify a string, the string specified on the previous FIND, INCLUDE, EXCLUDE, FIRST, NEXT, PREVIOUS, or LAST command is used as a default value.

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

ERROR

(Procedure definition only.) Locates 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.

startcolumn

Column where the search for the string begins.

endcolumn

Column where the search for the string ends.

MAX

Default. Farthest right‑hand column.