Creating user resource types in bundles

The resource types that are supported in a bundle are extensible, so you can provide your own resource types if required. To support your new resource type in CICS®, you must write a program to handle the creation and life cycle of the resource type when the bundle is deployed to CICS.

Before you begin

Before you deploy the bundle to CICS, ensure that the bundle manifest that defines your resource type conforms to the bundle manifest schema.

About this task

CICS provides two interfaces that are channel-based. The first interface registers a program as the manager of a user resource. The second interface is similar to the callbacks between CICS domains. CICS uses the callback interface to pass details of a resource that must be created to the registered program when a BUNDLE resource is installed.

Procedure

  1. Write a program to register a callback program as the manager of a resource type in a CICS region.
    CICS uses this program when the region starts up to recover the resource type in the bundle.
  2. Write a callback program to handle the management of the resource type.
    CICS calls this program using a callback interface when a bundle that contains the resource type is deployed.
  3. Create and install PROGRAM resource definitions for the two programs.
    The program that uses the registration interface must be available during PLTPI processing.

What to do next

Test that a bundle containing your resource type can successfully be deployed into CICS and that an enabled BUNDLE resource can be recovered on a CICS restart.