|
PDF Available |
|
|
PDF Available |
Abstract
The ROTATE utility can be used to rotate tape volumes on which generations of a generation data group reside. It can also be used to catalog any data set using the volume information of an existing cataloged data set.
<editor@cns.ufl.edu>Table of Contents
The ROTATE utility can be used to rotate tape volumes on which generations of a generation data group reside. It can also be used to catalog any data set using the volume information of an existing cataloged data set.
Suppose "U.USERID.DATA" is a cataloged generation data group consisting of four generations (0, -1, -2, -3), each on a different magnetic tape volume. To create a new generation cataloged on the same volume as 'U.USERID.DATA(-3)', execute the ROTATE utility as follows:
// EXEC PGM=ROTATE,PARM='U.USERID.DATA(-3)'
If ROTATE has been invoked AFTER any reference to the GDG data set using relative generation numbers, the new relative generation numbers will not "take effect" during the current jobstream (See NOTE2). If ROTATE has been invoked BEFORE any such reference, then after execution of the utility, the new generation can be referred to as follows:
//OUTPUT DD DSN=U.USERID.DATA(0),DISP=(OLD,KEEP)
For example, if the data sets in the generation data group are cataloged on TAPEA, TAPEB, TAPEC, and TAPED, the following table shows how the data sets will be cataloged after execution of the utility. The data sets have not moved but they have changed generation numbers.
Table 1. Generation Data Group with ROTATE
| Tape | Data Set Name Before | Data Set Before |
|---|---|---|
TAPEA | U.USERID.DATA.G0004V00 | U.USERID.DATA(0) |
TAPEB | U.USERID.DATA.G0003V00 | U.USERID.DATA(-1) |
TAPEC | U.USERID.DATA.G0002V00 | U.USERID.DATA(-2) |
TAPED | U.USERID.DATA.G0001V00 | U.USERID.DATA(-3) |
| Tape | Data Set Name After | Data Set After |
TAPED | U.USERID.DATA.G0005V00 | U.USERID.DATA(0) |
TAPEA | U.USERID.DATA.G0004V00 | U.USERID.DATA(-1) |
TAPEB | U.USERID.DATA.G0003V00 | U.USERID.DATA(-2) |
TAPEC | U.USERID.DATA.G0002V00 | U.USERID.DATA(-3) |
The ROTATE utility can also be used to catalog a data set using the volume information of an existing cataloged data set. The data set names must be expressed as fully qualified names and NOT as generations of a generation data group. To use this
feature, specify two data set names in the PARM field separated by a comma as follows:
// EXEC PGM=ROTATE,PARM='U.USERID2.INVENT,U.USERID2.ACCOUNTS'
After execution of the utility, 'U.USERID2.ACCOUNTS' will be cataloged on the same volume as 'U.USERID2.INVENT'.
This utility can be used for tape data sets residing on 20 or fewer volumes.
Table 2. Return Codes
| RETURN CODE | EXPLANATION |
|---|---|
0 | Normal end of the step. |
8 | The current generation was coded in the PARM field. |
U100 | An abnormal condition occurred. |
The IBM JCL User's Guide states that "relative generation numbers are obtained from the catalog as it existed at the beginning of the first step that specifies the generation data set by relative generation number."
We welcome your comments and suggestions on this and all CNS documentation. Please send your comments to:
<editor@cns.ufl.edu>