The UNDEPLOY BUNDLE command

Change a CICS® bundle resource to a specified target state of UNAVAILBLE, DISABLED, or DISCARDED in a CICS system or a group of CICS systems.

Note: If you specify CSDGROUP or RESGROUP when you deploy a bundle, but do not specify the same option again when you undeploy the bundle, the bundle definition is not removed and remains linked to the CSD group or BAS resource group. DFHDPLOY does not support the installation of a bundle defined by an existing resource definition.
Read syntax diagramSkip visual syntax diagramUNDEPLOY BUNDLE( data-value)SCOPE( data-value)STATE(UNAVAILABLE)STATE(DISABLED)STATE(DISCARDED)TIMEOUT( 300)TIMEOUT( data-value)CSDGROUP( data-value)RESGROUP( data-value)

Options

BUNDLE(data-value)
Specifies the name of the CICS bundle (up to 8 characters) to undeploy.
CSDGROUP(data-value)
Optionally specifies which CSD group to remove the bundle definition from. If it is not specified, the bundle definition is not removed from the CSD. CSDGROUP and RESGROUP are mutually exclusive.
RESGROUP(data-value)
Optionally specifies which BAS resource group to remove the bundle definition from. If it is not specified, the bundle definition is not removed from the data repository. RESGROUP and CSDGROUP are mutually exclusive.
SCOPE(data-value)
Specifies the name of the CICS System, or CICS System Group (up to 8 characters) that the CICS bundle is removed from.
STATE(UNAVAILABLE | DISABLED | DISCARDED)
Specifies the target state of the bundle. The following options are valid:
  • UNAVAILABLE: Makes the bundle unavailable.
  • DISABLED: Makes the bundle unavailable and then disabled.
  • DISCARDED: Makes the bundle unavailable, then disabled, and then discards the bundle run time object and removes the definition.
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.

Example

This example connects to MYPLEX and undeploys bundle BUND1 to a disabled state:
//DFHDPLY1 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(BUND1)
                SCOPE(AOR1) STATE(DISABLED) TIMEOUT(10) CSDGROUP(MYCSDGRP); /*