Rational Developer for System z

Scoping of bundles

The BUNDLE resource definition provides the BASESCOPE attribute as a way of grouping together related BUNDLE resources. You can also use this attribute to set a Service Component Architecture (SCA) domain for a bundle that contains SCA composite applications.

You can deploy different application types as bundles in a CICS® region, including events and SCA composite applications. BASESCOPE is an optional attribute on the BUNDLE resource definition that you can use to group similar bundles together. You can use the IBM CICS Explorer to view all of the BUNDLE resources that are defined in a CICS region and order them by the value of the BASESCOPE attribute.

Scoping of bundles into SCA domains

The BASESCOPE attribute has a specific use for bundles that contain SCA composite applications. A composite application is deployed into an SCA domain. An SCA domain typically represents a set of services providing an area of business function that is controlled by a single organization; for example, the SCA domain for an accounts department in a business might cover all financial related functions and contain a series of composite applications dealing with specific areas of accounting.
In a CICS region, by default there is one SCA domain. Every bundle that is deployed into the CICS region has the same default SCA domain, although the value is empty. You can use the BASESCOPE attribute on the BUNDLE resource definition to set a value for the SCA domain.

You can also deploy the same bundle multiple times into the CICS region by specifying different SCA domains for the BASESCOPE attribute. CICS uses the SCA domain and the composite together to identify the service during runtime processing. The scope of the service is available to the task that is processing the request.

You are recommended to use a unique URI for the BASESCOPE attribute value; for example, http://mycompany/HR or http://mycompany/warehouse. CICS creates the names of services, composites, and references by extending the value of the BASESCOPE attribute; for example, installing a service with a local name of location/taxService into the HR SCA domain would create a scoped name of http://mycompany/HR/location/taxService.

Do not extend the same URI to create a new SCA domain. If you extend the same URI, you might get unexpected service or reference name clashes; for example, if you used http://mycompany/HR and http://mycompany/HR/location as different SCA domains and had a service with a local name of location/taxService and another service called taxService, installing these services into both the http://mycompany/HR and http://mycompany/HR/location SCA domains create clashes with the service names. Although you can install and enable BUNDLE resources successfully with these values, you might get unexpected results and errors when the services are called by other applications.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)