Check mount state of tape and MTC devices
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing code: | T |
Function
This command checks the mount state of tape devices and magnetic tape cartridge devices. The tape monitor (TM) is called to update the online state for the specified devices. A typical application is where the mounting or dismounting of a tape or magnetic tape cartridge is not recognized by the system because of the absence of an activation interrupt.
Format
CHECK-TAPE-MOUNT |
UNIT = *ALL / list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4> ,ACTION = *UPDATE / *REPORT |
Operands
UNIT =
Defines the devices whose mount state is to be checked.
UNIT = *ALL
All tape devices having the following attributes are checked:
ATTACHED or DETACH-PENDING
ACTION-STATE = NO ACTION
PHASE not equal MOUNT and PHASE not equal IN-USE.
UNIT = list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4>
The devices whose mount state is to be checked and updated are defined by means of their mnemonic name. A maximum of 10 devices may be specified.
ACTION =
Defines the logging of the online state.
ACTION = *UPDATE
An updated online state is to be logged by the following messages (default value):
NKVT010 TAPE vsn MOUNTED ON DEVICE mn
NKVT011 TAPE vsn DISMOUNTED FROM DEVICE mn
No message is issued for devices whose online state has not changed.
ACTION = *REPORT
Logging as for UPDATE; in addition the device error state is logged via message EXC0858 if no volume is recognized as online.
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
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 |