VSRESERVE



VSRESERVE


Notifies the system to keep a particular volume set on line.
This corresponds to the MPE V/E MOUNT command.

SYNTAX


VSRESERVE [volumesetname][;GEN=genindex]

PARAMETERS


volumesetname The name of the MPE/iX volume set to be kept online.
If you omit the parameter, the request is issued for
the home volume set of the user's logon group and
account. Refer to "OPERATION".

genindex A value from -1 to 32,767 specifying which
generation of the volume set is to be kept online.
If you omit the parameter, the system does not check
the generation version of the specified volume set.

OPERATION


This command calls for the specified volume set to be kept
online, and prevents the console operator from taking a
particular volume set offline. Once this is done, the
volume set is designated as being in use by the user. It
will remain in this reserved state until the user issues a
VSRELEASE command or the operator issues a VSCLOSE ;NOW
command; or until the user logs off.

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 will
accept 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 new
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/iX, and so is MY.OWN.PERSONAL.VOLUME.SET; similarly,
A.B.C is acceptable.

Be aware, though, that if a volume set is named according to
the old MPE V/E naming convention (A.B.C), then you must use
an unambiguous reference when using the MPE/iX volume set
commands. For example, the command below works:

Vcommand A.B.C

The next command, however, will fail to access the volume set,
since you cannot specify the first part of the volume set name
alone and expect the group and account to default.

Vcommand A

This command may be issued from a session, job, in BREAK or
from a program. Pressing [Break] has no effect on this
command. You must have UV (Use Volumes) or CV (Create
Volumes) capability to use this command.

EXAMPLE(S)

     To request that volume set ACCOUNTING_PAYROLL be kept
     online, enter

     VSRESERVE ACCOUNTING_PAYROLL

ADDITIONAL INFORMATION

Commands:   The VSxxxxxx commands.

Manuals : Volume Management Reference Manual (32650-90045)