Troubleshooting data for Dynamic Scripting problems in CICS TS 5.1 or later

CICS® MustGather for Dynamic Scripting problems in CICS TS 5.1 or later

A CICS Dynamic Scripting problem in CICS occurs for many reasons. For information about the most common problems, see Troubleshooting and support for CICS Dynamic Scripting Feature Pack V2.0.

Gather the following diagnostic information before contacting the CICS support team to troubleshoot your Dynamic Scripting problems.

Required data:
  1. Trace and dumps under the JVM server working directory:
    <workdir/javacore* [any java core dumps]
    <workdir/Snap* [any java snap dumps]
    <workdir/p8trace* [any p8 trace files]
  2. If available, the JVM server standard out, standard error, and trace files. These files are created in the JVM server working directory and named in the following way:
    applid.JVMServer.Dyyyymmdd.Thhmmss.dfhjvmout
    applid.JVMServer.Dyyyymmdd.Thhmmss.dfhjvmerr
    applid.JVMServer.Dyyyymmdd.Thhmmss.dfhjvmtrc

    where applid is the application identifier (APPLID) of the CICS region and JVMServer is the name of the JVMSERVER resource.

    Note: The JVM server working directory is defined in the WORK_DIR parameter in the JVM server profile.
  3. If available, the CICS transaction dump and the CICS system dump.
  4. The contents of your Liberty server profile directory. This directory is specified in the WLP_OUTPUT_DIR parameter in the JVM server profile. By default, it is created in the JVM server working directory <workdir/$APPLID/$JVMSERVER/wlp/usr/servers/server_name. Replace the symbols with runtime values.
Optional data:
If IBM® Support requests more detailed logging, consider the following options:
  1. Run CICS transaction CETR to activate tracing and logging information by setting AP and SJ component level to ALL. Rerun your applications. More logging and trace information will be dumped in dfhjvmtrc.
  2. Provide the contents in <workdir>/$APPLID/$JVMSERVER/*.xapictrace [any xapic trace files] if the SJ component level is set to 3 or higher.
  3. Provide the contents of your JVM profile directory. This directory is defined in the JVMPROFILEDIR system initialization parameter in your CICS region.
  4. Provide JESMSGLG and MSGUSR for messages that are issued by CICS.