Cancel assignments of tape devices to depots
| Component: | BS2000 | 
| Functional area: | Device management | 
| Domain: | DEVICE | 
| Privileges: | OPERATING | 
| Routing code: | T | 
Function
The REMOVE-DEVICE-DEPOT command is used to cancel the assignment of tape devices to depots created by means of the ADD-DEVICE-DEPOT command. This command can only be processed successfully if the device is DETACHED or not used. Otherwise, message NKG0010 is issued. If UNIT-*ALL is specified, no device with that depot may be allocated. Otherwise, message NKG0009 is issued.
Format
| REMOVE-DEVICE-DEPOT | 
| UNIT = *ALL / list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4> ,LOCATION = *ALL / <alphanum-name 1..8> | 
Operands
UNIT =
Specifies one or more (up to 10) tape devices whose assignment to a depot is to be canceled.
As soon as the last device has been removed from a depot, all information on the depot involved is deleted implicitly.
UNIT = *ALL
All device assignments to the specified depot are to be canceled.
UNIT = list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4>
The assignment of the devices identified by their mnemonic names to the specified depot is to be canceled. A maximum of 10 devices may be specified.
LOCATION =
Specifies the depot for which the assignment of the specified devices (UNIT operand) is to be canceled.
LOCATION = *ALL
The assignment of the specified devices (UNIT operand) is to be canceled for all known depots.
LOCATION = <alphanum-name 1..8>
Name of the depot for which the assignment of the specified devices (UNIT operand) is to be canceled. 
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 | NKVT002 | Tape monitor not available |