Remove input/output unit from configuration
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing code: | G |
Function
Using the REMOVE-IO-UNIT command, systems support staff can dynamically remove input/output devices from a configuration. Input/output units (devices, controllers, channels) that are DETACHED can be removed from the configuration in this process. If an “internal” unit is removed (channel or controller), the system implicitly also removes the relevant “external” devices (controllers or devices), provided they are not allocated to some other “internal” unit. Input/output devices have to be removed in the order device -> controller -> channel.
The command is only accepted if the dynamic I/O configuration change was started successfully (see START-CONFIGURATION-UPDATE command).
Format
REMOVE-IO-UNIT |
Operands
UNIT = *CHANNEL(...) / *CONTROLLER(...) / *DEVICE(...)
Specifies the input/output units to be removed from the configuration.
UNIT = *CHANNEL(...)
Specifies a channel to be removed from the configuration. Controllers and devices that can only be accessed through this channel are implicitly removed along with the channel.
NAME = <alphanum-name 2..3>
Mnemonic device code of a channel.
UNIT = *CONTROLLER(...)
Specifies a controller to be removed from the configuration. Devices that can only be accessed via this controller are implicitly removed along with it.
NAME = <alphanum-name 2..2> / <x-text 4..4>
Mnemonic device code of a controller.
UNIT = *DEVICE(...)
Name of the device to be removed from the configuration.
NAME = <alphanum-name 2..2> / <x-text 4..4>
Mnemonic device code.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | NKR0006 | Syntax error | |
64 | CMD0216 | No authorization | |
1 | 64 | NKR0169 | System error |
2 | 64 | NKR0169 | Wrong parameter |
3 | 64 | NKR0169 | Dynamic I/O configuration change was rejected |
4 | 64 | NKR0169 | Dynamic I/O configuration change not supported |
5 | 64 | NKR0169 | Input/output unit not removed |
9 | 64 | NKR0169 | Input/output unit not defined |
11 | 64 | NKR0169 | Path to input/output unit not removed |
12 | 64 | NKR0169 | Dynamic I/O configuration change was not started |
14 | 64 | NKR0169 | Configuration changes not completed in the guest system |
16 | 64 | NKR0169 | Another guest system is being started |
17 | 64 | NKR0169 | Another guest system is being terminated |
18 | 64 | NKR0169 | Dynamic I/O configuration change not supported by one or several guest systems |