Berechtigung ADA, DA, Administrator ohne Domänen
Diese Anweisung gibt ohne Zuhilfenahme anderer Komponenten von MAREN Informationen aus den MAREN-Katalogdateien aus.
Format
SHOW-MAREN-FILE | Kurzname: SHMF |
FILE-NAME = *MARENCAT / *MARENLOG / <filename 1..54> | |
Operandenbeschreibung
FILE-NAME =
FILE-NAME = *MARENCAT
Einträge aus dem aktuellen MAREN-Katalog werden ausgegeben.
FILE-NAME = *MARENLOG
Einträge aus der aktuellen MAREN-Logging-Datei werden ausgegeben.
FILE-NAME = <filename 1..54>
Name der Datei, aus der die MAREN-Katalogeinträge ausgegeben werden sollen.
Folgende Dateien können gelesen werden:
Volume-Katalog
Es können sowohl der aktuelle Volume-Katalog von MAREN als auch beliebige Kopien davon zugewiesen werden.Logging-Dateien
Auch hier kann sowohl die aktuelle und daher noch geöffnete, als auch eine frühere, evtl. aus mehreren Dateien zusammengemischte Logging-Datei verwendet werden.Ausgabedateien
Es handelt sich dabei um Dateien, die vollständige Katalogeinträge im MAREN-Format enthalten und mithilfe verschiedener Anweisungen der Programme MAREN und MARENADM erstellt werden können.//SHOW-VOLUME-ATTRIBUTES OUTPUT=<filename>
Anwendungsmöglichkeiten
Für SHOW-MAREN-FILE gibt es u.a. folgende Anwendungsmöglichkeiten:
Trotz Ausfall des Steuerprogramms MARENCP können Informationen aus dem MAREN-Katalog abgerufen werden.
Die bei verschiedenen Anweisungen, z.B. RESERVE-FREE-VOLUME erstellbaren Ausgabedateien können ausgewertet werden.
Alle Zugriffe auf ein Band können auf einfache Weise anhand der Logging-Dateien untersucht werden.
Die Ausgabe der Katalogeinträge und der MAREN-Parameter erfolgt im selben Format wie bei den Anweisungen SHOW-VOLUME-ATTRIBUTES VOL=<vsn> und SHOW-MAREN-PARAMETERS.
Nach der Eingabe der Anweisung werden je nach angegebenem Dateityp (Volume-Katalog, Logging-Datei oder Ausgabedatei) unterschiedliche Eingabealternativen angeboten.
Hinweise
Nach der Eingabe des Dateinamens wird diese Datei überprüft. So wird zuerst anhand verschiedener Dateimerkmale überprüft, ob es sich bei der Datei um eine Katalogdatei handelt und wenn ja, um welchen Typ. Um auch auf aktuelle Katalogdateien zugreifen zu können, wird die Dateieröffnung bei einem Volume-Katalog bzw. einer Logging-Datei im Modus SHARED-UPDATE=YES vorgenommen.
Handelt es sich um einen Volume-Katalog, so werden danach die MAREN-Parameter (sie befinden sich immer im ersten Satz des Volume-Katalogs) ausgegeben und anschließend erfolgt jeweils die Eingabeaufforderung:
MARM1E2 ENTER: VSN / POS(VSN) / +N / -N / ++ / -- / 'ETX' / END
Wurde eine Logging-Datei zugewiesen, so erscheint ohne vorherige Ausgabe die Eingabeaufforderung:
MARM1E3 ENTER: FROM=VSN / LIST=VSN / VSN / +N / -N / ++ / -- / 'ETX' / END
Handelt es sich um eine Ausgabedatei, so wird daraus der erste Katalogeintrag aufgezeigt. Danach erfolgt jeweils die Eingabeaufforderung:
MARM1E1 ENTER: +N / -N / ++ / -- / 'ETX' / END; RECORD COUNTER = '(&00)'
Das Katalogeintragsfeld SATZZAEHLER informiert bei den im Dateiformat SAM erstellten MAREN-Ausgabedateien darüber, der wievielte Satz aus der Datei mit der zuletzt durchgeführten Aktion gelesen wurde. Durch Eingabe von „++“ (Positionieren auf Dateiende) lässt sich somit auf einfache Weise ermitteln, wie viele Katalogeinträge die Ausgabedatei enthält.
Folgende Parameter können bei allen Arten von Eingabedateien verwendet werden:
Parameter | durchgeführte Aktion / Hinweise |
+n | Ab der aktuellen Position werden „n“ Sätze in Richtung Dateiende gelesen und danach der betreffende Satz ausgegeben (n = max. 6-stellige Zahl). |
-n | Ab der aktuellen Position werden „n“ Sätze in Richtung Dateianfang gelesen und danach der betreffende Satz ausgegeben (n = max. 6-stellige Zahl). |
++ | Der letzte Satz der Datei wird ausgegeben. |
-- | Der erste Satz der Datei wird ausgegeben. |
'ETX' | (entspricht |
END | Die Ausgabe wird beendet. Im Anschluss daran können weitere MARENADM-Anweisungen eingegeben werden. |
Folgende Parameter können zusätzlich angegeben werden, wenn es sich bei der Eingabedatei um einen Volume-Katalog handelt:
Parameter | durchgeführte Aktion / Hinweis |
vsn | In der Eingabedatei wird der erste Satz mit der angegebenen Archivnummer (z.B. TAPE01) gezeigt. |
POS(vsn) | Im Volume-Katalog wird an die Stelle der betreffenden Archivnummer positioniert und danach der nachfolgende Satz gelesen. Es kann sich dabei um den Katalogeintrag zur angegebenen oder, falls dieser nicht vorhanden, zur nächsthöheren Archivnummer handeln. |
Zusätzlich zu den bei allen Dateiarten angebbaren Parametern sind bei Logging-Dateien noch folgende Eingaben möglich:
Parameter | durchgeführte Aktion / Hinweis |
vsn | Der erste Logging-Eintrag zur angegebenen Archivnummer wird angezeigt. |
FROM=vsn | Eine Kurzinformation aller Logging-Einträge ab der betreffenden Archivnummer wird ausgegeben, wobei innerhalb der einzelnen Archiv- und Dateifolgenummern die Logging-Einträge zeitlich sortiert sind. |
LIST=vsn | Eine Kurzinformation aller Logging-Einträge zur betreffenden Archivnummer wird in der zeitlichen Reihenfolge von deren Erstellung ausgegeben. |
Erstreckt sich bei den Parametern FROM=<vsn> und LIST=<vsn> die Ausgabe über mehr als einen Bildschirm, so kann diese durch Drücken der Taste 
unterbrochen werden.
Wird beim Blättern ein FREE-POOL-Satz gefunden, wird statt der Ausgabemaske die Meldung ausgegeben:
MARM214 FREE-POOL-NAME '(&00)', LAST ACCESS FUNCTION NAME '(&01)', FUNCTION NUMBER '(&02)'
Durch Setzen des Auftragsschalters 5 kann erreicht werden, dass auch im Dialogbetrieb die Ausgabe der Katalogeinträge und der MAREN-Parameter nicht in einer einzigen Bildschirmmaske, sondern zeilenweise erfolgt. Dies bewirkt eine bessere Lesbarkeit dieser Einträge in SYSOUT-Protokollen. Im Batchbetrieb erfolgt die Ausgabe zeilenweise.
Ausgabe von Logging-Sätzen
Bei den Logging-Sätzen wird zuerst der darin enthaltene Katalogeintrag und danach noch die Logging-Information ausgegeben. Diese gibt Auskunft darüber, wann und auf welchem Pubset der Logging-Satz geschrieben wurde. Beispiel:
** LOGGING RECORD WRITTEN AT DATE: <date> AT TIME: <time> ON PVS: PI1B **
Sollen bei Logging-Dateien alle Sätze zu einer oder ab einer bestimmten Archivnummer ausgegeben werden (Parameter LIST=vsn bzw. FROM=vsn), so werden lediglich einige Katalogeintragsfelder daraus aufgelistet. Es werden keine kompletten Katalogeinträge aufgelistet.
Im Einzelnen handelt es sich um folgende Informationen (vorangestellt die Abkürzungen aus der Überschriftszeile):
VOLUME | - Archivnummer (VOLUME) |
FSEQ | - Dateifolgenummer (FILE-SEQUENCE) |
C# | - Prüfziffer (CHECK-COUNT) |
FUNCNAME | - Funktionsname des letzten Zugriffs (LAST-ACCESS-FUNCTION-NAME) |
FF | - Funktionskennzeichen des letzten Zugriffs (LAST-ACCESS-FUNCTION-FLAG) |
LOG-DATE | - Datum der Erstellung des Logging-Eintrags |
LOG-TIME | - Uhrzeit der Erstellung des Logging-Eintrags |
C-ID | - Katalogkennung des Pubsets, an dem der Logging-Eintrag geschrieben wurde |
HOSTNAME | - Name des Systems, an dem das Band zuletzt verarbeitet wurde |
STA | - Status des Bandes (VOLUME-STATUS) |
DV | - Gerätetyp (DEVICE-TYPE) in interner Darstellung |
MN | - Mnemotechnischer Name des Geräts, an dem das Band zuletzt verarbeitet wurde (DEVICE-NAME) |
TSN | - TSN des Tasks, der das Band zuletzt bearbeitet hat (LAST-ACCESS-TSN) |
RES# | - Reservierungszähler des Bandes (RESERVATION-COUNT) |
Beispiel
Im nachfolgenden Beispiel werden aus der Datei $SYSMAREN.MARENLOG.14 folgende Informationen ausgegeben:
nach
der erste Logging-Satz für das Band „A00001“nach Eingabe von LIST=TST001 alle Logging-Einträge zum Band „TST001“ in Kurzform
|
Mit END wird die SHOW-Ausgabe beendet.