OSI/FTAM Configuration and Management Manual

FTAM Troubleshooting
OSI/FTAM Configuration and Management Manual—421944-001
6-9
Subsystem Control Facility (SCF) TRACE Command
and PTrace Utility
Trace data can help you understand what is happening as the APLMGR, FTAM, TAPS,
TSP, and NSP processes attempt to perform the work of an application. Close
examination of process activity can help you determine the source of a problem so that
you can correct it. Section 2, FTAM Management Environment
, presents an overview of
the information available in trace records from APLMGR and FTAM and the PTrace
options that help you view this information.
Set the SELECT option to ALL when starting traces with the TRACE command, then
use the SELECT command in PTrace to choose which types of trace records you want to
see. Later, if you need to provide trace data to the Global Customer Support Center
(GNSC) or to your local service provider, you will need to include all the trace records.
Set the RECSIZE option in the SCF TRACE command to 4050, which is the maximum
value; occasionally records are large, especially in traces of TAPS processes. Note that
FTAM data records may be truncated if they exceed the 4050 value.
In Tandem FTAM troubleshooting, the following types of FTAM trace records are
generally most useful:
•
PROV records show messages sent between an FTAM initiator or responder process
and the underlying TAPS process.
•
ASN1 records show input and output from ASN.1 encoding and decoding done on
behalf of an initiator or responder.
•
USER records show messages sent between the FTAM API and the Tandem
initiator.
For general information concerning the PTrace utility, see the PTrace Reference Manual.
For PTrace information specific to the FTAM and APLMGR subsystems, including
descriptions of the FTAM and APLMGR trace record displays, see the OSI/FTAM and
OSI/APLMGR SCF Reference Manual. For PTrace information for processes in
underlying subsystems (OSI/AS for TAPS processes, OSI/TS for TSP processes, and
X25AM, TLAM, PAM, or TCP/IP for NSP processes), see the manuals listed in Related
Manuals on page xx. See the OSI/AS Configuration and Management Manual for
additional guidance on troubleshooting problems in underlying subsystems.