Troubleshooting the dynamic cache service

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.

Procedure

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.
1. 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.
2. 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".
```
3. Find the message for each message ID in the documentation for WebSphere® Application Server. In the documentation navigation tree, click product_name > Reference > Troubleshooter > Messages > DYNA to view dynamic cache service messages.
4. 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.
5. 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.