Using the sample utility programs to manage and acquire a connection factory

CICS® supplies three sample programs that illustrate how to:
  1. Publish a connection factory to a JNDI namespace (the CICSConnectionFactoryPublish sample). You can use the sample to create a ConnectionFactory object suitable for use with the CCI Connector for CICS TS, and to publish it to the JNDI namespace used by the local CICS region. An enterprise bean or Java™ program, running on CICS, can then perform a JNDI lookup to obtain a reference to the connection factory.

    This sample is described in Publishing a connection factory using CICSConnectionFactoryPublish.

  2. Retract a previously-published connection factory from the JNDI namespace (the CICSConnectionFactoryRetract sample). This sample is described in Retracting a connection factory using CICSConnectionFactoryRetract.
  3. Look up a connection factory in the JNDI namespace (the CCI Connector sample application). This sample also shows you how to use the CCI Connector for CICS TS to call a CICS server program. It is described in The CCI Connector sample application.

Using the CICSConnectionFactoryPublish and CICSConnectionFactoryRetract samples, you can create, publish, and manage a connection factory separately from the applications that use it.

To use the sample programs, you need a suitably configured name server. If you need to configure a name server, see Enabling JNDI references and Specifying the location of the JNDI name server.