Transaction management

Two resource adapters are supplied.

cicseci.rar
This resource adapter provides LocalTransaction support when deployed on any supported J2EE application server. Local transactions are not supported when using WebSphere® Application Server for z/OS® with CICS® TG on z/OS in local mode, as the resource adapter provides global transaction support in conjunction with MVS® RRS.
cicseciXA.rar
This provides both XATransaction and LocalTransaction support when deployed on any supported J2EE application server connecting to a remote CICS TG for z/OS. It also provides global transaction support when using WebSphere Application Server for z/OS with a CICS TG on z/OS in local mode.
The cicseciXA.rar resource adapter should be used for two-phase commit functionality with IPIC. For one-phase commit functionality the cicseciXA.rar resource adapter can be used, however performance might be improved by using cicseci.rar resource adapter.

In order to provide for different transactional qualities of service for J2EE applications, it is possible to deploy both CICS resource adapters into the same J2EE application server. When multiple resource adapters are used in the same J2EE application server, they must all be at the same version.

See CICS Transaction Gateway: z/OS Administration for information about installing the resource adapters. See the Migration section for support for resource adapters.

When carrying out multiple interactions with CICS using the ECI resource adapter you might wish to group all actions together to ensure that they either all succeed or all fail. The preferred way is to let the J2EE application server manage this; such transactions are known as container-managed transactions. However, to do this yourself use the LocalTransaction or UserTransaction interface. Such transactions are known as bean-managed transactions. Bean-managed transactions that use the LocalTransaction interface can group work performed only through the resource adapter; the UserTransaction interface allows all transactional resources within the application to be grouped.
cicseciXA.rar with bean-managed transactions
Supports the UserTransaction and LocalTransaction interfaces.
cicseci.rar with bean-managed transactions
Supports the LocalTransaction interface.