In addition to using CICS® Configuration Manager to work with resource definitions stored in CSD files or CICSPlex® SM contexts, you can also work with "in-memory" resource definitions in active CICS regions, by performing discard, install, newcopy, or phase-in actions:
You can instruct CICS Configuration Manager to "quiesce" the resource before discarding. This sets the resource to a status that allows its definition to be discarded (for example: disabled, closed, or out of service). The particular status depends on the resource type.
You cannot use CICS Configuration Manager to discard resource definitions that are:
You can only use CICS Configuration Manager to discard the resource definitions that exist in the CSD file used by the CICS region.
For CSD-based resource definitions, you can optionally instruct CICS Configuration Manager to do either (or both) of the following before installing:
For context-based resource definitions, you can optionally force the installation. For details, see the CICSPlex SM documentation.
However, if the existing resource is currently in use, then the newcopy action is not performed.
Any copies of the program in use remain until they are no longer in use, but all requests that occur after the refresh use the new copy.
CICS Configuration Manager presents "phase-in" as an option of its newcopy action; to perform a phase-in, you perform a newcopy action "with the phase-in option selected".
You can already perform these actions within CICS without using CICS Configuration Manager. However, CICS Configuration Manager offers additional flexibility:
To perform these actions on CICS regions managed by CICSPlex SM, the CICS Configuration Manager server uses a CICSPlex SM API command. For CSD-based CICS regions, the server calls the CICS Configuration Manager agent, which requires some extra setup. Table 1 describes the actions supported by CICS Configuration Manager and the underlying method that CICS Configuration Manager uses to perform them.
Action | How the CICS Configuration Manager server performs the action | |||
---|---|---|---|---|
For CSD-based CICS regions | For CICS regions managed by CICSPlex SM | |||
Use agent to invoke… | More information | Call CICSPlex SM API command… | More information | |
Install | CEDA INSTALL | CICS Transaction Server for z/OS®: CICS Supplied Transactions | PERFORM OBJECT… ACTION(action) | CICS Transaction Server for z/OS: CICSPlex SM Application Programming Reference |
Discard (see note) | CICS EXEC DISCARD | CICS Transaction Server for z/OS: CICS System Programming Reference | ||
Newcopy | CICS EXEC SET PROGRAM … NEWCOPY ![]() ![]() |
|||
Phase-in | CICS EXEC SET PROGRAM … PHASEIN |