PERFORM DJAR

Perform certain actions against a specified DJAR.

Read syntax diagramSkip visual syntax diagramPERFORM DJAR
 
>>-PERFORM --DJAR(data-value)--+--------------+----------------><
                               +-ACTION(cvda)-+
                               +-PUBLISH------+
                               '-RETRACT------'
 

Conditions: INVREQ, NOTAUTH, NOTFND

Description

The PERFORM DJAR command allows you to publish or retract all beans installed in a specified deployed JAR file. If no action is specified, the command has no effect.

In addition to the traditional DFSMS-managed data sets, such as partitioned data sets (PDS), CICS requires access to z/OS® UNIX System Services and the hierarchical file store (HFS) in order to launch a JVM. This requires that the CICS region userid is authorized to z/OS UNIX System Services to enable CICS to access the required HFS directories, such as those specified on the JVMPROPS, LIBPATH, and CLASSPATH parameters.

Options

DJAR(data-value)
specifies the 1-32 character name of a deployed JAR file.
ACTION(cvda)
returns a CVDA value indicating the action to be taken on the deployed JAR file. CVDA values are:
PUBLISH
publish all the beans installed from the deployed JAR file. Publishing a bean means binding a reference to the home of the bean in a namespace. The naming context in which the bean is bound is named, relative to the initial context defined for the CICS region, using a concatenation of the JNDI prefix attribute of the deployed JAR file's CorbaServer and the name of the bean.
RETRACT
retract all the beans installed from the deployed JAR file. Retracting a bean means unbinding a reference to the home of the bean from the namespace. The naming context in which the bean is bound is named, relative to the initial context defined for the CICS region, using a concatenation of the JNDI prefix attribute of the deployed JAR file's CorbaServer and the name of the bean.

Conditions

INVREQ
RESP2 values:
5
The specified CVDA value is invalid, that is, it is neither PUBLISH nor RETRACT.
10
The state of the deployed JAR file is not INSERVICE.
16
djar publish error.
17
djar retract error.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 values:
3
djar not found.
[[ Contents Previous Page | Next Page Index ]]