Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-DAB-CACHING Information über die aktuelle DAB-Konfiguration einholen

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.

Die von openSM2 ausgegebenen Werte beziehen sich auf das jeweils letzte Zeitintervall und unterscheiden sich deshalb in der Regel von den bei /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

CACHE-ID = *ALL / <alphanum-name 1..32>

,INFORMATION = *STD / *SUMMARY / *SYSTEM-CACHED-FILES(...)


*SYSTEM-CACHED-FILES(...)



|

CACHING = *ANY / *ACTIVE / *SUSPENDED

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)  SC1MaincodeBedeutung

0CMD0001Ohne Fehler

32CMD0221Interner SDF- Fehler

64CMD0216Erforderliches Privileg fehlt

64CMD2009Fehler bei Erzeugung der S-Variablen

64NDB0005Fehlende Berechtigung zum Kommandoaufruf

64NDB0010Falsche Syntax-Datei-Version

64NDB0024Kein Cache-Bereich aktiv

64NDB0068Cache-Bereich ist unbekannt

64NDB0079Cache-Bereich ist unbekannt

65CMD2241Subsystem 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
INFORMATION = *SYSTEM-CACHED-FILES
INFORMATION = *SUMMARY

1
2
3

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
var(*LIST).AREA = *FILE / *BY-SYSTEM
var(*LIST).AREA = *FILE
var(*LIST).AREA = *BY-SYSTEM

a
b
c
d

Ausgabe-Information

Name der S-Variablen

T

Inhalt

Bedingung

AREA-Spezifikation:
Cache-Bereich
(AREA=*FILE / *BY-SYSTEM)




*FILE=Ausgabe erfolgt dateispezifisch



*BY-SYSTEM=Ausgabe erfolgt
dateispezifisch

var(*LIST).AREA-TYPE

S

*FILE

*BY-SYSTEM


Name des Cache-Bereichs

var(*LIST).CACHE-ID

S

<c-string 1..32>


Cache-Medium des Cache-
Bereichs
*MAIN-MEM=Hauptspeicher-
Cache-Bereich

var(*LIST).CACHE-MED

S

*MAIN-MEM


Segmentgröße des Cache-
Bereichs (nicht bei AutoDAB)

var(*LIST).CACHE-SEGMENT-SIZE

I

*UNDEF
<integer 4..32>


Angeforderte Größe des Cache-
Bereichs

var(*LIST).CACHE-SIZE

I

<integer 1..8388608>


Angabe der Größe des Cache-
Bereichs in:
*KB=Kilobyte
*MB=Megabyte

var(*LIST).SIZE-DIM

S

*KB
*MB


Aktuelle Größe des Cache-
Bereichs

var(*LIST).CACHE-SIZE-ACTUAL

I

<integer 1..8388608>

a

Angabe der aktuellen Größe des
Cache-Bereichs in:
*KB=Kilobyte
*MB=Megabyte

var(*LIST).SIZE-DIM-ACTUAL

S

*KB
*MB

a

Lage des Cache-Bereichs im
Hauptspeicher

var(*LIST).MEMORY

S

*ABOVE
*BELOW
*ANY

a

Anteil des von den Datenbereichen
belegten Cache-Speichers

var(*LIST).CACHE-USE-RATIO

I

<integer 0..100>

3c

Anteil des von den Dateien belegten
Cache-Speichers bei
AREA=*BY-SYSTEM

var(*LIST).CACHED.CACHE-USE-RATIO

I

<integer 0..100>

3d

Anzahl der gepufferen Dateien bei
AREA=*BY-SYSTEM

var(*LIST).CACHED.NUM-OF-FILE

i

<integer
0..4294967296>

3d

Anzahl der Lesezugriffe auf die
gepufferten Dateien bei
AREA=*BY-SYSTEM

var(*LIST).CACHED.NUM-OF-READ

I

<integer
0..4294967296>

3d

Anzahl der Schreibzugriffe auf die
gepufferten Dateien bei
AREA=*BY-SYSTEM

var(*LIST).CACHED.NUM-OF-WRITE

I

<integer
0..4294967296>

3d

Lese-Hitrate der gepufferten
Dateien bei AREA=*BY-
SYSTEM

var(*LIST).CACHED.READ-HIT-RATIO

I

<integer 0..100>

3d

Schreib-Hitrate der gepufferten
Dateien bei AREA=*BY-
SYSTEM

var(*LIST).CACHED.WRITE-HIT-RATIO

I

<integer 0..100>

3d

Caching-Modus
*READ=Lese-Caching
*READ-WRITE=Schreib-Lese-
Caching
*WRITE=Schreib-Caching


*BY-MED=in Abhängigkeit vom
Cache-Medium

var(*LIST).CACHING-MODE

S

*READ
*READ-WRITE
*WRITE

*BY-MED


Anzahl der geschlossenen
Dateien

var(*LIST).CLOSE.NUM-OF-FILES

I

<integer
0..4294967296>

3d

Anzahl der Lese-Zugriffe, die auf
bereits geschlossene Dateien
erfolgt sind

var(*LIST).CLOSE.NUM-OF-READ

I

<integer
0..4294967296>

3d

Anzahl der Schreib-Zugriffe, die
auf bereits geschlossene
Dateien erfolgt sind

var(*LIST).CLOSE.NUM-OF-WRITE

I

<integer
0..4294967296>

3d

Lese-Hitrate der geschlossenen
Dateien

var(*LIST).CLOSE.READ-HIT-RATIO

I

<integer 0..100>

3d

Schreib-Hitrate der geschlossenen
Dateien

var(*LIST).CLOSE.WRITE-HIT-RATIO

I

<integer 0..100>

3d

Anteil des von der Datei belegten
Cache-Speichers

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
0..4294967296>

1b

Anzahl der Schreibzugriffe

var(*LIST).FILE(*LIST).NUM-OF-WRITES

I

<integer
0..4294967296>

1b

Lese-Hitrate

var(*LIST).FILE(*LIST).READ-HIT-RATIO

I

<integer 0..100>

1b

Betriebszustand der bedienten
Datei
*Y=Datei bzw. Teilqualifikation wird
momentan von DAB bedient
*Y(SHARED)=Datei auf shared
Platte wird bedient
*Y(STOP)=Cache-Bereich wird
soeben aufgelöst
*Y(PARTIAL)=Datei wird teilweise
bedient, da sie über mehrere
Platten verteilt ist, von denen
nicht alle exklusiv belegt sind
*Y(MANDATORY)= Datei bzw.
Teilqualifikation, deren Caching
mit /MODIFY-DAB-CACHING
explizit vorgeschrieben ist.
*Y(PINNED-DATA)=
*N(PINNED-DATA)=
Cache-Daten des Datenbereichs
konnten bei der letzten Sicherung
des Datenbereichs wegen
eines Hardware- oder Software-
Fehlers nicht gesichert werden
*N(INVALID)=Daten-Beschreibung
des DAB und des Disk-
Space-Allocator stimmen wegen
Fehler nicht mehr überein
*N(SHARED)=Datei auf shared
Platte wird nicht bedient
*N(CLOSE)=Datei ist geschlossen
*N(DELETED)=Datei wird gerade
gelöscht
*N(SUSPENDED)=Datei ist
wegen schlechter Cache-Nutzung
vom Caching ausgeschlossen
*N(REMOVED)=Datei bzw.
Teilqualifikation wurde explizit mit
/MODIFY-DAB-CACHING vom
Caching ausgeschlossen
*N=Bereiche werden momentan
nicht von DAB bedient
*UNDEF=Status konnte nicht
ermittelt werden
*N(ENCRYPTED)=
*Y(ENCRYPTED)=Für die
verschlüsselte Datei wird kein
Schreib-Caching durchgeführt.
*N(CLOSED/CRYPT)=Verschlüsselte
Datei ist geschlossen. Kein
Schreib-Caching.
*Y(SHARED/CRYPT)=Verschlüsselte
Datei auf shared Platte wird
bedient, aber nicht
schreibgecacht.
*Y(MAND/CRYPT)=Verschlüsselte
Datei wird explizit gecacht,
aber nicht schreib-gecacht.
*Y(SH/MAND/CRYPT)=Verschlüsselte
Datei auf shared Platte wird
explizit gecacht, aber nicht
schreib-gecacht.

var(*LIST).FILE(*LIST).SERVICE

S

*Y
*Y(SHARED)
*Y(STOP)
*Y(PARTIAL)
*Y(MANDATORY)
*Y(PINNED-DATA)
*N(PINNED-DATA)
*N(INVALID)
*N(SHARED)
*N(CLOSE)
*N(DELETED)
*N(SUSPENDED)
*N(REMOVED)
*N
*UNDEF
*N(ENCRYPTED)
*Y(ENCRYPTED)
*N(CLOSED/CRYPT)
*Y(SHARED/CRYPT)
*Y(MAND/CRYPT)
*Y(SH/MAND/CRYPT)

1b

Schreib-Hitrate

var(*LIST).FILE(*LIST).WRITE-HIT-RATIO

I

<integer 0..100>

1b

Cache-Füllungsgrad, ab dem die
Schreibdaten des Cache-
Bereichs auf die Platten
zurückgeschrieben werden
NO=Die Daten werden nicht
schwellwertgesteuert gesichert.
Die Sicherung erfolgt nur beim
Auflösen des Cache-Bereichs
oder bei Beendigung der
Plattenbelegung
AT-LOW-FILL=Die Sicherung
erfolgt schwellwertgesteuert,
wenn der Cache-Bereich zu 25%
mit Schreibdaten gefüllt ist
AT-HIGH-FILL=Die Sicherung
erfolgt schwellwertgesteuert,
wenn der Cache-Bereich zu 75%
mit Schreibdaten gefüllt ist

var(*LIST).FORCE-OUT

S

*UNDEF
*NO
*AT-LOW-FILL
*AT-HIGH-FILL


Anzahl der bedienten Dateien

var(*LIST).NUM-OF-FILE

I

<integer
0..4294967296>

3b

Anzahl der Lesezugriffe

var(*LIST).NUM-OF-READ

I

<integer
0..4294967296>

3c

Anzahl der Schreibzugriffe

var(*LIST).NUM-OF-WRITE

I

<integer
0..4294967296>

3c

Betriebszustand der gepufferten
Privatplatten

var(*LIST).PRIV(*LIST).SERVICE

S

*N
*Y
*UNDEF

1d

VSN der gepufferten Privatplatten
bei AREA=*BY-SYSTEM

var(*LIST).PRIV(*LIST).VOL

S

<c-string 1..6>

1d

Pubset-ID der gepufferten Pubsets
bei AREA=*BY-SYSTEM

var(*LIST).PUBSET(*LIST).PUBSET

S

<cat-id>

1d

Typ des Pubsets

var(*LIST).PUBSET(*LIST).PUBSET-TYPE

S

*SINGLE-FEATURE
*SYS-MANAGE
*VOLSET
*UNDEF

1d

Betriebszustand des Pubsets

var(*LIST).PUBSET(*LIST).SERVICE

S

*N
*Y
*Y(SHARED)
*N(SHARED)
*UNDEF

1d

Anteil des belegten Cache-Speichers
(random Zugriff)

var(*LIST).RANDOM.CACHE-USE-RATIO

I

<integer 0..100>

3d

Anzahl der als random bearbeitet
erkannten Dateien bei
AREA=*BY-SYSTEM

var(*LIST).RANDOM.NUM-OF-FILE

I

<integer
0..4294967296>

3d

Anzahl der Lesezugriffe (random
Zugriff)

var(*LIST).RANDOM.NUM-OF-READ

I

<integer
0..4294967296>

3d

Anzahl der Schreibzugriffe
(random Zugriff)

var(*LIST).RANDOM.NUM-OF-WRITE

I

<integer
0..4294967296>

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
(sequenzieller Zugriff)

var(*LIST).SEQ.CACHE-USE-RATIO

I

<integer 0..100>

3d

Anzahl der als sequenziell
bearbeitet erkannten Dateien bei
AREA=*BY-SYSTEM

var(*LIST).SEQ.NUM-OF-FILE

I

<integer
0..4294967296>

3d

Anzahl der Schreibzugriffe
(sequenzieller Zugriff)

var(*LIST).SEQ.NUM-OF-WRITE

I

<integer
0..4294967296>

3d

Anzahl der Lesezugriffe
(sequenzieller Zugriff)

var(*LIST).SEQ.NUM-OF-READ

I

<integer
0..4294967296>

3d

Lese-Hitrate (sequenzieller
Zugriff)

var(*LIST).SEQ.READ-HIT-RATIO

I

<integer 0..100>

3d

Schreib-Hitrate (sequenzieller
Zugriff)

var(*LIST).SEQ.WRITE-HIT-RATIO

I

<integer 0..100>

3d

Festlegung, ob shared belegte
Platten bei Lese-Caching
bedient werden sollen (nur bei
AREA=*FILE)
*TRUE=Information wird ausgegeben


*FALSE=Information wird nicht
ausgegeben

var(*LIST).SHARED-DISK-SUP

B

*UNDEF
*TRUE
*FALSE


Anzeige, ob ein Cache-Bereich mit
CACHE-SIZE=*BY-FILE
eingerichtet wurde; nur für mit
AREA=*FILE eingerichtete
Cache-Bereiche, anderenfalls
wird *UNDEF angezeigt

var(*LIST).SIZE-BY-FILE

B

*UNDEF
*TRUE
*FALSE


Anzahl der nicht gepufferten
Dateien

var(*LIST).UNCACHED.NUM-OF-FILE

I

<integer
0..4294967296>

3d

Lesezugriffe auf nicht gepufferte
Dateien

var(*LIST).UNCACHED.NUM-OF-READ

I

<integer
0..4294967296>

3d

Schreibzugriffe auf nicht gepufferte
Dateien

var(*LIST).UNCACHED.NUM-OF-WRITE

I

<integer
0..4294967296>

3d

Anteil des belegten Cache-Speichers
(Zugriffsverhalten
unbekannt)

var(*LIST).UNDEF.CACHE-USE-RATIO

I

<integer 0..100>

3d

Anzahl der Dateien bei
AREA=*BY-SYSTEM, deren
Zugriffsverhalten noch nicht
ermittelt werden konnte

var(*LIST).UNDEF.NUM-OF-FILE

I

<integer
0..4294967296>

3d

Anzahl der Lesezugriffe (Zugriffsverhalten
unbekannt)

var(*LIST).UNDEF.NUM-OF-READ

I

<integer
0..4294967296>

3d

Anzahl der Schreibzugriffe
(Zugriffsverhalten unbekannt)

var(*LIST).UNDEF.NUM-OF-WRITE

I

<integer
0..4294967296>

3d

Schreib-Hitrate

var(*LIST).WRITE-HIT-RATIO

I

<integer 0..100>

3c

Beispiele

Beispiel 1 (Ausgabe verschiedener Cache-Bereiche)

/show-dab-caching cache-id=gsaudrw,

                  information=*system-cached-files(caching=*any)

CACHE-ID     = GSAUDRW
CACHE-MEDIUM = M-M

CACHE-SIZE   = 400 MB

CACHING-MODE = READ-WRITE(FORCE-OUT=AT-LOW-FILLING)

----------------------------------------------------------------------------

CURRENT STATISTIC INTERVAL SET UP AT:    <date> <time>

----------------------------------------------------------------------------

CATID/VSN    TYPE           SERVICE

=========    ====           =======

:X:          SF-PUBSET         Y
:B304:       SF-PUBSET         Y

WORK02       PRIVATE-DISK      Y

WORK01       PRIVATE-DISK      Y

----------------------------------------------------------------------------

FILE   AREA      CACHE-USE  SERVICE   # OF READS  RD-HIT # OF WRITES  WR-HIT

====   ====      =========  =======   ================== ===================

:A302:$TSOS.ARCHIVE.SAVE.FILE.<date>.<time>.WORK02

       1-1404        0%     N(CLOSED)

:B304:$DB124NK.E.Q1UTMGE1.UDOMI

       1-3           0%        Y             160    100%           2   100%
:B304:$DB124NK.FBUTMGE1.KDCA

       1-22314      11%        Y             314     98%     3124966   100%

:B304:$DB124NK.I.XSUTM.UDS.UTM.CTRL

       1-39          0%        Y              47     98%          33   100%

:B304:$DB124NK.L.Q1UTMGE1.UDOMI.9J7Y

       1-2298        1%        Y               0                2147   100%
:B304:$DB124NK.MA.LEIA.BASE

       1-580224      0%    N(SUSPENDED)

...

:B304:$DB124NK.SDF.USER.SYNTAX

       1-279         0%        Y             371     94%           0

:B304:$DB124NK.UDS.ENTER.9J6W.ST001

       1-3           0%        Y               3    100%           1   100%

:B304:$DB125SQL.SYSMSGA.ESQL.011

       1-30          0%        Y             159     95%           0
:B304:$TSOS.TSOSCAT

       1-10002       2%        Y          375435     98%         543    100%

...

:X:$TSOS.TSOSCAT

       1-1002        0%        Y              65     97%           0

/show-dab-caching cache-id=gsaudrw,inf=*summary

CACHE-ID     = GSAUDRW

CACHE-MEDIUM = M-M

CACHE-SIZE   = 400 MB

CACHING-MODE = READ-WRITE(FORCE-OUT=AT-LOW-FILLING)

----------------------------------------------------------------------------

CURRENT STATISTIC INTERVAL SET UP AT:    <date> <time>

----------------------------------------------------------------------------

            # OF FILES   CACHE-USE  # OF READS  RD-HIT   # OF WRITES  WR-HIT
CACHED             138         87%      540696     84%       3723420    100%

(SEQUENTIAL)        98         17%      123037     98%         86534    100%

(RANDOM)            28         67%      417112     80%       3443284    100%
(UNDEFINED)         12          3%         547                    20

CLOSED                                12453696     89%       4534536    100%

UNCACHED             1                   24534                   345

/show-dab-caching inf=*all

CACHE-ID     = BUFFER#001

CACHE-MEDIUM = M-M

CACHE-SIZE   = 100 MB REDUCED TO 66 MB (ABOVE)
CACHING-MODE = BY-MEDIUM (FORCE-OUT=AT-LOW-FILLING)

----------------------------------------------------------------------------

CURRENT STATISTIC INTERVAL SET UP AT:    <date> <time>
----------------------------------------------------------------------------

CATID/VSN    TYPE           SERVICE

=========    ====           =======
:RATS:       SF-PUBSET         Y

:CAM4:       SF-PUBSET         Y

WORK01       PRIVATE-DISK      Y
----------------------------------------------------------------------------

FILE   AREA      CACHE-USE  SERVICE   # OF READS  RD-HIT # OF WRITES  WR-HIT

====   ====      =========  =======   ================== ===================
:CAM4:$RZV120.PROC.UPDATE

       1-1224        1%        Y             208     54%           0

:CAM4:$RZV120.S.116.06V7.UL

       1-72          0%        Y               0                  59    100%

:CAM4:$TSOS.TSOSCAT

       1-8193        0%        Y               0                   0
:RATS:$ATSSRPM1.SRPM.GRUPPEN.LIB.V11

       1-10881       1%        Y            1179     84%           0

:RATS:$ATSSRPM1.SRPM.START.PRC.V11

       1-3           0%        Y               6     83%           0

:RATS:$ATSSRPM1.SRPM.TOOLS.LIB.V11

       1-843         0%        Y           15949    100%           0
:RATS:$TSOS.SYSCAT.GUARDS

       1-48          0%        Y               2     50%           0

:RATS:$TSOS.TSOSCAT

       1-8193        0%        Y               5      0%        1908      0%

/show-dab-caching cache-id=buffer6

CACHE-ID     = BUFFER6

CACHE-MEDIUM = M-M

CACHE-SIZE   = 16416 KB (BY-FILE)                    SEGMENT-SIZE =    32 KB

CACHING-MODE = READ

----------------------------------------------------------------------------

CURRENT STATISTIC INTERVAL SET UP AT:    <date> <time>

----------------------------------------------------------------------------

FILE         AREA           SERVICE   # OF READS  RD-HIT # OF WRITES  WR-HIT
====         ====           =======   ================== ===================

:RQH1:$TSOS.TSOSCAT

              1-8196           Y             316     84%         137      0%

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.

/declare-variable lvar3(type=*structure),multiple=*list

/exec-cmd (show-dab-caching cache-id=c#priv),struc-out=lvar3

CACHE-ID     = C#PRIV

CACHE-MEDIUM = M-M

CACHE-SIZE   = 20 MB

CACHING-MODE = READ-WRITE(FORCE-OUT=AT-LOW-FILLING)

----------------------------------------------------------------------------

CURRENT STATISTIC INTERVAL SET UP AT:    <date> <time>

----------------------------------------------------------------------------

CATID/VSN    TYPE           SERVICE
=========    ====           =======

WK51EB     PRIVATE-DISK        Y

WK51E1     PRIVATE-DISK   N(SHARED)
----------------------------------------------------------------------------

FILE         AREA           SERVICE   # OF READS  RD-HIT # OF WRITES  WR-HIT

====         ====           =======   ================== ===================
NO DATA AREAS

/show-var lvar3

LVAR3(*LIST).CACHE-ID = C#PRIV

LVAR3(*LIST).CACHE-MED = *MAIN-MEM

LVAR3(*LIST).CACHE-SEGMENT-SIZE = *UNDEF

LVAR3(*LIST).CACHE-SIZE = 20

LVAR3(*LIST).SIZE-DIM = *MB

LVAR3(*LIST).SIZE-BY-FILE = *UNDEF

LVAR3(*LIST).CACHE-SIZE-ACTUAL = 20

LVAR3(*LIST).SIZE-DIM-ACTUAL = *MB

LVAR3(*LIST).CACHING-MODE = *READ-WRITE

LVAR3(*LIST).FORCE-OUT = *AT-LOW-FILL

LVAR3(*LIST).SHARED-DISK-SUP = *UNDEF

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