CA Dynam for VSE User Guide

DYNCAT Commands
ALL
Optional parameter. Specifies that all versions of the old dataset be renamed.
NEWVERS, OLDVERS and VOLSER must not be present when ALL is specified.
The data set name specified by NEWNAME must not exist in the Catalog when
the ALL operand is used.
When ALL is specified, the name of the entire dataset is changed. If not, a
version is moved from one dataset to another.
MF=RESET
Optional parameter. Automatically resets the prototype record of the AMF
dataset to indicate 001 as the next output data set name to be used as file one
of the tape to be created. Renames all existing members of the AMF group to a
new name, as specified by the NEWNAME parameter.
When MF=RESET is used, the data set names specified for both OLDNAME and
NEWNAME must contain three asterisks (***) identifying the position for the
numeric AMF numbers in the old and new data set names.
NEWVERS, OLDVERS and VOLSER must not be present when MF=RESET is
specified.
NEWVERS=
Optional parameter. Specifies the new version number to be assigned to the
renamed version. Valid entry is:
a 1- to 3-digit number in the range 0 - 999.
OLDVERS=
Optional parameter. Specifies the version of the dataset to be renamed.
OLDVERS and VOLSER are mutually exclusive. Valid entry is:
a 1- to 3-digit number in the range 0 - 999.
VOLser=
Optional parameter. Specifies the volume serial number of the first or only
volume of the dataset to be renamed. VOLSER and OLDVERS are mutually
exclusive. Valid entry is a 1- to 6-character volume serial number. (May be
enclosed in parentheses.)
Examples
Examples follow:
// JOB RENAME CA Dynam DATA SETS
// EXEC DYNCAT,SIZE=128K
RENAME OLDNAME='DSN1' NEWNAME='DSN2' ALL
RENAME OLDNAME='DSN3' NEWNAME='DSN4' OLDVERS=3 NEWVERS=13
RENAME OLDNAME='DSN5' NEWNAME='DSN6' VOLSER=7528 NEWVERS=7
RENAME OLDNAME='PAY***' MF=RESET NEWNAME='PAYDEC***'
/*
/&
Chapter 8: Maintaining the Catalog−DYNCAT Program 8–79