The bundle registration interface

Use the bundle registration interface to register a program as the owner of a resource type that is deployed in an application bundle. The program is responsible for managing the life cycle of any resources of a particular type that are installed in a CICS® region as part of a bundle deployment.

A bundle is the unit of deployment for an application. A bundle is defined and installed in a CICS region using the BUNDLE resource. The bundle contains a manifest that describes all of the resources that the application requires as universal resource identifiers (URIs). These resources can be typical CICS RDO resources, artifacts that exist on zFS, or user resources.

To define your own user resources in a bundle, write a callback program to handle the management of the user resources when the bundle deploys into the CICS region. CICS provides a registration interface to register the callback program as the owner of a user resource type. The registration interface is channel-based and provides containers that your registration program must populate.

When a bundle contains a resource type that the callback program is responsible for handling, CICS calls the program to create the resource using a channel-based callback interface.

All the resources associated with the bundle are managed together; for example, when you disable a BUNDLE resource, all the associated resources are also disabled. Your callback program can opt into this life-cycle support if appropriate for the user resource.