This statement saves all disks of a pubset to MTC. PUBSET=*HOME enables you to save the home pubset online.
The disks of the pubset are saved either separately (SAVE-ENTITY=*SINGLE-DISK) or as multiple disks together (SAVE-ENTITY=*DISK-SET) to their own MTCs (tape sets).
In the case of SAVE-ENTITY=*SINGLE-DISK, the individual disks of the pubset are saved separately to their own MTC (tape sets). If a pubset is to be restored, every disk of this pubset must be restored with the RELOAD-DISK statement.
In the case of SAVE-ENTITY=*DISK-SET, the disks of the pubset are combined to form one or more disk sets. The disks of a disk set are saved together to their own MTC (tape sets). A pubset saved in this way can be restored using a RELOAD-PUBSET statement.
DUMP-PUBSET | Alias: DMP | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PUBSET =
Determines the pubset which is to be copied.
PUBSET = <catid 1..4>(...)
Catalog ID of the pubset to be copied.
FDDRL determines the device type automatically from the VSN of the PUBRES. 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)" Operand NEW-VSN=*SPECIAL-VSN .
The SPECIAL-VSN operand serves to assign disks and specifies whether the disks are additional disk units with special VSNs which was renamed in this way.
SPECIAL-VSN = *NO
The disks still have the original VSN.
SPECIAL-VSN = *YES
Die Platten haben eine spezielle, von SHC-OSD gebildete VSN mit eindeutigem Bezug zur Original-VSN: They can also be restored under their original VSN.
PUBSET = *HOME(...)
The home pubset is to be copied during ongoing operation (online save).
DEFAULT-PUBSET = *HOME / <catid 1..4>
Determines the pubset on which the SYSOUT files of the subtasks and the FDDRL variable for recording the tape VSNs are stored.
The default setting is DEFAULT-PUBSET=*HOME: the SYSOUT log is disabled and the job variable is only supplied with a value at the end of the save.
TIME-LIMIT = 5 / <integer 1..120 minutes>
Defines a time limit for the online save. After the time limit has expired, the write lock for the disks of the home pubset is canceled. Any save run which has not yet been completed is continued, but in this case the save is inconsistent and unusable for restoration.
TAPE =
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 MTC 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 MTC 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 MTC devices for SCRATCH requests are to be selected. The /SHOW-DEVICE-DEPOT command can be used to display the allocations of locations to MTC 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(512): <vsn 1..6>
The specified MTCs can be used for saving.
The first n MTCs in the list are permanently assigned to the n tapes sets as the first MTC. If a save requires further MTC for a tape set, the continuation MTCs are assigned to the tape sets in dynamic sequence.
TAPE-DEVICE-TYPE =
Defines the volume type of the MTCs 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 MTCs on the basis of which device management determines the type of device that will be required for tape processing. TAPE may not be specified.
SAVE-ENTITY = *DISK-SET(...)
Multiple disks are combined to form a save entity, this being referred to as a disk set. The number of disk sets is defined in the NUMBER-OF-DISK-SETS operand.
NUMBER-OF-DISK-SETS = 1 / <integer 1..8> / *BY-TASK-LIMIT
Determines the number of save entities to be created. This specification controls the utilization of the MTC capacity on the one hand and the parallelism of the save on the other:
The lower the number of disk sets created per pubset, the higher the number of disks which are assigned to the individual disk sets and, as a result, the better the utilization of the disk capacity.
The greater the number of disk sets created per pubset, the greater the degree of parallelism in the save.
The number of disk sets is automatically limited to the number of disks per pubset and to the value of the FDDRL parameter TASK-LIMIT. If PROCESS-JOBS=*BY-
MAINTASK is set, the number of disk sets is limited to 1.
One tape set is generated per save entity. You must ensure that not more than
255 MTC are required per tape set.
NUMBER-OF-DISK-SETS = *BY-TASK-LIMIT
The number of save entities to be formed is derived from the FDDRL parameter TASK-LIMIT.
SAVE-ENTITY = *SINGLE-DISK
The save entity is the single disk. Each disk of the pubset is saved to its own MTC/tape set. As many tape sets are created as there are disks per pubset.
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.