PFA-Caching für eine bereits geöffnete Datei starten
Komponente: | BS2000 OSD/BC |
Funktionsbereich: | Dateiverarbeitung |
Anwendungsbereich: | FILE |
Privilegierung: | STD-PROCESSING |
Funktionsbeschreibung
Das Kommando START-FILE-CACHING startet das Caching für eine Datei, die bereits zur Dateibearbeitung geöffnet ist. Voraussetzung ist, dass die Datei auf einem Pubset liegt, für den im MRSCAT eine Cache-Konfiguration definiert ist, und dass dieser Cache aktiv ist, d.h. dass PFA-Caching für den Pubset aktiviert ist.
Somit kann für Dateien, bei denen zum OPEN-Zeitpunkt (bei Shared-Update-Verarbeitung der erste OPEN) kein geeignetes Cache-Medium verfügbar war bzw. angefordert wurde, das Caching „nachträglich“ gestartet werden. Die Performance-Anforderungen für Ein-/Ausgabe-Operationen erfolgen über den Operanden IO-ATTRIBUTES, der genauso validiert und ausgewertet wird wie eine Anforderung zum OPEN-Zeitpunkt (siehe Kommando ADD-FILE-LINK).
Das Kommando wird in folgenden Fällen abgewiesen:
Der Aufrufer besitzt keine Dateizugriffsrechte.
Die Datei ist am lokalen Rechner nicht geöffnet.
Es ist kein PFA-Cache-Bereich eingerichtet.
Die Datei wird bereits gecached.
Die Datei befindet sich auf Privatplatte oder Band.
Für die Datei existiert ein XCS-Lock.
Die angegebenen Cache-Einstellungen sind nicht möglich oder nicht erlaubt.
Format
START-FILE-CACHING | ||||||||||||||||||||
| ||||||||||||||||||||
Operandenbeschreibung
FILE-NAME = <filename 1..54>
Name der Datei, die gecached werden soll. Die Datei muss bereits geöffnet sein und auf einem lokal zugreifbaren Pubset liegen.
IO-ATTRIBUTES = *PARAMETERS(...)
Gibt an, welche Performance-Anforderungen der Benutzer für Ein-/Ausgabe-Operationen an das System stellt. Ob und in welchem Maße diese Anforderungen erfüllt werden, ist abhängig von dem Cache-Medium, das für den Pubset aktiv ist (siehe Ausgabe des Kommandos SHOW-PUBSET-CACHE-ATTRIBUTES bzw. SHOW-PUBSET-PARAMETERS). Schreib- und Lesezugriffe erfolgen über schnelle Zwischenspeicher. Die Anzahl der Plattenzugriffe und die Zugriffszeiten verringern sich.
IO-ATTRIBUTES = *PARAMETERS(...)
Die Performance-Eigenschaften ergeben sich aus den Angaben zu den Operanden PERFORMANCE und USAGE.
PERFORMANCE = *HIGH / *VERY-HIGH / *USER-MAXIMUM
Gibt das Performance-Attribut der Datei an. Es bestimmt welche Priorität für die im Operanden USAGE bezeichneten Ein-/Ausgabe-Operationen gewünscht wird. Das höchste zulässige Performance-Attribut für Dateien, die auf einem PFA-Pubset mit der Einstellung CACHED-FILES=*BY-USER liegen (siehe Kommando MODIFY-PUBSET-CACHE-ATTRIBUTES), ist im Benutzereintrag festgelegt (siehe Ausgabe des Kommandos SHOW-USER-ATTRIBUTES, Ausgabefeld DMS-TUNING-RESOURCES).
PERFORMANCE = *HIGH
Die Datei soll über einen Cache bearbeitet werden (hohe Performance-Priorität).
Für eine Datei, die auf einem PFA-Pubset mit der Einstellung CACHED-FILES=*BY-USER liegt, ist die Angabe nur möglich, wenn der Benutzer das DMS-Tuning-Privileg CONCURRENT-USE bzw. EXCLUSIVE-USE für den Pubset besitzt (siehe Ausgabe des Kommandos SHOW-USER-ATTRIBUTES, Ausgabefeld DMS-TUNING-RESOURCES).
PERFORMANCE = *VERY-HIGH
Die Datei soll über einen Cache bearbeitet werden. Die referenzierten Daten der Datei sollen dabei permanent im Cache gehalten werden (höchste Performance-Priorität). Die Cache-Daten werden erst beim Schließen der Datei aus dem Cache verdrängt. Die Angabe ist nur möglich für Benutzer, die das DMS-Tuning-Privileg EXCLUSIVE-USE für den Pubset besitzen (siehe Ausgabe des Kommandos SHOW-USER-ATTRIBUTES, Ausgabefeld DMS-TUNING-RESOURCES).
Hinweis
Alle für diese Datei belegten Cache-Segmente werden bis zum Schließen der Datei gesperrt. Sind viele Dateien gleichzeitig mit diesem Attribut geöffnet, kann dadurch der für normal gepufferte Dateien verfügbare Cache-Speicher so erheblich eingeschränkt werden, dass Datenzugriffe auf diese Dateien nicht mehr performant ausgeführt werden können.
PERFORMANCE = *USER-MAXIMUM
Die Datei erhält das Performance-Attribut, das für den Benutzer als höchstes zulässiges im Benutzerkatalog eingetragen ist. Besitzt der Benutzer kein DMS-Tuning-Privileg, wird das Kommando abgewiesen.
USAGE = *READ-WRITE / *WRITE / *READ
Gibt an, für welche Ein-/Ausgabe-Operationen die erhöhte Performance-Anforderung (Bearbeitung über einen Cache) gewünscht wird. Voreinstellung ist *READ-WRITE, d.h. die Anforderungen gelten für Lese- und Schreiboperationen.
Besitzt die Datei kein besonderes Performance-Attribut (PERFORMANCE= *STD) und ist der Cache-Bereich für den Pubset nicht so definiert, dass alle vorhandenen Dateien bedient werden (siehe Operand CACHED-FILES=*ALL im Kommando MODIFY-PUBSET-CACHING-ATTRIBUTES), hat der Operand USAGE keine Auswirkung auf die Bearbeitung.
USAGE = *READ-WRITE
Die erhöhte Performance-Anforderung gilt sowohl für Lese- als auch Schreiboperationen.
USAGE = *WRITE
Die erhöhte Performance-Anforderung gilt nur für Schreiboperationen.
USAGE = *READ
Die erhöhte Performance-Anforderung gilt nur für Leseoperationen.
Hinweis
Bei USAGE=*READ-WRITE bzw. *WRITE erfolgt nur dann ein Schreib-Caching, wenn die Bedingungen für das Datei-Attribut DISK-WRITE erfüllt sind (siehe CREATE-FILE bzw. MODIFY-FILE-ATTRIBUTES).
Bei DISK-WRITE=*IMMEDIATE muss für Schreib-Caching das genutzte Cache-Medium ausfallsicher sein (siehe Ausgabe des Kommandos SHOW-MASTER-CATALOG-ENTRY INFORMATION=*USER, Ausgabefeld CACHE-MEDIUM).
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Kommando ausgeführt | |
1 | 0 | CMD0001 | Der gewünschte Zustand war bereits erreicht |
1 | CMD0202 | Syntaxfehler | |
32 | DMS1D0E | MSCF-Verbindungsfehler | |
32 | DMS1D10 | Interner Fehler | |
64 | DMS1D03 | Anwender ist nicht zugriffsberechtigt auf die Datei | |
64 | DMS1D05 | Datei ist nicht (lokal) geöffnet | |
64 | DMS1D06 | Kein Cache verfügbar | |
64 | DMS1D07 | Kein Benutzerprivileg für erhöhte Performance | |
64 | DMS1D08 | Für diese Datei ist Caching nicht erlaubt | |
64 | DMS1D09 | Die Datei wird mit XCS-Umgebung bearbeitet | |
64 | DMS1D0A | Unzulässige Datei (oder nicht da) | |
64 | DMS1D0B | Datensicherung darf nicht erst bei Close erfolgen. | |
64 | DMS1D0D | Speichermangel | |
64 | DMS1D0F | Fehler bei Katalog-Management-Aufruf. | |
64 | DMS1D11 | Subsystem 'DAB' nicht gefunden. |