VSRESERVE

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


VSRESERVE


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

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)

Back to Main Index