DETACH-DEVICE (Detach hardware units)

This command allows the operator to detach one or more hardware units from the system and thus prevent the operating system from using these units.

Format (VM2000-specific operands)

DETACH-DEVICE

UNIT = ... / *CHANNEL(...) / *CONTROLLER(...) / *CHANNEL-RANGE(...) / *PUBSET-DEVICES(...) / ...
	. . .
	*CHANNEL(...)
		|	CHANNEL-PATH-ID = list-poss(16): <x-text 2..2>
		|	,SCOPE = *OWN-SYSTEM-ONLY / *VM2000-GLOBAL
	*CONTROLLER(...)
		|	CONTROLLER-UNIT = list-poss(16):<alphanum-name 2..2> / <x-text 4..4>
		|	,SCOPE = *OWN-SYSTEM-ONLY / *VM2000-GLOBAL
	*CHANNEL-RANGE(...)
		|	FROM = <x-text 2..2>
		|	,TO = <x-text 2..2>
		|	,SCOPE = *OWN-SYSTEM-ONLY / *VM2000-GLOBAL
	*PUBSET-DEVICES(...)
		|	PUBSET = list-poss(255): <cat-id 1..4> / *BY-PUBRES-DEVICE(...)
		|		*BY-PUBRES-DEVICE(...)
		|			|	UNIT = list-poss(255): <alphanum-name 2..2> / <x-text 4..4>
	. . .
,FORCE = *STD / *YES / *NO(...) / *UNCONDITIONAL-OFFLINE

Description of the operands (VM2000-specific operands)

UNIT = *CHANNEL(...) / *CONTROLLER(...) / *CHANNEL-RANGE(...) / *PUBSET-DEVICES(...)
Specifies the channels or controllers or pubsets that are to be detached. The devices of a pubset can also be controlled as a unit (with analogous syntax *PUBSET-DEVICES(...)) in the VM2000 commands.

SCOPE = (nur für *CHANNEL, *CONTROLLER, *CHANNEL-RANGE)
Specifies how the command is to be executed in VM2000 operating.

SCOPE = *OWN-SYSTEM-ONLY
The command is carried out only in the local system.

SCOPE = *VM2000-GLOBAL
If entered in the monitor system (SU /390), the command is executed in all guest systems.
If entered in another guest system or in the monitor system of an SU x86, the command is rejected with message NKR0178.
The command is rejected for hardware units if one of the guest systems is protected against global detachment (system parameter VMGIORAL=NO) and if the hardware unit that is to be detached is not yet in the DETACHED state (unless FORCE=*UNCONDITIONAL-OFFLINE has been specified for channels).

. . .

FORCE =
Specifies the mode of execution.

FORCE = *UNCONDITIONAL-OFFLINE
Operand value only for the monitor system on SU /390.
The reconfiguration request is to be executed regardless. In contrast to FORCE=*YES, the hardware action associated with the request must always be carried out. This setting is only permissible when channels are detached (CHANNEL or CHANNEL-RANGE).
The protection of one of the guest systems against global detachment (system parameter VMGIORAL=NO) is ignored when this operand is specified.