User's Manual

Using the CCI API to Develop Applications
Integrating OracleAS Adapter for IMS/DB with OC4J 3-3
Using the CCI API to Develop Applications
You can develop applications to run adapter interactions using the Common Client
Interface (CCI) API.
Perform the following steps to use the CCI API with the J2CA 1.5 IMS/DB adapter:
1. Select a ConnectionFactory entry for the J2CA 1.5 IMS/DB adapter.
2. Create a Connection object using this ConnectionFactory. A Connection is
a handle to the underlying network connection to the EIS, which is identified in
the oc4j-ra-xml file by the serverName property.
serverName Sets the TCP/IP address or host name where the Oracle
Connect daemon is running. The daemon runs on the
computer specified at the beginning of "Setting Up the IBM
z/OS Platform in Oracle Studio" on page 2-14.
workspace Specifies to the name of a Oracle Connect server workspace
to use. The default workspace is Navigator.
See Also: "Workspaces" on page C-7 for details about
workspaces.
portNumber Specifies to the TCP/IP port where the Oracle Connect
daemon is running on the server. The default port is 2551.
userName
(optional)
Specifies a user who can access the Oracle Connect server.
The user is defined in the Oracle Connect daemon
configuration.
See Also: Daemon "Security" and Workspace "Security" for
details about users allowed to access an Oracle Connect
server.
password
(optional)
Specifies a valid password for the user.
persistentConnection
(optional)
Set to true or false. When set to true, connections can
persist across multiple requests or connection context
changes. It is recommended to set this property to true.
keepAlive
(optional)
Set to true or false. When set to true, the socket used for
the connection is always kept open. It is recommended to set
this property to true.
firewallProtocol
(optional)
Specifies the firewall protocol used: either none or fixedNat
(the Nat protocol using a fixed address for the daemon). The
default value is none.
connectTimeout
(optional)
Specifies the connection timeout in seconds. The default is 0,
meaning that there is no connection timeout.
encryptionProtocol
(optional)
Specifies the name of encryption protocol to use. The default
is null. The RC4 protocol is supported.
encryptionKeyName
(optional)
Specifies the name of the symmetric encryption key to use.
encryptionKeyValue
(optional)
Specifies the value of the symmetric encryption key to use.
fakeXa
(optional)
When set to true, the XA APIs are internally converted to
local transaction APIs. Always set to true
.
Table 3–1 (Cont.) OC4J Connection Properties
Property Description