PTrace Reference Manual

Introduction to PTrace and Trace Files
PTrace Reference Manual526393-001
1-4
Trace File Header Record
data record is record 1. The newest record in the file is record number n-1, where n is
the number of records in the trace file.
Trace File Header Record
When you enter the PTrace FROM command, formatted data from the trace file header
record appears.
Example 1-1 shows the trace file header record from a trace file named
$ACCT.PAY.TAM; the header record includes at least the following information:
System and device traced.
Device type and subtype—When a trace file is created, the type and subtype of the
device being traced are recorded in the file. When PTrace opens the trace file, it
uses this information to determine which subsystem generated the trace records.
Name of the trace file.
Time the trace was started.
Timestamps of the first and last data records.
Trace entry size limit—This indicates the maximum length of records in the file.
This value is the RECSIZE specified in the TRACE command used to create the
file.
When a trace file becomes full, records are wrapped around and overwritten beginning
at record number 1. This means that the oldest data is overwritten first. If trace data
has wrapped around in a disk file, PTrace issues a message. PTrace also issues a
message if the data is in extended format or if there are no data records.
Trace Data Record
PTrace displays the formatted header data at the beginning of each trace data record.
Trace data appears below the header information if appropriate formatting options are
selected.
The header line contains the following information (as shown in Example 1-2):
Date at which the trace was captured
This date appears, in the form mm/dd/yy, in columns 1 through 8 of the display.
Example 1-1. Trace File Header Record
Trace of: \LAACCT.$TR3271, Type (60,11).
Ptrace Data File: $ACCT.PAY.TAM
Trace started: 03/20/95 16:55:28.567324
First trace entry: 03/20/95 16:55:28.569957
Last trace entry: 03/20/95 16:57:33.983325
Trace entry size limit: 120
1