OSI/FTAM and OSI/APLMGR SCF Reference Manual

PTrace Reference for Tandem FTAM
OSI/FTAM and OSI/APLMGR SCF Reference Manual—421943-001
5-5
Trace Record Size
In addition, the USER records generated by initiator processes provide information on
requests from the application program, which you can use to follow the flow and
sequence of these requests. However, because the data displayed in this record is
presented in an internal format (not fully described in this manual), you might prefer to
deal primarily with the PROV and ASN1 records, which display PDU data in ASN1
encoded format following the ASN1 PDU definitions described in ISO 8571-4.
The SM, DSM, MEM, MSG, and SYSMSG trace records provide information that is
primarily for use by your service provider in troubleshooting the Tandem FTAM
software. As a result, these records will generally be of little interest to the typical user
of the FTAM software. If you do examine these records and note error conditions, bring
this information to the attention of your service provider, who can determine any further
actions that might be necessary.
With the PROV, ASN1, and USER options, PTrace provides some FILTER options,
which can be used to filter out unnecessary trace records and concentrate only on
specific types of activities. For example, it might be useful in some situations to
examine only CONNECT PROV records, or perhaps look at only PROV or USER trace
records for a specific subdevice.
Trace Record Size
The maximum size of trace records in the trace file is determined by the RECSIZE
option of the SCF TRACE command. If RECSIZE is not set large enough, the trace
records displayed by PTrace are truncated and you may need to repeat the trace run.
If RECSIZE is too small to accommodate the trace record, PTrace displays the following
message below the trace record:
**NOTE:** Header unavailable for display. RECSIZE must be
enlarged to view record.
If RECSIZE is too small to accommodate a PTrace display when the DETAIL option is
on, the following message appears below the trace-record header:
**NOTE:** Data is truncated. RECSIZE must be enlarged to view
record.
In either case, start the trace again, resetting the record size up to 2000 (or higher, if
needed in your environment) using the RECSIZE option of the SCF TRACE command.
The following command sets the record size to 4050 bytes, selects all records to log in
the trace file, and writes the captured trace records into the file named
$DATA.SYS00.TRACE01 on the same system:
TRACE PROCESS \MARS.$process-name &
, SELECT ALL, RECSIZE 4050 &
, TO \MARS.$DATA.SYS00.TRACE01