The function statements tell the DDR program what action to perfor •• The function comaands also describe the extents to be duaped, copied, or
restored. The format of the DUMP/COPY/RESTORE control statement is: I r , DUmp Copy
REstore I Icyl1 [TO] I ICPvol I IALL [cyl2 [Reorder] [To] [cyI3]] I I I I !her!!: I INUcleus I L .I DUMP requests the program to move data from a direct access volume onto a magnetic tape or tapes. The data is moved cylinder by
cylinder. Any number of cylinders may be moved. The format of the resulting tape is: COpy RESTORE Record 1: a volume header descrIbIng the voluaes.
record, consisting of data
Record 2: a track header record, consisting of a list of count fIelds to restore the track, and the number of data records
written on tape. After the last count field the record
contains key and data records to fill the 4K buffer.
Record 3: track data records, consisting of key and data records-packed into 4K blocks, with the last record truncated.
Record 4: either the end-of-volume (EOV) or end-of-jab (EOJ) traller- label. The end-af-voluae label contains the same inforaation as the next volume header record, except that the
ID field contains EOV. The end-of-job trailer label contains
the saae inforaation as record 1 except that the cylinder number field contains the disk address of the last record on tape field requests the program to copy data from one device to another
device of the same or equivalent type. Data may be recorded
on a cylinder basis froa input device to output device. A tape-to-tape copy can be accomplished only with data dumped by this program. requests the program to return data that has been dumped by
this program. Data can be restored only to a DISD volume of
the same or equivalent device type froa which it was dumped.
It is possible to duap froa a real disk and restore to a
ainidisk as long as the device types are the saae. cy11 [TO] [cy12 [REORDER] [TO] [cyl3]] Only those cylinders spscified are :cvsd, starting with the first track of the first cylinder (cyln, and ending with the
last track of the second cylinder (cy12). The REORDER operand
causes the output to be reordered, that is, moved to different
cylinders, starting at the specified cylinder (cyI3) or.at the
starting cylinder (cy11) if cy13 is not specified. The REORDER operand must 'not be specified unless specified limits are defined for the operation; the starting and, if required,
ending cylinders (cy11 and cy12) must be specified. Note that
if the input device cylinder extents exceed the number of
162 V8/370 Operator's Guide

CPYOL ALL BUCLEUS cylinders specified on the output device, an error aessage
results.
Caution: The REORDER operand is intended to be used to move iIiIdisks to new locations; it is not intended forre-locating
non-ainidisk cylinders. To understand the difference,
consider a 10 cylinder minidisk. Its cylinders are numbered 0-9 and the count fields of its records refer to cylinders 0-9. Furthermore, if the minidisk contains location-dependent
data, then references to cylinders 0-9 will be hidden within
that data. When REORDER is used to move the minidisk to a new
real location, the minidisk cylinders are nevertheless still
regarded as being cylinders 0-9 and there is no need to change
the cylinder numbers in the .count field of the records. On the other hand, when moving non-minidisk cylinders, one would
generally want the count fields of the moved records to
reflect the new cylinder addresses; but REORDER keeps the
original cylinder numbers in the count fields.
specifies that cylinder 0 and all active directory and
permanent disk space are to be copied, dumped, or restored.
This indicates that both source and target disk must be in CP foraat, that is, the CP Format/Allocate program must have formatted them.
specifies that the operation is to be performed on all
cylinders, except alternate track cylinders on some devices. (See "Restrictions" below.)
Note: The occurrence of aessage DBKDDR705E (issued upon comFletion of the copy restore or duap operation) indicates
that an attempt vas made to copy restore or dump the contents
of.cylinders beyond the extents of the designated minidisk.
specifies that record 2 on cylinder 0, track 0 and the nucleus
cylinders are dumped, copied, or restored. • Each track processed by this utility aust have a valid home address
on it containing the real cylinder and track location. Even when
restoring and copying data to a track it must have a pre-existing
home address on it. • Each track on an input DASD device must have a valid record zero on
it, with no more than eight bytes in the key and data fields of the
record. Each track on an output DisD device must also have a valid
record zero on it unless that device is 2314, 2319, 2305-1, or 2305-2. • Flagged tracks are treated just as any other track for all 2314,
2319, and 2305 devices. That is, no attempt is made to substitute
the alternate track data when a defective primary track is read. In
addition, tracks are not inspected to determine whether they were
previously flagged when written. Therefore, volumes containing
flagged tracks should be restored to the same cylinders of the voluae from which they were dumped. The message occurs each time a defective track is dumped, copied or restored, and the operation
continues. When ALL is specified for these device types, both the primary cylinders and the high-order cylinders normally reserved for
alternate tracks are copied, or restored. Section 4. V8/310 Service Prograas 163