CHANGE-DISK-MOUNT

Lock private disk

Component:	BS2000
Functional area:	Device management
Domain:	DEVICE
Privileges:	OPERATING
Routing code:	D

Function

This command denies the user access to a private disk already in use.

Format

CHANGE-DISK-MOUNT                                                                                                                              

UNIT = *VOLUME(...) / *EXCHANGE-PAIR(...) /
			list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4>
	*VOLUME(...)
		|		VOLUME = list-poss(10): <vsn 1..6>
	*EXCHANGE-PAIR(...)
		|		EXCHANGE-PAIR = list-poss(10): *PARAMETER(...)
		|			*PARAMETER(...)
		|				|	DISMOUNT-VOLUME = <vsn 1..6>
		|				|	,REMOUNT-VOLUME = <vsn 1..6>
,ACTION = *EXCHANGE / *MOVE / *CANCEL

Operands

UNIT =
Specifies one or more disks which are to be no longer available.

UNIT = *VOLUME(...)
Specifies the volume serial numbers (VSN, up to 6 characters) of one or more disks which are to be no longer available. A maximum of 10 disks may be specified.

VOLUME = list-poss(10): <vsn 1..6>
Specifies the volume serial number (VSN). 

UNIT = *EXCHANGE-PAIR(...)

This operand value is not relevant, as in this and subsequent versions on only hard disk devices are supported.

UNIT = list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4>
Lists up to 10 disks that are to be no longer available.

ACTION = *EXCHANGE / *MOVE / *CANCEL
Specifies the way in which the mount state is to be changed.

The operand values *EXCHANGE and *MOVE are not relevant, as in this and subsequent versions only hard disk devices are supported.

ACTION = *CANCEL
The allocated private disk specified under UNIT in the *VOLUME operand is no longer to be available to the user.
Every I/O request is rejected. Opened files are not closed; these files must be made available again using the REMOVE-FILE-ALLOCATION-LOCKS command before the next OPEN.
The disk parameters ASSIGN-TIME=*USER and USER-ALLOCATION=*NO are implicitly set. In this way all allocation requests are rejected until the disk is released by the occupying users. The disk can only be made available again (SET-DISK-VOL=...,USER=*ALL) after it has been released by all users. Until that time it is also defined as allocated in the SHOW commands (SH-DEV, SH-DISK).

The CANCEL function is an “emergency command” and should thus be used only in urgent cases, such as with a permanent INOP for the disk.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
	1	NKV0001	Syntax error
	64	NKV0004	Command partially processed
	64	NKV0005	Command not processed for an object
	64	NKV0006	Command not processed
	130	NKVD002	Disk monitor not available