INQUIRE CORBASERVER

Retrieve information about a particular CorbaServer.

Read syntax diagramSkip visual syntax diagramINQUIRE CORBASERVER
 
>>-INQUIRE CORBASERVER(data-value)------------------------------>
 
   .-----------------------------.
   V                             |
>----+-------------------------+-+-----------------------------><
     +-ASSERTED(data-area)-----+
     +-AUTOPUBLISH(cvda)-------+
     +-CERTIFICATE(data-area)--+
     +-CLIENTCERT(data-area)---+
     +-CIPHERS(data-area)------+
     +-DJARDIR(data-area)------+
     +-ENABLESTATUS(cvda)------+
     +-HOST(data-area)---------+
     +-JNDIPREFIX(data-area)---+
     +-NUMCIPHERS(data-area)---+
     +-OUTPRIVACY(cvda)--------+
     +-SESSBEANTIME(data-area)-+
     +-SHELF(data-area)--------+
     +-SSLUNAUTH(data-area)----+
     '-UNAUTH(data-area)-------'
 

Conditions: END, NOTAUTH, NOTFND

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

Description

The INQUIRE CORBASERVER command allows you to retrieve information about a particular CorbaServer.

Browsing

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

Options

Start of changeASSERTED(data-area)End of change
Start of changereturns the 8-character name of a TCPIPSERVICE resource that defines the characteristics of the port which is used for inbound IIOP with asserted identity authentication.End of change
AUTOPUBLISH(cvda)
returns a CVDA value indicating whether enterprise beans are to be automatically published to the JNDI namespace when the deployed JAR file that contains them is successfully installed in the CorbaServer. The CVDA values are:
AUTOPUB
Enterprise beans are to be automatically published.
NOAUTO
Enterprise beans are not to be automatically published.
CERTIFICATE(data-area)
returns a 56-character area containing the label of the certificate within the key ring that is used as a client certificate in the SSL handshake for outbound IIOP connections. If the label is blank, the certificate nominated as the default for the key ring is used.

The distinguished name within this certificate is used to provide inputs to the Distinguished Name URM (DFHEJDNX). See the CICS® Intercommunication Guide.

Start of changeCIPHERS(data-area)End of change
Start of changereturns a 56-character area containing the list of cipher suites that is used to negotiate with clients during the SSL handshake. The list is set by the ENCRYPTION system initialization parameter, but you can edit the list to remove or change the order of cipher suites. See the CICS RACF Security Guide.End of change
CLIENTCERT(data-area)
returns the 8-character name of a TCPIPSERVICE resource that defines the characteristics of the port which is used for inbound IIOP with SSL client certificate authentication.
CORBASERVER(data-value)
specifies the 4-character name of a CorbaServer.
DJARDIR(data-value)
returns a 255-character area containing the name of the deployed JAR file directory (also known as the pickup directory) on HFS. (The pickup directory is the place that you put deployed JAR files that you want to be installed into the CorbaServer by the CICS scanning mechanism.)
ENABLESTATUS(cvda)
returns a CVDA value indicating the current state of the CorbaServer. The CVDA values are:
DISABLED
The CorbaServer is currently not processing any requests and is unable to accept new requests. It may have failed to initialize properly or been explicitly disabled.
DISABLING
The CorbaServer is quiescing before entering disabled state. It is not accepting new requests but is allowing currently-executing work to complete.
DISCARDING
A DISCARD request has been received for this CorbaServer. The CorbaServer is quiescing before being discarded. It is not accepting new requests but is allowing currently-executing work to complete.
ENABLED
The CorbaServer is available and is accepting requests.
ENABLING
The CorbaServer is being initialized. It is not yet ready to accept requests.
HOST(data-area)
returns a 255-character area containing the TCP/IP host name, or a string containing the dotted decimal TCP/IP address, which is included in Interoperable Object References (IORs) exported from the CorbaServer.
JNDIPREFIX(data-area)
returns a 255-character area containing the JNDI prefix.
Start of changeNUMCIPHER(data-area)End of change
Start of changereturns a binary halfword data-area that contains the number of cipher suites that are specified in the CIPHERS attribute.End of change
Start of changeOUTPRIVACY(cvda) End of change
Start of changeStart of changereturns a CVDA value indicating the level of SSL encryption that is used for outbound connections from this CORBASERVER. This level is determined by the CIPHERS attribute. Possible values are:
NOTSUPPORTED
Encryption is not used. During the SSL handshake, CICS advertises only supported cipher suites that do not provide encryption.
REQUIRED
Encryption is used. During the SSL handshake, CICS advertises only supported cipher suites that provide encryption.
SUPPORTED
Encryption is used if both client and server support it. During the SSL handshake, CICS advertises all supported cipher suites.
End of changeEnd of change
SESSBEANTIME(data-area)
returns a fullword area containing the elapsed time period in minutes, in the range 0 through 143999 (99 days, 23 hours, 59 minutes) of inactivity after which a session bean may be discarded. A value of zero indicates that beans are not timed out.
SHELF(data-area)
returns a 255-character area containing the name of the HFS shelf directory.
SSLUNAUTH(data-area)
returns the 8-character name of a TCPIPSERVICE resource that defines the chracteristics of the port which is used for inbound IIOP with SSL but no client authentication.
UNAUTH(data-area)
returns the 8-character name of a TCPIPSERVICE resource that defines the characteristics of the port which is used for inbound IIOP with no authentication.

Conditions

END
RESP2 values:
2
There are no more Corbaservers to browse.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 values:
2
The named CorbaServer was not found
[[ Contents Previous Page | Next Page Index ]]