Spooler Plus Utilities Reference Manual

Spoolcom
Spooler Plus Utilities Reference Manual—522294-002
3-44
FIND Command
string
is a set of printable ASCII characters set off by two identical separators. You can
use quotation marks ("), apostrophes ('), or slashes(/) as separators, but actually
any ASCII character can act as the boundary for string.
Spoolcom scans the current job, starting at the beginning of the file, for an
occurrence of the specified string.
If no string is specified, then Spoolcom scans the current job for the last string
given, starting from where the last occurrence of the string was found.
start-position
is the page number from which to begin the search. The start-position
parameter can be specified as:
[ F | L | * | number ] [ offset ]
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 ]
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 match 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 this 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, Spoolcom scans the first job that is part of the current
batch job.