Common Command Options › Setting Expiration Dates for Tapes › CYCLE number Option

CYCLE number Option

Use the CYCLE number option to specify that tape expiration depends on a specified maximum number of iterations of a primary data set name.

The CYCLE number option specifies the number of iterations of a particular primary data set name that CA VM:Tape is to keep. When you create the number +1 iteration of the data set name, the tape or tapes that contain the oldest iteration of that primary data set name expire. For example, if number is 5 and five iterations exist, CA VM:Tape expires the oldest iteration when you create the sixth iteration. You can keep from 1 through 364 cycles of a data set name.

All tapes with the same CYCLE number, owner, and primary data set name are members of the same cycle group. If you want to change the number of iterations of a primary data set name to keep, you must change the CYCLE number for every member of the cycle group.

[Authorization: NOMAXRET]

If your system administrator has set a maximum retention period for your site, you need NOMAXRET authorization to use this option.