CorbaServers - EJCOSE

The CorbaServers (EJCOSE) views display information about currently installed CorbaServers.

Supplied views

To access from the main menu, click:

CICS operations views > Enterprise Java component operations views > CorbaServers

Table 1. Views in the supplied CorbaServers (EJCOSE) view set
View Notes
CorbaServers

EYUSTARTEJCOSE.DETAIL1

Detailed JNDI and shelf information about a selected CorbaServer.
CorbaServers

EYUSTARTEJCOSE.DETAIL2

Detailed host and certificate information about a selected CorbaServer.
CorbaServers

EYUSTARTEJCOSE.DETAIL3

Detailed DJAR and statistics information about a selected CorbaServer.
CorbaServers

EYUSTARTEJCOSE.DETAIL4

Detailed cipher information about a selected CorbaServer.
CorbaServers

EYUSTARTEJCOSE.DETAIL5

Detailed information about the resource signature.
CorbaServers

EYUSTARTEJCOSE.DETAILED

Detailed general information about a selected CorbaServer.
CorbaServers

EYUSTARTEJCOSE.DISCARD

Discard the selected CorbaServer from its associated MAS together with any associated deployed JAR files and beans.
CorbaServers

EYUSTARTEJCOSE.PUBLISH

Publish:
  • all beans installed in the specified CorbaServer
  • the Generic Factory Interoperable Object Reference (Generic factory) of the specified Corbaserver
Publishing a bean means binding a reference to the home of the bean in 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 JNDIPREFIX attribute of the CorbaServer and the name of the bean. The Generic factory is bound with the name GenericFactory concatenated to the JNDIPREFIX attribute of the Corbaserver.
CorbaServers

EYUSTARTEJCOSE.RETRACT

Retract all beans installed in the selected CorbaServer. 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 JNDIPREFIX attribute of the CorbaServer and the name of the bean.
CorbaServers

EYUSTARTEJCOSE.SCAN

Scan the selected CorbaServer's deployed JAR file directory (also known as the pickup directory) for new or updated deployed JAR files. If CICS finds any new deployed JAR files in the pickup directory, it copies them to its shelf directory and dynamically creates and installs DJAR definitions for them. If CICS finds any updated deployed JAR files in the pickup directory, it updates both the LASTMODTIME, DATESTAMP, and TIMESTAMP attributes of the installed DJAR definitions and the shelf copies of the deployed JAR files.
CorbaServers

EYUSTARTEJCOSE.SET

Change the attributes of a selected CorbaServer.
CorbaServers

EYUSTARTEJCOSE.TABULAR

Tabular information about installed CorbaServers.

Actions

Table 2. Actions available for EJCOSE views
Action Description
DISCARD Discard the selected CorbaServer from its associated MAS together with any associated deployed JAR files and beans.
PUBLISH Publish:
  • all beans installed in the specified CorbaServer
  • the Generic Factory Interoperable Object Reference (Generic factory) of the specified Corbaserver
Publishing a bean means binding a reference to the home of the bean in 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 JNDIPREFIX attribute of the CorbaServer and the name of the bean. The Generic factory is bound with the name GenericFactory concatenated to the JNDIPREFIX attribute of the Corbaserver.
RETRACT Retract all beans installed in the selected CorbaServer. 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 JNDIPREFIX attribute of the CorbaServer and the name of the bean.
SCAN Scan the selected CorbaServer's deployed JAR file directory (also known as the pickup directory) for new or updated deployed JAR files. If CICS finds any new deployed JAR files in the pickup directory, it copies them to its shelf directory and dynamically creates and installs DJAR definitions for them. If CICS finds any updated deployed JAR files in the pickup directory, it updates both the LASTMODTIME, DATESTAMP, and TIMESTAMP attributes of the installed DJAR definitions and the shelf copies of the deployed JAR files.
SET Change the attributes of a selected CorbaServer.

Fields

Table 3. Fields in EJCOSE views
Field Attribute name Description
TCP/IP service for Asserted Identity protocol ASSERTED The 8-character name of a TCPIPSERVICE that defines the characteristics of the port that is used for inbound IIOP with asserted identity authentication.
Auto publish beans to Java naming directory (JNDI) AUTOPUBLISH Indicates 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 values are:
  • Autopub
    • Enterprise beans are to be automatically published.
  • Noauto
    • Enterprise beans are not to be automatically published.
BAS resource definition version BASDEFINEVER The BAS version number of this definition.
Secure sockets layer (SSL) client certificate CERTIFICATE This specifies the label of a certificate within the key ring that is to be used as a client certificate in the SSL handshake for outbound IIOP connections. If this option is not specified, the default certificate for the key ring is used.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CSDBATCH - The resource was last changed by a DFHCSDUP job.
  • DREPAPI - The resource was last changed by a CICSPlex SM BAS API command.
  • DREPBATCH - The resource was last changed by a CICSPlex SM utility.
  • CREATESPI - The resource was last changed by an EXEC CICS CREATE command.
  • NOTAPPLIC - This is not applicable for this resource.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification to the resource definition.
Last modification time CHANGETIME The local date and time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification to the resource definition.
SSL cipher suite codes CIPHERS The list of cipher suites, in the form of up to 28 hexadecimal pairs, that is used to negotiate with clients during the SSL handshake. When a secure connection is established between a pair of processes, the most secure cipher suite supported by both is used.
TCP/IP service for client certificated protocol CLIENTCERT The 8-character name of a TCPIPSERVICE resource that defines the characteristics of the port that is used for inbound IIOP with SSL client certificate authentication.
Source of the resource definition DEFINESOURCE The source of the definition, depending on which agent made the last change.
Creation time DEFINETIME The local date and time when the resource definition record was created on DFHCSD or EYUDREP.
CICS-deployed JAR file pickup directory DJARDIR A 255-character area containing the name of the deployed JAR file directory (also known as the pickup directory) on zFS. (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.)
CorbaServer status ENABLESTATUS Specifies the current state of the CorbaServer. The 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 have 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.
Input Values: ENABLED, DISABLED
Number of Failed Activates FAILACTIVATE The total number of failed stateful session bean activations.
Host name or IP address HOST The host name or IP address of this logical EJB or CORBA server. The HOSTTYPE option gives the format of this value, as either a name, an IPv4 address or an IPv6 address. HOST is a static value, specified in the Resource Definition.
The format of the host name or address HOSTTYPE The format of the name or address in the HOST option. These are the possible values:
  • HOSTNAME - HOST contains a character host name. The IP address that corresponds to the host name is looked up using DNS.
  • IPV4 - HOST contains an IPv4 address specified in dotted decimal address format
  • IPV6 - HOST contains an IPv6 address specified in colon hexadecimal address format
  • NOTAPPLIC - The HOST name or address is incorrect (HOST=0.0.0.0 or HOST=*).
Installation agent INSTALLAGENT The install agent identifier that made the installation.
  • CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CREATESPI - The resource was installed by an EXEC CICS CREATE command.
  • GRPLIST - The resource was installed by GRPLIST INSTALL.
Installation time INSTALLTIME The local date and time when the definition was installed.
Installation user ID INSTALLUSRID The user ID that installed the resource definition.
The format of the resolved IP address IPFAMILY The format of the IP address in the IPRESOLVED option. These are the possible values:
  • IPV4 - IPRESOLVED contains an IPv4 address specified in dotted decimal address format.
  • IPV6 - IPRESOLVED contains an IPv6 address specified in colon hexadecimal address format.
  • UNKNOWN - IPRESOLVED is not yet in use, or the address cannot be resolved. This is the default when IPRESOLVED is 0.0.0.0
The resolved address of this CORBA server IPRESOLVED The resolved IPv4 or IPv6 address of the CORBA server named in the HOST option, or 0.0.0.0 if it is unavailable or unknown. The format of this IP address is given by the IPFAMILY option.
Java naming directory (JNDI) prefix JNDIPREFIX The prefix to be used at run time when publishing enterprise beans to the Java Naming and Directory Interface (JNDI). The prefix must include any trailing delimiter, such as a forward slash, because CICS does not insert a delimiter between the prefix and a suffix. If this option is not specified, no prefix is prepended when publishing beans to JNDI.
CorbaServer name NAME The name of the CorbaServer.
Number of SSL cipher suite codes NUMCIPHERS The number of SSL cipher suite codes.
Number of Object Activates OBJACTIVATES The total number of successful stateful session bean activations.
Number of Object Stores OBJSTORES The total number of successful stateful session bean passivations.
Outbound privacy OUTPRIVACY Indicates the level of SSL encryption used for outbound requests from this CorbaServer. The 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.
TCP/IP port number PORT This attribute is obsolete and unsupported.
Session bean timeout (minutes) SESSBEANTIME This defines the elapsed time (in minutes) of inactivity after which a session bean may be discarded. A value of 0 prevents beans from being timed out. The default value is 10 minutes.
zSeries File System (zFS) shelf directory SHELF The fully qualified name of up to 255 characters of a directory (a shelf, primarily for deployed JAR files) on zFS.
Secure sockets layer (SSL) usage SSL This attribute is obsolete and unsupported.
Secure sockets layer (SSL) port number SSLPORT This attribute is obsolete and unsupported.
TCP/IP service for SSL AUTHENTICATE=NO protocol SSLUNAUTH The 8-character name of a TCPIPSERVICE resource that defines the characteristics of the port that is used for inbound IIOP with SSL but no client authentication
CorbaServer state usage STATE Applies only to releases earlier than CICS Transaction Server for z/OS Version 3 Release 1. In later releases this is replaced by ENABLESTATUS. This specifies the current status of this CorbaServer and has a value of:
  • INITING - The CorbaServer is being initialized. It is not yet ready to accept requests.
  • INSERVICE - The CorbaServer is available and is accepting requests.
  • PENDINIT - Initialization has not yet started.
  • PENDRESOLVE - Resolution of the CorbaServer has not yet started.
  • UNRESOLVED - Resolution of the CorbaServer has failed.
  • UNUSABLE - The CorbaServer is unusable.
  • DISCARDING - A DISCARD is in progress for this CorbaServer.
  • RESOLVING - The CorbaServer is being resolved.
TCP/IP service for unauthenticated protocol UNAUTH The 8-character name of a TCPIPSERVICE resource that defines the characteristics of the port that is used for inbound IIOP with no authentication


eyua3y8.html | Timestamp icon Last updated: Sunday, 4 June 2017