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:
- 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.
- 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.