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:
| 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
| 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
| 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:
|
| 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.
|
| 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.
|
| 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:
|
| 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. |