Transaction management

CICS® Transaction Gateway includes a resource adapter that can provide LocalTransaction support or XATransaction support.

The cicseci.rar resource adapter provides LocalTransaction support when deployed on any supported JEE application server. It can also provide XATransaction support when deployed with the custom property xasupport=on on any supported JEE application server using local mode to connect to CICS Transaction Server using the IPIC protocol.

To provide for different transactional qualities of service for JEE applications, you can deploy the CICS resource adapter into the JEE application server and create multiple connection factories on it. Each of these connection factories can be configured with a different quality of service.

See Deploying CICS resource adapters for information about installing the resource adapters.

Managed mode

If you are running multiple interactions with CICS using the ECI resource adapter, you might want to group all actions together to ensure that they either all succeed or all fail. The preferred method is to let the JEE application server manage the transactions which are then known as container-managed transactions.

Alternatively, you can 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 in the application to be grouped. The cicseci.rar resource adapter with xasupport enabled and with bean-managed transactions supports the UserTransaction and LocalTransaction interfaces.

The cicseci.rar resource adapter with xasupport disabled and bean-managed transactions supports only the LocalTransaction interface.

For more information on container-managed transactions and bean-managed transactions, see The Java EE 6 Tutorial.

Nonmanaged mode

When the ECI resource adapter is used in nonmanaged mode, interactions with CICS will be non-transactional by default (synconreturn). Only the LocalTransaction interface is available for applications using nonmanaged mode, and any global transaction context, such as provided by the UserTransaction interface, will be ignored by the ECI resource adapter.

Samples

JEE ECI sample programs are provided in the <install_path>\samples subdirectory and as a deployable EAR file in the <install_path>\deployable subdirectory.

For more information, see Resource adapter samples.