This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Working with Trace Operation in AS400

The trace operation can be used to enable/disable the trace logs that are generated by JTOpen library. The Trace feature of JTOpen library provides several levels of logging and each of these logging levels can be enabled/disabled using this operation. The operation also allows enabling/disabling all log levels at once. This operation is meant for development and debugging purposes only. All log levels are disabled by default.

The generated logs will be available in the <ESB_HOME>/repository/logs/pcml-connector-logs.log  file. The location of the log files can be changed only during startup by setting the  com.ibm.as400.access.Trace.file  system property.


Trace Operation
<pcml.trace>
	<conversion>true</conversion>
	<datastream>true</datastream>
	<diagnostics>false</diagnostics>
	<error>true</error>
	<information>true</information>
	<pcml>true</pcml>
	<warning>true</warning>
	<proxy>false</proxy>
</pcml.trace>
Properties

The following trace levels can be configured using this operation:

  • all: Whether all trace logs needs to be enabled/disabled.
  • conversion: Whether conversion trace logs needs to be enabled/disabled.
  • datastream: Whether datastream logs needs to be enabled/disabled.
  • diagnostics: Whether diagnostic trace logs needs to be enabled/disabled.
  • error: Whether error trace logs needs to be enabled/disabled.
  • information: Whether information logs needs to be enabled/disabled.
  • pcml: Whether PCML trace logs needs to be enabled/disabled.
  • warning: Whether warning trace logs needs to be enabled/disabled.
  • proxy: Whether proxy logs needs to be enabled/disabled.

Important!

Enabling and disabling the log levels will effect all AS400 PCML connector based operations within the ESB instance. If there are two proxy services within ESB that use the connector, and trace logs for a specific level are enabled for one of them, the same level of logs will be enabled for the other proxy service as well.

Trace Operation is not recommended for Production Environments

Enabling trace logs is not recommended for production environments as using the trace operation will generate logs in the log file but this file does not get cleared.