Creating or modifying undo log associations

Use the "CICS® VR Undo logs assignment" panel to access the "CICS VR Undo logs management" panel, which you can use to add a new undo log association or modify an existing undo log association.

Before you begin

To create a new undo log association using the "CICS VR Undo logs assignment" panel, press F5, Add.

To modify an existing undo log association using the "CICS VR Undo logs assignment" panel, type S, select, against the association or associations that you want to modify, and press F6, Alter. For example:
Figure 1. CICS VR Undo logs assignment panel: selecting associations
Administrate  View  Help                                                     
------------------------------------------------------------------------------ 
DWWPPULA                 CICSVR Undo logs assignment           Row 1 to 8 of 8 
                                                                               
Select one association, then select an action. Or, use Add action to register  
new association.                                                               
                                                                               
                                                                               
  S  Value     Type      Undo log name               Time (GMT)                      
  S  CICSMVS7  HLQ       CM7.UNDOLOG                 08.181 15:13:12           
  S  CICSVR2   HLQ       TEST.TST2.UNDOLOG           08.181 15:13:17           
  _  AT*       JOBNAME   DWW.USER.UNDOLOG            08.185 16:11:08           
  S  ATEST2*   JOBNAME   TEST.TST2.UNDOLOG           08.181 15:14:05           
  _  ATEST1    JOBNAME   TEST.TST1.UNDOLOG           08.179 16:01:43           
  S  AAAA      USERID    DWW.USER.UNDOLOG            08.185 15:35:24           
  _  APROD*    JOBNAME   PROD.UNDOLOG                08.184 13:17:31           
  _  TESTUSER  USERID    TEST.TST1.UNDOLOG           08.184 13:17:31           

  
                                                                              
Command ===>                                                                   
  F1=Help      F3=Exit     F4=SwSort    F5=Add       F6=Alter       F7=Bkwd
  F8=Fwd      F10=Menu bar F11=Delete   F12=Cancel
When you press F5, Add, or F6, Alter, the "CICS VR Undo logs management" panel is displayed:
Figure 2. CICS VR Undo logs management panel
DWWPPULM               CICSVR Undo logs management                          
                                                                            
Choose association type by pressing PF4, SwType, type the value, specify    
undo log name prefix and press Enter. Or, press F12 to cancel request.      
                                                                            
 Association type  . . : USERID                                             
                                                                            
 Association value . . . ________                                           
                                                                            
 Undo log name prefix    __________________  .UNDOLOG                       
                                                                            
                                                                            
                                

                                            
                                                                            
                                                                            
Command ===>                                                                
 F1=Help        F4=SwType      F7=PrevItem   F12=Cancel                 
If you are creating a new undo log association, the association value and undo log name prefix are blank. If you are modifying existing undo log associations, the existing parameters for the first association are filled in, and the correct association type is shown.

About this task

Undo log associations explains the meaning of each parameter and the rules that CICS VR uses to match job information to associations. For detailed help for any of the fields, move the cursor to the field and press F1.

To create or modify undo log associations, follow these steps:

Procedure

  1. Use the information in Undo log associations to plan your new undo log associations or your changes.
    1. Do not set up conflicting associations. If more than one association can be matched to the same job, the associations must specify the same undo log name; otherwise, CICS VR undo logging cannot proceed.
    2. If you want to use high-level qualifier associations to determine the undo log, and you update multiple VSAM spheres in the same job, make sure that all the VSAM spheres listed in the job have a high-level qualifier association, and that they specify the same undo log.
    When you are creating a new undo log association, CICS VR notifies you if the association that you try to create is identical to an existing association. However, CICS VR cannot determine whether two associations conflict until the job responsible for the conflict has been submitted. Also, CICS VR cannot determine whether the associations for multiple VSAM spheres are correct until processing starts against the first VSAM data set that is different from those encountered previously in the job. To avoid processing errors, plan your associations carefully beforehand.
  2. Before creating or modifying any undo log association, make sure that no CICS VR batch jobs are currently running. Your changes take effect immediately, and can affect running CICS VR batch jobs that involve undo logging.
  3. To specify or change the association type, press F4, SwType, to loop through the three possible types, USERID, JOBNAME, or HLQ.
  4. Specify, or overtype to change, the association value.
    1. For the USERID association type, the value is an exact user ID under which matching jobs run.
    2. For the HLQ association type, the value is an exact high-level qualifier for a VSAM sphere name to which matching jobs relate.
    3. For the JOBNAME association type, the value is the job name prefix of matching jobs. The value can be an exact job name prefix or it can be a mask ending with an asterisk (*) as a wildcard. Undo log associations explains how matching takes place when masks are used.
  5. Specify or overtype to change the undo log name prefix. This undo log is used when the association applies for a submitted job. The prefix can be up to 18 characters, and CICS VR appends .UNDOLOG to form the complete undo log name. You can use the name of an existing undo log or specify a new undo log name. If you specify a new undo log name, you do not take any additional actions to create or activate the new undo log.
  6. Press Enter to create or modify the association. The association is stored in the RCDS, and it is available to CICS VR immediately for matching.
  7. If you are modifying more than one association, repeat this process for the rest of the associations. If you want to return to a previous association, press F7, PrevItem. When you have finished modifying all the associations that you selected, CICS VR returns to the "CICS VR Undo logs assignment" panel, where your changed associations are displayed.