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

For further details on tracing J2EE resources in CICS, refer to Chapter 4 in
WebSphere Application Server V4.0.1 for z/OS and OS/390, Messages and
Diagnosis, GA22-7837.
Java client trace
CICS TG Java client tracing can be set programmatically within the servlet by
adding the following statements to the Java application:
com.ibm.ctg.client.T.setDebugOn(true);
com.ibm.ctg.client.T.setTimingOn(true);
In our CTGTesterECI Web application the Trace option on the index.jsp welcome
page controls this tracing. Output from this trace will go to the SYSPRINT log of
the J2EE Server, since this is what we set up for the TRACEBUFLOC, as shown
on page 286.
Note: Enabling CICS TG Java client tracing in an application will enable it for
all applications running in the application server, as a consequence of the
static nature of the T class.
CICS TG JNI trace
CICS TG JNI trace is output from the Gateway JNI module (libCTGJNI.so) that
acts as the interface between the Gateway and the underlying native transport
(EXCI). We found it to be a very useful means of problem determination.
It is controlled with the Java system property gateway.T.setJNITFile. The
property value specifies the file name where the JNI trace is output. This must be
set in the JVM properties file for the J2EE Server. To do this, we performed the
following steps:
1. Edited our J2EE Server instance’s jvm.properties file, located in the directory
/WebSphereC1/CB390/controlinfo/envfile/WTSCPLX1/C1OASR2A.
2. Added the following Java property:
gateway.T.setJNITFile=/tmp/wasctgjni.trc
3. Restarted our J2EE Server instance using the Operations application.
You can see the output in our JNI trace file (/tmp/wasctgjni.trc) for a simple
request to our CTGTesterCCI Web application in Example 10-9.
Example 10-9 CICS TG JNI trace output from WebSphere
CICS Transaction Gateway JNI Trace file for z/OS Version 5.0, Build Level
c000-20020621
20:13:59.451 [020e008c,10e616a0,WS007208 ] : CCL6813I CcicsInit: Running
under Websphere z/OS.
Chapter 10. CICS TG and WebSphere Application Server for z/OS 285