Anwendungsbereich: | SYSTEM-TUNING |
Privilegierung: | TSOS |
Funktionsbeschreibung
Mit dem Kommando /MODIFY-DAB-CACHING erhält die Systembetreuung die Möglichkeit, alle wesentlichen Parameter eines DAB-Cache-Bereichs dynamisch zu ändern.
Die geänderten Parameter beinhalten hierbei die Cache-Größe und die Cache-Segmentgröße, daneben die Datenbasis von dateispezifischen Cache-Bereichen (eingerichtet mit dem Kommando /START-DAB-CACHING AREA=*FILE/*BY-SYSTEM), den Caching-Modus und den FORCE-OUT-Parameter.
Format
MODIFY-DAB-CACHING | Kurzname: MDDABC | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
CACHE-ID = <alphanum-name 1..32>
Identifier des zu ändernden Cache-Bereichs.
CACHE-SIZE = *UNCHANGED / *EXTEND(...) / *REDUCE(...)
Legt die Größe des Cache-Bereichs fest.
CACHE-SIZE = *UNCHANGED
Die Größe des Cache-Bereichs soll unverändert bleiben.
CACHE-SIZE = *EXTEND(...)
Der Cache-Bereich soll vergrößert werden.
NEW-SIZE = <integer 1..8388608>(...)
Gibt die neue Größe des Cache-Bereichs an.
Die Vergrößerung des Cache-Bereichs auf die angegebene Größe geschieht additiv, alle bereits eingelagerten Cache-Daten bleiben erhalten.
Bei Cache-Bereichen im Hauptspeicher mit MEMORY=*ANY/*BELOW-MIN-MEM-SIZE/*ABOVE-MIN-MEM-SIZE (siehe /START-DAB-CACHING auf "START-DAB-CACHING ADM-PFA DAB-Cache-Bereiche anlegen") wird die eingestellte (gewünschte) Größe des Cache-Bereichs erhöht. Eine Erhöhung der aktuellen Größe findet im Laufe der Kommando-Ausführung statt, wenn die Speicherauslastung dies zulässt.
DIMENSION = *KILOBYTE / *MEGABYTE
Legt fest, ob die Größenangabe für den Cache-Bereich in KB oder in MB erfolgt.
CACHE-SIZE = *REDUCE(...)
Der Cache-Bereich soll verkleinert werden.
NEW-SIZE = <integer 0..8388608>(...)
Gibt die neue Größe des Cache-Bereichs an.
Für Cache-Bereiche mit CACHING-MODE=*WRITE/*READ-WRITE gilt:
Es werden nur die Cache-Daten auf die Platte zurückgeschrieben, die nötig sind, um den Cache-Bereich auf die angeforderte Größe verkleinern zu können. Anschließend werden, wie für alle Arten von Caching-Modi, die betroffenen Cache-Segmente des Cache-Bereichs abgebaut. Das Caching in allen anderen Cache-Segmenten bleibt davon unbeeinflusst.
Bei Bereichen im Hauptspeicher mit MEMORY=*ANY/*BELOW-MIN-MEM-SIZE/*ABOVE-MIN-MEM-SIZE (siehe /START-DAB-CACHING auf "START-DAB-CACHING ADM-PFA DAB-Cache-Bereiche anlegen") wird die eingestellte (gewünschte) Größe des Cache-Bereichs verkleinert. Die aktuelle Größe wird nur verringert, wenn die neu eingestellte Größe unterhalb der aktuellen Größe liegt.
DIMENSION = *KILOBYTE / *MEGABYTE
Legt fest, ob die Größenangabe für den Cache-Bereich in KB oder in MB erfolgt.
CACHE-SEGMENT-SIZE = *UNCHANGED / *32 / *16 / *8 / *4
Angabe welche Cache-Segmentgröße eingestellt werden soll.
Eine Veränderung der bisherigen Cache-Segmentgröße ist wirkungslos für Cache-Bereiche mit automatisiertem Caching (AutoDAB).
CACHE-SEGMENT-SIZE = *UNCHANGED
Die Cache-Segmentgröße soll unverändert bleiben.
CACHE-SEGMENT-SIZE = *32 / *16 / *8 / *4
Die Cache-Segmentgröße soll auf 32KB / 16KB / 8 KB / 4 KB verändert werden.
AREA = *UNCHANGED / *ADD-FILE(...) / *REMOVE-FILE(...) / *RESET-FILE(...) /*ADD-PUBSET(...) / *REMOVE-PUBSET(...)
Die Datenbasis eines Cache-Bereichs soll verändert werden:
Bei einem dateispezifischen Cache-Bereich (eingerichtet mit AREA=*FILE) können einzelne Dateien in den Cache aufgenommen oder aus dem Cache entfernt werden.
Bei einem automatischen Cache-Bereich (eingerichtet mit AREA=*BY-SYSTEM) können eine oder mehrere Dateien dauerhaft in den Cache aufgenommen oder daraus entfernt werden. Für diese Dateien kann auch eingestellt werden, dass sie wieder automatisch d.h. abhängig von der Beurteilung durch AutoDAB gecacht werden.
Bei einem automatischen Cache-Bereich (eingerichtet mit AREA=*BY-SYSTEM) kann ein Pubset dauerhaft in den Cache aufgenommen oder daraus entfernt werden.
AREA = *UNCHANGED
Die Datenbasis des Cache-Bereichs soll unverändert bleiben.
AREA = *ADD-FILE(...)
Die Datenbasis des Cache-Bereichs soll um eine bzw. mehrere Dateien erweitert werden.
FILE-NAME = <filename 1..54 without-vers>
Name der Datei, die in den spezifizierten Cache-Bereich aufgenommen werden soll.
FILE-NAME = <partial-filename 2..53>
Nur für automatische Cache-Bereiche (eingerichtet mit AREA=*BY-SYSTEM):
Teilqualifizierter Dateiname für eine Dateimenge, die in den spezifizierten Cache-Bereich aufgenommen werden soll.
AREA = *REMOVE-FILE(...)
Die Datenbasis des Cache-Bereichs soll um eine bzw. mehrere Dateien reduziert werden. Die Cache-Daten werden dabei auf die Platte(n) zurückgeschrieben und im Cache invalidiert.
FILE-NAME = <filename 1..54 without-vers>
Name der Datei, die aus dem spezifizierten Cache-Bereich entfernt werden soll.
FILE-NAME = <partial-filename 2..53>
Nur für automatische Cache-Bereiche (eingerichtet mit AREA=*BY-SYSTEM):
Teilqualifizierter Dateiname für eine Dateimenge, die aus dem spezifizierten Cache-Bereich entfernt werden soll.
AREA = *RESET-FILE(...)
Nur für automatisierte Cache-Bereiche (eingerichtet mit AREA=*BY-SYSTEM):
Die Datenbasis des automatischen Cache-Bereichs soll für eine bzw. mehrere Dateien so geändert werden, dass diese Dateien wieder automatisch, d.h. abhängig von der Beurteilung durch AutoDAB gecacht werden.
FILE-NAME = <filename 1..54 without-vers> / <partial-filename 2..53>
Name der Datei bzw. teilqualifizierter Dateiname für eine Dateimenge, die in dem spezifizierten Cache-Bereich wieder automatisch gecacht werden soll.
AREA = *ADD-PUBSET(...)
Nur für automatisierte Cache-Bereiche (eingerichtet mit AREA=*BY-SYSTEM):
Die Datenbasis des Cache-Bereichs soll um ein Pubset erweitert werden.
PUBSET = <cat-id 1..4>
Name des Pubset, das in den spezifizierten Cache-Bereich aufgenommen werden soll.
AREA = *REMOVE-PUBSET(...)
Nur für automatisierte Cache-Bereiche (eingerichtet mit AREA=*BY-SYSTEM):
Die Datenbasis des Cache-Bereichs soll um ein Pubset reduziert werden.
PUBSET = <cat-id 1..4>
Name des Pubset, das aus dem spezifizierten Cache-Bereich entfernt werden soll.
CACHING-MODE = *UNCHANGED / *READ / *READ-WRITE / *WRITE / *BY-CACHE-MEDIUM
Der Caching-Modus des Cache-Bereichs soll verändert werden.
Bei der Änderung des Caching-Modus können zwei verschiedene „Richtungen“ unterschieden werden:
Bei einem Wechsel von *READ nach *READ-WRITE/*WRITE/*BY-CACHE-MEDIUM bleiben die eingelagerten Lese-Daten erhalten, in Zukunft werden zusätzlich (oder bei *WRITE nur noch) Schreibdaten in den Cache eingelagert.
Bei einem umgekehrten Wechsel (nach *READ) werden Daten ohne Plattenkopie auf die Platte(n) zurückgeschrieben, anschließend werden nur noch Lesedaten in den Cache eingelagert.
CACHING-MODE = *UNCHANGED
Der Caching-Modus bleibt unverändert.
CACHING-MODE = *READ
Der Cache-Bereich soll zu einem Lese-Cache verändert werden. Im Cache eingelagerte Schreibdaten müssen auf die Platte(n) zurückgeschrieben werden.
CACHING-MODE = *READ-WRITE
Der Cache-Bereich soll zu einem Lese-Schreib-Cache verändert werden.
CACHING-MODE = *WRITE
Der Cache-Bereich soll zu einem Schreib-Cache verändert werden.
CACHING-MODE = *BY-CACHE-MEDIUM
Der eingestellte Caching-Modus soll abhängig von den Dateiattributen sein (siehe /START- DAB-CACHING-Kommando).
FORCE-OUT = *UNCHANGED / *AT-LOW-FILLING / *AT-HIGH-FILLING / *NO
Der Schwellwert zum asynchronen Zurückschreiben von Cache-Daten soll verändert werden. Damit wird beeinflusst, ob und ab wann Schreibdaten aus dem Cache auf die Platte(n) zurückgeschrieben werden (siehe Kommando /START-DAB-CACHING).
FORCE-OUT = *UNCHANGED
Der Schwellwert zum asynchronen Zurückschreiben von Cache-Daten soll unverändert bleiben.
FORCE-OUT = *AT-LOW-FILLING
Durch schwellwertgesteuerte Sicherungsläufe soll die Anzahl der Cache-Segmente, die nicht auf Platte zurückgeschrieben sind, möglichst klein gehalten werden. Das Zurückschreiben soll erfolgen, sobald der Cache zu 25% mit nicht zurückgeschriebenen Schreibdaten belegt ist.
FORCE-OUT = *AT-HIGH-FILLING
Für die Cache-Segmente dieses Cache-Bereichs sollen nur so viele Datensicherungen durchgeführt werden, wie erforderlich sind, um immer einen ausreichend großen Vorrat an Segmenten für neue Cache-Einlagerungen zur Verfügung zu haben. Das Zurückschreiben soll erfolgen, sobald der Cache zu 75% mit nicht zurückgeschriebenen Schreibdaten belegt ist.
FORCE-OUT = *NO
Die Daten dieses Cache-Bereichs sollen nicht in schwellwertgesteuerten Sicherungsläufen auf die Platte übertragen werden. Die Daten werden erst auf die Platte übertragen, wenn über das Kommando /STOP-DAB-CACHING der Cache-Bereich abgebaut wird.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
| 0 | CMD0001 | Ohne Fehler | |
| 32 | CMD0221 | Interner SDF-Fehler | |
| 64 | CMD0216 | Erforderliches Privileg fehlt | |
| 64 | NDB0002 | Pubset mit Key-Platten kann nicht in Cache-Bereich ohne Keys aufgenommen werden | |
| 64 | NDB0005 | Fehlende Berechtigung zum Kommandoaufruf | |
| 64 | NDB0006 | Pubset kann nicht in einen File-Area-Cache aufgenommen werden | |
| 64 | NDB0010 | Falsche Syntaxdatei-Version | |
| 64 | NDB0012 | DVS-Fehler | |
| 64 | NDB0026 | Datei ist nicht katalogisiert | |
| 64 | NDB0027 | Datei kann nicht bedient werden, weil sie entweder eine Banddatei, durch HSMS migriert, eine Dateigruppe, eine Arbeitsdatei für S0-Migration oder eine Arbeitsdatei für SPACEOPT ist | |
| 64 | NDB0028 | Datei bereits bedient | |
| 64 | NDB0029 | Cache-Bereich konnte nicht vollständig auf Platte gesichert werden | |
| 64 | NDB0032 | Datenbereiche auf einem User-PFA-Pubset, die von DAB bedient werden, können nicht in ADM-PFA-Cachebereichen bedient werden | |
| 64 | NDB0034 | Datei auf Key-Platte kann nicht in Cache-Bereich ohne Keys aufgenommen werden | |
| 64 | NDB0071 | Für die angegebene Datei ist wegen Dateiverschlüsselung kein Schreib-Caching möglich | |
| 64 | NDB0072 | Benutzerkennung der angegebenen Datei ist unbekannt | |
| 64 | NDB0080 | Caching von Daten im Home-Pubset ist in einem Schreib- oder Schreib-Lese-Cache nicht erlaubt | |
| 64 | NDB0096 | Die Cache-Sicherungsfehler oder Fehler bei einer BS2000-internen Funktion nicht durchgeführt werden | |
| 64 | NDB0097 | Der Cache-Bereich ist unbekannt, mehrfach vorhanden oder rekonfiguriert worden | |
| 64 | NDB0098 | Pubset nicht lokal importiert | |
| 64 | NDB0100 | Pubset wird bereits bedient | |
| 64 | NDB0101 | Mehr als ein SM-Pubset für Schreib-Lese-Caching angegeben | |
| 64 | NDB0103 | Dateikatalog kann nicht bedient werden (Fehler) | |
| 64 | NDB0110 | SM-Pubset enthält kein cache-bares Volume-Set | |
| 64 | NDB0111 | Für den Cache-Bereich ist ein ADD-FILE oder REMOVE-FILE nicht zulässig | |
| 64 | NDB0112 | Datei liegt auf nicht belegtem Platten-Volume | |
| 64 | NDB0113 | Die Cache-Größe von Cache-Bereichen mit dynamischer Cache-Größe kann nicht explizit geändert werden | |
| 64 | NDB0114 | Parameter-Fehler bei Erweiterung: neue Größe ist kleiner gleich alter Größe | |
| 64 | NDB0115 | Parameter-Fehler bei Reduktion: neue Größe ist größer gleich alter Größe | |
| 64 | NDB0116 | Modifikation der Cache-Segment-Größe ist bei automatischen Caching nicht möglich | |
| 64 | NDB0117 | Größe eines User-PFA-Cache-Bereichs für ein shared Pubset kann nicht modifiziert werden | |
| 64 | NDB0118 | Modifikation des Cache-Bereichs auf Caching-Mode *WRITE/*READ-WRITE ist nicht möglich, da Dateien auf dem Home-Pubset bedient werden | |
| 64 | NDB0119 | Das Kommando kann zur Zeit nicht ausgeführt werden, da bereits ein anderes MODIFY-DAB-CACHING-Kommando ausgeführt wird | |
| 64 | NDB0120 | Parameter-Fehler beim Kommando MODIFY-DAB-CACHING: die Datei(en) werden nicht vom angegebenen Cache-Bereich bedient | |
| 64 | NDB0121 | Für einen User-PFA-Cache-Bereich ist ein Umschalten des Caching-Mode nicht erlaubt | |
| 64 | NDB0124 | Neue Cache-Segment-Größe ist gleich der alten Cache-Segment-Größe | |
| 64 | NDB0127 | Datei kann im angegebenen Cache-Bereich nicht bedient werden | |
| 64 | NDB0129 | Modifikation der Cache-Segment-Größe eines Cache-Bereichs ohne Cache-Speicher ist nicht möglich | |
| 64 | NDB0155 | Partielle Dateinamen werden nicht unterstützt, da kein Cache-Bereich mit automatischen Caching vorliegt | |
| 64 | NDB0156 | Parameter RESET-FILE wird für angegebenen Cache-Bereich nicht unterstützt | |
| 64 | NDB0158 | Cache-Bereich ist wegen Mangel an Hauptspeicher reduziert worden. | |
| 64 | NDB0159 | Datei kann wegen Mangel an Hauptspeicher nicht in Cache- Bereich aufgenommen werden. | |
| 64 | NDB0161 | Pubset kann wegen Pubset-Import nicht aus dem Cache-Bereich entfernt werden | |
| 64 | NDB0162 | Die Bearbeitung eines Pubsets ist beim Zugriff auf ein bestimmtes Volume abgebrochen worden | |
| 64 | NDB0163 | Die Bearbeitung eines Pubsets ist beim Zugriff auf ein Volume abgebrochen worden | |
| 64 | NDB0165 | Die Bearbeitung eines Pubsets ist beim Zugriff auf ein bestimmtes Volume unterbrochen worden. Der Abschluss der Bearbeitung ist unbekannt | |
| 64 | NDB0166 | Die Bearbeitung eines Pubsets ist beim Zugriff auf ein Volume unterbrochen worden. Der Abschluss der Bearbeitung ist unbekannt | |
| 64 | NDB0168 | Parameter-Fehler: zu entfernendes Pubset wird von DAB im Cache-Bereich nicht bedient | |
| 64 | NDB0169 | Im Cache-Bereich wird bereits die maximale Anzahl Pubsets bedient | |
| 64 | NDB0170 | Parameter-Fehler: aufzunehmendes Pubset wird von DAB im Cache-Bereich nicht bedient | |
| 64 | NDB0177 | Die Konfiguration eines Cache-Bereichs kann während einer Hauptspeicher-Rekonfiguration nicht modifiziert werden | |
| 64 | NBD0197 | Pubset kann wegen Mangel an Hauptspeicher nicht in Cache- Bereich aufgenommen werden. | |
| 65 | CMD2241 | Subsystem DAB nicht geladen |
Hinweise
Behandlung von Dateien, die der Angabe verschiedenen teilqualifizierten Dateinamen entsprechen
Durch die Angabe teilqualifizierter Dateinamen beim Operanden AREA=*ADD-FILE(...)/REMOVE-FILE(...)/RESET-FILE(...) lassen sich Teilmengen von Dateien bbilden, die von der Festlegung einer gegebenen Obermenge von Dateien abweichen. Sollen z.B. die Dateien, die mit dem Teilnamen :<catid>:$TSOS.SYS. beginnen, nicht in den automatischen Cache-Bereich aufgenommen werden, so geschieht dies durch:
/MODIFY-DAB-CACHING CACHE-ID=<cache-id>,AREA=*REMOVE-FILE(SYS.)Andererseits sollen aber Dateien, die mit dem :<catid>:$TSOS.SYS.SDF. beginnen, immer gecacht werden. Mit folgendem Kommando werden diese Dateien immer gecacht:
/MODIFY-DAB-CACHING CACHE-ID=<cache-id>,AREA=*ADD-FILE(SYS.SDF.)In diesem Fall werden Dateien, die mit dem :<catid>:$TSOS.SYS.<xyz>. beginnen und xyz <> SDF ist, nicht gecacht. Die Reihenfolge der Kommandos muss aber in der angegebenen Weise erfolgen. Bei umgekehrter Angabe würden sonst auch alle Dateien mit :<catid>:$TSOS.SYS.SDF. nicht gecacht.
Die Angabe eines kürzeren Präfix hebt alle vorher gemachten Angaben für längere, teilqualifizierte oder vollständige Dateinamen auf, die mit diesem Präfix beginnen.
Umbenennung von Dateien
Wenn eine Datei umbenannt wird, die mit ADD-FILE zur Datenbasis des Cache-Bereichs hinzugenommen bzw. mit REMOVE-FILE aus der Datenbasis entfernt worden ist, behält sie diese Eigenschaft auch nach der Umbenennung.
Wenn eine Datei umbenannt wird, die durch Angabe eines teilqualifizierten Dateinamens mit ADD-FILE zur Datenbasis des Cache-Bereichs hinzugenommen bzw. mit REMOVE-FILE aus der Datenbasis entfernt worden ist, behält sie diese Eigenschaft auch nach der Umbenennung.
Wenn eine Datei umbenannt wird, die durch Angabe eines teilqualifizierten Dateinamens mit ADD-File hinzugenommen bzw. REMOVE-FILE entfernt) wurde (in diesen Fällen verliert die Datei diese Eigenschaft, oder auf die weder ein ADD-FILE oder noch ein REMOVE-FILE angewendet worden ist, so übernimmt sie die Eigenschaft bzgl. der Zugehörigkeit zur Datenbasis, die für den neuen Dateinamen gilt. Erhält die Datei einen neuen Namen, der zu einer vorangegangenen Angabe eines teilqualifizierten Dateinamens passt, so wird sie zur Datenbasis hinzugefügt, wenn der teilqualifizierte Dateiname bei ADD-FILE angegeben wurde. Umgekehrt gilt dies, wenn der teilqualifizierte Dateiname bei REMOVE-FILE angegeben wurde. Sonst entscheidet DAB über die Cache-Würdigkeit der Datei.
Modifikation der Cache-Segmentgröße
Bei der Modifikation der Cache-Segmentgröße bei einem File-Area-Cache ist es möglich, dass die alte Cache-Größe nicht wieder eingestellt werden kann und der Cache mit einer gemeldeten kleineren Cache-Größe weitergeführt wird.
Konkurrierende Cache-Bereiche
Die aktuelle Größe eines Cache-Bereichs im Hauptspeicher (MEMORY =*BELOW-MIN-MEM-SIZE/*ABOVE-MIN-MEM-SIZE/*ANY) kann deshalb zu groß sein, weil er zuerst eingerichtet wurde. Ein anderer Cache-Bereich, der später mit dieser MEMORY-Einstellung eingerichtet wurde, ist deshalb zu klein. Dies ist ein Fall, in dem die aktuellen Größen der Cache-Bereiche geändert werden sollten.
Dazu muss die eingestellte Größe des größeren Cache-Bereichs verringert werden. Nach Abschluss dieser Verringerung und einer Wartezeit von ca. zwei Minuten sollte sich die aktuelle Größe des kleineren Cache-Bereichs erhöht haben (siehe Kommando
/SHOW-DAB-CACHING). Wenn die Erhöhung nicht ausreichend ist, dann muss die Größe des größeren Cache-Bereichs nochmals verringert werden. Wenn die Erhöhung ausreichend ist, dann kann die Größe des größeren Cache-Bereichs wieder auf den ursprünglichen Wert gesetzt werden.