VSCLOSE


VSCLOSE

     Informs the system to close the specified volume set and
take it offline.

SYNTAX


VSCLOSE volumesetname

[ [;PARTVS=] {USER } ]
{BACKUP}
[{;NOW }]
{;SPLIT}

PARAMETERS


volumesetname 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, unless the NOW parameter
is specified. 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."

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 non-split 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 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 members of each volume
pair must be identical at the time of the split.

However, the ;NOW option cannot be used in
conjunction with the ;SPLIT option. There
can be no users logged onto the volume set
when the split is processed. It 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. An attempt is
made to place the backup volumes and user
volumes on separate hardware channels. 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.

OPERATION

     This command notifies the system to close the volume set and take
it offline once all users have ceased using files on the volume
set. If the operator specifies the NOW parameter, the volume set
is taken offline immediately unless a VSRESERVESYS or an LMOUNT
command has been issued, or unless a program file that resides
on the volume set is still allocated.

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 consist
of no more than 32 characters.

A volume set called MY_OWN_PERSONAL_VOLUME_SET is acceptable in MPE
XL, 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
XL volume set commands:

The following will work:

Vcommand A.B.C

Entering the following will fail to access the volume set:

Vcommand A

You cannot specify the first part of the volume set name alone and
expect the group and account to default.

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.

EXAMPLE(S)

     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

ADDITIONAL INFORMATION

Commands:   VSOPEN, STORE, DSTAT