SNAX/APC Configuration and Management Manual

SNAX/APC Configuration and Management Manual—138787

5-1

Trace Analysis Program

When attempting to solve problems in SNAX/APC communications, it is useful to be

able to examine the information transmitted between TPs and SNAX/APC, and the

information transmitted between SNAX/APC and SNAX/XF, SNAX/APN, or

SNAX/CDF.

The SNAX/APC Trace Analysis Program (APCTAP) is an interactive utility that allows

you to examine information passed among the SNAX/APC components after this

information has been captured in a trace file. APCTAP allows you to select a range of

entries, record types, and so on, to restrict the focus of your investigations.

APCTAP does not support D-series or G-series software high PINs. It must run at low

PINs. Refer to Section 1, Introduction

, for more information.

Starting and Stopping the Trace Facility

You can use the TRACE command with SCF to start and stop tracing dynamically.

However, you can also use the SNAX/APC configuration parameters TRACE,

TRACEPAGES, and TRACEOPTION to make tracing constantly active. Constant

tracing is particularly useful when debugging new applications and when initially

installing SNAX/APC.

Running APCTAP

After you have collected trace records, you need to evaluate the data with APCTAP. You

start APCTAP by executing the following commands:

1> ASSIGN BINDERFILE, $volume.subvol.APCLMAP

2> RUN $volume.subvol.APCTAP /IN trace-file/

The APCLMAP file is a load map that is included in the SNAX/APC distribution

subvolume. APCTAP uses the information in the APCLMAP file to format selected

records.

In the ASSIGN command, volume and subvol are the disk volume and subvolume

that contain the APCLMAP file. If you omit the ASSIGN command, you can use the

LOAD command.

In the RUN command, volume and subvol are the disk volume and subvolume that

contain the APCTAP program file, and trace-file is the file that contains the trace

data. If you omit trace-file, you can use the FROM command to read in the trace

data.

Note. The APCLMAP file is version-dependent; the APCLMAP file must match the version of

SNAX/APC that generated the trace file.