VSCLOSE

The VSCLOSE command is used by the operator to put a volume set in the LONER state. If there are no files open in the volume set, the VSCLOSE command closes the set at that time. If there are files open, the volume set goes into a close-pending (CP) state. That means the set will be closed when the last file is closed. Closing takes the volume set offline and puts the volumes in the LONER state. The volumes can now be removed from the system or deleted and reused.

This command is used by the operator to notify users that a volume set is going to be removed. This command restricts access to the volume set. Command patiently waits until all files are closed on the volume set unless NOW specified then all users of volume set will be aborted and the volume set will be ready for removal.

Any job/session that 1)has not done an explicit RESERVE/MOUNT on the volume set and 2)currently has no files open on the volume set, will be denied access to the volume set.

Task

Takes volumes offline.

Capability

SM, system manager capability and can only be issued from the console.

Syntax

VSCLOSE volsetname [; NOW]

Parameters

volsetname

The volume set that will be taken offline. Required.

NOW

Aborts all users of the volume set immediately. Optional.

Example

This example shows how to take a volume set offline and put it in the LONER state.

1. Try to take the volume set offline by using the VSCLOSE command when there is an open file or a VSRESERVE is in effect.

2. Verify that the "close pending" message displays.

3. Use DSTAT to verify that the volume set is still online. The CP* indicates a close pending state for the volume set.

   :VSCLOSE BSET VOLUME SET IN USE, CLOSE PENDING APPLIED TO VOLUME SET. (CIERR 10637) :DSTAT LDEV-TYPE STATUS VOLUME (VOLUME SET - GEN) --------- --------- -------------------------- 21-079350 CP*MASTER BVOL1 (BSET-0) 22-079350 CP*MEMBER BVOL2 (BSET-0) 23-079350 CP*MEMBER BVOL3 (BSET-0)

4. Close the last file and verify that the volume set is automatically taken offline and put in the LONER state.

   :DSTAT LDEV-TYPE STATUS VOLUME (VOLUME SET - GEN) --------- ------ -------------------------- 21-079350 LONER BVOL1 (BSET-0) 22-079350 LONER BVOL2 (BSET-0) 23-079350 LONER BVOL3 (BSET-0)