PTrace Reference Manual

PTrace Commands
PTrace Reference Manual526393-001
3-10
FIND Command
filter-option
is a subsystem-specific option that selects records for display.
Consideration: FILTER Command
Be sure to select a trace file with the FROM command before setting filter options.
FIND Command
The FIND command searches formatted trace records for a specified string of
characters. When the string is found, the entire record is displayed. Optionally, you can
include a range of record numbers within which the search occurs.
You can continue searching the file for additional occurrences of the string by entering
FIND with no parameters.
BOTH
specifies that the search is to be case-insensitive (the search is for both uppercase
or lowercase characters matching the specified search-string). If BOTH is
omitted, the search is case-sensitive.
ALL
specifies that all records containing the search-string in the specified (or
implied) range will be displayed (provided that all other display criteria is met). If
ALL is omitted, the search is for only the first occurrence of the search-string.
search-string
is any string of one or more alphanumeric characters representing the text to be
found.
range-spec
defines a range of record numbers by which the search is restricted. If range-
spec is omitted, all records from the beginning to the end of the file are searched.
The syntax of range-spec is:
[ ( ] [ integer ]
[ begin-integer , end-integer ]
[ begin-integer / end-integer ] [ ) ]
integer
is an integer that defines the beginning record number for the search. The end-
of-file is assumed as the ending record number.
F[IND] [ [ B[OTH] ] [ A[LL] ] "search-string" [ range-spec ]]