Analyzing a multi-target change in batch by using panels

You can use panels to create a Change Management (CM) batch job to analyze multi-target changes. Using a CM batch job can be more efficient than analyzing changes one at a time with the CM panels.

Procedure

To use panels to create a multi-target analyze batch job:

  1. On the Change Management (CM) (ADB2C) panel, specify option 1 (Manage changes), and press Enter.
  2. On the Manage Changes (ADB2C1) panel, specify option 1 (Display changes), and press Enter.
  3. On the Changes (ADB2C11) panel, issue one of the following line commands next to the change that you want to analyze:
    AN
    Creates a simple CM batch job without any panel options
    ANO
    Allows you to specify analyze options to include in the generated CM job. ANO can be specified only if the change type is MULTI-TC
  4. On the Generate Multi-target Analyze Job (ADBPCMTA) panel, complete the fields, and press Enter:
    Figure 1. Generate Multi-target Analyze Job (ADBPCMTA) panel
    ADBPCMTA  ----------------- Generate Multi-target Analyze Job  -------------- 13:45
    Command ===>                                                                   
                                                                                   
     Specify the following for Analyze:                                            
                                                                      More:     + 
     Base version method . . . . . A
                                                                                  
     Change reporting options  . . Yes       (Yes/No)                               
     
     PDS for WSL . . . . . . . . . DSNB.RUN.WSL                                    
     PDS for analyze job . . . . . DSNB.ANALYZE.JCL
     Prefix for data sets  . . . . SYSADM                                         
     Existing data set action  . . REPLACE     (Conditional, Replace, Stop)      
     Change tag type . . . . . . . NAME        (ID, Name, Owner)                   
                                                                                   
     Run SQLID . . . . . . . . . . <NONE>   (Blank, a SQLID, or <NONE>)            
     Object Grantor  . . . . . . .          (Blank or a SQLID)                     
     Validate WSL  . . . . . . . . YES      (Yes/No)                               
     Use utility options . . . . . YES      (Yes/No)
     Generate templates  . . . . . YES      (Yes/No)                                                      
     Authorization Switch ID . . . SYSADM   (SQLID to connect, <SQLID> or blank)   
     SECADM Authorization ID . . . SYSADM   (SQLID to connect or blank)            
     Stop on conversion error. . . YES      (Yes/No)                               
     Content of apply job(s) . . . DDL      (All, DDL)                             
     Unload method . . . . . . . . P        (Unload, Parallel unload, HPU)         
     Use DEFER YES . . . . . . . . YES      (Yes/No)                               
     Allow rotate parts  . . . . . NO       (Yes/No)                               
     Retain GENERATED ALWAYS:                                                    
       For ROWID . . . . . . . . . YES      (Yes/No)
       For ROW CHANGE TIMESTAMP. . YES      (Yes/No)                         
     IDENTITY START value  . . . . COMPUTED (Original, Computed)             
     SEQUENCE RESTART value  . . . COMPUTED (Original, Computed)             
     Disable REORG optimization  . YES      (Yes/No)                         
                                                                            
     Run CHECK DATA  . . . . . . . YES      (Yes/No)                         
     Take an image copy  . . . . . R        (after: Reload/Alter/Both/None)  
     Run REORG/REBUILD . . . . . . M        (Mandatory, All relevant, None)  
     Run RUNSTATS  . . . . . . . . R        (after: Reload/Alter/Both/Min/None)  
     Run REBIND  . . . . . . . . . M        (Mandatory, All relevant, None)  
    
     Generate ALL options  . . . .          (Yes/No, default is NO)
                                                                            
    BP - Change batch job parameters
    CO - Change options common to change functions          
    

    The first time this panel is used in a session, values are pre-filled with the CM batch default parameter values. For subsequent uses of this panel in a session, the previously entered values are reused. To reset the panel to use the default values, issue the DEFAULTS command. This command overrides any previously entered values.

    Most fields on the panel correspond to CM batch parameters; see CM batch parameter definitions.

    Batch parameters are generated in the job only if the corresponding value entered on the panel is different from the CM batch default value. If you want to generate CM batch options for all values that are specified on the panel, regardless of whether the values differ from the default values, set the GENERATE ALL options field to Y.

    Note: Start of changeIf a target or targets exist on other subsystems, the generated jobs include additional steps for remote subsystems with the MTC_CENTRAL_LOCATION parameter and the appropriate location name of the change. In this case, the PDS_FOR_WSL parameter is generated with the default value to avoid overwriting members in the same data set by different steps.End of change

    Depending on the values that you specify, you might be prompted for additional information before the analyze job is generated and the ISPF Edit session is displayed.

Results

A CM batch job is generated in the data set that is specified in the PDS for analyze job field, as shown in the following example:
****** ***************************** Top of Data ******************************
000001 //RHP1 JOB ,                                                            
000002 //*       RESTART=STEPNAME, <== FOR RESTART REMOVE * AND ENTER STEP NAME
000003 //     REGION=0M,NOTIFY=&SYSUID,                                        
000004 //     MSGCLASS=H,TIME=(,30)                                            
000005 //*                                                                     
000006 /*JOBPARM S=SY4A                                                        
000007 //*                                                                     
000008 //ADBLIBS JCLLIB ORDER=ADB.DEVCUST.PROCLIB                              
000009 //*                                                                     
000010 //******************************************************GOCCM***********
000011 //* STEP REGISTER A CHANGE                                    
000012 //**********************************************************************
000013 //GOCCM EXEC GOCCM,SSID=DSNA,PLAN=ADBDEV,GRP=VB2APAR                   
000014 //GOCCM.PARMS  DD *                                                     
000015  ACTION_ANALYZE_CHANGE='Y'                                              
000016  CHANGE_OWNER='SYSADM'                                                 
000017  CHANGE_NAME='TESTRHP_CHG03'
000018  
000019  PREFIX_FOR_DATA_SETS = ’SYSADM’
000020  PDS_FOR_WSL = ’DSNB.RUN.WSL’
000021  EXISTING_DATA_SET_ACTION=’REPLACE’
000022  CHGTAG_TYPE = 'NAME'
000023        
000023  RUN_SQLID = '<NONE>'
000024  VALIDATE_WSL = 'Y'
000025  USE_UTILITY_OPTIONS='Y'
000025  GENERATE_TEMPLATES = 'Y'	
000026  AUTH_SWITCH_USERID = 'SYSADM'
000027  AUTH_SWITCH_SECADM = 'SYSADM'
000028  STOP_ON_CONVERSION_ERROR = 'Y'
000029  CONTENT_OF_APPLY_JOBS = 'D'
000030  UNLOAD_METHOD = 'P'
000031  USE_DEFER_YES = 'Y'
000032  ALLOW_ROTATE_PARTS = 'N'	
000033  RETAIN_GENERATED_ALWAYS_FOR_ROWID = 'Y'
000034  RETAIN_GENERATED_ALWAYS_FOR_ROW_CHANGE_TS = 'Y'
000035  IDENTITY_START_VALUE = 'C'	
000036  SEQUENCE_RESTART_VALUE = 'COMPUTED'	
000037  DISABLE_OPTIMIZE_REORG = 'Y'	
000038	
000039  RUN_CHECK_DATA = 'Y'
000040  TAKE_AN_IMAGE_COPY = 'R'
000041  RUN_REORG_REBUILD = 'M'
000042  RUN_RUNSTATS = 'R'
000043  RUN_REBIND = 'M'
000044
000045  REPORT_ONLY_CHANGED_OBJECTS = 'Y'
000046  REPORT_USER_SPECIFIED_IGNORE_FIELDS = 'Y'
000047  REPORT_SYSTEM_GENERATED_IGNORE_FIELDS = 'Y'
000048  REPORT_TRANSLATION_MASKS = 'Y'
000049  REPORT_SUMMARY = 'Y'
000050  REPORT_OBJECT_COUNT = 'Y'
000051  REPORT_EXPECTED_CONVERSION_PROBLEMS = 'Y'
000052  
000053  RELOAD_ACCELERATED_TABLES = 'N'
000054  ;
****** **************************** Bottom of Data ****************************

What to do next

After reviewing the batch job, you can save it by using the SAVE command.

For information on what to expect when you run the batch job and what to do after the batch job completes, see Analyzing a multi-target change