Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

DUMP-DISK Save disk

This statement saves a disk onto MTC. You can then use this backup to restore the disk with the RELOAD-DISK statement if necessary.

DUMP-DISK

Alias: DMD

DISK = <vsn 1..6>(...) / list-poss(64): <vsn 1..6>


<vsn 1..6>(...)



|

SPECIAL-VSN = *NO / *YES

,TAPE = *ANY (...) / list-poss(255): <vsn 1..6>


*ANY (...)



|

LOCATION = *BY-PAR AMETER / *STD / <alphanum-name 1..8>

,TAPE-DEVICE-TYPE = *BY-VOL UME -CAT ALOG / <device>

,FILE-NAME = *STD / <filename 1..41 without-cat-user-gen-vers>

,RETENTION-PERIOD = *BY-PAR AMETER / <integer 0..32767 days>


DISK = <vsn 1..6>(...)

Volume serial number of the disk to be copied. The disk is saved to a tape/tape set (single disk save entity).
FDDRL determines the device type automatically from the VSN. If this is not possible, for example because the disk is not attached, the disk with device type STDDISK is requested.

SPECIAL-VSN = *NO / *YES
In the case of disk mirroring with SHC-OSD (Storage Host Component), the additional disk units can be split and renamed during live operation. These are then assigned a special, temporarily modified VSN in order to ensure that they are not confused with the original disks. See also chapter "Saving Clones (SHC-OSD)".
The SPECIAL-VSN operand serves to assign disks and specifies whether the disk is an additional disk unit with a special VSN which was renamed in this way.

SPECIAL-VSN = *NO
The disk still has the original VSN.

SPECIAL-VSN = *YES
The disk has been assigned a special VSN as created by SHC-OSD with an unambiguous reference to the original VSN. The disk is saved as with the original VSN. It can be restored under the original VSN.

DISK = list-poss(64): <vsn 1..6>
All specified disks are combined to form a save entity and saved to a tape/tape set (disk set save entity).

TAPE = *ANY(...) / list-poss(255): <vsn 1..6>
Specifies the volumes to be used for the save. These volumes must have a valid label and their retention period must have already expired.

TAPE = *ANY(...)
The operator assigns any volumes of the specified type.
MARENUCP automatically assigns scratch tapes.

LOCATION =
The location specifies the set of devices, from which tape devices for SCRATCH requests are to be selected.
Explicitly stating a location is only possible with the chargeable MAREN subsystem.

LOCATION = *BY-PARAMETER
The value set with MODIFY-FDDRL-PARAMETERS is to be used.

LOCATION = *STD
Device management is to determine the set of devices and select a suitable tape device from it. If MAREN is being used, device management obtains the information on the location from MAREN.

LOCATION = <alphanum-name 1..8>
Specifies the device set location from which tape devices for SCRATCH requests are to be selected. The /SHOW-DEVICE-DEPOT command can be used to display the allocations of locations to tape devices. If device management does not recognize the location specified, the device request is rejected.

Please refer to the additional information under chapter "Defining a location".

TAPE = list-poss(255): <vsn 1..6>
The designation and order of the volumes is determined by a list. In the mount process, the volumes specified here are requested. No reassignments to volumes with another VSN are permitted. In an emergency, the operator must use the INIT utility routine to initialize the missing volumes (see the “Utility Routines” manual [2]).

If the operator rejects volumes that have been specified incorrectly, the save run is terminated abnormally. If more volumes are required than are specified in the list, the remaining volumes are requested as with *ANY.

TAPE-DEVICE-TYPE = *BY-VOLUME-CATALOG / <device>
Data volume type of the MTC to be used for the save.

TAPE-DEVICE-TYPE = *BY-VOLUME-CATALOG
This specification is only possible when MAREN is being used.
MAREN determines the volume type itself. In the case of scratch tapes (TAPE=*ANY), this is the default volume type set for MAREN (MAREN parameter DEFAULT-DEVICE-TYPE).

TAPE-DEVICE-TYPE = <device>
Volume type of the MTC on the basis of which device management determines the type of device that will be required for tape processing. TAPE may not be specified.

FILE-NAME = *STD / <filename 1..41 without-cat-user-gen-vers>
Designates the file name in the MAREN volume catalog. The file name must begin with the string “FDDRL”. If a job variable of the same name exists, it is supplied with the VSNs of the tapes used (see the chapter "Job variable for backup volumes").

FILE-NAME = *STD
The file name is formed as follows:

Single disk:

FDDRL.D.<vsn>

Disk set:

FDDRL.D.<vsn>-1, where <vsn> is the VSN of the first disk specified and “1” designates the first disk set.

RETENTION-PERIOD =
Retention period of the volumes in days.

RETENTION-PERIOD = *BY-PARAMETER
The value set in the MODIFY-FDDRL-PARAMETERS statement is used.

RETENTION-PERIOD = 0
There is no retention period. The backup volumes can be overwritten on the same day, but not in the same save run.

RETENTION-PERIOD = <integer 1..32767 days >
The backup volumes are protected against overwriting until the specified number of days has elapsed.