Berechtigung Administratoren, die unter der Benutzerkennung TSOS arbeiten
Mit dieser Anweisung können bestehende Unterschiede zwischen dem MAREN-Katalog und dem Dateikatalog (TSOSCAT) bezüglich Banddateien und Dateigenerationsgruppen ermittelt werden.
Die Anweisung gibt auch belegte Bänder mit älteren Dateigenerationen frei.
Gründe für die Unterschiede können sein:
der MAREN-Katalog enthält Informationen, die mehrere Systeme betreffen
der MAREN-Katalog enthält eindeutige Archivnummern-Zuordnungen, aber es können mehrere Einträge mit demselben Dateinamen existieren
der TSOSCAT kann mehrere Dateigenerationseinträge zu einer Archivnummer enthalten
Änderungen am TSOSCAT mit dem Kommando EXPORT-FILE werden nicht automatisch in den MAREN-Katalog übernommen
Format
| CHECK-TSOSCAT | Kurzname: CHTS | |||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
TYPE-OF-FILES =
Gibt an, welche Arten von Banddateien überprüft werden sollen.
TYPE-OF-FILES = *ANY(...)
Es sollen die Katalogeinträge von allen Banddateien überprüft werden (siehe die „Hinweise zu TYPE-OF-FILES = *ANY“).
ATTRIBUTES = *FILE-NAME / list-poss(7): *FILE-NAME / *USER-IDENTIFICATION / *USER-ACCESS / *CREATION-DATE / *EXPIRATION-DATE / *LAST-ACCESS-DATE / *FIRST-VOLUME
Gibt an, welche Datei- bzw. Bandeigenschaften auf eventuelle Unterschiede hin überprüft werden sollen.
TYPE-OF-FILES = *FGG-ONLY(...)
Es soll für alle im TSOSCAT katalogisierten Dateigenerationsgruppen geprüft werden, ob es dazu im MAREN-Katalog noch Einträge zu älteren Generationen gibt, die im TSOSCAT nicht mehr vorhanden sind (siehe „Hinweise zu TYPE-OF-FILES = *FGG-ONLY“).
FREE-DATE =
Gibt an, ob ältere Dateigenerationen nur protokolliert oder zusätzlich auch die dazugehörigen Bänder im MAREN-Katalog freigegeben werden sollen.
FREE-DATE = *UNCHANGED
Ältere Dateigenerationen werden lediglich protokolliert.
FREE-DATE = *TODAY
Ältere Dateigenerationen werden protokolliert und alle dazugehörigen Bänder freigegeben.
FREE-DATE = *DIALOG
Wird eine ältere Dateigeneration gefunden, so wird der komplette MAREN-Katalogeintrag des dazugehörigen Bandes ausgegeben. Der Benutzer kann danach entscheiden, ob das Band freigegeben werden soll oder nicht. Falls gewünscht, kann er an dieser Stelle auch die Anweisungsausführung beenden. Die Angabe DIALOG ist im Batchbetrieb nicht erlaubt.
Hinweise
Da nur die Systembetreuung unbeschränkten Zugriff zu den Katalogeinträgen von fremden Benutzerkennungen hat, ist eine sinnvolle Durchführung dieser Anweisung nur unter der Benutzerkennung TSOS möglich. Die Eingabe der MARENADM-Anweisung CHECK-TSOSCAT unter einer nichtprivilegierten Benutzerkennung wird mit der Meldung MARM1C0 abgewiesen.
Möchte der MAREN-Administrator einen TSOSCAT-Abgleich nur für seine eigene Benutzerkennung durchführen, so hat er dazu die gleich lautende Anweisung des Benutzerprogramms MAREN zu verwenden.
Hinweise zu TYPE-OF-FILES = *ANY
Diese Funktion protokolliert lediglich bestehende Unterschiede in den TSOSCAT- und MAREN-Katalogeinträgen von Banddateien. Sie nimmt keine Änderungen am MAREN-Katalog vor. Dabei werden nur die explizit im Operanden ATTRIBUTES angegebenen Merkmale verglichen.
Für jedes in den TSOSCAT-Einträgen von Banddateien enthaltene und auch tatsächlich beschriebene Band wird der dazugehörige MAREN-Katalogeintrag gelesen. Gibt es das Band nicht im MAREN-Katalog, ist es dort einer anderen Benutzerkennung zugeordnet oder als freies Band eingetragen, so erscheint eine Ausgabezeile die neben dem Dateinamen aus dem TSOSCAT die Archivnummer mit dem betreffenden Hinweis „NOT EXISTING“ bzw. „NOT RESERVED“. Es findet kein Vergleich einzelner Attribute statt.
Enthält das Band im MAREN-Katalogeintrag das Kennzeichen USER-ACCESS= FOREIGN-READ-ONLY (auf das Band kann von fremden Benutzerkennungen nur lesend zugegriffen werden), so unterbleibt ein Vergleich des Merkmals Mehrbenutzbarkeit, da es dafür keinen analogen Wert im TSOSCAT-Eintrag gibt.
Für temporäre Banddateien werden keine Vergleiche angestellt.
Hinweise zu TYPE-OF-FILES = *FGG-ONLY
Werden im MAREN-Katalog Einträge zu Dateigenerationen gefunden, welche bei einer im TSOSCAT katalogisierten Dateigenerationsgruppe nicht mehr vorhanden sind, so werden diese bei Angabe von FREE-DATE = *UNCHANGED oder *TODAY mit folgenden Merkmalen protokolliert:
VOLUME USER-IDENTIFICATION FILE-NAME CREATION-DATE FREE-DATE
Im Falle von FREE-DATE = *TODAY wird danach das Freigabedatum des Bandes im MAREN-Katalog mit dem Tagesdatum versehen. Das Band bleibt damit nur bis zum nächsten Freigabelauf für die eigene Benutzerkennung reserviert.
Im Falle von FREE-DATE = *TODAY oder *DIALOG werden solche Bänder, deren Freigabedatum ohnehin schon abgelaufen ist, nicht ausgegeben und auch nicht modifiziert, da sie ohnehin beim nächsten Freigabelauf freigegeben werden.
Nicht erfasst werden die Katalogeinträge von temporären Banddateien sowie Bänder, die im MAREN-Katalog nicht der eigenen Benutzerkennung zugeordnet sind.
Beispiele
THE FOLLOWING DIFFERENCES EXIST BETWEEN MAREN CATALOG AND TSOSCAT: FILENAME IN TSOSCAT VSN /FSEQ IN MARENCAT ----------------------------------------------------------------------------- :2OSG:$USER1.TAPE.FILE.2 M5637K/0001 FILENAME IN TSOSCAT : TAPE.FILE.2 FILENAME IN MAREN : TAPE.FILE.2(1) ----------------------------------------------------------------------------- :2OSG:$USER1.TAPE.FILE.2(3) M5637K/0003 FILENAME IN TSOSCAT : TAPE.FILE.2(3) FILENAME IN MAREN : TAPE.FILE.2(4) ----------------------------------------------------------------------------- :DATA:$MAREN005.MRTP0007.001.TAPE.FILE-0 TLS017/0001 NOT RESERVED ----------------------------------------------------------------------------- :DATA:$MAREN005.MRTP0007.001.TAPE.FILE-1 TLS018/0001 NOT RESERVED ----------------------------------------------------------------------------- % MARM170 STATEMENT '//CHECK-TSOSCAT' PROCESSED |
Es werden alle Unterschiede zwischen MAREN-Katalog und TSOSCAT nach SYSOUT ausgegeben.
|
Es wird überprüft, ob zu Dateigenerationsgruppen im Dateikatalog ältere Dateigenerationen im MAREN-Katalog existieren. Die Namen der älteren Dateigenerationsgruppen werden nur nach SYSOUT ausgegeben (FREE-DATE=*UNCHANGED).