LEAVE DDR
leaves the tape positioned at the end of the file at
the end of a function.
1. When the wronq input tape is mounted. the message is
displayed and the tape will rewind and unload regardless of options REiIND. UNLOAD, or LEAVE being specified.
2. If DDR is executed from CMS, failure to attach the tape drive or
the disk device (or both) to your virtual machine prior to invoking
the input/output statement causes the following response to be
displayed: INVALID INPUT OR OUTPUT DEFINITION Use the SYSPRINT control statement (in the standalone DDR virtual
machine only) to describe the printer that is to print data extents
specified by the PRINT statement. It also can print a map of the
cylinder extents from the DUMP, RESTORE, or COpy statement. If the SYSPRINT statement is not provided. the printer assignment defaults to OOE. ignores the SYSPRINT statement when you invoke DDR as a
command under CMS, and eMS always directs the output to OOE. The format
of the SYSPRINT control statement is:
r----------------------------------------------------------------------, , SYsprint, cuu , cuu specifies the unit address of the device. The function statements tell the DDR program what action to perform.
The function commands also describe the extents to be dumped. copied. or
restored. The format of the DUMP/COPY/RESTORE control statement is:
r----------------------------------------------------------------------, , , r l' , DUmp I Icyll [To] [cyl2 [Reorder] [To] [cyI3]] , , , COpy " CPvol " I REstore" ALL I I , I ,NUcleus I' , I L L----------------------------------------------------------------------J DUMP requests the program to move data from a 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: a volume header
describing the volumes.
record, consisting of data 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. Section 2. CMS Commands 49

DDR 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-job (EOJ) traIler- label. The end-of-volume label contains the same
information as the next volume header record, except that the
ID field contains EOV. The end-of-job trailer label contains
the same information as record 1 except that the cylinder
number field contains the disk address of the last record on
tape and the ID field contains EOJ. COpy 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 from input device to output device. A
tape-to-tape copy can be accomplished only with data dumped by
this program. RESTJRE requests the program to return data that has been dumped by
this program. Data can be restored only to a DASD volume of
the same or equivalent device type from which it was dumped.
It is possible to dump from a real disk and restore to a
minidisk as long as the device types are the same.
cyll [TO] [cy12 [REORDER] [TO] [cyI3]] Only those cylinders specified are moved, starting with the
first track of the first cylinder (cyll), and ending with the
last track of the second cylinder (cyI2). 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 (cyll) if cyl3 is not specified. Specify the REORDER operand only if specific limits are defined for
the operation; the starting and, if required, ending cylinders
(cyll and cyl2) must be specified. Note that if the input
device cylinder extents exceed the number of cylinders
specified on the output device, an error message CPVOL 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 format; that is, the CP Format/Allocate program must have
formatted them.
ALL specifies that the operation is to be performed on on all
cylinders. NUCLEUS The occurrence of message DMKDDR705E (issued upon
completion of the copy, restore, or dump operation) indicates
that an attempt was made to copy, restore, or dump the
contents of cylinders beyond the extents of the designated
minidisk.
specifies that record 2 on cylinder 0, tra=k 0 and the nucleus
cylinders are dumped, copied, or restored. • Each track must contain a valid home address, containing the real
cylinder and track location. • Record zero must not contain more than eight key and/or data
characters. 50 IBM VM/370 CMS Command and Macro Reference