Mass Update of Personal CICS System Definitions

Suppose that, some time ago, you created CICS® System Definitions in CICS PA, and specified their CICS VRM as 630 (CICS Transaction Server Version 2.3), matching the current system environment at the time. Perhaps you also specified version-specific data set names for the MCT and SDFHLOAD libraries. Now you have upgraded to a later version of CICS TS, and you want to upgrade your CICS System Definitions in CICS PA to match this change in your system environment. Rather than selecting and then editing each CICS System Definition individually, you can upgrade several (or all of them) together.

  1. On the list panel of System Definitions:
    • Type line action U next to each of the CICS System Definitions that you want to upgrade together, and then press Enter.

      or

    • On the command line, enter: S prefix* U

      where prefix matches the leading characters of the names of the CICS System Definitions that you want to upgrade together. To select all CICS System Definitions, omit the prefix: enter S * U

      This command inserts line action U next to every selected CICS System Definition, including any above or below the current view of the list panel. If you want to upgrade all of the selected CICS System Definitions together, press Enter. Otherwise, selectively remove the line action U from the System Definitions that you do not want to upgrade, and then press Enter. (As described below in a later step, even if you select all CICS System Definitions, the upgrade only affects those CICS System Definitions that match the particular existing "from" values that you specify.)

    Note: You can only enter line action U next to System Definitions of type CICS.

    The Mass Update CICS Systems panel appears:

    Figure 1. System Definitions: Mass Update CICS Systems
       File  Options  Help                                                          
     ------------------------------------------------------------------------------ 
                                Mass Update CICS Systems                            
     Command ===> _________________________________________________________________ 
     
     Execution option  . . 1  1. Report only
                              2. Perform update and report
                              3. Populate From and To with first system details
     Definition changes:
     MVS Image          From . . _______   To . . _______                           
     
     Description        From . . ____________________________________               
                        To . . . ____________________________________               
     
     CICS Version (VRM) From . . ___       To . . ___  +                            
     
     MCT Suffix         From . . __        To . . __                                
     
     MCT Load Library   From . . ______________________________________________     
                        To . . . ______________________________________________     
     
     SDFHLOAD Library   From . . ______________________________________________     
                        To . . . ______________________________________________     
     
     Dictionary DSN     From . . ______________________________________________     
                        To . . . ______________________________________________     
     Update options:                                                               
     _  Update CICS VRM based on SDFHLOAD
     _  Populate dictionary data set with new dictionary record
     _  Auto save after successful update
  2. In the "From" fields, enter the old values that you want to upgrade. In the matching "To" fields, enter the new values.

    The CICS VRM "From" field can specify any CICS version; however, the "To" field can only specify one of the CICS versions supported by CICS PA.

    The "From" fields for Description and data set names (MCT Library, SDFHLOAD Library, and Dictionary DSN) can specify an asterisk (*) as a wildcard to indicate zero or more characters, or the percent symbol (%) as a wildcard to indicate any single character.

  3. To view a report of the changes that your "From" and "To" field values would have on each of the selected CICS System Definitions, select the "Report only" option. To perform the changes and then view a report of the changes, select "Perform update and report".