DETACH-DEVICE (Hardware-Einheiten wegschalten)

Mit diesem Kommando kann das Operating eine oder mehrere Hardware-Einheiten vom System wegschalten und damit dem Betriebssystem die Benutzung dieser Einheiten untersagen.

Format (VM2000-spezifische Operanden)

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

Operandenbeschreibung (VM2000-spezifische Operanden)

UNIT = *CHANNEL(...) / *CONTROLLER(...) / *CHANNEL-RANGE(...) / *PUBSET-DEVICES(...)

Legt Kanäle, Steuerungen oder Pubsets fest, die weggeschaltet werden sollen.
Die Geräte eines Pubset können auch in den VM2000-Kommandos als Einheit (mit analoger Syntax *PUBSET-DEVICES(...)) bedient werden.

SCOPE = (nur für *CHANNEL, *CONTROLLER, *CHANNEL-RANGE)
Gibt an, wie das Kommando unter VM2000 ausgeführt werden soll.

SCOPE = *OWN-SYSTEM-ONLY
Das Kommando wird nur im lokalen System ausgeführt.

SCOPE = *VM2000-GLOBAL
Bei Eingabe im Monitorsystem (SU /390) wird das Kommando in allen Gastsystemen ausgeführt.
Bei Eingabe in einem anderen Gastsystem oder im Monitorsystem einer SU x86 wird das Kommando mit der Meldung NKR0178 abgewiesen.
Das Kommando wird für Hardware-Einheiten abgewiesen, wenn eines der Gastsysteme gegen globales Wegschalten geschützt ist (Systemparameter VMGIORAL=NO) und sich die wegzuschaltende Hardware-Einheit noch nicht im Zustand DETACHED befindet (außer es wurde FORCE=*UNCONDITIONAL-OFFLINE für Kanäle angegeben).

. . .

FORCE =
Legt den Ausführungsmodus fest.

FORCE = *UNCONDITIONAL-OFFLINE
Operandenwert nur für das Monitorsystem auf SU /390.
Der Rekonfigurationsauftrag soll in jedem Fall ausgeführt werden. Anders als bei FORCE=*YES soll die mit dem Auftrag verbundene Hardware-Aktion unbedingt ausgeführt werden. Diese Einstellung ist nur zulässig beim Wegschalten von Kanälen (CHANNEL oder CHANNEL-RANGE).
Der Schutz eines der Gastsysteme gegen globales Wegschalten (Systemparameter VMGIORAL=NO) wird bei dieser Angabe ignoriert.