INQUIRE DJAR

Retrieve information about a DJAR definition.

Read syntax diagramSkip visual syntax diagramINQUIRE DJAR
 
                               .----------------------------.
                               V                            |
>>-INQUIRE --DJAR(data-value)----+------------------------+-+--><
                                 +-CORBASERVER(data-area)-+
                                 +-HFSFILE(data-area)-----+
                                 +-LASTMODTIME(data-area)-+
                                 '-STATE(cvda)------------'
 

Conditions: NOTAUTH, NOTFND

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

The INQUIRE DJAR command returns the attributes associated with a deployed JAR file.

Browsing

You can also browse through all the deployed JAR files installed in the specified CorbaServer, using the browse options (START, NEXT, and END) on INQUIRE DJAR commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

CORBASERVER(data-area)
specifies a 4-character area to receive the name of the associated CorbaServer.
DJAR(data-value)
specifies a 1-32-character deployed JAR file name.
HFSFILE(data-area)
specifies a 255-character area to receive the fully-qualified HFS file name.

If this DJAR definition was created by performing the SCAN function on a CORBASERVER definition, this fully-qualified HFS file name is the one that appears in the DJARDIR parameter of that CORBASERVER definition.

LASTMODTIME(data-area)
specifies an 8-byte packed-decimal field to receive the time, in milliseconds since 00:00 on January 1st 1900, that the deployed JAR file on HFS was last updated. This is a readonly value that CICS updates when the DJAR resource is installed or updated. The last-modified-time can be used to determine whether CICS has refreshed itself after an update is made to a JAR in the pickup directory.

For dynamically-installed DJARs (those installed by the CICS scanning mechanism), the value of LASTMODTIME is the timestamp of the HFS file pointed to by the DJAR definition, at the time the DJAR definition was last installed or updated.

For statically-installed DJARs (those installed from a CSD or by CREATE DJAR), the value of LASTMODTIME is the timestamp of the HFS file pointed to by the DJAR definition, at the time the DJAR was installed. The value is fixed--it cannot be updated like a dynamically-installed DJAR.

You can use the EXEC CICS FORMATTIME command to convert the LASTMODTIME value to the date-and-time format that you prefer.

If you issue an INQUIRE DJAR command before a newly-installed or updated DJAR has fully initialized, the returned LASTMODTIME value will be zero.

STATE(cvda)
specifies a CVDA value indicating the state of the deployed JAR file. The CVDA values are:
DISCARDING
a DISCARD is in progress for this deployed JAR file.
INITING
The jar file is being copied to the shelf.
INSERVICE
Resolution of the copy of the jar file on the shelf has succeeded and the deployed JAR file is usable.
PENDINIT
Copying of the jar file to the shelf has not yet started.
PENDRESOLVE
Resolution of the copy of the jar file on the shelf has not yet started.
RESOLVING
The copy of the jar file on the shelf is being resolved.
UNRESOLVED
Resolution of the copy of the jar file on the shelf has failed and the deployed JAR file is unusable.
UNUSABLE
Copying the jar file to the shelf has failed and the deployed JAR file is unusable.

Conditions

NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 values:
2
The named deployed JAR file was not found
[[ Contents Previous Page | Next Page Index ]]