Activating trace

The CICS® TS Feature Pack for Dynamic Scripting V2.0 uses the Liberty JVM server trace mechanism, with extra functions that are specific to the PHP engine.

About this task

You can active PHP native tracing, to assist in troubleshooting your PHP application.

Procedure

Use the CETR transaction to activate trace for the JVM server, and set the trace levels as follows:
  • Select the SJ component and set trace level 4.
  • Select the AP component and set trace level 2.
The trace is redirected to the file with the name format workdir/$APPLID/$JVMSERVER/&CONTEXT_ROOT.DyyyyMMdd.THHmmss.xapictrace.

The &CONTEXT_ROOT is the context root of the web application bundle (WAB) with the forward slash character (/) replaced by period character (.), because a file name is not allowed to contain a forward slash character. Before the file is created, the trace checks whether a file with the same name exists. If the file exists, trace adds a random number to the end of the file name.

Note:
  • If the AP level is not 2 and the SJ level is not 4, the PHP native trace is disabled.
  • SJ level 4 tracing produces verbose logging information in the JVM and XAPIC trace files and should only be used when directed to do so by CICS service. If you want to use this trace level, you must ensure that there is enough space in zFS for the files.


activating_tracing.html | Timestamp icon Last updated: Sunday, 4 June 2017