CHECK-LIBRARY überprüft die Konsistenz der Blockzuordnung in einer Bibliothek, um sicherzustellen, dass in der Bibliothek keine Blöcke für verschiedene Elemente doppelt zugewiesen werden.
Diese Funktion verfügt über zwei Ausführungsmodi::
- Schneller (Quick) Modus:
Für die Konsistenzprüfung werden nur die Kontrollinformationen (vom TOC bis zum Kontrollbereich) gelesen. Dabei wird die Konsistenz der BIT-Zuweisung im Datenträgerverwaltungsblock überprüft, die Lesbarkeit des Format-A-Datensatzes (Header-Konsistenz) wird jedoch nicht überprüft. - Vollständiger (Complete) Modus:
Neben den Steuerinformationen werden auch Format A Datenblöcke gelesen, um alle Konsistenzprüfungen abzudecken.
Wenn die Bibliothek zerstört ist, wird die Fehlermeldung LMS0021 ausgegeben, andernfalls erfolgt keine Ausgabe.
CHECK-LIBRARY | ||||||||||||||||
| ||||||||||||||||
LIBRARY = *STD / <filename 1..54 without-vers> / *LINK(...)
Gibt die zu überprüfende Bibliothek an.
LIBRARY = *STD
Überprüft die Bibliothek, die global mit OPEN-LIBRARY geöffnet wurde.
LIBRARY = <filename 1..54 without-vers>
Überprüft die Bibliothek mit dem hier angegebenen Namen.
LIBRARY = *LINK(...)
Überprüft die über den Dateikettungsnamen zugewiesene Bibliothek.
LINK-NAME = <structured-name 1..8>
Dateikettungsname der Bibliothek, der vor dem Aufruf von LMS mit einem /ADD-FILE-LINK-Kommando vereinbart wurde.
MODE = *QUICK/ *COMPLETE
Gibt an, ob eine schnelle oder eine vollständige Prüfung durchgeführt werden soll.
MODE = *QUICK
Zur Konsistenzprüfung werden nur die Kontrollinformationen gelesen.
MODE = *COMPLETE
Format A Datenblöcke werden ebenfalls gelesen, um alle Konsistenzprüfungen abzudecken.
Anweisungs-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
0 | CMD0001 | Ohne Fehler | |
1 | 0 | LMS0036 | Bibliothek nicht zugewiesen |
1 | CMD0230 | Syntaxfehler | |
32 | LMS0021 | Bibliothek zerstört | |
32 | LMS1002 | Interner Fehler | |
64 | LMS1004 | Sonstige Fehler | |
130 | LMS0041 | Systemadressraum erschöpft |
Notwendige Zugriffsrechte
Leserecht für die durch LIBRARY angegebene Datei
Beispiele
The library is not corrupted:
//CHECK-LIBRARY LIBRARY=OK.FORMATAKeine Ausgabe bedeutet, dass die Bibliothek konsistent ist.
Die Bibliothek ist zerstört:
//CHECK-LIBRARY LIBRARY=CORRUPT.DUP% LMS0021 BIBLIOTHEK ZERSTOERT