Troubleshoot problems that you might encounter with the
dynamic cache service.
About this task
Complete the following steps to resolve problems that you
think are related to the dynamic cache service.
Note: This topic references one or more of the application server log files. As a
recommended alternative, you can configure the server to use the High Performance Extensible Logging
(HPEL) log and trace infrastructure instead of using SystemOut.log ,
SystemErr.log, trace.log, and
activity.log files on distributed and IBM®
i systems. You can also use HPEL in conjunction with your native z/OS® logging facilities. If you are using HPEL, you can access all of your log and trace
information using the LogViewer command-line tool from your server profile bin directory. See the
information about using HPEL to troubleshoot applications for more information on using HPEL.
- Review the logs. Messages that are prefaced
with DYNA result from dynamic cache service operations.
For distributed platforms, review the JVM logs for
your application server.
On the z/OS platform,
check the job logs for the controller and servant.
On distributed platforms, view the
JVM logs for your application server. Each server has its own JVM
log file. For example, if your server is named Member_1,
the JVM log is located in the subdirectory install_root/logs/Member_1. To use the administration console to review the JVM logs, click Troubleshooting
> Logs and trace > server_name > JVM logs > Runtime
> View.
- Find any messages prefaced with DYNA in
the log you are viewing, and write down the message IDs. A sample
message having the message ID DYNA0030E follows:
DYNA0030E: "property" element is missing required attribute "name".
- Find the message for each message ID in the information
center for WebSphere® Application Server. In the information
center navigation tree, click product_name >
Reference > Troubleshooter > Messages > DYNA to view dynamic
cache service messages.
- Read the message Explanation and User Action statements.
A search for the message ID DYNA0030E displays a
page having the following message:
DYNA0030E: "property" element is missing required attribute "name".
Explanation: A required attribute was missing in the cache configuration.
User Action: Add the required attribute to your cache configuration file.
This
explanation and user action suggests that you can fix the problem
by adding or correcting a required attribute in the cache configuration
file.
- Try the solutions stated under User Action in the DYNA messages.
- Use the cache monitor to determine whether
the dynamic cache service is functioning as expected. The cache monitor
is an installable web application that displays simple cache statistics,
cache entries, and cache policy information.
- If you have completed the preceding steps and still cannot
resolve the problem, contact your IBM software
support representative.
On distributed
platforms, you can use the collector tool (collector.bat or collector.sh
located in the bin directory) to gather trace information and other
configuration information for the support team to diagnose the problem.
The collector tool gathers dynamic cache service files and packages
them into a JAR file. The IBM representative can specify when
and where to send the JAR file.
The IBM representative
might ask you to complete a diagnostic trace. To enable tracing in
the administrative console, click Troubleshooting > Logs
and trace > server_name > Diagnostic trace and
specify Enable trace with the following specification.
The IBM representative can tell you what trace specification
to enter. Note that dynamic cache trace files can become large in
a short period of time; you can limit the size of the trace file by
starting the trace, immediately re-creating the problem, and immediately
stopping the trace.
For current information available from IBM Support
on known problems and their resolution, see the IBM Support
page.
For technical support on dynamic cache service, see the IBM Support
page.