HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 8 Command Definitions SP-Z

VSCLOSE

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Informs the system to close the specified volume set and take it offline. (Native Mode)

Syntax

VSCLOSE volumesetname [[;PARTVS=] { USER BACKUP }] [ ;NOW ;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 User's Guide> 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

Feedback to webmaster