Gathering diagnostic information

Gather diagnostic information to help you troubleshoot problems with dynamic scripting applications. Many sources of CICS® diagnostic information contain information that applies to dynamic scripting applications.

About this task

CICS provides a standard set of diagnostic information that you can check when an application does not behave as expected. Informational and error messages are written to the appropriate log file. The JVM server standard out, standard error, and trace files, are stored in the working directory. The default file names are in the format applid.JVMSERVER.DyyyyMMdd.THHmmss.dfhjvmout, applid.JVMSERVER.DyyyyMMdd.THHmmss.dfhjvmerr, and applid.JVMSERVER.DyyyyMMdd.THHmmss.dfhjvmtrc. The behavior is the same as described in Activating and managing tracing for JVM servers. You can change the name and location in the JVM profile. These files are in EBCDIC format. You can also check the CICS logs, including JESMSGLG and MSGUSR, for messages that are issued by CICS. Dynamic Scripting feature pack error messages are written to the dfhjvmerr log file.

Procedure

To gather extra diagnostic information for your application, perform the following steps:

  1. Run CICS transaction CETR to activate tracing and logging information by setting AP and SJ component level to ALL.
    • Select the SJ component to trace the actions that CICS takes to start and stop the JVM server. The JVM logs diagnostic information in the zFS file.
    • Select the AP component to trace the installation of OSGi bundles.
  2. Rerun your application. Logging and trace information is written dependent on the trace level settings.
    Note: Setting these trace levels can produce a large amount of output in the trace files. If you want to use this trace level, you must ensure that there is enough space in zFS for the files.

What to do next

If you cannot fix the cause of the problem, contact IBM® support. Make sure that you provide the required information, as listed in the MustGather for reporting CICS TS Feature Pack for Dynamic Scripting V2.0 application problems.


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