Controlling trace

Trace is controlled through commands issued from the administration interface.

Commands are provided for the following tasks:

  • Set the trace level for the Gateway daemon
  • Set the trace file size limit
  • Set the amount of data from the hex dump to trace
  • Set the offset within a hex dump
  • Do a full hex dump
  • Turn JNI trace on or off
  • Query trace settings
Use the MVS MODIFY command /F JOB_NAME,APPL=TRACE, together with appropriate options, to control trace. Some examples of controlling trace follow. See Trace options for an explanation of the options.

Querying trace settings

Query trace settings to see values such as the trace file size limit or the amount of data to trace.

To query trace settings, enter the following command: 
/F JOB_NAME,APPL=TRACE

Setting the Gateway trace

Use this command to set the trace level to full debug.

To set the level to full debug tracing, enter the following command: 
/F JOB_NAME,APPL=TRACE,TLEVEL=4

To set a DUMPOFFSET of 128 and TRUNCATIONSIZE of 512, enter the following command:

/F JOB_NAME,APPL=TRACE,DUMPOFFSET=128,TRUNCATIONSIZE=512

Setting the JNI trace

Use these commands to set the level of the Java Native Interface (JNI) trace, and to disable the trace.

To enable JNI trace, enter the following command: 
/F JOB_NAME,APPL=TRACE,JNILEVEL=1
To disable JNI trace, enter the following command: 
/F JOB_NAME,APPL=TRACE,JNILEVEL=0

Combining options

Use multiple options on a single command to specify the required tracing characteristics.

For example, the following command sets the trace level for the Gateway daemon to 2, specifies a full data dump, and enables JNI trace: 
/F JOB_NAME,APPL=TRACE,TLEVEL=2,JNILEVEL=1,FULLDATADUMP