Troubleshoot problems that you might encounter with the
dynamic cache service.
About this task
Complete the steps below 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.