Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Informs the system to close the specified volume set and take it offline.
VSCLOSE volumesetname [ [;PARTVS=] {USER } ] {BACKUP} [{;NOW }] {;SPLIT}
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, 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.
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.
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
Commands: VSOPEN, STORE, DSTAT Back to Main Index