Work with JVM Jobs (WRKJVMJOB)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No
Parameters
Examples
Error messages

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.

Top

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
Top

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.
Top

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
Top

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.

Top

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.
JVAB323
Operation not supported with a Classic 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.
Top