The DEPLOY BUNDLE command

Define a CICS® bundle resource and change its state to DISABLED, ENABLED, or AVAILABLE in a CICS system or group of CICS systems.

Read syntax diagramSkip visual syntax diagramDEPLOY BUNDLE( data-value)BUNDLEDIR( data-value)SCOPE( data-value)STATE(DISABLED)STATE(ENABLED)STATE(AVAILABLE)TIMEOUT( 300)TIMEOUT( data-value)CSDGROUP( data-value)RESGROUP( data-value)DESCRIPTION( text)

Options

BUNDLE(data-value)
Specifies the name of the CICS bundle (up to 8 characters) to deploy.
BUNDLEDIR(data-value)
Specifies the location of the CICS bundle (up to 255 characters) on zFS.
CSDGROUP(data-value)
Specifies the CSD group (8 characters) to add the bundle resource to. The bundle resource is defined in the CSD of each CICS system that is specified by the SCOPE option. If CSDGROUP is not specified, the bundle is defined in BAS during the deployment and then removed. CSDGROUP and RESGROUP are mutually exclusive.
Note: In cases where SCOPE specifies a group of CICS regions from more than one sysplex, and the CSDs of those CICS regions use the same data set names, the bundle definition is created only on the CSD of the sysplex where the DFHDPLOY utility is running.
DESCRIPTION(text)
An optional value that specifies a description of the bundle definition (up to 58 characters).
RESGROUP(data-value)
Specifies the BAS resource group (8 characters) to add the bundle resource to. The bundle resource is defined in BAS. If RESGROUP is not specified, the bundle is defined in BAS during the deployment action and then removed. RESGROUP and CSDGROUP are mutually exclusive.
SCOPE(data-value)
Specifies the name of the CICS System, or CICS System Group (up to 8 characters) in which to install the CICS bundle.
STATE(DISABLED | ENABLED | AVAILABLE)
Specifies the target state of the bundle. The following options are valid:
  • DISABLED: Creates the bundle definition, installs the definition, then changes the bundle state to disabled and unavailable.
  • ENABLED: Creates the bundle definition, installs the definition, then changes the bundle state to enabled and unavailable.
  • AVAILABLE: Creates the bundle definition, installs the definition, then changes the bundle state to enabled and available.
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 DFHDPLOY - Timeout.

Installing bundles automatically during a COLD start

You can configure your CICS bundles to be installed automatically when a CICS system initializes:
  • For a CSD group, add the group to a list using the DFHCSDUP ADD command, then specify the list on the GRPLIST system initialization parameter.
  • For a BAS resource group, associate the RESGROUP with a RESDESC object. For more information, see Installing resources automatically in BAS.

Example usage

This example connects to MYPLEX, removes the existing bundle WEBSITE if it exists, and deploys a new bundle WEBSITE to an enabled state:
//DFHDPLOY JOB
                CLASS=A,MSGCLASS=A,NOTIFY=&SYSUID //* //DFHDPLOY EXEC PGM=DFHDPLOY //* //STEPLIB
                DD DISP=SHR,DSN=CICSTS53.CICS.SDFHLOAD
                // DD DISP=SHR,DSN=CICSTS53.CPSM.SEYUAUTH
                //SYSTSPRT DD SYSOUT=* //SYSIN DD * SET CICSPLEX(MYPLEX); * UNDEPLOY BUNDLE(WEBSITE)
                CSDGROUP(BANKING) SCOPE(SYS1) STATE(DISCARDED); * DEPLOY BUNDLE(WEBSITE)
                BUNDLEDIR(/var/cicsts/bundles/Website_1.0.0/) CSDGROUP(BANKING) SCOPE(SYS1)
                STATE(ENABLED) TIMEOUT(60); /*