NOTE: To modify the retention of a file the CTTMUP should NEVER be used unless instructed by the BMC Support or BMC lab!

To modify the retention of an existing file, the CTTRTM utility with TYPERET RECALC should be used with a specific RULE.

Here is the recommended method:

If it is a one-off then:
- Create a specific library (PDS) for this purpose, LRECL=80.
If it will be a regular rule then continue with the standard Rule PDS.
- Create a CONTROL-M/Tape rule in this library using the IOA ONLINE TR screen
- In this new rule, adjust the retention as you need.
- Create a CTTRTM jcl in this library that will use this specific rule and will select the specific datasets to modify. See sample below.
- Always run in TYPERUN MODE=SIMULATION first and check the report to see if it matches your needs.
- Then run in TYPERUN MODE=NORMAL to apply the change to the selected datasets/volumes

NOTE: This is a standard utility which allow a safe update of the MDB.

Sample JCL:
//*-                                                                    
//         JCLLIB  ORDER=&JCLLIB                                        
//         INCLUDE MEMBER=IOASET                                        
//*-                                                                    
//*--------------------------------------------------------------------
//* Reapply new rules on existing datasets                              
//* to modify some parameters                                           
//* Can be retention, vaulting...                                       
//*--------------------------------------------------------------------
//CTTRTM   EXEC CTTRTM                                                  
//*--------------------------------------------------------------------
//* You can use the existing rule modified            
//* or use a new rule from another PDS
//*--------------------------------------------------------------------
//DARULLST DD   *                                                       
*  your.CTTRULES               RULENAME  ORDER                         
//SYSIN    DD   *                                                       
TYPERUN MODE=SIMULATION / NORMAL                                        
TYPERET MODE=RECALC                                                     
INCLUDE DSNAME=my.dataset.filter*  
OR
INCLUDE VOLSER=vvvvvv   to modify the retention of all the datasets of this volume matching the rule selection.
//