JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Configuring Project Components for Oracle Java CAPS Communication Adapters     Java CAPS Documentation
search filter icon
search icon

Document Information

Configuring Java CAPS Project Components for Communication Adapters

Configuring Java CAPS Adapter Connectivity Map Properties

Configuring the Adapter Connectivity Map Properties

To Configure the Inbound Adapter Properties

To Configure the Outbound Adapter Properties

SNA Inbound Adapter Connectivity Map Properties

Connectivity Map Inbound Adapter General Settings

Connectivity Map Inbound Adapter SNA Settings

Connectivity Map Inbound Adapter Connection Establishment

Connectivity Map Inbound Adapter Inbound Connection Management

Connectivity Map Inbound Adapter Inbound Schedules

Listener Schedule

Service Schedule

Connectivity Map Outbound Adapter General Settings

Connectivity Map Outbound Adapter SNA Settings

Connectivity Map Outbound Adapter Connection Establishment

Configuring CICS Adapter Connectivity Map Properties

CICS Connector

CICS Client

Connection Mode

e-Mail Inbound Adapter Connectivity Map Properties

Polling Setting

File Adapter Inbound Connectivity Map Properties

Parameter Settings -- File Adapter Inbound

File Adapter Outbound Connectivity Map Properties

Parameter Settings

HTTPS Adapter Connectivity Map Properties

HTTPS Adapter Connectivity Map Properties

HTTPS Server Adapter Connectivity Map Properties

IMS Adapter Connectivity Map Properties

Connector -- IMS Adapter Outbound

Connection Mode -- IMS Adapter Outbound

LDAP Adapter Connectivity Map Properties

Connector Section Properties

Connection Section Properties

Referrals Section Properties

Additional Referrals Section Notes

To Create a Credentials File Using the RCF Utility

To Add Credentials Information To the File

To View the Contents of the Credentials File

Security/SSL Section Properties

Additional Security/SSL Property Notes

SSL Connection Type

Verify Hostname

MSMQ Adapter Inbound Connectivity Map Properties

MSMQ Adapter Inbound Connectivity Map Properties

Identifying an MSMQ Queue

MSMQ Format Name and Host Name

MSMQ Adapter Outbound Connectivity Map Properties

MSMQ Adapter Outbound Connectivity Map Properties

Identifying an MSMQ Queue

TCP/IP Adapter Inbound Connectivity Map Properties

General Inbound Settings -- TCP/IP Adapter Inbound

TCPIP Inbound Settings -- TCP/IP Adapter Inbound

TCPIP Inbound Settings - Server Port Binding -- TCP/IP Adapter Inbound

TCPIP Inbound Settings - Client Connection Establishment -- TCP/IP Adapter Inbound

TCPIP Inbound Settings - Inbound Connection Management -- TCP/IP Adapter Inbound

TCPIP Inbound Schedules - Listener Schedule -- TCP/IP Adapter Inbound

TCPIP Inbound Settings - Service Schedule -- TCP/IP Adapter Inbound

TCPIP Inbound Settings - Envelope Message -- TCP/IP Adapter Inbound

Java CAPS 5.1.x to 6 Upgrade Procedure

TCP/IP Adapter Outbound Connectivity Map Properties

General Outbound Settings -- TCP/IP Adapter Outbound

TCPIP Outbound Settings -- TCP/IP Adapter Outbound

TCPIP Outbound Settings - Connection Establishment -- TCP/IP Adapter Outbound

TCPIP Outbound Settings - Server Port Binding

TCPIP Outbound Settings - Envelope Message

Configuring CICS Adapter Connectivity Map Properties

The CICS Adapter configuration parameters, accessed from the Connectivity Map, are organized into the following sections:

CICS Connector

The Connector section of the CICS Connectivity Map properties contains the top-level parameters displayed in this table:

Table 10 Connectivity Map - Connector Properties

Name
Description
Required Value
Type
Specifies the connector type.
Enter CICS. The value always defaults to CICS for CICS connections.
Connection Transport
Specifies the underlying connection transport used by the CICS Adapter to send requests to and get responses from a CICS region.
Select one of the following underlying connection transports:
  • CICS Listener

  • CICS Transaction Gateway (specifies the IBM CICS Transaction Gateway)

CICS Listener is the default.

Class
Specifies the class name of the CICS Client connector object.
The (class) package name for the CICS Client connector object. The default is com.stc.adapters.cics.CicsClientConnector.
Property.Tag
Specifies the data source identity. This parameter is required by the current EBobConnectorFactory.
The data source package name.

CICS Client

The CICS Client section of the CICS Connectivity Map properties contains the top-level parameters displayed in the following table.

Table 11 CICS Client Connectivity Map Properties

Name
Description
Required Value
ECI call type
Specifies whether the ECI call type is Synchronous. Synchronous calls wait for the transaction to complete, then return the contents of the COMMAREA. Only Synchronous calls are supported.
Synchronous is the configured default.
CICS Program
Specifies the CICS program to be run on the server. Maximum length is eight characters.
A CICS program name, eight characters or less.
CICS TransId
CTG specific. Specifies the ID of a CICS transaction. Maximum length is four characters. Attributes are dependent upon the value set for Use TransId as ECI_TPN, as follows:
  • If EciTPN is set to false, the value of the transid is stored in EIBTRNID for the duration of the LINK to the program specified in the Program parameter. The called program runs under the mirror transaction CPMI, but is linked to under the Transid transaction name. This name is available to the called program for querying the transaction ID. Some servers use the transaction ID to determine security and performance attributes for the called program.

  • If EciTPN is set to true, the Transid will be interpreted as the ECI_TPN transid, a transaction that will be used in the server to process the ECI request. This transaction must be defined in the server as a CICS mirror transaction. If the ECI request is extended, this parameter has a meaning only for the first request.

A CICS transaction ID of four characters or less.
Use TransId as ECI_TPN
This is specific to CTG, and specifies whether the TransId is interpreted as ECI_TPN or if the called program runs under the default mirror transaction CPMI. Options are:
  • True: Indicates that the TransId is interpreted as ECI_TPN.

  • False: Indicates that the called program runs under the default mirror transaction CPMI, and is linked to under the TransId (if present).

Select True or False.

False is the default.

COMMAREA Length
Specifies the length (in bytes) of the COMMAREA passed to the ECI.
A number indicating the byte length of the COMMAREA.

Note - When using the CICS Transaction Gateway transport, data sent to CICS must be padded with spaces, if necessary, to match the full size of the commarea.


ECI extend mode
Specifies whether a logical unit of work is terminated at the end of a call.
Select Yes or No.

Yes indicates that the work unit is terminated at the end of a call.

The default is No.

ECI LUW Token
CTG specific. Specifies an integer used to identify the logical unit of work (LUW) to which a call belongs. This must be set to 0 (zero) at the start of an LUW, even if the LUW is to be extended. The ECI updates the value upon the first (or only) call of the LUW. If the LUW is to be extended, this value is used as input to any subsequent calls associated with the same LUW.

If the return code is not ECI_NO_ERROR, and a call is ending or continuing an existing LUW, then this field is used to report the state of the LUW as follows:

  • A code of 0 (zero) indicates that the LUW has ended and its updates have been backed out.

  • Any non-zero code indicates the current input value. It also indicates that the LUW is continuing, and updates are still pending.

    See the Logical units of work in ECI table in the CICS Transaction Gateway: Programming Guide for more information.

An integer used to identify the ECI logical unit of work.
Encoding
Specifies the canonical name for the encoding set.
The canonical name for any encoding set supported by JRE 1.1.8 (contained in rt.jar and i18n.jar). Examples are ASCII and Cp500 (EBCDIC). When running the CICS Adapter on a z/OS platform, set the Encoding value to Cp500.

Connection Mode

The Connection Mode section of the CICS Connectivity Map properties contains the top-level parameters displayed in the following table.

Table 12 Connectivity Map Properties - Connection Mode Section

Name
Description
Required Value
CICS Connection Mode
Specifies whether a physical connection is established when an external connection is instantiated. The options are,

Automatic: Establishes a physical connection when an external connection is instantiated.

Manual:Does not automatically establish a physical connection when an external connection is instantiated.

If a physical connection is not automatically established, a physical connection must be established from the Collaboration (for example, by calling the connect() method).

Select Automatic or Manual.

The configured default is Automatic.