PTrace Reference Manual

PTrace Commands
PTrace Reference Manual—526393-001
3-11
FIND Command
begin-integer
is an integer that defines the beginning record number for the search. This
value is followed by either a comma or a slash and an end-integer.
end-integer
is an integer that defines the ending record number for the search. If the value
of end-integer is greater than the total record count of the trace file, End of
Trace file is displayed.
Considerations: FIND Command
•
No records are displayed until search-string is found.
•
If range-spec is specified, the search is restricted to record numbers within the
range.
•
A FIND command that includes search-string initiates a new search operation
beginning with the first data record in the file, unless range-spec is specified.
•
A FIND command that does not include search-string continues the previously
initiated search operation beginning with the record immediately following the
record in which search-string was most recently found.
•
The FIND command searches through only those records that meet the selection
criteria set by the SELECT and FILTER commands.
•
You can stop execution of the FIND command using the BREAK key.
•
You can use the FIND command to display frames (records) missed during a trace
session. Frames are missed when the trace collector cannot keep up with the
subsystem process trace. Whenever a frame is missed, the record following that
frame is displayed.