Requesting a dump for a JVM

For non-Liberty JVMs, SVC dumps contain the ASID of the OpsMJE PAS and the ASID of the JVM on which you requested a dump. A message about the requested dump is displayed in the PAS log.

For IMS JVMs, the dump is generated when the JVM shuts down or the IMS receives signals.

Default directories

The default directory for Java core and heap dumps for IBM JVMs is your home directory. For more information about changing the location of these dumps, search for the following topics in the IBM documentation: 

• For CICS JVMs: "Controlling the location for JVM output, logs, dumps and trace"
• For WebSphere Application Server (WAS) JVMs: "WebSphere Application Server Dump Locations and Setup" 

The default directory for Java core and heap dumps for OpsMJE JVMs (MJEJVM and MJEJVMCH) is PAS user's HOME directory.

• The HOMEdirectory parameter determines the location where the OpsMJE Java component (MJEJVM) produces Java core and heap dumps. To redirect the dump location, change the HOMEdirectory path or add the following option to the RunMjeJvm.sh script:-Xdump:directory=<redirect location path> \The -Xdump option is an IBM JVM parameter. For more information about -Xdump, see the IBM documentation.

To request a dump

1. On JVMDISC, type DMP in the CMD column for a JVM.

2. In the Dump Java Virtual Machine dialog, type S next to one or more dump types: 

   • SVC Dump
   • Java Core Dump
   • Java Heap Dump (Liberty JVMs only)
   • Server Dump (Liberty JVMs only)

   +------------------------- Dump Java Virtual Machine -------------------------+
   | COMMAND ===>                                              SCROLL ===> CSR   |
   |                                                                             |
   | JVM's information:                                                          |
   | Job Name BAQSTSMN                                                           |
   | JVM Type Zconnect                                                           |
   | PID      50921755                                                           |
   | ASID     00C5                                                               |
   |                                                                             |
   | Dump options:                                                               |
   | Use 'S' to select.                                                          |
   | _ SVC Dump                                                                  |
   | _ Java Core Dump                                                            |
   | _ Java Heap Dump                                                            |
   | _ Server Dump    (Core/Heap dumps are included in the dump package)         |
   |                                                                             |
   | Time out interval: 10 (In seconds. Default is 10 sec [Integer])             |
   |                                                                             |
   | EXEC to request DUMP                                                        |
   | CANcel to exit without requesting a DUMP                                    |
   | HELP to display help                                                        |
   |                                                                             |
   +-----------------------------------------------------------------------------+

3. (Liberty JVMs only) In the Time out interval field, specify the number of seconds that you want to wait for a response. If you specified a server dump, consider leaving this value as 10 seconds (the default).

4. On the command line, type EXEC.

   Warning

   Important

   If OpsMJE detects that a Liberty JVM has an identical job name and job identifier, a warning message is displayed.

   If you have only one Liberty JVM with an identical job name and job identifier, OpsMJE requests a dump for that JVM. However, if you have multiple Liberty JVMs with an identical job name and job identifier, OpsMJE requests a dump for all instances of the JVM.

   You can check whether multiple JVMs are running with the same job name and job identifier by comparing the values in the Job Name and Step Name fields.

   When the dump has finished, OK is displayed in the CMD column.

5. View the dump's status in the JVM's job log. For Liberty JVMs, the dump's name and location is also displayed.