
TSIDMNT Commands CYCLE
Chapter 3. DSN Catalog Management Utility 3-21
Parameter Required? Valid Entry Default
dataset-name
Yes 1 to 44 characters None
Specify only one of the following three (required):
VER 1 to 999 None
SER 1 to 6 characters None
GEN 1 to 999999 None
Specify at least one of the following parameters (required):
EXD 1900001 to 2099366 None
DAY 1 to 999 None
CDT 1900001 to 2099366 None
JOB 1 to 8 characters None
dataset-name specifies the dataset name.
Specify either VER, SER, or GEN:
VER specifies the version number.
SER specifies the volume serial number of the first (or only) volume of a tape version.
GEN specifies the generation number of a disk version.
At least one of the following parameters must be included in the command statement. Specify
dates (EXD and CDT) in Julian format (4–digit year followed by 3–digit day, for example
January 1, 1991 = 1991001).
EXD specifies the new expiration date of the version that was cycled. If neither an expiration
date nor period retention is specified, the version is retained according to the period retention
established in the dataset defaults.
DAY specifies period retention. BIM-EPIC calculates the expiration date as today’s date plus
the number of days entered.
CDT specifies a new creation date. CDT has no effect on dataset expiration.
JOB changes the name of the job that created this version. JOB has no effect on dataset
expiration.
The following example cycles the AGED.TRIAL.BALANCE dataset, setting apart version 3
with a 7–day retention and changing its creating job name to TRIALBAL. All versions earlier
than version 3 (for example, versions 4–9) are now retained by cycle retention only.
CYCLE 'AGED.TRIAL.BALANCE',VER=3,DAY=7,JOB=TRIALBAL
Parameters
Example
Comentarios a estos manuales