The SET BUNDLE command

Change the state of an installed bundle to the specified target state, in a CICS® system or group of CICS systems. For example, the SET BUNDLE command can, within a specified SCOPE, change the state of a bundle to DISABLED from any other state. Use this command with the PHASEIN option to phase in a higher version of an OSGi bundle without disrupting active tasks.

Read syntax diagramSkip visual syntax diagramSET BUNDLE( data-value)SCOPE( data-value)STATE(AVAILABLE)STATE(UNAVAILABLE)STATE(ENABLED)STATE(DISABLED)PHASEINTIMEOUT( 300)TIMEOUT( data-value)

Options

BUNDLE (data-value)
Specifies the name of the bundle (up to 8 characters) to change state.
PHASEIN
Determines the highest semantic version of all OSGi bundles in the bundle's root directory and registers that version with the OSGi framework, if not already registered. Previously registered versions are removed from the OSGi framework. The new version is used for all subsequent requests, but any active tasks continue to use the old version until the task completes. The bundle must be in an ENABLED state, or the phase-in operation fails.

PHASEIN and STATE options are mutually exclusive.

Note: The PHASEIN option is valid only for CICS TS V5.3 or later.
SCOPE (data-value)
Specifies the CICS System, or CICS System Group (up to 8 characters) where the bundle is installed.
STATE ( AVAILABLE | UNAVAILABLE | ENABLED | DISABLED)
Specifies the target state of the bundle. The following options are valid:
AVAILABLE
Enables the bundle, and then makes it available.
UNAVAILABLE
Makes the bundle unavailable.
ENABLED
Enables the bundle.
DISABLED
Makes the bundle unavailable, and then disables it.
STATE and PHASEIN options are mutually exclusive.
TIMEOUT ( 300 | data-value)
An optional numerical value that specifies the maximum amount of time in seconds (1 - 1800 inclusive) for the command to complete. For more information about how to choose an appropriate TIMEOUT value, see Troubleshooting the DFHDPLOY utility.

For more information about CICS processing of the SET BUNDLE command, see SET BUNDLE.

Example

The following example connects to MYPLEX and sets the state of BUND1 to ENABLED: 

//DFHDPLY1 JOB CLASS=A,MSGCLASS=A,NOTIFY=&SYSUID
//*
//DFHDPLOY EXEC PGM=DFHDPLOY
//*
//STEPLIB  DD DISP=SHR,DSN=CICSTS55.CICS.SDFHLOAD
//         DD DISP=SHR,DSN=CICSTS55.CPSM.SEYUAUTH
//SYSTSPRT DD SYSOUT=*
//SYSIN    DD *
SET CICSPLEX(MYPLEX);
*
SET BUNDLE(BUND1) SCOPE(AOR1) STATE(ENABLED) TIMEOUT(10);
/*