CEMT SET BUNDLE

Description

Use CEMT SET BUNDLE to change the status of standalone CICS bundles.

The SET BUNDLE command does operate on a CICS bundle that was installed for an application in a single CICS region, but it is not intended for normal management of CICS bundles for applications. For CICS bundles that are installed as part of an application deployed on a platform, in CICS Explorer®, use the Cloud Explorer view in the CICS Cloud perspective to work with the application. Actions that you perform on the application are applied to all the CICS bundles for the application. If you need to troubleshoot the status of an individual CICS bundle for the application, you can also use CICS Explorer to investigate problems with the individual bundles across multiple CICS regions.

A successfully installed CICS bundle can be in an enabled or disabled state, and also in an available or unavailable state, in the CICS regions where it is installed. If the CICS bundle is in a disabled state or in an unavailable state, the resources for the CICS bundle have been dynamically created, but they cannot yet be used.

• For a CICS bundle that declares application entry points, you must first enable the bundle, then make it available, to give users access to the resources. When you make the bundle available, CICS gives callers access to the application entry points, which enables them to access all the resources in the CICS bundle.
• For a CICS bundle that does not declare application entry points, you only need to enable the bundle. Resources that are not controlled by application entry points are available to users as soon as they are enabled.

Before you uninstall a CICS bundle, you must remove users' access to it and disable it. You can then discard the BUNDLE resource for a standalone CICS bundle, or uninstall the application for which the CICS bundle was installed.

• For a CICS bundle that declares application entry points, you must first make the bundle unavailable, then disable it.
• For a CICS bundle that does not declare application entry points, you do not need to make the bundle unavailable. You only need to disable it.

You must issue separate SET BUNDLE commands to specify ENABLESTATUS and AVAILSTATUS. CICS must complete each operation separately to ensure the integrity of the state of the CICS bundle.

Syntax

• Type CEMT SET BUNDLE followed by one or more BUNDLE identifiers or ALL. CEMT displays a list of BUNDLE resources and the current status of each resource. You can then tab to the highlighted or blank fields and overtype them with the required values.
• Type CEMT SET BUNDLE followed by one or more BUNDLE identifiers or ALL, followed by the attribute setting that you want to change.

Typing ? at the beginning of either the first or second line gives a syntax prompt. Resetting the values takes effect immediately.

Options

ALL

Apply any changes to all of the specified resources that you are authorized to access.

AVAILABLE

Make one or more BUNDLE resources available. CICS gives callers access to the resources identified in the CICS bundle as application entry points.

DISABLED

Disable one or more BUNDLE resources. CICS tries to disable the resources that have been dynamically created for the CICS bundle in the CICS region, and to disable the BUNDLE resource.

ENABLED

Enable one or more BUNDLE resources. CICS tries to enable the BUNDLE resource, and to enable the resources that have been dynamically created for the CICS bundle in the CICS region. You can enable a BUNDLE resource that is in any state except DISABLING or DISCARDING.

UNAVAILABLE

Make one or more BUNDLE resources unavailable. CICS removes access to the resources identified in the CICS bundle as application entry points, so callers cannot access any of the private resources in the CICS bundle.

value

Specify the 1-8 character name of the BUNDLE resource definition.