Actions on active CICS regions

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:

Discard
Discards resource definitions from an active CSD-based CICS region.

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:

  • Managed by CICSPlex SM.
  • Dynamically defined. For example:
    • Model terminal definitions for autoinstall (AUTINSTMODEL definitions)
    • Terminal definitions dynamically defined from session definitions.
    • Autoinstalled program definitions

    You can only use CICS Configuration Manager to discard the resource definitions that exist in the CSD file used by the CICS region.

Install
Installs resource definitions from a CSD file or a CICSPlex SM data repository into an active CICS region.

For CSD-based resource definitions, you can optionally instruct CICS Configuration Manager to do either (or both) of the following before installing:

  • Quiesce the resource by setting it to a status that allows its definition to be installed or discarded. If you do not specify this quiesce option, and the resource status prevents the install, then the install action for that resource definition will fail.
  • Discard the resource. This is done after the "quiesce". If you specify the discard option, but not the quiesce option, and the resource status prevents the discard, then the "pre-install" discard action will fail, and the install will not be attempted.

For context-based resource definitions, you can optionally force the installation. For details, see the CICSPlex SM documentation.

Newcopy
Makes a new version of a program or a document template resource available to an active CICS region.

However, if the existing resource is currently in use, then the newcopy action is not performed.

Phase-in
Similar to newcopy: makes a new version of a program available to an active CICS region.

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.

Table 1. Actions that CICS Configuration Manager can perform on active CICS regions
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 (or SET DOCTEMPLATE)
Phase-in CICS EXEC SET PROGRAM … PHASEIN
Note: Discard is not supported for CICS regions whose resource definitions are managed by CICSPlex SM.

Information Information

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///ccv-actions.htm