DISCARD BUNDLE
Remove a BUNDLE definition.
Description
Use the DISCARD BUNDLE command
to permanently remove a bundle resource definition from the CSD or
data repository. Before discarding a CICS® bundle,
you must do the following:
- Disable the bundle. This is required because the DISCARD BUNDLE command does not itself attempt to disable associated CICS bundles before attempting to discard them.
- Ensure that all resources that were dynamically created when the CICS bundle was originally deployed are disabled. You can use the INQUIRE BUNDLEPART command to browse the resources that are contained in an installed BUNDLE resource. If all the resources have the status DISABLED or UNUSABLE, the bundle can be discarded.
A CICS bundle that was installed by a platform or application cannot be discarded independently. To remove a bundle that was installed by a platform, use the CICS Explorer® to remove the bundle from the region type in the platform. To remove a bundle that was installed by an application, disable and discard the application, and the bundle is removed automatically.
For more information about discarding, see Discarding resource definitions.
Options
- BUNDLE(data-value)
- Specifies the 8-character name of the BUNDLE resource definition that is to be discarded.
Conditions
- INVREQ
- RESP2 values:
- 5
- The bundle is not disabled.
- 6
- The bundle is in an invalid state (the bundle may contain resources which are ENABLED). You must disable the bundle before it can be discarded.
- 7
- CICS failed to link to the registered bundle callback program.
- 8
- Discard not allowed. The bundle is part of an installed platform or application.
- 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 cannot be found.