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(6): *FILE-NAME / *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 die 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
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.
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
|
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).