Volume Master File Inquiry and Update › VMF Inquiry/Update Commands › UPV Command—Update Volume Information › Sample JCL for Changing the Retention Schedule

Sample JCL for Changing the Retention Schedule

Before a "SCHED" command can be issued, TLMSIPO option MANUAL=YES must be specified.

//TLMSINQR  JOB
//TLMSINQR  EXEC CATINQR
//CAIIPT    DD   *
UPV CPX123,SCHED(6DC,7L2)

This example will change a volume's retention schedule to move the volume from the data center as soon as TRS runs, and retain the volume at location L2 under manual control.

//TLMSINQR  JOB
//TLMSINQR  EXEC CATINQR
//CAIIPT    DD   *
UPV CPX123,SCHED(,,7L3)

This example will change the value of the third retention entry in the schedule to manual control. Other entries in the schedule remain unchanged.

The SCHED keyword allows you to update the RTN-SCHED of a tape without RMF changes, and restricts the changes to a single chain. TRS will not override a retention schedule updated with the SCHED keyword. The value of SCHED is 1 to 6 retentions of the same values as the RMF. These must be separated by blanks or commas. The tapes current location must be somewhere in the schedule, and the retention will automatically be set to match the current location. Retention methods are edited for required count fields. An omitted retention entry will be left unchanged. SCHED() clears the retention schedule and allows TRS to assign a new one.