Anwendungsbereich: | SYSTEM-TUNING |
Privilegierung: | TSOS SW-MONITOR-ADMINISTRATION |
Funktionsbeschreibung
Das Kommando /SHOW-DAB-CACHING
informiert die Systembetreuung über die aktuell installierten Cache-Bereiche. Die angeforderte Information kann alle Statusdaten, eine Zusammenfassung der Statistikdaten oder (bei AREA=*BY-SYSTEM) die aktuell bedienten und unbedienten Datenbereiche für jeden Cache-Bereich umfassen.
/SHOW-DAB-CACHING
ausgegebenen kumulierten Statistikwerten.Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe "SHOW-DAB-CACHING Information über die aktuelle DAB-Konfiguration einholen").
Format
SHOW-DAB-CACHING | Kurzname: SHDABC | ||||||||||||||||
|
Operandenbeschreibung
CACHE-ID = *ALL / <alphanum-name 1..32>
Gibt an, über welchen Cache-Bereich Information ausgegeben werden sollen.
CACHE-ID = *ALL
Die Konfigurations- und Statistikdaten aller vorhandenen Cache-Bereiche sollen ausgegeben werden.
CACHE-ID = <alphanum-name 1..32>
Name des Cache-Bereichs, für den die Konfigurations- und Statistikdaten ausgegeben werden sollen.
INFORMATION = *STD / *SUMMARY / *SYSTEM-CACHED-FILES(...)
Legt die Art der auszugebenden Information fest.
INFORMATION = *STD
Zu einem Cache-Bereich werden alle Informationen einschließlich Volume-/Datei-Liste angezeigt.
INFORMATION = *SUMMARY
Zu einem Cache-Bereich werden globale Informationen (ohne Volume-/Datei-Liste, aber mit kumulierten Statistikdaten) angezeigt.
INFORMATION = *SYSTEM-CACHED-FILES(...)
Bei Cache-Bereichen mit automatisiertem Caching kann die Auswahl der Dateien, für die Informationen angezeigt werden, eingeschränkt werden.
CACHING = *ANY / *ACTIVE / *SUSPENDED
Legt die Auswahl der Dateien fest, über die Informationen ausgegeben werden sollen.
CACHING = *ANY
Alle von DAB erfassten Dateien werden berücksichtigt.
CACHING = *ACTIVE
Die Informationen werden über die aktuell bedienten Dateien ausgegeben.
CACHING = *SUSPENDED
Die Informationen werden über alle Dateien ausgegeben, deren Caching (vorübergehend)
gestoppt wurde.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
---|---|---|---|
0 | CMD0001 | Ohne Fehler | |
32 | CMD0221 | Interner SDF- Fehler | |
64 | CMD0216 | Erforderliches Privileg fehlt | |
64 | CMD2009 | Fehler bei Erzeugung der S-Variablen | |
64 | NDB0005 | Fehlende Berechtigung zum Kommandoaufruf | |
64 | NDB0010 | Falsche Syntax-Datei-Version | |
64 | NDB0024 | Kein Cache-Bereich aktiv | |
64 | NDB0068 | Cache-Bereich ist unbekannt | |
64 | NDB0079 | Cache-Bereich ist unbekannt | |
65 | CMD2241 | Subsystem nicht vorhanden |
Ausgabeformat
Für jeden ausgewählten Cache-Bereich wird folgende Information ausgegeben:
Name des Cache-Bereichs (Cache-ID)
Der Name ist beim Kommando/START-DAB-CACHING
frei wählbar (DEFAULT=BUFFER#nnn) .Cache-Medium des Cache-Bereichs
Cache-Medium, das von diesem Cache-Bereich genutzt wird: Main-Memory (MM).Eingestellte (gewünschte) Größe des Cache-Bereichs
Diese kann durch Spezifikation von AREA=*BY-FILE variabel sein. Dies wird durch einen Zusatz „(BY-FILE)“ kenntlich gemacht.Aktuelle Größe des Cache-Bereichs (bei MEMORY=*ANY/*ABOVE-MIN-MEM-SIZE/*BELOW-MIN-MEM-SIZE)
Diese kann sich durch Spezifikation von MEMORY=*ANY/ *ABOVE-MIN-MEM-SIZE von der eingestellten (gewünschten) Größe unterscheiden. Dies wird durch einen Zusatz „(ANY)“, „(ABOVE)“ oder „(BELOW)“ kenntlich gemacht.Segmentgröße des Cache-Bereichs (nicht bei AutoDAB)
Caching-Modus (READ, READ-WRITE, WRITE oder BY-CACHE-MEDIUM)
Bei den Caching-Modi ungleich READ darüber hinaus die Information, ab welchem Cache-Füllungsgrad die Schreibdaten des Cache-Bereichs auf den externen Datenträger zurückgeschrieben werden (Operand FORCE-OUT).Während des Auflösens des Cache-Bereichs wird bei den oben genannten Caching-Modi ausgegeben, zu welchem Anteil Schreibdaten bisher auf die zugehörigen externen Datenträger zurückgeschrieben wurden (DESTAGED).
Unterstützung von Shared Pubsets (bei AREA=*FILE)
Festlegung, ob bei Lese-Caching ein Datenbereich auch dann bedient werden soll, wenn die zugehörige Platte bei der Erstbelegung im Shared-Pubset-Modus betrieben wird; bei Schreib-Caching wird der Datenbereich nicht bedient.
Die Information wird nur bei SHARED-DISK-SUPPORT=*YES ausgegeben.Beginn des aktuellen Monitoring-Intervalls mit Datum/Uhrzeit
Evtl. Ende des Monitoring-Intervalls mit Datum/Uhrzeit, falls inzwischen Statistikwerte übergelaufen sind
Bei INFORMATION=*STD oder =*SYSTEM-CACHED-FILES(...) wird zusätzlich eine Liste der bedienten Datenbereiche ausgegeben:
Für Cache-Bereiche mit automatisiertem Caching zuerst die Liste der spezifizierten Datenträger (Pubsets/Privatplatten) mit Katalogkennung bzw. VSN
Dateiname (AREA=*FILE/*BY-SYSTEM )
Bedienter Datenbereich (Datei: Größe in LHP)
Bei INFORMATION=*SYSTEM-CACHED-FILES(CACHING=*ANY) zusätzlich der Anteil des von dieser Datei belegten Cache-Speichers (CACHE-USE)
Betriebszustand des bedienten Datenbereichs (SERVICE)
Information, ob der Bereich momentan von DAB bedient wird (Y) oder nicht (N)
Angabe, ob die Platte shared belegt ist (N(SHARED) bzw. Y(SHARED))
Information, dass Cache-Bereich soeben aufgelöst wird (Y(STOPPED))
Information, dass Datei bedient wird und verschlüsselt ist (Y(ENCRYPTED))
Beispiel
% :CN31:$TSOS.FALAST.2.FILE.004.3ALE % 1-129 Y(ENCRYPTED) 7068868 100% 2512446 0% % :CN31:$TSOS.FALAST.2.FILE.007.3ALH % 1-129 Y(ENCRYPTED) 4915150 100% 2662941 0%
Bei Dateien:
Information, dass Datei / Teilqualifikation bedient wird (Y).
Information, ob Datei nicht bedient (N) oder nicht bedient wird und geschlossen ist (N(CLOSED)).
Information, ob eine shared Datei bedient (Y(SHARED)) oder nicht bedient (N(SHARED)) wird.
Information, dass Datei teilweise bedient (Y(PARTIAL)) wird, da sie über mehrere Platten verteilt ist, von denen nicht alle exklusiv belegt sind.
Cache-Daten des Datenbereichs konnten bei der letzten Sicherung des Datenbereichs wegen eines Hardware- oder Software-Fehlers nicht gesichert werden (Y(PINNED-DATA) bzw. N(PINNED-DATA))
Daten-Beschreibung des DAB und des Disk-Space-Allocator stimmen wegen Fehler nicht mehr überein (N(INVALID)).
Information, dass Datei / Teilqualifikation explizit ausgeschlossen wurde (N(REMOVED)).
Information, dass Datei / Teilqualifikation explizit bedient wird (Y(MANDATORY)).
Information, dass die verschlüsselte Datei bedient (Y(ENCRYPTED)) oder nicht bedient (N(ENCRYPTED)) wird. Verschlüsselte Dateien werden nicht schreibgecacht.
Information, dass die verschlüsselte Datei explizit gecacht wird (Y(MAND/CRYPT)). Ein Schreib-Caching findet auch für diese Datei nicht statt.
Information, dass verschlüsselte Datei nicht bedient wird, da sie geschlossen ist (N(CLOSED/CRYPT)).
Information, dass verschlüsselte und shared Datei bedient wird (Y(SHARED/CRYPT)), sie wird aber nicht schreib-gecacht.
Information, dass eine verschlüsselte und shared Datei explizit gecacht wird (Y(SH/MAND/CRYPT)), sie wird aber nicht schreib-gecacht.
Statistik über die auf den jeweiligen Daten-Bereich erfolgten Lese- und Schreibzugriffe und die zugehörigen Hitraten.
Bei INFORMATION=*SUMMARY wird zusätzlich eine Statistik über die auf den jeweiligen Cache-Bereich erfolgten Lese- und Schreibzugriffe und die zugehörigen Hitraten ausgegeben.
Bei automatisiertem Caching ist die Statistik unterteilt nach den aktuell gepufferten Dateien (CACHED), diese klassifiziert nach sequenziell bearbeiteten (SEQUENTIAL), random bearbeiteten (RANDOM) und noch undefiniertem Zugriffsverhalten (UNDEFINED), die vom Caching ausgeschlossenen Dateien (UNCACHED) und die bereits geschlossenen Dateien (CLOSED).
Ausgabe in S-Variable
Die S-Variablen bilden eine Struktur mit Elementen für jeden Cache-Bereich. Die Unterstrukturen für die Datei-/Volume-Listen bzw. die Statistikdaten werden für jeden Cache-Bereich erzeugt.
Mit dem Operanden INFORMATION des /SHOW-DAB-CACHING
-Kommandos wird festgelegt, welche S-Variablen mit Werten versorgt werden. Folgende Angaben sind im Operanden INFORMATION möglich:
Wert des Operanden INFORMATION | gekürzte Schreibweise in Tabelle |
INFORMATION = *STD / *SYSTEM-CACHED-FILES | 1 |
Zusätzliche Bedingungen, welche die Versorgung der S-Variablen mit Werten festlegen:
Zusätzliche Bedingungen | gekürzte Schreibweise in Tabelle |
var(*LIST).AREA = *FILE / *BY-SYSTEM | a |
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
AREA-Spezifikation: | var(*LIST).AREA-TYPE | S | *FILE | |
Name des Cache-Bereichs | var(*LIST).CACHE-ID | S | <c-string 1..32> | |
Cache-Medium des Cache- | var(*LIST).CACHE-MED | S | *MAIN-MEM | |
Segmentgröße des Cache- | var(*LIST).CACHE-SEGMENT-SIZE | I | *UNDEF | |
Angeforderte Größe des Cache- | var(*LIST).CACHE-SIZE | I | <integer 1..8388608> | |
Angabe der Größe des Cache- | var(*LIST).SIZE-DIM | S | *KB | |
Aktuelle Größe des Cache- | var(*LIST).CACHE-SIZE-ACTUAL | I | <integer 1..8388608> | a |
Angabe der aktuellen Größe des | var(*LIST).SIZE-DIM-ACTUAL | S | *KB | a |
Lage des Cache-Bereichs im | var(*LIST).MEMORY | S | *ABOVE | a |
Anteil des von den Datenbereichen | var(*LIST).CACHE-USE-RATIO | I | <integer 0..100> | 3c |
Anteil des von den Dateien belegten | var(*LIST).CACHED.CACHE-USE-RATIO | I | <integer 0..100> | 3d |
Anzahl der gepufferen Dateien bei | var(*LIST).CACHED.NUM-OF-FILE | i | <integer | 3d |
Anzahl der Lesezugriffe auf die | var(*LIST).CACHED.NUM-OF-READ | I | <integer | 3d |
Anzahl der Schreibzugriffe auf die | var(*LIST).CACHED.NUM-OF-WRITE | I | <integer | 3d |
Lese-Hitrate der gepufferten | var(*LIST).CACHED.READ-HIT-RATIO | I | <integer 0..100> | 3d |
Schreib-Hitrate der gepufferten | var(*LIST).CACHED.WRITE-HIT-RATIO | I | <integer 0..100> | 3d |
Caching-Modus | var(*LIST).CACHING-MODE | S | *READ | |
Anzahl der geschlossenen | var(*LIST).CLOSE.NUM-OF-FILES | I | <integer | 3d |
Anzahl der Lese-Zugriffe, die auf | var(*LIST).CLOSE.NUM-OF-READ | I | <integer | 3d |
Anzahl der Schreib-Zugriffe, die | var(*LIST).CLOSE.NUM-OF-WRITE | I | <integer | 3d |
Lese-Hitrate der geschlossenen | var(*LIST).CLOSE.READ-HIT-RATIO | I | <integer 0..100> | 3d |
Schreib-Hitrate der geschlossenen | var(*LIST).CLOSE.WRITE-HIT-RATIO | I | <integer 0..100> | 3d |
Anteil des von der Datei belegten | var(*LIST).FILE(*LIST).CACHE-USE-RATIO | I | <integer 0..100> | 2d |
Dateiname | var(*LIST).FILE(*LIST).F-NAME | S | <c-string 1..54> | 1b |
Größe der Datei | var(*LIST).FILE(*LIST).F-SIZE | I | <integer 0..16777216> | 1b |
Anzahl der Lesezugriffe | var(*LIST).FILE(*LIST).NUM-OF-READS | I | <integer | 1b |
Anzahl der Schreibzugriffe | var(*LIST).FILE(*LIST).NUM-OF-WRITES | I | <integer | 1b |
Lese-Hitrate | var(*LIST).FILE(*LIST).READ-HIT-RATIO | I | <integer 0..100> | 1b |
Betriebszustand der bedienten | var(*LIST).FILE(*LIST).SERVICE | S | *Y | 1b |
Schreib-Hitrate | var(*LIST).FILE(*LIST).WRITE-HIT-RATIO | I | <integer 0..100> | 1b |
Cache-Füllungsgrad, ab dem die | var(*LIST).FORCE-OUT | S | *UNDEF | |
Anzahl der bedienten Dateien | var(*LIST).NUM-OF-FILE | I | <integer | 3b |
Anzahl der Lesezugriffe | var(*LIST).NUM-OF-READ | I | <integer | 3c |
Anzahl der Schreibzugriffe | var(*LIST).NUM-OF-WRITE | I | <integer | 3c |
Betriebszustand der gepufferten | var(*LIST).PRIV(*LIST).SERVICE | S | *N | 1d |
VSN der gepufferten Privatplatten | var(*LIST).PRIV(*LIST).VOL | S | <c-string 1..6> | 1d |
Pubset-ID der gepufferten Pubsets | var(*LIST).PUBSET(*LIST).PUBSET | S | <cat-id> | 1d |
Typ des Pubsets | var(*LIST).PUBSET(*LIST).PUBSET-TYPE | S | *SINGLE-FEATURE | 1d |
Betriebszustand des Pubsets | var(*LIST).PUBSET(*LIST).SERVICE | S | *N | 1d |
Anteil des belegten Cache-Speichers | var(*LIST).RANDOM.CACHE-USE-RATIO | I | <integer 0..100> | 3d |
Anzahl der als random bearbeitet | var(*LIST).RANDOM.NUM-OF-FILE | I | <integer | 3d |
Anzahl der Lesezugriffe (random | var(*LIST).RANDOM.NUM-OF-READ | I | <integer | 3d |
Anzahl der Schreibzugriffe | var(*LIST).RANDOM.NUM-OF-WRITE | I | <integer | 3d |
Lese-Hitrate (random Zugriff) | var(*LIST).RANDOM.READ-HIT-RATIO | I | <integer 0..100> | 3d |
Schreib-Hitrate (random Zugriff) | var(*LIST).RANDOM.WRITE-HIT-RATIO | I | <integer 0..100> | 3d |
Lese-Hitrate | var(*LIST).READ-HIT-RATIO | I | <integer 0..100> | 3c |
Anteil des belegten Cache-Speichers | var(*LIST).SEQ.CACHE-USE-RATIO | I | <integer 0..100> | 3d |
Anzahl der als sequenziell | var(*LIST).SEQ.NUM-OF-FILE | I | <integer | 3d |
Anzahl der Schreibzugriffe | var(*LIST).SEQ.NUM-OF-WRITE | I | <integer | 3d |
Anzahl der Lesezugriffe | var(*LIST).SEQ.NUM-OF-READ | I | <integer | 3d |
Lese-Hitrate (sequenzieller | var(*LIST).SEQ.READ-HIT-RATIO | I | <integer 0..100> | 3d |
Schreib-Hitrate (sequenzieller | var(*LIST).SEQ.WRITE-HIT-RATIO | I | <integer 0..100> | 3d |
Festlegung, ob shared belegte *FALSE=Information wird nicht | var(*LIST).SHARED-DISK-SUP | B | *UNDEF | |
Anzeige, ob ein Cache-Bereich mit | var(*LIST).SIZE-BY-FILE | B | *UNDEF | |
Anzahl der nicht gepufferten | var(*LIST).UNCACHED.NUM-OF-FILE | I | <integer | 3d |
Lesezugriffe auf nicht gepufferte | var(*LIST).UNCACHED.NUM-OF-READ | I | <integer | 3d |
Schreibzugriffe auf nicht gepufferte | var(*LIST).UNCACHED.NUM-OF-WRITE | I | <integer | 3d |
Anteil des belegten Cache-Speichers | var(*LIST).UNDEF.CACHE-USE-RATIO | I | <integer 0..100> | 3d |
Anzahl der Dateien bei | var(*LIST).UNDEF.NUM-OF-FILE | I | <integer | 3d |
Anzahl der Lesezugriffe (Zugriffsverhalten | var(*LIST).UNDEF.NUM-OF-READ | I | <integer | 3d |
Anzahl der Schreibzugriffe | var(*LIST).UNDEF.NUM-OF-WRITE | I | <integer | 3d |
Schreib-Hitrate | var(*LIST).WRITE-HIT-RATIO | I | <integer 0..100> | 3c |
Beispiele
Beispiel 1 (Ausgabe verschiedener Cache-Bereiche)
|
|
|
Beispiel 2 (Ausgabe in S-Variable)
Das folgende Beispiel zeigt, wie die Informationen eines /SHOW-DAB-CACHING
-Kommandos in einer zuvor deklarierten S-Variablen (hier LVAR3) abgelegt werden.
|
LVAR3(*LIST).STATIS(*LIST).STA = *ACTIVE LVAR3(*LIST).STATIS(*LIST).DATA-RESET-DATE = <date> LVAR3(*LIST).STATIS(*LIST).DATA-RESET-TIME = <time> LVAR3(*LIST).AREA-TYPE = *BY-SYSTEM LVAR3(*LIST).PRIV(*LIST).VOL = WK51EB LVAR3(*LIST).PRIV(*LIST).SERVICE = *Y LVAR3(*LIST).PRIV(*LIST).VOL = WK51E1 LVAR3(*LIST).PRIV(*LIST).SERVICE = *N(SHARED) LVAR3(*LIST).UNCACHED(*LIST).NUM-OF-FILE = 0 LVAR3(*LIST).UNCACHED(*LIST).NUM-OF-READ = 0 LVAR3(*LIST).UNCACHED(*LIST).NUM-OF-WRITE = 0