This statement copies all disks of a pubset to disks of the same device type. For each disk of the pubset to be copied, there must be one output disk. All disks of the pubset to be copied must be attached and available before CREATE-JOBS, otherwise the FDDRL function for this pubset will not be started.
The disks of the home pubset can be saved during ongoing operation by specifying PUBSET=*HOME.
The ACTION operand specifies whether the copy operation is for saving or restoration purposes.
COPY-PUBSET | Kurzname: CPP | ||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||
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.
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.
OVERWRITE-DISK =
Specifies the VSN of the output disk to be mounted. If copying is successful, the output disk is given the VSN of the input disk (original VSN).
OVERWRITE-DISK = *SAME-VSN
The output disks to be mounted have the same VSNs as the corresponding input disks.
OVERWRITE-DISK = *BY-OPERATOR
The VSNs of the output disks to be mounted are not known to the FDDRL user. The operator is responsible for assigning the correct VSN.
The operand value *BY-OPERATOR should not be used during normal operation, since an operator error may cause foreign disks to be overwritten inadvertently. *BY-OPERATOR is intended exclusively for cases where the VSN is not known. This situation can occur if a previous COPY-DISK, COPY-PUBSET, RELOAD-DISK or RELOAD-PUBSET run was not terminated correctly. In this case, the SVL still contains a dummy VSN which has been assigned by FDDRL (formed from the time of the FDDRL run) and which is designed to prevent BS2000 from working with this disk.
OVERWRITE-DISK = *UNIT(...)
The output disks to be mounted are specified using their mnemonic device names (MNs). The operator must confirm the disk assignment. The output disks can be used even if they are not initialized or have the wrong format. In this case they are automatically initialized and formatted in the required format (if this is possible with VOLIN).
UNIT = list-poss(1000): <alphanum-name 2..2> / <x-text 4..4>
Mnemonic device names (MNs) of the output disks.
OVERWRITE-DISK = list-poss(1000): <vsn 1..6>
The output disks to be mounted have the specified volume serial numbers.
ACTION =
Specifies whether the copy operation is for saving (*SAVE) or restoring (*RESTORE) if the input disk has the same VSN as the output disk. Here it could happen that the operator mistakenly mixes up the two disks, in which case the copy direction would be wrong. The ACTION operand prevents this. FDDRL can use this operand to check the copy direction. Here the time stamps in the SVLs of the two disks are compared. If the disks are found to have been incorrectly assigned, the assignments for the input and output disks are rejected. Operation then continues with the mount request for the input disk.
ACTION = *SAVE
The disk contents are to be saved, i.e. the disk with the earlier time stamp is to be overwritten by the contents of the disk with the more recent time stamp. If the operator assigns an output disk with a more recent time stamp than that of the input disk, the assignment is rejected.
When an online save is performed for the home pubset (PUBSET=*HOME operand), only ACTION=*SAVE is possible.
ACTION = *RESTORE
The disk contents are to be restored, i.e. the disk with the more recent time stamp is to be overwritten by the contents of the disk with the earlier time stamp. If the operator assigns an output disk with an earlier time stamp than that of the input disk, the assignment is rejected.