Betriebssystem BS2000 OS DX V1.0B (de)

&pagelevel(3)&pagelevel

Informationen über ISAM-Cache-Bereiche in Data Spaces ausgeben

Komponente:	BS2000
Funktionsbereich:	System steuern und optimieren
Anwendungsbereich:	FILE
Privilegierung:	TSOS SW-MONITOR-ADMINISTRATION

Funktionsbeschreibung

Das Kommando SHOW-ISAM-CACHING informiert über die maximale Anzahl von Data Spaces für ISAM-Cache-Bereiche und deren Nutzung. Neben globalen Informationen können auch detaillierte Informationen über Data Spaces, ISAM-Pools und die darin gepufferten ISAM-Dateien angefordert werden.

Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").

Die maximale Anzahl der Data Spaces für ISAM-Cache-Bereiche kann mit dem Kommando dynamisch geändert werden.

Format

SHOW-ISAM-CACHING

Kurzname: SHISAMC

SELECT = *ALL
,INFORMATION = SUMMARY / ALL
,OUTPUT = SYSOUT / SYSLST(...)
	*SYSLST(...)
		\|	SYSLST-NUMBER = *STD / <integer 1..99>

Operandenbeschreibung

SELECT = *ALL
Es werden Informationen für alle Data Spaces, die für ISAM-Cache-Bereiche zur Verfügung stehen, ausgegeben.

INFORMATION = *SUMMARY / *ALL
Bestimmt den Umfang der auszugebenen Information.

INFORMATION = *SUMMARY
Es werden allgemeine Informationen zum ISAM-Caching und pro Data Space ein Informationsblock mit globalen Informationen ausgegeben.

INFORMATION = *ALL
Es werden allgemeine Informationen zum ISAM-Caching und pro Data Space zwei Informationsblöcke mit globalen und mit detaillierten Informationen ausgegeben.

OUTPUT = *SYSOUT / *SYSLST(...)
Gibt an, auf welches Ausgabemedium die Information ausgegeben werden soll. Voreingestellt ist die Ausgabe nach SYSOUT.

OUTPUT = *SYSOUT
Die Information wird nach SYSOUT ausgegeben.

OUTPUT = *SYSLST(...)
Die Information wird nach SYSLST ausgegeben.

SYSLST-NUMBER = *STD / <integer 1..99>
Nummer einer SYSLST-Datei aus der Menge SYSLST01 bis SYSLST99. Die Angabe *STD (Default-Wert) entspricht der Systemdatei SYSLST.

Kommando-Returncode

SC1	Maincode	Bedeutung / garantierte Meldungen
0	CMD0001	Kommando fehlerfrei ausgeführt
32	CMD2009	VAS/OPS meldet internen Fehler
32	DMS0A66	Interner Fehler bei Ausführung des Kommandos
64	CMD0216	Privileg für Kommando-Aufruf nicht vorhanden
130	OPS0001	Speichermangel bei Ausgabe in S-Variable

Ausgabeformat

Die Ausgabe beginnt mit einem allgemeinen Informationsblock:

Globale Informationen zum ISAM-Caching

Anschließend werden die folgenden zwei Informationsblöcke für jeden der aktuell genutzten Data Spaces ausgegeben:

Globale Informationen zu dem Data Space
Detaillierte Informationen zu dem Data Space (nur mit INFORMATION=*ALL)

Globale Informationen zum ISAM-Caching

Nach der Überschrift „ISAM CACHING INFORMATION (SUMMARY)“ werden folgende Informationen ausgegeben:

Ausgabefeld	Bedeutung
MAXIMUM NUMBER OF DATA SPACES	Maximale Anzahl von Data Spaces (1..127)
NUMBER OF DATA SPACES CURRENTLY IN USE	Aktuell genutzte Anzahl von Data Spaces (1..127)
TOTAL DATA SPACE AMOUNT	Summe des gesamten verfügbaren Speicherbereiches in MByte (Vielfache von 2048)
TOTAL USED SPACE	Summe des genutzten Speicherbereiches in MByte
TOTAL FREE SPACE	Summe des freien Speicherbereiches in MByte
TOTAL NUMBER OF ISAM POOLS	Anzahl der angelegten ISAM-Pools
TOTAL NUMBER OF ISAM FILES	Anzahl der gepufferten ISAM-Dateien
TOTAL NUMBER OF FREE AREAS	Anzahl der freier Speicherbereiche

Tabelle 117: Globale Informationen zum ISAM-Caching

Globale Informationen zu dem Data Space

Nach der Überschrift „DATA SPACE GLOBAL INFORMATION“ werden folgende Informationen ausgegeben:

Ausgabefeld	Bedeutung
DS#	Nummer des Data Spaces (1..127)
USED SPACE	genutzter Speicherplatz in MB
#ISAM POOLS	Anzahl der ISAM-Pools
#ISAM FILES	Anzahl der gepufferten Dateien
FREE SPACE	freier Speicherplatz in MB
#FREE AREAS	Anzahl freier Speicherbereiche

Tabelle 118: Globale Informationen zum ISAM-Caching in einem Data Space

Detaillierte Informationen zu dem Data Space

Nach der Überschrift „DETAILED INFORMATION FOR DATA SPACE“ informiert eine Tabelle über die Nutzung des Data Spaces. Die Tabelle enthält für jeden darin angelegten ISAM-Pool eine Ausgabezeile mit folgenden Informationen:

Informationsspalte

Bedeutung

SIZE

Größe des ISAM-Pools in MB

FILENAME

Pfadname einer im ISAM-Pool gepufferten Datei.
Wenn dem Pool ausnahmsweise mehrere Dateien zugeordnet sind (vgl. FILE-ASS=SAT), wird jeder weitere Pfadnamen in einer Folgezeile ausgegeben.

FILE-ASS

Art der Datei-Zuordnung

DEF: Die Zuordnung erfolgte durch die Standardverarbeitung des Systems bei der Dateieröffnung.
USER: Die Zuordnung erfolgte durch den Benutzer über Kommando (/CREATE-ISAM-POOL, /ADD-ISAM-POOL-LINK).
SAT: Zuordnung wie bei DEF, aber für die Datei konnte kein neuer Cache-Bereich bereitgestellt werden. Der ISAM-Cache-Bereich sollte vergrößert werden (/MODIFY-ISAM-CACHING).

Tabelle 119: Detaillierte Informationen zum ISAM-Caching in einem Data Space

Ausgabe in S-Variable

Der Operand INFORMATION des Kommandos legt fest, welche S-Variablen erzeugt werden. Folgende Angaben sind für INFORMATION möglich:

Schreibweise im Kommando	gekürzte Schreibweise in Tabelle
INFORMATION = *SUMMARY	INF=*SUM
INFORMATION = *ALL	INF=*ALL

Ausgabe-Information	Name der S-Variablen	T	Inhalt	Bedingung
Größe des ISAM-Pools in MByte	var(LIST).DATA-SPACE(LIST).POOL(*LIST).SIZE	S	<integer 1..32766>	nur INF=*ALL
Anzahl der im Data Space gepufferten Dateien	var(LIST).DATA-SPACE(LIST).FILE-NUM	S	<integer 1.. 2147483647>
Anzahl freier Speicherbereiche im Data Space	var(LIST).DATA-SPACE(LIST).FREE-AREA-NUM	S	<integer 1..2047>
Freier Speicherplatz im Data Space in MByte	var(LIST).DATA-SPACE(LIST).FREE-SPACE	S	<integer 1..2048>
Art der Datei-Zuordung	var(LIST).DATA-SPACE(LIST).POOL(LIST).FILE(LIST).FILE-ASS	S	DEF / USER / SAT	nur INF=*ALL
Name der Datei, die in dem ISAM-Pool gepuffert wird	var(LIST).DATA-SPACE(LIST).POOL(LIST).FILE(LIST).FILE-NAME	S	<filename>	nur INF=*ALL
Anzahl der Dateien, die in dem ISAM-Pool gepuffert werden	var(LIST).DATA-SPACE(LIST).POOL(*LIST).NUM-FILES-IN-POOL	S	<integer 1..32766>	nur INF=*ALL
Anzahl ISAM-Pools in dem Data Space	var(LIST).DATA-SPACE(LIST).POOL-NUM	S	<integer 1..2048>
Genutzter Speicherplatz im Data Space in MByte	var(LIST).DATA-SPACE(LIST).USED-SPACE	S	<integer 1..2048>
Maximale Anzahl Data Spaces	var(*LIST).DATA-SPACE-MAX-NUM	S	<integer 1..127>
Anzahl genutzer Data Spaces	var(*LIST).DATA-SPACE-USED-NUM	S	<integer 1..127>
Summe aller gepufferten Dateien	var(*LIST).TOTAL-FILE-NUM	S	<integer 1..2147483647>
Summer aller freien Speicherbereiche in MByte	var(*LIST).TOTAL-FREE-AREA-NUM	S	<integer 1..260095>
Summe des freien Speicherplatzes in MByte	var(*LIST).TOTAL-FREE-SPACE	S	<integer 1..260096>
Anzahl aller angelegten ISAM-Pools	var(*LIST).TOTAL-POOL-NUM	S	<integer 1..260096>
Insgesamt verfügbarer Speicherplatz in MByte	var(*LIST).TOTAL-SPACE	S	<integer 1..260096>
Summe des insgesamt genutzten Speicherplatzes in MByte	var(*LIST).TOTAL-USED-SPACE	S	<integer 1..260096>

Beispiele

/show-isam-caching inf=*all

---------------------------------------------------------------------------
------------------- ISAM CACHING INFORMATION  (SUMMARY) -------------------
---------------------------------------------------------------------------
 MAXIMUM NUMBER OF DATA SPACES            :      2
 NUMBER OF DATA SPACES CURRENTLY IN USE   :      1
 TOTAL DATA SPACE AMOUNT                 :   2048 MB
 TOTAL USED SPACE                        :      7 MB
 TOTAL FREE SPACE                        :   2041 MB
 TOTAL NUMBER OF ISAM POOLS              :      6
 TOTAL NUMBER OF ISAM FILES              :      8
 TOTAL NUMBER OF FREE AREAS              :      1
---------------------------------------------------------------------------
-------------------    DATA SPACE GLOBAL INFORMATION    -------------------
---------------------------------------------------------------------------
 DS# :  1     USED SPACE  :      7 MB        FREE SPACE   :   2041 MB
             #ISAM POOLS :      6           #FREE AREAS  :      1
              #ISAM FILES :      8
---------------------------------------------------------------------------
------------------  DETAILED INFORMATION FOR DATA SPACE  ------------------
---------------------------------------------------------------------------
    SIZE    FILENAME                                            FILE-ASS
---------------------------------------------------------------------------
     1 MB   :SBZ8:$TSOS.SYS.HEL.2012-06-15.183613                   DEF
---------------------------------------------------------------------------
     2 MB   :SBZ8:$SYSAUDIT.SYSLOG.ESS.SYSTEM                       USER
---------------------------------------------------------------------------
     1 MB   :SBZ8:$TSOS.SYSDAT.BCAM.APPLICATIONS.IS1                USER
           :SBZ8:$TSOS.SYSDAT.BCAM.ETC.HOSTS.IS1                   USER
           :SBZ8:$TSOS.SYSDAT.BCAM.PROCESSORS.IS1                  USER
---------------------------------------------------------------------------
     1 MB   :SBZ8:$SYSFJAM.SYSFSA                                   DEF
---------------------------------------------------------------------------
     1 MB   :SBZ8:$SYSSPOOL.PRFILE                                  DEF
---------------------------------------------------------------------------
     1 MB   :SBZ8:$SYSMAREN.TEST.MARENCAT                           DEF
---------------------------------------------------------------------------

Your Browser is not longer supported

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

SHOW-ISAM-CACHING