How To
Summary
When encountering Certifcate errors using GSKIT with IBM Transformation Extender (ITX) it maybe necessary to enable logging to diagnose the error in further detail.
Objective
To enable GSKIT tracing on both ITX and GSKIT.
Environment
Using GSKIT installed with ITX and encountering a Certifcate error.
Steps
The following details are instructions how to enable the GSKIT Trace. These Trace files are not human readable and are only for use by GSKit support.
This is done by setting environment variables:
GSK_TRACE_FILE
For Windows:
set GSK_TRACE_FILE=filespec
For UNIX:
export GSK_TRACE_FILE=filespec
This environment variable is set to indicate to GSKit that it should start producing trace. filespec is a file specification suitable for the platform. GSKit will fill the file filespec with about 25MB of trace and then create filespec.1 and do the same If the trace continues, filespec is overwritten (ie. trace will cycle through these two files). So at most, there will be two files of 25MB each that make up the trace.
The trace files are binary so if transferred by ftp be sure to use the binary transfer option. The environment variable must in place before starting the program to be traced.
The program to be traced should be terminated as normal as possible. In cases of program crashes, it is helpful to also have the environment variable.
For IBM Transformation Extender GSKIT Trace log (Client) the log is enabled in the dtx.ini file as follows :
[SSL_CLIENT]
secure_mode=0
key_store=wtx_keys.p12
key_stash=wtx_keys.sth
authentication=off
cert_label=
cert_label_global=0
trace_file=wtxsslclient.log
trace_mode=1
protocol_disable=3
secure_mode=0
key_store=wtx_keys.p12
key_stash=wtx_keys.sth
authentication=off
cert_label=
cert_label_global=0
trace_file=wtxsslclient.log
trace_mode=1
protocol_disable=3
[SSL_SERVER]
secure_mode=0
key_store=wtx_keys.p12
key_stash=wtx_keys.sth
authentication=off
trace_file=wtxsslserver.log
trace_mode=1
protocol_disable=3
secure_mode=0
key_store=wtx_keys.p12
key_stash=wtx_keys.sth
authentication=off
trace_file=wtxsslserver.log
trace_mode=1
protocol_disable=3
Document Location
Worldwide
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSVSD8","label":"IBM Transformation Extender"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0.0.0;9.0.0.1;9.0.0.2;9.0.0.3","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]
Was this topic helpful?
Document Information
Modified date:
03 July 2019
UID
ibm10880901