PH44746: CFG MGR TO OPTIONALLY DISCARD CHANGE PACKAGE DELETION RESOURCES WHEN PROCESSING INSTALL OR DISCARD API COMMAND REQUESTS

APAR status

• Closed as new function.

Error description

• Change packages may contain commands to delete resources. These
  are the resources marked for deletion.
  
  The enhancement provides a user selectable option to include for
  CICS region discard processing the change package deletion
  resources as follows:
  
   1. The discarding option can be specified:
   - in batch, via a parameter for the CCVBMAIN utility INSTALL
   or DISCARD control statements
  
   - in TSO/ISPF online, via a parameter in the options pop-up
   for the change package INSTALL or DISCARD requests.
   2. Only deletion resources matching target CICS Configurations
   within the Scheme are processed. Deletion resources for other
   CICS Configurations are ignored from selection and discard
   processing.
   3. The processing is limited to CSD based CICS Configurations.
   For CICSPlex SM context based CICS Configurations, the option
   is ignored.
   4. The change package deletion resource may or may not exist
   within the target CICS Configurations:
  
   - If the MIGRATE has run, the CSD resource may be deleted.
  
   - If the MIGRATE has not run; or the CSD resource has
   been recovered, backed out or redefined, then the deletion
   resource may exist within the CSD.
  
   Regardless of the delete resource's existent within the target
   CICS Configurations, they are selected for discard processing.
  
   5. For INSTALL,the discard of deletion resources only occurs if
   the "Discard resources before Install" option is also selected.
  
   6. For INSTALL, the deletion resources are only discarded.
   They are ignored for install processing.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS Configuration Manager.     *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS Configuration Manager is enhanced  *
  *                      to optionally discard change package    *
  *                      deletion resources when processing      *
  *                      INSTALL or DISCARD API command          *
  *                      requests.                               *
  ****************************************************************
  Change packages may contain commands to delete resources. These
  are the resources marked for deletion.
  
  The enhancement provides a user selectable option to include for
  CICS region discard processing the change package deletion
  resources as follows:
  
     1. The discarding option can be specified:
  
          - in batch, via a parameter for the CCVBMAIN utility
            INSTALL or DISCARD control statements
  
          - in TSO/ISPF online, via a parameter in the options
            pop-up for the change package INSTALL or DISCARD
            requests.
  
     2. Only deletion resources matching target CICS
        Configurations within the Scheme are processed. Deletion
        resources for other CICS Configurations are ignored from
        selection and discard processing.
  
     3. The processing is limited to CSD based CICS
        Configurations. For CICSPlex SM context based CICS
        Configurations, the option is ignored.
  
     4. The change package deletion resource may or may not exist
        within the target CICS Configurations:
  
          - If the MIGRATE has run, the CSD resource may be
            deleted.
  
          - If the MIGRATE has not run; or the CSD resource has
            been recovered, backed out or redefined, then the
            deletion resource may exist within the CSD.
  
        Regardless of the delete resource's existence within the
        target CICS Configurations, they are selected for discard
        processing.
  
     5. For INSTALL, the discard of deletion resources only occurs
        if the "Discard resources before Install" option is also
        selected.
  
     6. For INSTALL, the deletion resources are only discarded.
        They are ignored for install processing.
  

Problem conclusion

• CICS Configuration Manager is enhanced.  An option may be set
  via the TSO/ISPF online dialog or CCVBMAIN batch utility control
  cards to include for discard processing change package resources
  associated with CSDs matching the target CICS Configuration in
  the Scheme.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI80675 UI80676 UI80677

Modules/Macros

• CCVADISC CCVAINST CCVBMAIN CCVDEFLT CCVE52   CCVHCODE CCVHDSCD
  CCVI10   CCVJ0002 CCVJPKGI CCVL24   CCVOADMN CCVOPRIM CCVP0007
  CCVP0011 CCVP0015 CCVP0047 CCVP0048 CCVP0049 CCVSMSGE CCVSMSGK
  CCVXBTCH
  

Fix information

• Fixed component name

  CICS CONFIG MGR

• Fixed component ID

  5697CIC00

Applicable component levels