[ Bottom of Page | Previous Page | Next Page | Table of Contents | Index ]
This panel contains settings for tracing CICS® Transaction Gateway.
Select check boxes to specify the Gateway daemon and Client daemon components to trace when tracing is enabled.
You can also use the -m parameter of the cicscli command to specify trace components (excluding the Gateway daemon). This overrides any settings in the configuration file.
If you enable tracing without specifying the components in either the cicscli command or in ctg.ini, a default set of components is traced:
Selecting any of the check boxes in the Configuration Tool overrides the default set of components.
This is the path name of the trace file where Gateway trace messages are written if tracing is enabled.
If you do not complete this field,
On Windows: the default name is cicstg.trc.
On UNIX: the trace is written to stderr.
When the filename parameter is defined without a directory the log file
is created in the:
On Windows: "IBM\CICS Transaction Gateway" subdirectory, that exists in
the Windows common application data directory.
On UNIX: /opt/IBM/cicstg/bin directory.
On Linux: /opt/ibm/cicstg/bin directory.
UNIX® and Linux®: You can also specify a trace file using the tfile option on the ctgstart command.
The trace file is overwritten (not appended to) each time the CICS Transaction Gateway starts.
This value specifies the size in kilobytes to which the gateway trace file will grow. Once the file reaches this size, subsequent trace entries continue to be written from the beginning of the file.
Enter a value in the range 0 through 1,000,000.If tracing is enabled you can name the trace file to which Client trace messages will be written or use the default name, cicscli.bin
You do not have to enter an extension for the file name, because a file of type .BIN is always generated (or .WRP if the trace file wraps).
When the trace name parameter is defined without a directory the trace
file is created in the:
On Windows: "IBM\CICS Transaction Gateway" subdirectory, that exists in
the Windows common application data directory.
On UNIX and Linux: /var/cicscli directory.
To minimize any performance impact, the trace file is written out
in binary format. To read it, convert the file to ASCII using the cicsftrc
command.
If you use the memory mapped tracing option (cicscli -b), the
size of the trace files is determined by this field, which specifies the
total amount of space in KB reserved for trace data files.
Enter a value in the range 0 through 2,000,000.
Subsequent trace entries will continue to be written from the beginning of the file. Client trace file wrap size (KB) must be greater than 0 if memory mapped tracing is to be used; the default value of 0 disables wrapping. If its value is between 1 and 99, a value of 100 is used instead to guarantee an adequate minimum trace size.On Windows:
Use ctgservice to enable JNI trace for the start up of CICS Transaction Gateway, or by setting environment variables when starting an application in local
mode.
Use one of the following methods to enable JNI trace:
ctgservice -R -A-j-Dgateway.T.set name=JNI TFile=filenameThis setting is defined in the Windows registry and persists, to remove the startup parameters issue the command, ctgservice -R.
ctgadmin -a trace -jnilevel=1 -jnifile=filenameIf a directory is not defined the file is created in the <product_data_path> directory.
java -Dgateway.T.setJNITFile=filename applicationwhere
You cannot enable JNI trace through the Configuration Tool.
On UNIX and Linux:
Enable JNI trace by setting environment variables, or by using a ctgstart override, or when starting an application in local mode.
Use one of the following methods to enable JNI trace:
ctgadmin -a trace -jnilevel=1 -jnifile=filename
ctgstart -j-Dgateway.T.setJNITFile=filenamewhere filename is the name of the file to which trace output is to be sent. If you do not specify a full path to the file, the location is <install_path>/bin.
java -Dgateway.T.setJNITFile=filename applicationwhere
You cannot enable JNI trace through the Configuration Tool.
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]
(C) Copyright IBM Corporation, 1999, 2010. All rights reserved. Legal