Spooler Plus Utilities Reference Manual

Peruse
Spooler Plus Utilities Reference Manual—522294-002
2-18
FIND Command
start-position
is the page number from which to begin the search. start-position can be
specified as
[ F | L | * | number ] [ offset ]
If an offset is specified, it is added to or subtracted from the base (F, L, or *) to
define the page.
Considerations
•
The NUMCOL and STARTCOL commands affect the line displayed by FIND.
FIND will find string even if string is located in an area excluded by a
NUMCOL or STARTCOL command, but FIND displays only that area permitted by
NUMCOL and STARTCOL.
•
If no line is displayed after a FIND command is executed, then there are no
occurrences of string in the remainder of the job.
•
FIND without the BOTH parameter distinguishes between uppercase and
lowercase letters, so that searching for BOY, for example, does not find boy. If you
want to search for a string that may be in either uppercase or lowercase letters,
use the BOTH parameter.
•
You cannot use the FIND command to locate TFORM commands embedded in
your EDIT file. FIND locates only character strings that appear in the formatted
copy.
•
If a batch job is current, Peruse scans the first job that is part of the current batch
job.
Examples
1. This example shows you how to find errors in your TAL compilation. Once you key
in the beginning sequence of the error message, you can reexecute the FIND
command without repeating the string, and the command continues to show you
the next occurrence of that string:
_FIND /**** ERROR/
**** ERROR 49 **** Undeclared Identifier
_F
F is the first page of the job.
L is the last page of the job.
* is the current page of the job.
number is a page number.
offset is specified as [ + number | - number ]