SET BUNDLE

Use the SET BUNDLE command to change the status of an installed BUNDLE resource, which represents a CICS® bundle.

SET BUNDLE

Read syntax diagramSkip visual syntax diagramSET BUNDLE( data-value)AVAILSTATUS( cvda)AVAILABLEUNAVAILABLEENABLESTATUS( cvda)ENABLEDDISABLED

Conditions: INVREQ, NOTAUTH, NOTFND

This command is threadsafe.

Description

Use the SET BUNDLE command 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.

Start of changeA 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.
End of change
Start of changeBefore 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.
End of change

Start of changeYou 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.End of change

Options

Start of changeAVAILSTATUS(cvda)End of change
Start of change Changes the status of the BUNDLE resource that represents the CICS bundle:
AVAILABLE
CICS gives callers access to the resources identified in the CICS bundle as application entry points, so that they can access all the resources in the CICS bundle.
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.
End of change
ENABLESTATUS(cvda)
Changes the status of the BUNDLE resource that represents the CICS bundle:
ENABLED
Start of changeCICS tries to enable the BUNDLE resource, and to enable the resources that have been dynamically created for the CICS bundle in the CICS region.End of change
DISABLED
Start of changeCICS tries to disable the resources that have been dynamically created for the CICS bundle in the CICS region, and to disable the BUNDLE resource.End of change

Conditions

INVREQ
RESP2 values:
4
An invalid CVDA value was specified for ENABLESTATUS.
6
An attempt was made to enable or disable a BUNDLE resource that is in an invalid state.
7
CICS failed to link to the registered bundle callback program.
9
The BUNDLE resource cannot be enabled.
Start of change10End of change
Start of changeAn attempt was made to set the availability of a BUNDLE resource that contains no application entry points.End of change
Start of change11End of change
Start of changeAn attempt to make the BUNDLE resource available failed because the bundle is not enabled.End of change
Start of change12End of change
Start of changeThe BUNDLE resource failed to set the availability of the bundle.End of change
Start of change13End of change
Start of changeAn attempt to disable the BUNDLE resource failed because the bundle is not unavailable.End of change
Start of change14End of change
Start of changeAn invalid CVDA value was specified for AVAILSTATUS.End of change
Start of change15End of change
Start of changeBoth ENABLESTATUS and AVAILSTATUS were specified on the command.End of change
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
101
The user associated with the issuing task is not authorized to access this particular resource in the way required by this command.
NOTFND
RESP2 values:
3
The BUNDLE was not found.