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.
>>-UNDEPLOY BUNDLE(data-value)--SCOPE(data-value)---------------> .-TIMEOUT(300)--------. >--+-STATE(UNAVAILABLE)-+--+---------------------+--------------> +-STATE(DISABLED)----+ '-TIMEOUT(data-value)-' '-STATE(DISCARDED)---' >--+----------------------+------------------------------------>< +-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 the DFHDPLOY utility.
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=
CICSTS54.CICS
.SDFHLOAD
// DD DISP=SHR,DSN=
CICSTS54.CPSM
.SEYUAUTH
//SYSTSPRT DD SYSOUT=*
//SYSIN DD *
SET CICSPLEX(MYPLEX);
*
UNDEPLOY BUNDLE(BUND1) SCOPE(AOR1)
STATE(DISABLED) TIMEOUT(10) CSDGROUP(MYCSDGRP);
/*
