CICS Transaction Gateway V5 The WebSphere ... - IBM Redbooks

3.5.2 Tracing
SNA sense data can be entered in the Sense Data field and a detailed sense
code description displayed by clicking Lookup.
In this section, we provide information on how to use the trace facilities provided
with the Client daemon to debug a simple TCP62 communications problem.
Client daemon
The first place to look for error messages when using the CICS TG on the
Windows system is the log file. This is specified in the Client configuration
parameters in the CICS TG Configuration Tool. We used the default name
CICSCLI.LOG, which can be found in the CICS TG \bin subdirectory.
The first step to useful tracing with the Client daemon is identifying which
components should be traced. A full list is shown in Example 3-16 and can be
viewed using the command CICSCLI /M. If in doubt, you should trace with the
default selected components, since these have been selected to be sufficient to
diagnose most problems. The default components have an X in front of them in
the following example. To turn on all the parameters, you can use the /M=ALL
option.
Example 3-16 CICS TG client trace options
C:\>cicscli /m
CCL8001I CICSCLI - CICS Client Control Program
CCL0002I (C) Copyright IBM Corporation 1994,2001. All rights reserved.
CCL1120I Trace has not been started
CCL1100I The following list shows what components can be traced
CCL1101I An 'X' indicates which components are enabled
CCL1102I CICSCLI Command Process [CLI]
CCL1103I Interprocess Communication [TRN]
CCL1104I X Protocol Drivers (Level 1) [DRV.1]
CCL1105I Protocol Drivers (Level 2) [DRV.2]
CCL1106I X API (Level 1) [API.1]
CCL1107I API (Level 2) [API.2]
CCL1108I X Client Daemon [CCL]
CCL1109I Terminal Emulators [EMU]
CCL1111I C++ Class Libraries [CPP]
CCL1112I Workload Manager [LMG]
CCL1113I CICS Client Service for NT [SER]
Trace is written to a binary file called, by default, CICSCLI.BIN. To read the trace,
you must format the binary file into a text file by using the CICSFTRC /D
command. This will produce a viewable file called CICSCLI.TRC. Both
CICSCLI.BIN and CICSCLI.TRC are found, by default, in the \BIN subdirectory.
Chapter 3. TCP62 connections to CICS 61