Check mount state of a disk
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing code: | D |
Function
This command checks the mount state of disk devices. The disk monitor (DM) is called to update the online state of the specified devices if the mounting or dismounting of a disk is not recognized by the system because of a missing activation interrupt.
Format
CHECK-DISK-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 and updated.
UNIT = *ALL
All disk drives 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>
Specifies the mnemonic device names (2 or 4 alphanumeric characters) of the devices whose mount state is to be checked and updated. 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):
NKVD010 DISK vsn IS MOUNTED ON mn
NKVD011 DISK vsn IS DISMOUNTED FROM mn
No message is issued for devices whose online state has not changed.
ACTION = *REPORT
Like UPDATE; in addition the device error state is logged via message EXC0857 if no volume is recognized as online.
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 | NKVD002 | Disk monitor not available |
Note
The SHC-OSD subsystem requires the assignment of mnemonics to volume numbers for the supported disks. BS2000 determines the volume numbers during system power-up and during attachment of devices (/ATTACH-DEVICE) and enters them into the BS2000 device table.
If the configuration is changed in the storage system, the assignment of mnemonics to volume numbers can change as well. In these cases, the mnemonic <mn> can be used to update the volume number for the disk:
/CHECK-DISK-MOUNT UNIT=<mn>,ACTION=*UPDATE
If BS2000 recognizes a change, the volume numbers are updated for all other disks in the storage system automatically.