HP 3000 Manuals HP 3000 Manuals
System Volume Mounting Commands
The following system commands can be used with volume management to
notify the system that you want a volume set to remain physically mounted
for a period of time. Refer to the MPE/iX Commands Reference Manual
Volumes 1 and 2 (32650-90003 and 32650-90364) for more information on
these commands.
Table 5-2. System Volume Mounting Commands
---------------------------------------------------------------------------------------------
| | |
| Command | Task |
| | |
---------------------------------------------------------------------------------------------
| | |
| VMOUNT | Enables/disables the MPE XL nonsystem volume facility. |
| | |
| VSCLOSE | Closes a specified volume set and takes it offline. |
| | |
| VSOPEN | Reopens a volume set closed with VSCLOSE. |
| | |
| VSRELEASE | Releases a volume set that was explicitly reserved by the user |
| | with VSRESERVE. |
| | |
| VSRELEASESYS | Cancels a previously issued VSRESERVESYS command for a |
| | specified volume set. |
| | |
| VSRESERVE | Reserves a particular volume set online. |
| | |
| VSRESERVESYS | Reserves a volume set online system-wide. |
| | |
| VSUSER | Lists all users of a currently reserved, nonsystem volume set. |
| | |
---------------------------------------------------------------------------------------------
MPE XL and MPE V/E Commands
A number of MPE V/E commands have been changed in MPE XL. The XL commands
and their corresponding V/E commands are shown in Table 5-3 . This
section gives detailed descriptions and examples for these commands.
There are two user commands, VSRESERVE and VSRELEASE. The other commands
require system manager capability and can only be executed from the
console.
Table 5-3. MPE XL and MPE V/E Commands
-------------------------------------
| | |
| MPE XL | MPE V/E |
| | |
-------------------------------------
| | |
| VMOUNT | VMOUNT |
| | |
-------------------------------------
| | |
| VSOPEN | None. |
| | |
-------------------------------------
| | |
| VSCLOSE | None. |
| | |
-------------------------------------
| | |
| VSRELEASE | DISMOUNT |
| | |
-------------------------------------
| | |
| VSRELEASESYS | LDISMOUNT |
| | |
-------------------------------------
| | |
| VSRESERVE | MOUNT |
| | |
-------------------------------------
| | |
| VSRESERVESYS | LMOUNT |
| | |
-------------------------------------
| | |
| VSUSER | VSUSER |
| | |
-------------------------------------
VMOUNT
The VMOUNT command is used by the operator to enable and disable the
mountable (nonsystem) volume facility. At system startup the volume
facility is enabled to automatically answer nonsystem volume requests,
such as VSRESERVE and VSRESERVESYS. Without the AUTO parameter, the
operator has to respond to the requests.
Task
Enables nonsystem volumes.
Capability
SM, system manager capability and can only be issued from the console.
Syntax
VMOUNT {ON[,AUTO]} [;ALL]
{OFF }
Parameters
ON or ON,AUTO Enables the use of nonsystem volumes. When ON is
used without AUTO, the operator must reply to all
reserve-related requests. When ON,AUTO is used,
the system attempts to satisfy user reserve-related
requests without operator intervention.
OFF The operator can set VMOUNT to OFF, which will
cause the system to reject all requests to use
nonsystem volumes. Users who have already reserved
volume sets will not be affected. The command will
take effect when the last file is closed.
ALL The ALL parameter displays all reserve-related
messages on the system console. Optional.
Example
The example on the following page shows how to disable and enable the
volume set facility.
1. Disable the volume sets by entering the VMOUNT command at the
system prompt.
_______________________________________
| |
| |
| :VMOUNT OFF |
| |
| |
_______________________________________
2. Verify that the nonsystem volume sets cannot be accessed by trying
to open a file on a nonsystem volume that you know is online.
Verify that it cannot be opened.
3. Enable the volume set facility by entering the VMOUNT command.
_______________________________________
| |
| |
| :VMOUNT ON,AUTO |
| |
_______________________________________
4. Verify that the volume sets can be accessed by opening a file on a
volume set you know is online. Verify that it can be opened.
VSCLOSE
The VSCLOSE command is used by the operator to put a volume set in the
LONER state. If there are no files open in the volume set, the VSCLOSE
command closes the set at that time. If there are files open, the volume
set goes into a close-pending (CP) state. That means the set will be
closed when the last file is closed. Closing takes the volume set
offline and puts the volumes in the LONER state. The volumes can now be
removed from the system or deleted and reused.
This command is used by the operator to notify users that a volume set is
going to be removed. This command restricts access to the volume set.
Command patiently waits until all files are closed on the volume set
unless NOW specified then all users of volume set will be aborted and the
volume set will be ready for removal.
Any job/session that 1)has not done an explicit RESERVE/MOUNT on the
volume set and 2)currently has no files open on the volume set, will be
denied access to the volume set.
Task
Takes volumes offline.
Capability
SM, system manager capability and can only be issued from the console.
Syntax
VSCLOSE volsetname [; NOW]
Parameters
volsetname The volume set that will be taken offline.
Required.
NOW Aborts all users of the volume set immediately.
Optional.
Example
This example shows how to take a volume set offline and put it in the
LONER state.
1. Try to take the volume set offline by using the VSCLOSE command
when there is an open file or a VSRESERVE is in effect.
2. Verify that the "close pending" message displays.
3. Use DSTAT to verify that the volume set is still online. The CP*
indicates a close pending state for the volume set.
________________________________________________________________
| |
| |
| :VSCLOSE BSET |
| |
| VOLUME SET IN USE, CLOSE PENDING APPLIED TO VOLUME SET. |
| (CIERR 10637) |
| |
| :DSTAT |
| LDEV-TYPE STATUS VOLUME (VOLUME SET - GEN) |
| --------- --------- -------------------------- |
| 21-079350 CP*MASTER BVOL1 (BSET-0) |
| 22-079350 CP*MEMBER BVOL2 (BSET-0) |
| 23-079350 CP*MEMBER BVOL3 (BSET-0) |
| |
________________________________________________________________
4. Close the last file and verify that the volume set is
automatically taken offline and put in the LONER state.
________________________________________________________
| |
| |
| :DSTAT |
| |
| LDEV-TYPE STATUS VOLUME (VOLUME SET - GEN) |
| --------- ------ -------------------------- |
| 21-079350 LONER BVOL1 (BSET-0) |
| 22-079350 LONER BVOL2 (BSET-0) |
| 23-079350 LONER BVOL3 (BSET-0) |
| |
________________________________________________________
VSOPEN
The VSOPEN command cancels a VSCLOSE command and places the volume set
online.
After a VSOPEN command is issued, the volume set is ready for use. A
volume set is open unless explicitly closed by the VSCLOSE command.
Task
Places a previously closed volume set online.
Capability
SM, system manager capability and can only be issued from the console.
Syntax
VSOPEN volsetname
Parameter
volsetname The volume set that will be placed online.
Required.
Example
This example shows how to bring a volume set online.
1. To bring a volume set online, enter the VSOPEN command.
2. Verify that VSOPEN was effective by entering the DSTAT command.
The master/member status indicates that the set is online.
________________________________________________________
| |
| |
| :VSOPEN BSET |
| |
| :DSTAT |
| |
| LDEV-TYPE STATUS VOLUME (VOLUME SET - GEN) |
| --------- ------ -------------------------- |
| 21-079350 MASTER BVOL1 (BSET-0) |
| 22-079350 MEMBER BVOL2 (BSET-0) |
| 23-079350 MEMBER BVOL3 (BSET-0) |
| |
________________________________________________________
VSRELEASE
The VSRELEASE command allows the user to cancel the VSRESERVE command and
release a volume set so that it can be taken offline. Logging off the
system also releases the volume set.
If the volume set is not specified, then the home volume set of the
user's logon group and account is used.
Task
Releases a volume set.
Capability
No special capability required.
Syntax
VSRELEASE [ volsetname ]
Parameter
volsetname The volume set that will be placed online. If you
omit the volume set name, the request will be
issued for the home volume set of the user's logon
group and account. Optional.
Example
This example shows how to cancel a VSRESERVE command.
1. Enter the VSRELEASE command from the system prompt.
2. Verify that the volume set has been released.
________________________________________________________________
| |
| |
| :VSRELEASE BSET |
| |
| :VSUSER |
| |
| NO VOLUME SETS CURRENTLY RESERVED (CIERR 10625) |
| |
________________________________________________________________
VSRELEASESYS
The VSRELEASESYS command allows the operator to cancel the VSRESERVESYS
command and release a volume set to take it offline.
Negates the VSRESERVESYS command. Indicates that the system wide
reservation of the volume set is no longer in effect. It has no effect
on VSRESERVE commands issued by individual users on the system.
Task
Releases a volume set.
Capability
SM, system manager capability and can only be issued from the console.
Syntax
VSRELEASESYS volsetname
Parameter
volsetname The volume set that will be placed offline that was
previously issued a VSRESERVESYS command.
Required.
Example
This example shows how to cancel a VSRESERVESYS command by using the
VSRELEASESYS command.
_______________________________________
| |
| |
| :VSRELEASESYS BSET |
| |
_______________________________________
VSRESERVE
The VSRESERVE command allows a user to reserve a specified volume set.
This means that the volume set cannot be taken offline by the operator.
Whenever a user opens a file on a volume set, the system issues a
VSRESERVE. When the user closes the file, the volume set is released and
may be taken offline. A VSRESERVE is usually issued when a user may be
opening and closing files over a period of time and wants to make sure
the volume set remains available.
The VSRESERVE command is canceled when the user issues a VSRELEASE
command, or when the user logs off the system.
Reserves the volume set between file opens for the user. That is, it
notifies the system when the user does not explicitly have a file open on
the volume set, further access will be forthcoming. This prevents the
operator from taking the volume set offline. If no volume set is
specified, then the request is for the home volume set of the user's
logon group and account. Otherwise, the user must specify the full
volume set name. The reservation of the volume automatically ends when
the user logs off.
Task
Keeps a volume set online.
Capability
No special capability required.
Syntax
VSRESERVE [ volsetname ] [;GEN= genindex]
Parameters
volsetname The volume set that will be kept online. If this
parameter is omitted, the home volume set of the
user's logon group and account will be used.
Optional.
genindex A number from 1 to 100 specifying the new
generation number of the copied volume set. If it
is omitted, the generation number will be one
greater than the original volume set. Optional.
Example
This example shows how to reserve a volume set.
1. Check to make sure that the volume set is mounted and online.
Enter the DSTAT command from the system prompt. The master/member
status indicates that the set is online.
2. Reserve the volume set BSET by entering the VSRESERVE command from
the system prompt.
3. Verify that the reserve has taken effect by using the VSUSER
command.
________________________________________________________
| |
| |
| :DSTAT |
| |
| LDEV-TYPE STATUS VOLUME (VOLUME SET - GEN) |
| --------- ------ -------------------------- |
| 21-079350 MASTER BVOL1 (BSET-0) |
| 22-079350 MEMBER BVOL2 (BSET-0) |
| 23-079350 MEMBER BVOL3 (BSET-0) |
| |
| :VSRESERVE BSET |
| |
| :VSUSER |
| |
| VOLUME SET NAME JOBNUM JOBNAME |
| --------------- ------ ------- |
| BSET #S6 (USER.ACCT) |
| |
________________________________________________________
VSRESERVESYS
The VSRESERVESYS command is an operator command that reserves a volume
set on a system-wide basis. Logging on and off does not cancel the
reserve.
This command can be used when the operator wants to stream several jobs
that use files on the volume set. This system-wide reserve remains in
effect during the logging on and logging off of the jobs that use the
volume set.
Reserves the volume set for the entire system. This command indicates to
the system that the volume set is to remain online until an VSRELEASESYS
command is issued. Unlike the VSRESERVE command, this command is
unaffected by logging off.
Task
Keeps a volume set online.
Capability
SM, system manager capability, and can only be issued from the console.
Syntax
VSRESERVESYS volsetname
Parameter
volsetname The volume set that will be kept online. Required.
Example
This command shows how to reserve a volume set on a system-wide basis.
1. Use DSTAT to verify that the volume set is mounted and online.
The master/member status indicates that the set is online.
2. Reserve the volume set.
________________________________________________________
| |
| |
| :DSTAT |
| |
| LDEV-TYPE STATUS VOLUME (VOLUME SET - GEN) |
| --------- ------ -------------------------- |
| 21-079350 MASTER BVOL1 (BSET-0) |
| 22-079350 MEMBER BVOL2 (BSET-0) |
| 23-079350 MEMBER BVOL3 (BSET-0) |
| |
| :VSRESERVESYS BSET |
| |
________________________________________________________
3. Verify that the set is reserved by attempting to close it.
4. Verify that the volume set is still online. The master/member
status indicates that the set is online.
_____________________________________________________________
| |
| |
| :VSCLOSE BSET |
| |
| VSRESERVESYS (OR LMOUNT) IS IN EFFECT ON VOLUME SET. |
| (CIERR 10634) |
| |
| :DSTAT |
| |
| |
| LDEV-TYPE STATUS VOLUME (VOLUME SET - GEN) |
| --------- ------ -------------------------- |
| 21-079350 MASTER BVOL1 (BSET-0) |
| 22-079350 MEMBER BVOL2 (BSET-0) |
| 23-079350 MEMBER BVOL3 (BSET-0) |
| |
_____________________________________________________________
VSUSER
The VSUSER command lists all users who have reserved a nonsystem volume
set. It also displays the volume set name, job number, and the job names
of all users currently performing a reserve function.
Task
Lists all users of a currently reserved nonsystem volume set.
Capability
No special capability required.
Syntax
VSUSER [volsetname]
Parameter
volsetname The volume set that will be kept online. Optional.
Example
This example shows how to list all of the currently reserved volume sets
by using the VSUSER command.
_______________________________________________________
| |
| |
| :VSUSER |
| |
| VOLUME SET NAME JOBNUM JOBNAME |
| --------------- ------ ------- |
| BSET #S6 (USER.ACCT) |
| |
_______________________________________________________