Work with JVM Jobs (WRKJVMJOB)
|Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
The Work with JVM Jobs (WRKJVMJOB) command allows the user to monitor Java Virtual Machines (JVMs) running in active jobs. If the values specified for the Job name (JOB) parameter identify a single job, a menu is displayed showing the options available for the specific JVM job. Otherwise a list of jobs with active JVMs is displayed.
Once a specific job is identified, the following information or functionality is available for the IBM Technology for Java Virtual Machine job:
- The arguments and options with which the JVM was started.
- Environment variables for both ILE and PASE.
- Java lock requests outstanding for the JVM job.
- Garbage collection information.
- The properties with which the JVM was started.
- The properties with which the JVM is currently running.
- The list of threads associated with the JVM.
- The partially completed job log for the JVM job.
- The ability to work with spooled input and output files for the JVM job.
- The ability to generate JVM (System, Heap, Java) dumps from a panel option.
- The ability to enable and disable verbose garbage collection from a panel option.
Any user can generate a list of the jobs with active JVMs. However, in order to work with a single JVM job 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.
|JOB||Job name||Qualified job name||Optional, Positional 1|
|Qualifier 1: Job name||Generic name, name, *ALL|
|Qualifier 2: User||Generic name, name, *ALL|
|Qualifier 3: Number||000000-999999, *ALL|
|OPTION||Option||*SELECT, *CRTOPT, *ENVVAR, *PASEENVVAR, *LCK, *GC, *THREAD, *INLPROP, *CURPROP, *HEAPDMP||Optional|
|JAVA||Show Java information||*YES, *NO||Optional|
|JDK||Java level||Character value, *ALL||Optional|
|BIT||Java version||*BOTH, 32, 64||Optional|
Job name (JOB)
Specifies the name of the job where the JVM is running. If no job number and user name is given, all of the jobs currently in the system are searched for the simple job name. The job name entered must be a job in which an IBM Technology for Java VM is currently running. If multiple jobs are found, the *OPTION parameter is ignored and the list of jobs is displayed.
Qualifier 1: Job
- All jobs with the specified job user name and job number are searched for an active IBM Technology for Java Virtual Machine.
- Specify the generic name of the job to be displayed. A generic name is a character string of one or more characters followed by an asterisk (*). If a generic name is specified, all jobs with active JVMs with job names that have the same prefix as the generic name are displayed.
- Specify the name of the job to be displayed.
Qualifier 2: User
- All jobs with the specified job name and job number are searched for an active IBM Technology for Java Virtual Machine.
- Specify a generic name that identifies the user profile under which the job was started. A generic name is a character string of one or more characters followed by an asterisk (*). If a generic name is specified, all jobs with active JVMs with job users that have the same prefix as the generic name are displayed.
- Specify the name that identifies the user profile under which the job was started.
Qualifier 3: Number
- All jobs with the specified job name and job user are searched for an active IBM Technology for Java Virtual Machine.
- Specify the job number assigned by the system.
Specifies which information is being worked with. If multiple jobs are found, the *OPTION parameter is ignored and the list of jobs is displayed.
- Display the Work with Java Virtual Machine menu which allows you to select the option that is needed.
- Display JVM creation options
- Display environment variables
- Display PASE environment variables
- Display Java lock information
- Display garbage collection information
- Display threads
- Display initial Java system properties
- Display current Java system properties
Show Java information (JAVA)
Specifies whether the Java infomation(Java level and Java version) is shown in the active Java job list. It also controls if the following two options are displayed.
- Displays the Java information for each job filtered by two different options "Java level" and "Java version".
- Do not display the Java information for each active Java job. The following two options, Java level and Java version have no effect.
Java level (JDK)
Specifies the Java level of a job which is used to filter the jobs tobe displayed in the job list. For example, if you want to show only JDK 60 jobs in the output list, specify '1.6.0', '1.6','6.0','60' or '6' in this field.
- Displays all Java jobs no matter which Java level it is running on.
Java version (BIT)
Specifies the Java version of a job which is used to filter the jobs displayed in the job list. For example, if you want to show only 32 bit Java jobs in the output list, specify '32'.
- Displays both 32 bit and 64 bit Java jobs.
- Displays 32 bit Java jobs.
- Displays 64 bit Java jobs.
Example 1: Showing All Jobs With Active JVMs
This command displays a panel listing all of the jobs running on the system which have an active IBM Technology for Java VM.
Example 2: Showing Actions For Specific Job
This command will display a panel listing actions that may be taken on the job named 032072/NISTLER/QP0ZSPWP.
- Operation not supported.
- No authority to job &3/&2/&1.
- Error occurred while processing.
- Java Virtual Machine job &3/&2/&1 not found or not active.
- Not authorized to perform function on Java Virtual Machine.
- Java Thread not found.
- Verbose garbage collection has been enabled.
- Verbose garbage collection has been disabled.
- WRKJVMJOB failed.