CHECK-LIBRARY checks the consistency of block allocation in a library to ensure that no blocks are assigned twice in the library for different elements.
This function has two execution modes:
- Quick mode:
Only the control information (from TOC up to Control area) is read for the consistency check. Consistency of BIT allocation in Disk Management block will be checked here, but readability of Format A record (header consistency) will not be checked. - Complete mode:
Along with control information, Format A data blocks are read as well covering all consistency checks.
If the library is corrupted, the message LMS0021 is output, otherwise no output is produced.
CHECK-LIBRARY | ||||||||||||||||
| ||||||||||||||||
LIBRARY = *STD / <filename 1..54 without-vers> / *LINK(...)
Specifies the library which is to be checked.
LIBRARY = *STD
Checks the library which was globally opened by means of OPEN-LIBRARY.
LIBRARY = <filename 1..54 without-vers>
Checks the library with the name specified here.
LIBRARY = *LINK(...)
Checks the library assigned via the link name.
LINK-NAME = <structured-name 1..8>
Link name of the library; this name was defined by means of a /ADD-FILE-LINK command prior to calling LMS.
MODE = *QUICK/ *COMPLETE
Indicates whether a quick or a complete check has to be done.
MODE = *QUICK
Only the control information is read for consistency check.
MODE = *COMPLETE
Format A data blocks are read as well covering all consistency checks.
Statement return code
(SC2) | SC1 | Maincode | Meaning |
| 0 | CMD0001 | No error |
Required access rights
Read authorization for the library specified by LIBRARY.
Examples
The library is not corrupted:
//CHECK-LIBRARY LIBRARY=OK.FORMATANo output means that the library is consistent.
The library is corrupted:
//CHECK-LIBRARY LIBRARY=CORRUPT.DUP% LMS0021 LIBRARY DESTROYED