APLMGR SCF Reference Manual

PTrace Reference for Tandem FTAM

OSI/FTAM and OSI/APLMGR SCF Reference Manual—421943-001

5-2

TRACE and PTrace

The order in which TRACE commands and PTrace commands are given is important.

You must start and stop a trace before you use PTrace to view the collected trace

records; you must start PTrace before you can issue PTrace commands. The order is as

follows:

1. Start a trace using the SCF TRACE command.

The following example starts a trace of an initiator process named $FTI1 on the

\MARS system, collects all record types, sets a trace record size of 4050, and writes

the collected trace records in the file $DATA.SYS00.TRACE01 on the same system:

TRACE PROCESS \MARS.$FTI1 &

, SELECT ALL &

, RECSIZE 4050 &

, TO \MARS.$DATA.SYS00.TRACE01

2. While the trace is running, perform the FTAM activity you wish to be recorded by

the TRACE facility.

3. Stop a trace using the SCF TRACE command.

The following example stops the trace started in Step 1:

TRACE PROCESS \MARS.$FTI1, STOP

4. Start the PTrace utility using the SCF RUN command. The following is an example

of an explicit RUN command and the display header that is returned:

RUN \DIAG.$SYSTEM.SYS00.PTRACE

PTrace - Trace Formatter - T9385D20 - (01JUN93) - (05APR93)

You can also use an implicit RUN command to start PTrace, as follows:

PTRACE

5. Display selected trace records, using PTrace commands.

The following example displays the PROV and USER trace records from the trace

file specified in the earlier TRACE command:

FROM \DIAG.$DATA.SYS00.TRACE01;SELECT(PROV,USER)

When using SCF TRACE and PTrace to create a complete trace file that might be sent to

Tandem for analysis, issue the SCF TRACE command using the SELECT ALL option

to ensure that all relevant information is captured. Then, when analyzing the trace file

using PTrace, select only among the PROV, ASN1, and USER options. (The PROV,

ASN1, and USER options have the most relevance for users; the others are primarily for

use by your service provider.)