Work with JVM Jobs (WRKJVMJOB)

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:

Restrictions:

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.

Parameters

Keyword Description Choices Notes
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
All jobs with the specified job user name and job number are searched for an active IBM Technology for Java Virtual Machine.
generic-name
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.
name
Specify the name of the job to be displayed.

Qualifier 2: User

*ALL
All jobs with the specified job name and job number are searched for an active IBM Technology for Java Virtual Machine.
generic-name
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.
name
Specify the name that identifies the user profile under which the job was started.

Qualifier 3: Number

*ALL
All jobs with the specified job name and job user are searched for an active IBM Technology for Java Virtual Machine.
000000-999999
Specify the job number assigned by the system.

Option (OPTION)

Specifies which information is being worked with. If multiple jobs are found, the *OPTION parameter is ignored and the list of jobs is displayed.

*SELECT
Display the Work with Java Virtual Machine menu which allows you to select the option that is needed.
*CRTOPT
Display JVM creation options
*ENVVAR
Display environment variables
*PASEENVVAR
Display PASE environment variables
*LCK
Display Java lock information
*GC
Display garbage collection information
*THREAD
Display threads
*INLPROP
Display initial Java system properties
*CURPROP
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.

*YES
Displays the Java information for each job filtered by two different options "Java level" and "Java version".
*NO
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.

*ALL
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'.

*BOTH
Displays both 32 bit and 64 bit Java jobs.
32
Displays 32 bit Java jobs.
64
Displays 64 bit Java jobs.

Examples

Example 1: Showing All Jobs With Active JVMs 

WRKJVMJOB

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 

WRKJVMJOB   JOB(032072/NISTLER/QP0ZSPWP)

This command will display a panel listing actions that may be taken on the job named 032072/NISTLER/QP0ZSPWP.

Error messages

*ESCAPE Messages

CPE3440
Operation not supported.
CPF1071
No authority to job &3/&2/&1.
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.
JVAB325
Java Thread not found.
JVAB326
Verbose garbage collection has been enabled.
JVAB327
Verbose garbage collection has been disabled.
JVAB331
WRKJVMJOB failed.