SET JVMPOOL

Change the status of the JVM pool in the CICS region.

Read syntax diagramSkip visual syntax diagramSET JVMPOOL
 
>>-SET JVMPOOL--+-------------------------+--+--------------+--->
                +-JVMLVL0TRACE(data-area)-+  +-STATUS(cvda)-+
                +-JVMLVL1TRACE(data-area)-+  +-ENABLED------+
                +-JVMLVL2TRACE(data-area)-+  '-DISABLED-----'
                '-JVMUSERTRACE(data-area)-'
 
>--+-----------------+-----------------------------------------><
   +-TERMINATE(cvda)-+
   +-PHASEOUT--------+
   +-PURGE-----------+
   '-FORCEPURGE------'
 

Conditions: INVREQ, NOTAUTH

Description

The SET JVMPOOL command allows you to change the status of the pool of JVMs in the CICS region or to terminate the pool. There can only be one pool of JVMs in a CICS region, therefore there is no name or identifier required on this command.

Options

JVMLVL0TRACE(data-value), JVMLVL1TRACE(data-value), JVMLVL2TRACE(data-value), JVMUSERTRACE(data-value)
specify a 240-character setting for the JVM tracing options, which are used when the associated level of tracing has been activated using the CICS-supplied transaction CETR, the EXEC CICS SET TRACETYPE command, or the system initialization parameter SPCTRSJ. Trace levels 29-32 for the SJ component correspond to JVMLVL0TRACE, JVMLVL1TRACE, JVMLVL2TRACE and JVMUSERTRACE respectively.
STATUS(cvda)
specifies whether new Java requests can be accepted and serviced by the JVM pool. The CVDA values are:
ENABLED
The pool status is set to enabled for use and Java programs can execute using JVMs from the pool.
DISABLED
The pool status is set to disabled, preventing new requests from being serviced from the pool. Programs that were started before the command was issued are allowed to execute to completion.
TERMINATE(cvda)
specifies that the JVM pool is to be terminated. All the JVMs in the pool, both worker JVMs using the shared class cache and JVMs running independently of the shared class cache, are terminated. No more JVMs can use the existing shared class cache, and it is deleted when all the worker JVMs that were dependent on it have been terminated. If autostart is enabled for the shared class cache, a new shared class cache is started as soon as a new JVM requests it. The CVDA values are:
PHASEOUT
All JVMs in the pool are marked for deletion. The JVMs are actually deleted when they finish running their current Java program. The shared class cache is deleted when all the worker JVMs that were dependent on it have been terminated.
PURGE
All tasks using JVMs in the pool are terminated using the SET TASK PURGE mechanism, and the JVMs are terminated. The shared class cache is deleted when all the worker JVMs that were dependent on it have been terminated.
FORCEPURGE
All tasks using JVMs in the pool are terminated by the SET TASK FORCEPURGE mechanism, and the JVMs are terminated. The shared class cache is deleted when all the worker JVMs that were dependent on it have been terminated.

Conditions

INVREQ
RESP2 values:
1
TERMINATE is specified with an invalid CVDA value.
2
STATUS is specified with an invalid CVDA value.
3
A task purge failed.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
[[ Contents Previous Page | Next Page Index ]]