CorbaServer definitions - EJCODEF

The CorbaServer definition (EJCODEF) views display information about the physical and operational characteristics of CorbaServer definitions.

CorbaServer definitions cannot be installed into CICS regions running CICS TS for z/OS, Version 5.1 or higher.

Supplied views

To access from the main menu, click:

Administration views > CICS resource definitions > CorbaServer definitions

Table 1. Views in the supplied CorbaServer definitions (EJCODEF) view set
View Notes
CorbaServer definitions

EYUSTARTEJCODEF.ADDTOGRP

Add one or more CorbaServer definitions to a resource group.
CorbaServer definitions

EYUSTARTEJCODEF.CREATE

Create a CorbaServer definition and add it to the data repository.
CorbaServer definitions

EYUSTARTEJCODEF.DETAILED

Detailed information about a selected CorbaServer definition.
CorbaServer definitions

EYUSTARTEJCODEF.INSTALL

Install a CorbaServer definition in an active system.
CorbaServer definitions

EYUSTARTEJCODEF.REMOVE

Remove a CorbaServer definition from the data repository.
CorbaServer definitions

EYUSTARTEJCODEF.TABULAR

Tabular information about all CorbaServer definitions for the current context.

Actions

Table 2. Actions available for EJCODEF views
Action Description
ADDTOGRP Add one or more CorbaServer definitions to a resource group.
CREATE Create a CorbaServer definition and add it to the data repository.
CSDCOPY Copy a CICS CSD resource definition.
CSDINSTALL Install a CICS CSD resource definition into an active system.
INSTALL Install a CorbaServer definition in an active system.
REMOVE Remove a CorbaServer definition from the data repository.
UPDATE Update a CorbaServer definition in the data repository.

Fields

Table 3. Fields in EJCODEF 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 which is used for inbound IIOP with asserted identity authentication.
Auto publish beans to Java naming directory (JNDI) AUTOPUBLISH Specifies whether the contents of a deployed JAR file should be automatically published to the namespace when the DJAR definition is successfully installed into this CorbaServer:
  • NO - The contents of the deployed JAR file will not be automatically published to the namespace.
  • YES - The contents of the deployed JAR file will be automatically published to the namespace.
Changing the setting of AUTOPUBLISH affects only DJAR definitions installed after the SET CORBASERVER command is executed. It has no effect on previously-installed DJAR definitions.
Secure sockets layer (SSL) client certificate CERTIFICATE A 32-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).

Note: If more than 32 characters are entered in this field, only the first 32 will be used.

Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
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.
SSL cipher suite codes CIPHERS Specifies a string of up to 56 hexadecimal digits that is interpreted as a list of up to 28 2-digit cipher suite codes. When you define the resource, CICS automatically initializes the attribute with a default list of acceptable codes. You can reorder the cipher codes or remove them from the initial list. However, you cannot add cipher codes that are not in the default list for the specified encryption level. To reset the value to the default list of codes, delete all the cipher suite codes; the field is automatically repopulated with the default list.
TCP/IP service for client certificated protocol CLIENTCERT The 8-character name of a TCPIPSERVICE that defines the characteristics of the port which is used for inbound IIOP with SSL client certificate authentication. This attribute is optional.
Time created CREATETIME The local date and time when the definition was created.
CSD group CSDGROUP The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
Version DEFVER The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.
Description code page DESCCODEPAGE The code page of the description field. This field is ignored for CICS CSD resource definitions.
Description DESCRIPTION A description of the CorbaServer definition.
CICS-deployed JAR file pickup directory DJARDIR The 1-255 character fully-qualified name of the deployed JAR file directory (also known as the pickup directory) on zFS. If specified, DJARDIR must refer to a valid zFS directory to which the CICS region has at least read access.
TCP/IP host address HOST The 255-character host name of this logical EJB/CORBA server (for example, www.example.com), or its dotted decimal IPv4 address (for example, 9.20.181.3), or its colon hexadecimal IPv6 address (for example ABCD:EF01::2345:6789). If an IPv4 address is entered as an IPv4 compatible IPv6 address (deprecated) or an IPv4 mapped IPv6 address (for example ::FFFF:1.2.3.4) it is converted to a standard IPv4 dotted decimal address. IPv6 addresses should not be used for CICS Transaction Server for z/OS, Version 3 Release 2 and earlier releases. This host name is included in Interoperable Object References (IORs) exported for objects in this logical server. Clients must use this host name to access the CICS listener regions.
Java naming directory (JNDI) prefix JNDIPREFIX A JNDI prefix of up to 255 characters, which is used when enterprise beans are published to the Java Naming and Directory Interface (JNDI). The JNDIPREFIX attribute must match the prefix specified by the client when it uses JNDI to obtain a reference to the home interface for a bean.
Name NAME The name of the CorbaServer definition.
Outbound privacy OUTPRIVACY This is obsolete from CICS TS Version 3 Release 1. Indicates whether cipher suites are used when an outbound SSL connection is opened.
  • 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 (DDHHMM) SESSBEANTIME The period , in days, hours, and minutes of inactivity after which a session bean may be discarded by CICS:
  • 00,00,00 - Session beans will not be timed out.
  • 00,00,10 - Session beans may be discarded after ten minutes of inactivity. This is the default value.
  • dd,hh,mm - Session beans may be discarded after the specified period of inactivity. The maximum value you can specify is 99 days, 23 hours, and 59 minutes.
zSeries File System (zFS) shelf directory SHELF The 1-255 character fully-qualified name of a directory (a shelf, primarily for deployed JAR files) on zFS. CICS regions into which the CORBASERVER definition is installed must have full permissions to the shelf directory-read, write, and the ability to create subdirectories.
Secure socket layer (SSL) usage SSL This attribute is obsolete and unsupported.
Secure socket 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 that defines the characteristics of the port which is used for inbound IIOP with SSL but no client authentication. This attribute is optional.
Status STATUS Specifies whether the CorbaServer is to be installed in enabled or disabled state. The default is enabled.
TCP/IP service for unauthenticated protocol UNAUTH The 8-character name of a TCPIPSERVICE that defines the characteristics of the port which is used for inbound IIOP with no authentication. You must specify a value for the UNAUTH attribute when you define a CORBASERVER, even if you intend that all inbound requests to this CORBASERVER should be authenticated. This is because the PORTNUMBER attribute of the TCPIPSERVICE is required in order to construct IORs that are exported from this logical server.
User data area 1 USERDATA1 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 2 USERDATA2 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 3 USERDATA3 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.


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