HP 3000 Manuals HP 3000 Manuals
VSCLOSE
Informs the system to close the specified volume set and take it offline.
(Native Mode)
Syntax
VSCLOSE volumesetname [[;PARTVS=] {USER }] [;NOW ]
[ {BACKUP}] [;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 This option is available only with the Mirrored
Disk/XL, a separately purchased product. For
information, refer to 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 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 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.
SPLIT 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.
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.
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 The VSxxxxxx commands in this chapter, DISMOUNT
Manuals Volume Management Reference Manual (32650-90045)