This topic reviews considerations for connection factories when using optimized local adapters.
A connection factory must be configured to enable the optimized local adapters on z/OS® for inbound and outbound support, even though it is only used directly for outbound. Multiple connection factories are supported. The connection factory can have any name.
Each configured connection factory can have different settings associated with it. Configurable settings include connection pool sizes and custom properties.
1-12 alphanumeric characters.
Set this value to the target registration name
1-8 alphanumeric characters.
1-16 alphanumeric characters.
Set this value to the target IMS OTMA server name.
1 character - 0|1
If you are running on Version 8.0.0.2 or earlier, set this value to 0 (zero) for SyncLevel NONE and 1 for SyncLevel CONFIRM. All calls to IMS transactions run with Commit Mode 1 or SEND_THEN_COMMIT behavior. Refer to the IMS Information Center for more information about these OTMA Sync Levels and CM1 SEND_THEN_COMMIT processing.
If you are running on Version 8.0.0.3 or higher, set this value to 0 (zero) for SyncLevel NONE and 1 for SyncLevel CONFIRM. If you want IMS to commit work for a processed transaction after sending the response to the application server without receiving a positive acknowledgment that the response was accepted, select None as the sync level. If you want IMS to commit the transaction only after receiving a positive acknowledgement, select Confirm as the sync level. If the acknowledgement is negative, the inflight work is rolled back. All calls to IMS transactions with OLA over OTMA run as SEND_THEN_COMMIT (CM1). Refer to the IMS Information Center for more information about these OTMA Sync Levels and CM1 SEND_THEN_COMMIT processing.
Integer - 1
Set this value to the maximum number of IMS message segments supported for sending to IMS or receiving from IMS.
Integer - 32768
Set this value to the maximum number size for any received message, including all message segments.
String
When running on a non-z/OS platform, specifies the host name where the JNDI lookup of the OLA proxy EJB is directed.
Integer
When running on a non-z/OS platform, specifies the port number on the remote host where the JNDI lookup of the OLA proxy EJB is directed
String
When running on a non-z/OS platform, specifies the JNDI name on the remote host where the OLA proxy EJB is bound. The remote host is specified by the RemoteHostname and RemotePort properties.
String
Specifies the user that is used to send requests to a registration which is running with security enabled. The MVS user ID associated with the username is used. If there is no MVS user ID associated with the username, no identity is sent on the request. If no username is specified, the user ID of the calling component is used to obtain an MVS user ID.
String
Specifies the password for the username.
String
When running on a non-z/OS platform, specifies the username that is used to obtain the JNDI initial context on the remote system. The JNDI context is used to look up the OLA proxy EJB.
String
When running on a non-z/OS platform, specifies the password to be used with the RemoteJNDIUsername.
String
When running on a non-z/OS platform, specifies the security realm to use with the RemoteJNDIUsername.
Integer - 0
When using the CICS Link Server, specifies that the request and response data are to be in containers.
String
When using the CICS Link Server, specifies the Link task transaction ID.
String
When using the CICS Link Server, specifies the name of the request, or input container.
Integer - 1
When using the CICS Link Server, specifies the type of the request container (CHAR=0|BIT=1).
String
When using the CICS Link Server, specifies the name of the response, or output container.
Integer - 1
When using the CICS Link Server, specifies the type of the response container (CHAR=0|BIT=1).
Integer - 30
Length of time, specified in seconds, to wait for a matching client connection for the current Register name. The external address space must have already been registered. This timeout applies to the time to wait for an available service with the matching register name to become available.
The IMS OTMA client name, which is automatically generated, is 16 characters and cannot be set with the optimized local adapters resource adapter. For more information about using the optimized local adapters over IMS OTMA, see the topic, Enabling optimized local adapters over OTMA/IMS support.
The connection pool settings for the adapter define the number of logical connections defined in the WebSphere® Application Server connection pool. This is not the same as the number of physical connections between WebSphere Application Server and an external address space. A logical connection is essentially the Java EE Connector Architecture (JCA) view of a physical connection, in this case. Logical connections are used by WebSphere applications calling outbound to an external address space.
The connection pool settings for the adapter define the number of logical connections defined in the WebSphere Application Server connection pool. This is not the same as the number of physical connections between WebSphere Application Server and an external address space. A logical connection is essentially the JCA view of a physical connection, in this case.
The balance between physical and logical connections depends on how many concurrent WebSphere application threads should be able to get a connection (logical), and how many requests should be able to be sent or received at any given time to and from an external address space (physical). The maximum number of physical connections can be set to make sure that an external address space does not flood the Application Server with requests, as these are used for both inbound and outbound communication with the external address space. If an external address space attempts to register with WebSphere Application Server and specifies a number of connections that are the maximum physical connections supported for a server in this node, the register request rejects the register with a reason code that indicates the failure. The register can also fail if the maximum connections for the daemon group are exceeded. Remember that physical connections are requested by the client and are not the same as the logical connections handed out by the JCA adapter. When an outbound request is issued, the JCA logical connection is paired with a physical connection for the duration of the interaction.
After you create and save the connection factories, you can modify the resource references defined in various modules of the application and specify the Java Naming and Directory Interface (JNDI) names of the connection factories wherever appropriate.
The Maximum Segments connection level value can also be set using the setOTMAMaxSegments(nnn) method on the Connection Specification.
If you want to use the resource adapter high availability feature, you must configure additional connection pool properties on each connection factory. Refer to the topic, Enabling resource adapter high availability support, for more information on how to set up and use this feature.