The VSCLOSE command closes the specified volume set and takes it offline. The PARTVS parameter and the SPLIT option have been added to support split-volume backup.
In order to close a volume set, all users must have stopped accessing files on that volume set.
 |
| |
|
 | NOTE:
The NOW option cannot be specified with the SPLIT option. The VSCLOSE command with the SPLIT option proceeds only if the files on the volume set are not being accessed.
|
|
| |
|
If there are open files, the volume set cannot be split. Note that a volume set is not placed in the CLOSE PENDING state if SPLIT was specified.
A default VSCLOSE of a split-volume set attempts to close both volume set halves. If it finds that only one of the halves is present, it closes it and returns no warning for the absent volume set half.
If the system fails while a VSCLOSE SPLIT is in progress, only part of the volume set may be split. The master volume is the last to be split, and its state determines if the entire set is split or joined; therefore, if the master is still joined, all the members in the set
must be joined. The next time that this partially split-volume set is mounted, an automatic join takes place. A repair starts for the volumes that were split. The user must wait for the repair to complete before another split can be initiated.
This command may be issued from a session, a job, or in BREAK, but not from a program. Pressing CTRLY has no effect on this command. This command may be issued only from the system console.
Task |
|
Closes a volume set and takes it offline.
Syntax |
|
VSCLOSE volumesetname [ [;PARTVS=]{USER [;NOW
BACKUP}] ;SPLIT]
|
Parameters |
|
- volumesetname
The name of the volume set to be closed. Any user who is accessing a file at the time is allowed to finish access; however, users who are not accessing files at the time are unable to open files on the volume set, and VSRESERVE and MOUNT requests are denied. Required.
- PARTVS
This parameter is only applicable to a previously split-volume set. It notifies the system which split-volume set half is to be closed.
- USER
Close only the user volumes.
- BACKUP
Close only the backup volumes.
If PARTVS is not specified, both volume set halves are closed. If PARTVS is specified for a nonsplit-volume set, an error is returned, and the volume set is not closed.
- NOW
This option cannot be used with the SPLIT option. This option instructs the system to abort any job or session using a file on the volume set.
- SPLIT
This option splits the volume set into user volumes and backup volumes if it is a mirrored volume set and is in the proper state. All members of the volume set and both members of each pair must be present. There can be no repair taking place. Both partners of each volume pair must be identical at the time of the split.
There can be no users logged on to the volume set when the split is processed. If there are files open on the volume set, the VSCLOSE fails and the volume set remains united.
For each mirrored pair, the system assigns a backup volume and user volume. The volume with the greater path number is selected as the backup volume.
If SPLIT is specified for a non-mirrored volume set, an error is returned and the volume set is not closed.
Example |
|
This example shows how to use the VSCLOSE command with the SPLIT option.
