Command Definitions SP-Z
VSCLOSE
VSCLOSE
Informs the system to close the specified volume set and take it offline. (Native Mode)
Syntax
VSCLOSE
volumesetname
[ [ ;PARTVS=] { USER BACKUP } ] [ ;NOW ;SPLIT ]
Parameters
volume- setname
The volume set that is to be closed. Any user who is accessing a file at the time this command is issued is allowed to finish accessing the file.
However, users who are not accessing files are unable to open files on the volume set, and
VSRESERVE
and
MOUNT
requests are denied. Refer to
"Operation Notes," below.
PARTVS
NOW
SPLIT
This option is available only with the Mirrored Disk/XL, a separately purchased product. For information, refer to !Mirrored Disk User's Guide>
Mirrored Disk/iX User's Guide (30349-90003). This parameter only applies to a previously split volume set. Specify it when you want only half of split volume set to be closed.
USER
BACKUP
Close only the user volumes.
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.
Instructs the system to abort any job or session that is using any file that resides in the specified volume set. However, if a
VSRESERVESYS
or an
LMOUNT
command has already been issued for the specified volume set, then the operator should execute a
VSRELEASESYS
command, followed by a
VSCLOSE ;NOW
command, in order to take the volume set offline.
The
NOW
parameter permits the operator to remove a volume set without having to use
VSUSER
and then perform an
ABORTJOB
on the users of the volume set. This command may be issued only from the system console.
This option is available only with the Mirrored Disk/iX, a separately purchased product. For information, refer to Mirrored Disk/iX User's
Guide (30349-90003). It splits the volume set into user volumes and backup volumes if it is a mirrored volume set and if it is in the proper state.
The
SPLIT
option cannot be used with the
NOW
option. All members of the volume set and both members of each pair must be present. There can be no repair taking place. Both members of each volume pair must be identical at the time of the split. There can be no users logged onto the volume set when the split is processed.
690 Chapter 8
Command Definitions SP-Z
VSCLOSE
For each mirrored pair, the system assigns a backup volume and user volume. An attempt is made to place the backup volumes and user volumes on separate hardware channels. The volume with the greatest path number is selected as the backup volume.
If
SPLIT
is specified for a nonmirrored volume set, an error is returned and the volume set is not closed.
Operation Notes
This command notifies the system to close the volume set and take it offline. This is done when all users have ceased using files on the volume set, and when any program file that has been allocated on the volume set has been deallocated (via the
DEALLOCATE command). Once the
VSCLOSE
command is issued for a volume set, individual users can no longer issue
VSRESERVE
or
MOUNT
commands for the volume set.
Specifying the
NOW
parameter permits the operator to take the volume set offline immediately, unless a
VSRESERVESYS
or an
LMOUNT
command has been issued, or unless a program file has been allocated on the volume set.
This command restricts access to the volume set. Jobs or sessions are granted access to the volume set only if they have at least one open file on the volume set or if they have already issued an explicit
VSRESERVE
or a
MOUNT
command for the volume set.
The MPE/iX naming convention for volume sets differs from that of MPE V/E for private volumes.
In MPE V/E, the name A.B.C indicates that B is the name of a group and that C is the name of an account. MPE/iX accepts that name, but no interpretation is made as to the referencing of B and C. Instead, MPE/iX treats A.B.C as a single, long string name. It is the flexibility of the MPE/iX naming convention that makes it possible for MPE/iX to work with a volume set designated A.B.C.
MPE/iX volume set names may consist of any combination of alphanumeric characters, including the underbar (
_
) and the period (
.
). The name must begin with an alphabetic character and must consist of no more than 32 characters.
A volume set called
MY_OWN_PERSONAL_VOLUME_SET
is acceptable in MPE/iX, and so is
MY.OWN.PERSONAL.VOLUME.SET
; similarly, A.B.C is acceptable. If a volume set is named according to the MPE V/E naming convention (A.B.C), you must use an unambiguous reference when using the MPE/iX volume set commands, such as:
Vcommand A.B.C
Entering
Vcommand A
fails to access the volume set. You cannot specify the first part of the volume set name alone and expect the group and account to default.
Use
This command may be issued from a session, job, program, or in BREAK. Pressing
Break
has no effect on this command. This command may be issued only from the system console unless distributed to other users with the
ALLOW
command.
Chapter 8 691
Command Definitions SP-Z
VSCLOSE
Examples
To close the volume set
ACCOUNTING_PAYROLL
, enter:
VSCLOSE ACCOUNTING_PAYROLL
However, if a
VSRESERVESYS
command has been issued for
ACCOUNTING_PAYROLL
, then a message is displayed on the console. In order to close this volume set and take it offline, the operator has to issue these commands:
VSRELEASESYS ACCOUNTING_PAYROLL
VSCLOSE ACCOUNTING_PAYROLL
Related Information
Commands
Manuals
The
VSxxxxxx
commands in this chapter,
DISMOUNT
Volume Management Reference Manual
692 Chapter 8
