CA Dynam for VSE User Guide

DYNCAT Commands
ROTATE
Causes CA Dynam/T to process tapes within this dataset
in a cyclical fashion, so that the newest output version
will be written over the oldest version of the dataset, if
the number of versions specified by the NGEN parameter
for the dataset is filled. All expiration and retention
criteria are ignored when rotating. That is, even if
EXPDATE=PERM, the oldest version will be scratched.
When the first file of a multifile set is reused, all the subsequent files are
scratched. Thus, if a multifile, multivolume set is being rotated, all the
volumes not reused by the first file are returned to the scratch pool and will
not be called when creating the subsequent files of the multifile set.
USerid=
VIRTape=
Optional parameter that specifies the user ID field which will appear in each
version record. Valid entry is a 2-character ID to be used for reporting
purposes.
Optional parameter. Specifies whether a dataset should be created as a virtual
file.
NO
VTAPE
FTAPE
The file is not created as a virtual file.
The file is created using VTAPE.
The file is created using FakeTape.
VLTloc=
Optional parameter. Specifies the vault rotation scheme to be used for
versions of the dataset. Valid entries are 1- to 100-alphabetic characters
enclosed in parentheses and separated by commas. Each character represents
a vault location. Its relative position in the string represents the generation of
the dataset that is to be in that vault.
For example: (A,A,B,A) specifies that Versions 1 and 2 are to be in vault A.
Version 3 is to go to vault B and Version 4 is to return to vault A. The first 999
versions of a data set may have vault location control. All versions after 999
will be kept in the default vault (see DEFVLT parameter).
VOLID=
Optional parameter. Defines a volume identifier that allows the tape volume to
receive output from the dataset. The volume identifier must match the first
two characters of the volume serial number.
Chapter 8: Maintaining the Catalog−DYNCAT Program 8–59