PH41693: CICS CONFIGURATION MANAGER BATCH PROGRAM CCVBMAIN IS ENHANCED TO PROVIDE PACKAGE COMMAND ADD/REMOVE RESOURCE TO CHANGE PACKAGE.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The CICS Configuration Manager batch utility program CCVBMAIN
  is enhanced to provide a PACKAGE command to add or remove
  resources for a change package.
  The CCVBMAIN batch utility now supports:
  
  
    - the PACKAGE control statement to identify the change package
  for updating, and the CICS Configuration associated with the
  
      resources.
    - ADD directives for adding resources to the package
  
  
    - REMOVE directives for removing resources from the package
  
  
  
  New SCCVSAMP sample CCVXBTCH describes the CCVBMAIN utility
  JCL statements and control cards, including PACKAGE, ADD and
  REMOVE. Syntax diagrams, parameter descriptions, examples, and
  full documentation are provided in sample CCVXBTCH.
  
  
  
  Examples below illustrate the packaging control statements:
  
  
   1.  Update change package PACKAGE1 to add two sets of resources
  from CICS Configuration DEVTCSD.  From group FINANCE, all
  
       programs are added.  From group FINADMIN only TRANSACTION
  FIN9 is added.
  
          PACKAGE RESOURCE CPID=PACKAGE1,CONFIG=DEVTCSD
  
  
              ADD GROUP=FINANCE,TYPE=PROGRAM,NAME=*
  
  
              ADD GROUP=FINADMIN,TYPE=TRANSACTION,NAME=FIN9
  
  
   2.  Update change package 00025374 to add resources from
  CONTEXT2, a CICSPlex SM context.  From groups named like FIN*,
  all
  
        resources created or updated on/after a DATE of today
  minus 7 days (i.e. in the past week) will be added to the
  package.  For
  
         type PERIODEF, the MORNING resource definition will be
  added.
  
           PACKAGE RESOURCE CPID=00025374,CONFIG=CONTEXT2
  
              ADD GROUP=FIN*,TYPE=*,NAME=*,DATE=TODAY-7
  
  
              ADD GROUP=*,TYPE=PERIODEF,NAME=MORNING
  
  
   3.  Remove all resources and commands from change package
  00025374, regardless of the associated CICS Configuration.
  
         However, LIMIT the request to 500 resources/commands.  If
  the LIMIT is exceeded, then the change package is not updated.
  
  
         If omitted, the default LIMIT is 10,000.
  
  
          PACKAGE ALL CPID=00025374,CONFIG=*,LIMIT=500
  
  
            REMOVE GROUP=*,TYPE=*,NAME=*
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS Configuration Manager.     *
  ****************************************************************
  * PROBLEM DESCRIPTION: The batch utility program CCVBMAIN is   *
  *                      enhanced to provide a PACKAGE command   *
  *                      to add or remove resources for a change *
  *                      package.                                *
  ****************************************************************
  The CCVBMAIN batch utility now supports:
  
    - the PACKAGE control statement to identify the change package
      for updating, and the CICS Configuration associated with the
      resources.
  
    - ADD directives for adding resources to the package
  
    - REMOVE directives for removing resources from the package
  
  New SCCVSAMP sample CCVXBTCH describes the CCVBMAIN utility JCL
  statements and control cards, including PACKAGE, ADD and REMOVE.
  Syntax diagrams, parameter descriptions, examples, and full
  documentation are provided in sample CCVXBTCH.
  
  Examples below illustrate the packaging control statements:
  
    1. Update change package PACKAGE1 to add two sets of resources
       from CICS Configuration DEVTCSD.  From group FINANCE, all
       programs are added.  From group FINADMIN only TRANSACTION
       FIN9 is added.
  
          PACKAGE RESOURCE CPID=PACKAGE1,CONFIG=DEVTCSD
              ADD GROUP=FINANCE,TYPE=PROGRAM,NAME=*
              ADD GROUP=FINADMIN,TYPE=TRANSACTION,NAME=FIN9
  
    2. Update change package 00025374 to add resources from
       CONTEXT2, a CICSPlex SM context.  From groups named like
       FIN*, all resources created or updated on/after a DATE of
       today minus 7 days (i.e. in the past week) will be added to
       the package. For type PERIODEF, the MORNING resource
       definition will be added.
  
          PACKAGE RESOURCE CPID=00025374,CONFIG=CONTEXT2
              ADD GROUP=FIN*,TYPE=*,NAME=*,DATE=TODAY-7
              ADD GROUP=*,TYPE=PERIODEF,NAME=MORNING
  
    3. Remove all resources and commands from change package
       00025374, regardless of the associated CICS Configuration.
       However, LIMIT the request to 500 resources/commands.  If
       the LIMIT is exceeded, then the change package is not
       updated.  If omitted, the default LIMIT is 10,000.
  
          PACKAGE ALL CPID=00025374,CONFIG=*,LIMIT=500
           REMOVE GROUP=*,TYPE=*,NAME=*
  

Problem conclusion

• The CCVBMAIN batch utility now supports the packaging of
  resources into a change package.
  

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:

  UI78621 UI78622 UI78623

Modules/Macros

• CCV$$$$$ CCVALIST CCVBHKP  CCVBMAIN CCVHATNN CCVHTRNN CCVOADMN
  CCVOPRIM CCVPAXFE CCVPCDF2 CCVRC010 CCVRC024 CCVSMCPS CCVSMSGE
  CCVSRCSD CCVTC550 CCVTC560 CCVXBTCH
  

Fix information

• Fixed component name

  CICS CONFIG MGR

• Fixed component ID

  5697CIC00

Applicable component levels

• R540 PSY UI78621

     UP21/12/23 P F112  

• R54E PSY UI78622

     UP21/12/23 P F112  

• R54K PSY UI78623

     UP21/12/23 P F112  

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.