PFA-Cache-Konfiguration eines Pubsets ausgeben
Komponente: | BS2000 |
Funktionsbereich: | Pubset- und MRSCAT-Verwaltung |
Anwendungsbereich: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privilegierung: | TSOS |
Berechtigungsschlüssel: | @ |
Funktionsbeschreibung
Das Kommando SHOW-PUBSET-CACHE-ATTRIBUTES informiert die Systembetreuung über die PFA-Cache-Konfiguration eines Pubsets. Bei einem SF-Pubset sind diese Eigenschaften Pubset-global, bei einem SM-Pubset sind diese Eigenschaften spezifisch für jeden Volume-Set festgelegt.
Voreingestellt werden die Informationen für alle Pubsets ausgegeben. Im Operanden SELECT-PUBSET kann die Ausgabemenge auf Pubsets mit bestimmten Eigenschaften beschränkt werden. Außerdem kann die Informationsausgabe im Operanden PUBSET bzw. VOLUME-SET auch explizit für einen bestimmten Pubset bzw. Volume-Set angefordert werden.
Die PFA-Cache-Konfiguration eines Pubsets bzw. Volume-Sets kann mit dem Kommando MODIFY-PUBSET-CACHE-ATTRIBUTES geändert werden.
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
Einschränkungen
Für SF-Pubsets im Shared-Pubset-Verbund sind nur die am Pubset-Master ausgegebenen Informationen gültig. Die an einem Pubset-Slave ausgegebenen Informationen werden jeweils gültig, wenn dieser zum Pubset-Master wird.
Format
SHOW-PUBSET-CACHE-ATTRIBUTES |
PUBSET = *ALL / <cat-id 1..4> ,SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *LOCAL / *REMOTE / *ACCESSIBLE / *LOCAL-ACCESSIBLE / *REMOTE-ACCESSIBLE / *HSMS-SUPPORTED / *SPEEDCAT / *PAGING / *SINGLE-FEATURE / *SYSTEM-MANAGED / *INACCESSIBLE / *QUIET / *DEFINED-XCS-CONFIGURATED / *XCS-CONFIGURATED ,VOLUME-SET = *ALL / <cat-id 1..4> |
Operandenbeschreibung
PUBSET = *ALL / <cat-id 1..4>
Bestimmt, für welche Pubsets die Cache-Attribute ausgegeben werden sollen.
PUBSET = *ALL
Es werden die Cache-Attribute aller Pubsets ausgegeben. Über den Operanden SELECT-PUBSET kann Informationsausgabe auf Pubsets mit bestimmten Eigenschaften beschränkt werden.
PUBSET = <cat-id 1..4>
Kennung des Pubsets, dessen Cache-Attribute ausgegeben werden sollen. Für einen SM-Pubset kann die Ausgabe der Cache-Attribute im Operanden VOLUME-SET auf einen bestimmten Volume-Set beschränkt werden.
SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *LOCAL / *REMOTE / *ACCESSIBLE /
*LOCAL-ACCESSIBLE / *REMOTE-ACCESSIBLE / *HSMS-SUPPORTED / *SPEEDCAT / *PAGING /
*SINGLE-FEATURE / *SYSTEM-MANAGED / *INACCESSIBLE / *QUIET /
*DEFINED-XCS-CONFIGURATED / *XCS-CONFIGURATED
Gibt an, ob die Informationsausgabe nur für bestimmte Pubsets erfolgen soll. Eine Einschränkung auf bestimmte Pubsets ist sinnvoll, wenn im Operanden PUBSET mit *ALL alle Pubsets ausgewählt wurden.
SELECT-PUBSET = *ALL
Die Cache-Attribute aller im Operanden PUBSET angegebenen Pubsets werden ausgegeben.
SELECT-PUBSET = *EXCLUSIVE
Die Cache-Attribute aller exklusiv importierten Pubsets werden ausgegeben.
SELECT-PUBSET = *SHARED
Die Cache-Attribute aller shared importierten Pubsets werden ausgegeben.
SELECT-PUBSET = *LOCAL
Die Cache-Attribute aller lokal importierten Pubsets werden ausgegeben. Es werden auch die Cache-Attribute der Pubsets, auf die nicht zugegriffen werden kann, ausgegeben.
SELECT-PUBSET = *REMOTE
Die Cache-Attribute aller Pubsets, für die das Attribut *LOCAL nicht zutrifft, werden ausgegeben.
SELECT-PUBSET = *ACCESSIBLE
Die Cache-Attribute aller Pubsets, auf die zugegriffen werden kann, werden ausgegeben.
SELECT-PUBSET = *LOCAL-ACCESSIBLE
Die Cache-Attribute aller lokal verfügbaren, d.h. importierten Pubsets, werden ausgegeben.
SELECT-PUBSET = *REMOTE-ACCESSIBLE
Die Cache-Attribute aller Pubsets, die nicht lokal importiert sind, auf deren Dateikatalog jedoch über eine MSCF-Verbindung zugegriffen werden kann, werden ausgegeben.
SELECT-PUBSET = *HSMS-SUPPORTED
Die Cache-Attribute aller durch das Subsystem HSMS bedienbaren Pubsets werden ausgegeben.
SELECT-PUBSET = *SPEEDCAT
Die Cache-Attribute aller SF-Pubsets, auf deren Dateikatalog im lokalen System über SPEEDCAT zugegriffen wird, werden ausgegeben.
SELECT-PUBSET = *PAGING
Die Cache-Attribute aller Pubsets mit lokal genutzten Seitenwechsel-Bereichen werden ausgegeben.
SELECT-PUBSET = *SINGLE-FEATURE
Die Cache-Attribute aller SF-Pubsets werden ausgegeben.
SELECT-PUBSET = *SYSTEM-MANAGED
Die Cache-Attribute der im Operanden VOLUME-SET ausgewählten Volume-Sets werden ausgegeben.
SELECT-PUBSET = *INACCESSIBLE
Die Cache-Attribute aller nicht verfügbaren Pubsets werden ausgegeben.
SELECT-PUBSET = *QUIET
Die Cache-Attribute aller Pubsets, deren MSCF-Verbindungen nicht mehr bestehen, werden ausgegeben.
SELECT-PUBSET = *DEFINED-XCS-CONFIGURATED
Die Cache-Attribute aller Pubsets, die im MRS-Katalog als XCS-Pubsets definiert sind, werden ausgegeben.
SELECT-PUBSET = *XCS-CONFIGURATED
Die Cache-Attribute aller XCS-Pubsets werden ausgegeben.
VOLUME-SET = *ALL / <cat-id 1..4>
Bestimmt die Volume-Sets, deren Cache-Attribute ausgegeben werden sollen.
VOLUME-SET = *ALL
Es werden die Cache-Attribute aller Volume-Sets ausgegeben.
VOLUME-SET = <cat-id 1..4>
Kennung des Volume-Sets, dessen Cache-Attribute ausgegeben werden.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
---|---|---|---|
0 | CMD0001 | Ohne Fehler | |
32 | CMD0221 | Interner Systemfehler | |
32 | CMD2009 | Fehler bei Ausgabe in S-Variable (z.B. Subsystem nicht verfügbar) | |
64 | CMD0216 | Privilegienfehler | |
64 | DMS1381 | Volume-Set-Konflikt | |
64 | DMS138B | Pubset nicht vorhanden oder nicht mit angegebener Eigenschaft | |
64 | DMS138E | Volume-Set nicht vorhanden | |
128 | DMS1386 | Klasse-4/5-Speichermangel |
Ausgabeformat
Als Kopfzeile wird der Kommandoname ausgegeben. Die Ausgabeinformation pro Pubset lässt sich in drei Gruppen von Ausgabeblöcken einteilen:
Ausgabeblock für die pubset-globale Grundinformation
Ausgabeblöcke für pubset-globale Detail-Informationen
Ausgabeblöcke für volumeset-spezifische Informationen
Pubset-globale Grundinformation
Der Ausgabeblock für die pubset-globale Grundinformation besteht aus einer Wertezeile, die gleichzeitig als Überschriftszeile die Informationsausgabe für einen Pubset einleitet. Die Grundinformation besitzt folgendes Layout:
PUBSET <catid>: <type>, CTL-SET = (<ctlid>, <type>), <status>, <hsms>
Bedeutung der Ausgabewerte
<catid> | Kennung des Pubsets |
<type> | Typ des Pubsets; möglich sind: SINGLE-FEATURE bzw. SYSTEM-MANAGED |
<ctlid> | Kennung des Control-Volume-Sets (bei SM-Pubset) |
<type> | Gerätetyp der Systemplatte des Control-Volume-Sets (bei SM-Pubset) |
<status> | Verfügbarkeit des Pubsets; möglich Werte sind:
|
<hsms> | Unterstützung durch das Subsystem HSMS (bei SM-Pubset); möglich Werte sind:
|
Pubset-globale Detail-Informationen
Nur für SF-Pubsets wird die Cache-Konfiguration Pubset-global ausgegeben (für SM-Pubsets siehe „Volume-Set-spezifische Informationen").
Die Überschriftszeile unterteilt die nachfolgenden Wertezeilen in eine dreispaltige Tabelle. Jede Wertezeile enthält in der ersten Spalte den Parameternamen, in der zweiten Spalte die pubset-global definierten Werte (DEFINED) und in der dritten Spalte die aktuell eingestellten Werte (CURRENT).
Der Ausgabeblock wird mit der folgenden Überschriftszeile eingeleitet:
--- CACHE CONFIGURATION ---- + --- DEFINED --- + --- CURRENT ---
Anschließend werden die folgenden Wertezeilen ausgegeben:
Information über das Cache-Medium:
CACHE MEDIUM | NONE | NONE | MAIN MEMORY | MAIN MEMORY | GLOBAL STORAGE | GLOBAL STORAGE
Ist der Cache gerade nicht aktiv, wird zusätzlich die folgende Zeile ausgegeben:
| | NOT ACTIVE
Wurde der Cache durch die Rekonfiguration abgeschaltet, wird zusätzlich die folgende Zeile ausgegeben:
| | IN HOLD
Information über die Cache-Größe (in MByte bzw. KByte):
CACHE SIZE | NONE | | <n> MB | <n> MB | <n> KB | <n> KB
Information darüber, ob Caching vom Benutzer zugelassen werden muss, global für alle Dateien gilt oder die Dateien vom System automatisch ausgewählt werden (AutoDAB bei dem Cache-Medium Hauptspeicher):
CACHED FILES | BY USER | | ALL | | BY SYSTEM |
Die nachfolgenden Zusatzinformationen sind abhängig von der Art des Cache-Mediums. Der definierte Wert wird immer ausgegeben, gilt aber nur, wenn das entsprechende Medium definiert ist (Angabe in Klammern). Der aktuell eingestellte Wert wird nur ausgegeben, wenn das aktuell entsprechende Medium aktuell genutzt wird.
Information darüber, ob die Konsistenz der im Cache zwischengespeicherten Schreibdaten bei Stromausfall des Globalspeichers gewährleistet ist:
VOLATILITY (GLOBAL STORAGE) | YES | YES | NO | NO
Für Globalspeicher (Global Storage) werden zusätzlich Informationen über die GS-Unit ausgegeben:
GS-UNIT (GLOBAL STORAGE) | BY DEFAULT | DUAL | DUAL | | MONO (1) | MONO (1) | MONO (2) | MONO (2)
Information über die Segment-Größe:
SEGMENT SIZE (NOT CONTROLLER) | 4 KB| 4 KB | 8 KB| 8 KB | 16 KB| 16 KB | 32 KB| 32 KB
Information über den Zeitpunkt, zu dem der Cache-Inhalt vom Cache-Handler DAB asynchron zur Anwendung auf Platte zurückgeschrieben wird (schwellwertgesteuerte Sicherung):
FORCE OUT (NOT CONTROLLER) | NO FORCE OUT | NO FORCE OUT | AT LOW FILLING | AT LOW FILLING | AT HIGH FILLING | AT HIGH FILLING
Volume-Set-spezifische Informationen
Bei einem SM-Pubset werden Konfigurationsinformationen pro Volume-Set ausgegeben (für alle oder für einen explizit angegebenen Volume-Set). Die Informationen zu einem Volume-Set werden mit folgender Überschriftszeile eingeleitet:
--- VOLUME SET INFORMATION --------------------------------------
Danach folgen die Ausgabeinformationen für alle Volume-Sets des SM-Pubsets oder für den explizit angegebenen Volume-Set. Die Ausgabeinformation pro Volume-Set beginnt mit der Grundinformation für den Volume-Set:
VOLUME-SET <catid>: <type> <status>
Bedeutung der Ausgabewerte:
<catid> | Kennung des Volume-Sets |
<type> | Gerätetyp der Volres |
<status> | Betriebszustand des Volume-Sets:
|
Danach wird die Cache-Konfiguration des Volume-Sets ausgegeben.
Die Überschriftszeile unterteilt die nachfolgenden Wertezeilen in eine dreispaltige Tabelle. Jede Wertezeile enthält in der ersten Spalte den Parameternamen, in der zweiten Spalte die pubset-global definierten Werte (DEFINED) und in der dritten Spalte die aktuell eingestellten Werte (CURRENT).
Der Ausgabeblock wird mit der folgenden Überschriftszeile eingeleitet:
--- CACHE CONFIGURATION ---- + --- DEFINED --- + --- CURRENT ---
Anschließend werden die folgenden Wertezeilen ausgegeben:
Information über das Cache-Medium:
CACHE MEDIUM | NONE | NONE | MAIN MEMORY | MAIN MEMORY | GLOBAL STORAGE | GLOBAL STORAGE
Ist der Cache gerade nicht aktiv, wird zusätzlich die folgende Zeile ausgegeben:
| | NOT ACTIVE
Wurde der Cache durch die Rekonfiguration abgeschaltet, wird zusätzlich die folgende Zeile ausgegeben:
| | IN HOLD
Information über die Cache-Größe (in MByte bzw. KByte):
CACHE SIZE | NONE | | <n> MB | <n> MB | <n> KB | <n> KB
Information darüber, ob Caching vom Benutzer zugelassen werden muss oder für alle
CACHED FILES | BY USER | | ALL |
Die nachfolgenden Zusatzinformationen sind abhängig von der Art des Cache-Mediums. Der definierte Wert wird immer ausgegeben, gilt aber nur, wenn das entsprechende Medium definiert ist (Angabe in Klammern). Der aktuell eingestellte Wert wird nur ausgegeben, wenn das aktuell entsprechende Medium aktuell genutzt wird.
Information darüber, ob die Konsistenz der im Cache zwischengespeicherten Schreibdaten bei Stromausfall des Globalspeichers gewährleistet ist:
VOLATILITY (GLOBAL STORAGE) | YES | YES | NO | NO
Für Globalspeicher (Global Storage) werden zusätzlich Informationen über die GS-Unit ausgegeben:
GS-UNIT (GLOBAL STORAGE) | BY DEFAULT | DUAL | DUAL | | MONO (1) | MONO (1) | MONO (2) | MONO (2)
Information über die Segment-Größe:
SEGMENT SIZE (NOT CONTROLLER) | 4 KB| 4 KB | 8 KB| 8 KB | 16 KB| 16 KB | 32 KB| 32 KB
Information über den Zeitpunkt, zu dem der Cache-Inhalt vom Cache-Handler DAB asynchron zur Anwendung auf Platte zurückgeschrieben wird (schwellwertgesteuerte Sicherung):
FORCE OUT (NOT CONTROLLER) | NO FORCE OUT | NO FORCE OUT | AT LOW FILLING | AT LOW FILLING | AT HIGH FILLING | AT HIGH FILLING
Beispiel
/show-pubset-cache-attributes pubset=nets
%---------------------------------------------------------------------------- %COMMAND: SHOW-PUBSET-CACHE-ATTRIBUTES %- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - %PUBSET NETS: SINGLE-FEATURE, ACC %---- CACHE CONFIGURATION --------- + ---- DEFINED ---- + ---- CURRENT --- % CACHE MEDIUM | NONE | NONE % CACHE SIZE | NONE | % CACHED FILES | BY USER | % SEGMENT SIZE (NOT CONTROLLER) | 32 KB | % FORCE OUT (NOT CONTROLLER) | AT LOW FILLING | %----------------------------------------------------------------------------
Ausgabe in S-Variable
Einige S-Variablen werden nur für Volume-Set-spezifische Informationen erzeugt. Sie sind in folgender Tabelle in der Spalte Bedingung mit „1“ gekennzeichnet.
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
---|---|---|---|---|
Aktuell eingestellter FORCE-OUT-Wert | var(*LIST).CACHE-CURR.FORCE-OUT | S | *AT-HIGH-FILL | |
Ohne Bedeutung (Anzeige nur aus Kompatibilitätsgründen) | var(*LIST).CACHE-CURR.GS-UNIT | S | *DUAL | |
Ohne Bedeutung(Anzeige nur ausKompatibilitätsgründen) | var(*LIST).CACHE-CURR.GS-UNIT-NUM | I | 0 | |
Aktuelles Cache-Medium | var(*LIST).CACHE-CURR.MED | S | *MAIN-MEM | |
Aktueller Status des Cache-Mediums | var(*LIST).CACHE-CURR.MED-STAT | S | *ACTIVE | |
Ohne Bedeutung (Anzeige nur aus Kompatibilitätsgründen) | var(*LIST).CACHE-CURR.PREFETCH | S | *HIGH | |
Aktuelle Segment-Größe des Cache-Mediums (0 für SM-Pubset) | var(*LIST).CACHE-CURR.SEG-SIZE | I | 0 | |
Aktuelle Cache-Größe (0 für SM-Pubset) | var(*LIST).CACHE-CURR.SIZE | I | 0 | |
Aktuelle Dimension der Cache-Größe | var(*LIST).CACHE-CURR.SIZE-DIM | S | *KB | |
Aktuell eingestellter Wert für Datenkonsistenz | var(*LIST).CACHE-CURR.VOLATILITY | S | *NO | |
Definierte Caching-Einstellung | var(*LIST).CACHE-DEFI.CACH-FILE | S | *ALL | |
Definierter FORCE-OUT-Wert | var(*LIST).CACHE-DEFI.FORCE-OUT | S | *AT-HIGH-FILL | |
Ohne Bedeutung (Anzeige nur aus Kompatibilitätsgründen) | var(*LIST).CACHE-DEFI.GS-UNIT | S | *BY-DEFAULT | |
Ohne Bedeutung (Anzeige nur aus Kompatibilitätsgründen) | var(*LIST).CACHE-DEFI.GS-UNIT-NUM | I | 0 | |
Definiertes Cache-Medium | var(*LIST).CACHE-DEFI.MED | S | *MAIN-MEM | |
Ohne Bedeutung (Anzeige nur aus Kompatibilitätsgründen) | var(*LIST).CACHE-DEFI.PREFETCH | S | *HIGH | |
Definierte Segment-Größe des Cache-Mediums(0 für SM-Pubset) | var(*LIST).CACHE-DEFI.SEG-SIZE | I | 0 | |
Definierte Cache-Größe (0 für SM-Pubset) | var(*LIST).CACHE-DEFI.SIZE | I | <integer 1..32767> | |
Definierte Dimension der Cache-Größe | var(*LIST).CACHE-DEFI.SIZE-DIM | S | *KB | |
Definierte Gewährleistung von Datenkonsistenz | var(*LIST).CACHE-DEFI.VOLATILITY | S | *NO | |
Gerätetyp der Systemplatte des Control-Volume-Sets; | var(*LIST).CONTR-DEV-TYPE | S | *NO | |
Kennung des Control-Volume-Sets; | var(*LIST).CONTR-VOLSET | S | *NO | |
HSMS-Unterstützung des Pubsets | var(*LIST).HSMS-SUP | S | *NO | |
Kennung des Pubsets | var(*LIST).PUBSET-ID | S | <cat-id> | |
Pubset-Typ | var(*LIST).PUBSET-TYPE | S | *SINGLE-FEATURE | |
Verfügbarkeit des Pubsets | var(*LIST).STA | S | *ACCESSIBLE | |
Aktuell eingestellter | var(*LIST).VOLSET(*LIST).CACHE-CURR.FORCE-OUT | S | *AT-HIGH-FILL | 1 |
Ohne Bedeutung(Anzeige nur aus Kompatibilitätsgründen) | var(*LIST).VOLSET(*LIST).CACHE-CURR.GS-UNIT | S | *DUAL | 1 |
Ohne Bedeutung (Anzeige nur aus Kompatibilitätsgründen) | var(*LIST).VOLSET(*LIST).CACHE-CURR.GS-UNIT-NUM | I | 0 | 1 |
Aktuelles Cache-Medium | var(*LIST).VOLSET(*LIST).CACHE-CURR.MED | S | *MAIN-MEM | 1 |
Aktueller Status des Cache-Mediums | var(*LIST).VOLSET(*LIST).CACHE-CURR.MED-STAT | S | *ACTIVE | 1 |
Aktuell eingestelltes Prefetching | var(*LIST).VOLSET(*LIST).CACHE-CURR.PREFETCH | S | *HIGH | 1 |
Aktuelle Segment-Größe des Cache-Mediums | var(*LIST).VOLSET(*LIST).CACHE-CURR.SEG-SIZE | I | 0 | 1 |
Aktuelle Cache-Größe | var(*LIST).VOLSET(*LIST).CACHE-CURR.SIZE | I | 0 | 1 |
Aktuelle Dimension der Cache-Größe | var(*LIST).VOLSET(*LIST).CACHE-CURR.SIZE-DIM | S | *KB | 1 |
Aktuell eingestellter Wert für Datenkonsistenz | var(*LIST).VOLSET(*LIST).CACHE-CURR.VOLATILITY | S | *NO | 1 |
Definierte Cache-Einstellung | var(*LIST).VOLSET(*LIST).CACHE-DEFI.CACH-FILE | S | *ALL | 1 |
Definierter FORCE-OUT-Wert | var(*LIST).VOLSET(*LIST).CACHE-DEFI.FORCE-OUT | S | *AT-HIGH-FILL | 1 |
Ohne Bedeutung (Anzeige nur aus Kompatibilitätsgründen) | var(*LIST).VOLSET(*LIST).CACHE-DEFI.GS-UNIT | S | *BY-DEFAULT | 1 |
Ohne Bedeutung (Anzeige nur aus Kompatibilitätsgründen) | var(*LIST).VOLSET(*LIST).CACHE-DEFI.GS-UNIT-NUM | I | 0 | 1 |
Definiertes Cache-Medium | var(*LIST).VOLSET(*LIST).CACHE-DEFI.MED | S | *MAIN-MEM | 1 |
Definierte Prefetch-Einstellung | var(*LIST).VOLSET(*LIST).CACHE-DEFI.PREFETCH | S | *HIGH | 1 |
Definierte Segment-Größe des Cache-Mediums | var(*LIST).VOLSET(*LIST).CACHE-DEFI.SEG-SIZE | I | 0 | 1 |
Definierte Cache-Größe | var(*LIST).VOLSET(*LIST).CACHE-DEFI.SIZE | I | <integer 1..32767> | 1 |
Definierte Dimension der Cache-Größe | var(*LIST).VOLSET(*LIST).CACHE-DEFI.SIZE-DIM | S | *KB | 1 |
Definierte Gewährleistung von Datenkonsistenz | var(*LIST).VOLSET(*LIST).CACHE-DEFI.VOLATILITY | S | *NO | 1 |
Gerätetyp der Systemplatte des Volume-Sets | var(*LIST).VOLSET(*LIST).DEV-TYPE | S | *UNKNOWN | 1 |
Status des Volume-Sets | var(*LIST).VOLSET(*LIST).STA | S | *DEFECT | 1 |
Kennung des Volume-Sets | var(*LIST).VOLSET(*LIST).VOLSET | S | <vsid> | 1 |