Unload magnetic tape or magnetic tape cartridge
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing code: | T |
Function
The UNLOAD-TAPE command enables a magnetic tape or magnetic tape cartridge to be unloaded.
Format
UNLOAD-TAPE |
UNIT = *ALL / list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4> |
Operands
UNIT =
Specifies the devices to be unloaded.
UNIT = *ALL
The volumes of all tape devices which have the following attributes are unloaded:
CONF-STATE = ATTACHED or DETACH-PENDING
ACTION = NO ACTION
PHASE not equal MOUNT and PHASE not equal IN-USE.
UNIT = list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4>
Specifies the mnemonic device names of the devices to be unloaded. A maximum of 10 devices can be specified.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | 1 | NKV0001 | Syntax error |
4 | 64 | NKV0004 | Command partially processed |
5 | 64 | NKV0005 | Command not processed for an object |
6 | 64 | NKV0006 | Command not processed |
2 | 130 | NKVT002 | Tape monitor unavailable |
Note
I/O errors are logged via message NKVT098.