Generate JVM Dump (GENJVMDMP)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Generate JVM Dump (GENJVMDMP) command will generate Java Virtual Machine (JVM) dumps upon request.
Restrictions:
The issuer of the command must be running under a user profile which is the same as the job user identity of the job being worked with, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority.
The job user identity is the name of the user profile by which a job is known to other jobs. More information about the job user identity is in the Work management topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| JOB | Job name | Qualified job name | Required, Positional 1 |
| Qualifier 1: Job name | Name | ||
| Qualifier 2: User | Name | ||
| Qualifier 3: Number | 000000-999999 | ||
| TYPE | Type | Values (up to 3 repetitions): *JAVA, *SYSTEM, *HEAP | Optional |
| Top |
Job name (JOB)
Specifies the name of the job where the JVM is running. All three of the qualifiers for the job parameter are required.
This is a required parameter.
Qualifier 1: Job
- name
- Specify the name of the job for which to generate a dump.
Qualifier 2: User
- name
- Specify the name that identifies the user profile under which the job was started.
Qualifier 3: Number
- 000000-999999
- Specify the job number assigned by the system.
| Top |
Type (TYPE)
Specifies the type of dump to generate.
You can specify 3 values for this parameter.
- *JAVA
- Generates multiple files that contain diagnostic information for the JVM and the Java applications running within the JVM.
- *SYSTEM
- Generate a binary format raw memory image of the job that was running when the dump was initiated.
- *HEAP
- Generates a dump of all the heap space allocations which have not yet been freed.
| Top |
Examples
Example 1: Generate Javadump
GENJVMDMP JOB(032072/USERNAME/QP0ZSPWP) TYPE(*JAVA)
This command will cause a Javadump for the Java Virtual Machine running the job 032072/USERNAME/QP0ZSPWP.
Example 2: Generate Three Java VM Dumps
GENJVMDMP JOB(032072/USERNAME/QP0ZSPWP) TYPE(*JAVA *SYSTEM *HEAP)
This command will generate a Java core dump, system dump, and heap dump for the Java virtual machine running the job 032072/USERNAME/QP0ZSPWP.
| Top |
Error messages
*ESCAPE Messages
- CPE3440
- Operation not supported.
- CPF9871
- Error occurred while processing.
- JVAB321
- Java Virtual Machine job &3/&2/&1 not found or not active.
- JVAB322
- Not authorized to perform function on Java Virtual Machine.
- JVAB328
- Machine or ASP storage limit reached.
- JVAB332
- GENJVMDMP failed.
| Top |