ZIIP |
Dieses Systemkommando gilt nur in z/OS Batch- oder TSO-Umgebungen, welche die Verwendung des IBM System z Integrated Information Processor (zIIP) unterstützen. Falls das Kommando in einer anderen Umgebung und/oder in einer Umgebung ohne zIIP-Unterstützung abgesetzt wird, erfolgt eine entsprechende Fehlermeldung.
Das Systemkommando ZIIP
liefert Status- und
Verarbeitungsinformationen zu den in Ihrer Umgebung verwendeten zIIPs und zu
der für die zIIP-Unterstützung erforderlichen Lizenzdatei. Darüber hinaus
können Sie mit diesem Kommando statistische Informationen zu den Komponenten
abrufen, die ein Umschalten auf den General Central Processor (GCP)
verursachen, und Sie können die Zählung der Komponentenumschaltvorgänge
verwalten.
Informationen zur zIIP-Unterstützung und Überwachung erhalten Sie in der Natural für zIIP-Dokumentation.
Anmerkung:
Die Benutzung der Funktionen des Systemkommandos
ZIIP
kann in Natural Security benutzerspezifisch
eingeschränkt werden. Ausführliche Informationen siehe
ZIIP
Utility Profiles in der Natural
Security-Dokumentation.
Dieses Dokument behandelt folgende Themen:
PRINT |
|
|||||||||||||
|
|
|
||||||||||||
STAT |
|
|||||||||||||
LIC |
|
|||||||||||||
RESET |
|
Subfunktion | Option | Erklärung |
---|---|---|
PRINT *
|
INFO |
Zeigt den Bericht Informationen zur zIIP-Verarbeitung an. |
ROLL |
Zeigt den Bericht Roll Server-zIIP-Informationen an. | |
STAT |
Zeigt den Bericht
zIIP-Komponenten-Umschaltstatistik
an, wenn die Zählung der Komponenten-Umschaltvorgänge eingeschaltet worden ist
(siehe STAT weiter
unten).
Bezüglich der Festlegung der Sortierreihenfolge siehe auch Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik. |
|
ALL
|
Zeigt zuerst den Bericht
Informationen zur
zIIP-Verarbeitung an, danach den Bericht
Roll
Server-zIIP-Informationen und anschließend den Bericht
zIIP-Komponenten-Umschaltstatistik
(falls aktiviert).
Dies ist die Standardeinstellung. Bezüglich der Festlegung der Sortierreihenfolge siehe Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik. |
|
STAT *
|
ON |
Aktiviert die Zählung der Komponenten-Umschaltvorgänge. |
OFF |
Deaktiviert die Zählung der Komponenten-Umschaltvorgänge. | |
CLR |
Löscht die Tabelle mit den Komponenten-Umschaltvorgängen. | |
LIC |
ANIS |
Bewirkt die linksbündige Anzeige der zIIP-Lizenzdatei im XML-Format. |
XML |
Bewirkt die Anzeige der zIIP-Lizenzdatei im XML-Format. | |
FORMATTED
|
Bewirkt die Anzeige der zIIP-Lizenzdatei
im freien Format ohne Klammern.
Dies ist die Standardeinstellung. |
|
RESET |
ALL |
Bewirkt das Zurücksetzen aller Zähler. |
SRB |
Bewirkt das Zurücksetzen des SRB-Start-Zählers. | |
STAT |
Bewirkt das Zurücksetzen der
Komponenten-Umschalttabelle (gleichbedeutend mit STAT
CLR ).
|
|
SWITCH |
Bewirkt das Zurücksetzen des SRB-Umschalt-Zählers. | |
TIMES |
Bewirkt das Zurücksetzen aller CPU-Zeitwerte. |
* Alternativ können Sie die Schlüsselwortsubparameter
STAT
und PRINT
des Profilparameters
ZIIP
bzw. des Makros NTZIIP
setzen. Siehe
Schlüsselwort-Subparameter
im Abschnitt ZIIP - zIIP-Verarbeitung (nur z/OS) in der
Parameter-Referenz-Dokumentation.
Schlüsselwort | Sortierreihenfolge |
---|---|
SORTDESC |
Der Bericht wird aufsteigend nach Komponentenbeschreibungen sortiert. |
SORTNAME |
Der Bericht wird aufsteigend nach Komponentennamen sortiert. |
SORTSWITCHES
|
Der Bericht wird absteigend nach
TCB-Umschaltungen (TCB = Task Control Block) sortiert.
Dies ist die Standardeinstellung. |
Dieser Abschnitt beschreibt die vom Systemkommando
ZIIP
zur Verfügung gestellten Berichte und
Statistikdaten.
Der Bericht zIIP Processing Information sieht folgendermaßen aus (Beispiel):
+---------------- zIIP Processing Information ---------------+ | | | Advanced zIIP Support Enabled | | | | General central processors (GPs) 6 | | Integrated Information Processors (zIIPs) 1 | | zIIP SMT threads 2 | | zIIP normalization factor 10.98 | | | | Switches into TCB mode 1590303 | | SRB starts 80 | | | | Total enclave CPU time 01:00:56.411 (100.00%) | | Enclave GP time 00:12:38.305 (20.74%) | | Enclave zIIP time 00:48:18.106 (79.26%) | | | | Eligible zIIP CPU time 00:48:22.619 (100.00%) | | Enclave zIIP time 00:48:18.106 (99.84%) | | Eligible zIIP time on GP 00:00:04.513 (0.16%) | | | | (zIIP times normalized) | | | | | +------------------------------------------------------------+ |
Wenn der z/OS-System-Parameter
PROJECTCPU=YES
gesetzt ist und für die aktuelle logische
Partition keine zIIPs konfiguriert sind, sieht der Bericht folgendermaßen aus
(Beispiel):
+--------------- zIIP Processing Information ---------------+ ! ! ! Advanced zIIP Support Enabled (PROJECTCPU) ! ! ! ! General central processors (GPs) 2 ! ! Integrated Information Processors (zIIPs) 0 ! ! ! ! zIIP normalization factor 0.00 ! ! ! ! Switches into TCB mode 938 ! ! SRB starts 6 ! ! ! ! Total enclave CPU time 00:00:06.091 (100.00%) ! ! Enclave TCB time 00:00:04.640 (76.19%) ! ! Enclave SRB time (*) 00:00:01.452 (23.81%) ! ! ! ! (*) possible zIIP offload ! ! ! ! ! ! ! +-----------------------------------------------------------+ |
Der Bericht enthält folgende Status- und Verarbeitungsinformationen:
Eintrag | Bedeutung | Erklärung |
---|---|---|
Advanced zIIP Support Enabled | Erweiterte zIIP-Unterstützung eingeschaltet | Zeigt an, dass die aktuelle Natural-Session mit voller zIIP-Unterstützung läuft. |
General central processors (GPs) | Generelle Zentralprozessoren | Die Anzahl der verfügbaren GPs, die unter Ihrem z/OS-System laufen. |
Integrated Information Processors (zIIPs) | Integrierte Informationsprozessoren (zIIPs) | Die Anzahl der zIIPs, die unter Ihrem z/OS-System laufen. |
zIIP SMT threads | zIIP Simultaneous Multi-Threading Threads | Die Anzahl der logischen zIIPs, die bei aktivem SMT unter Ihrem z/OS-System laufen. |
zIIP normalization factor | zIIP-Normalisierungsfaktor | Der zIIP-Normalisierungsfaktor gibt das
Verhältnis der zIIP-Geschwindigkeit zur GP-Geschwindigkeit an.
Dieser Faktor gibt an, wie schnell Ihr zIIP im Vergleich zu einem gedrosselten GP mit reduzierter Leistung läuft. In dem obigen Beispiel bedeutet der Wert10.98 , dass der zIIP circa elfmal schneller ist als ein GP.
|
Switches into TCB mode | Umschaltungen in den TCB-Modus | Anzahl der Umschaltungen vom SRB-Modus (SRB = Service Request Block) in den TCB-Verarbeitungsmodus (TCB = Task Control Block) aufgrund von Systemdienstaufrufen, die abgesetzt werden mussten. Die entsprechenden Umschaltungen zurück in den SRB-Modus werden nicht mitgezählt. |
SRB starts | Service Request Block Starts | Gibt an, wie oft ein SRB-Vorgang
gestartet wurde.
Der Zähler wird um 1 erhöht für den ersten SRB bei jedem Session-Start und für den SRB-Neustart nach einer abnormalen Beendigung im SRB-Modus. |
Total enclave CPU time | CPU-Gesamtzeit der Enklave | Die von der aktuellen Natural-WLM-Enklave verbrauchte CPU-Gesamtzeit (GCP plus zIIP). |
Enclave GP time | GP-Gesamtzeit der WLM-Enklave | Die innerhalb der aktuellen Natural-WLM-Enklave verbrauchte GP-Gesamtzeit. |
Enclave zIIP time | zIIP-Gesamtzeit der WLM-Enklave | Die innerhalb der aktuellen Natural-WLM-Enklave verbrauchte zIIP-Gesamtzeit. |
Eligible zIIP CPU time | In Frage kommende zIIP-CPU-Zeit | Die CPU-Gesamtzeit, die für einen zIIP in Frage kommt. |
Eligible zIIP time on GP | In Frage kommende zIIP-CPU-Zeit beim GCP | Die CPU-Zeit innerhalb der
Natural-WLM-Enklave, die für einen zIIP in Frage kommt, aber von ihm nicht
genutzt wird.
Wenn der Wert nicht Null ist, bedeutet dies, dass für den zIIP-Gebrauch in Frage kommende Arbeitslast nicht abgegeben werden konnte, weil kein zIIP zur Verfügung stand. |
Ausführliche Informationen zu den Statistikangaben siehe Natural zIIP Processing: TCBs, SRBs and Enclaves und Calculating the CPU Time in der Natural for zIIP-Dokumentation.
Hinweise, wie Sie die zIIP-Nutzung verbessern können, finden Sie im Abschnitt Tuning zIIP Usage in der Natural for zIIP-Dokumentation.
Taste | Funktion |
---|---|
ENTER oder PF5 | Aktualisieren der Berichtdaten. |
PF7 | Umschalten auf die Anzeige der
zIIP-Komponenten-Umschaltstatistik.
(Gilt nur bei |
PF8 | Umschalten auf die Anzeige der
Roll
Server-zIIP-Informationen.
(Gilt nur bei |
Der Bericht Roll Server zIIP Information sieht folgendermaßen aus (Beispiel):
+------------- Roll Server zIIP Information -------------+ ! ! ! Roll Server zIIP CPU Time Usage in Subsystem QA82 ! ! Job Name QAROLL82 ! ! ! ! Total WLM enclave CPU time .... 387524 ! ! Qualified zIIP CPU time ....... 387252 ! ! Eligible zIIP CPU time on GCP 133 ! ! Total WLM enclave zIIP CPU time 387119 ! ! Total WLM enclave zIIP CPU time (%) 99.89 ! ! ! ! (All times in milliseconds; zIIP times normalized.) ! ! ! +--------------------------------------------------------+ |
Der Bericht enthält folgende Status- und Verarbeitungsinformationen:
Eintrag | Bedeutung | Erklärung |
---|---|---|
Total WLM enclave CPU time | CPU-Gesamtzeit der WLM-Enklave | Die von der aktuellen WLM-Enklave verbrauchte CPU-Gesamtzeit (GCP plus zIIP). |
Qualified zIIP CPU time | Qualifizierte zIIP-CPU-Zeit | Die für den zIIP-Gebrauch bei SRB qualifizierte CPU-Zeit, welche die Summe der in Frage kommenden plus der gesamten zIIP-CPU-Zeit ist. |
Eligible zIIP CPU time on GCP | In Frage kommende zIIP-CPU-Zeit beim GCP | Die CPU-Zeit beim GCP, die für einen
zIIP in Frage kommt, aber von ihm nicht genutzt wird.
Wenn der Wert nicht Null ist, bedeutet dies, dass für den zIIP-Gebrauch in Frage kommende Arbeitslast nicht abgegeben werden konnte, weil kein zIIP zur Verfügung stand. |
Total WLM enclave zIIP CPU time | zIIP-CPU-Gesamtzeit der WLM-Enklave | Die von der aktuellen WLM-Enklave verbrauchte zIIP-CPU-Gesamtzeit. |
Total WLM enclave zIIP CPU time (%) | zIIP-CPU-Gesamtzeit der WLM-Enklave (%) | Die von der aktuellen WLM-Enklave prozentual verbrauchte zIIP-CPU-Gesamtzeit. Im obigen Beispiel konnte Natural 99.89 % der CPU-Gesamtlast an einen zIIP abgeben. |
Der Statistikbericht zIIP Component Switch Statistics enthält die Auflistung aller TCB-Umschaltungen, die nicht den Wert Null haben, sowie der Komponenten, die diese Umschaltungen verursachen, wie in der folgenden Beispielmaske dargestellt:
+----------------- zIIP Component Switch Statistics -----------------+ | | | Component Description TCB Switches | | ------------------------------------------------------------------ | | CMDBAS Call Adabas 72 | | CMGETMP Acquire working storage 14 | | CMGTIMER Set CPU time limit 10 | | CMFREMP Release working storage 3 | | CMWTERM Primary I/O 3 | | ZPINIT Initialization of zIIP support 1 | | CMWTL Write message to system log 1 | | CMDLET Release external module 1 | | ------------------------------------------------------------------ | | Total 105 | | | | | | | | | | | | | | | | | | | | | | | | | | | +--------------------------------------------------------------------+ |
Komponenten sind Service-Routinen des Natural Nucleus,
Natural-Add-on-Produkte oder sonstige Software AG-Produkte (z.B. Adabas), die
zum Beispiel bei der Ausführung von Adabas-Aufrufen oder bei externen
CALLNAT
-Anforderungen TCB-Umschaltungen verursachen. Der Bericht
enthält den Namen, die Beschreibung und die jeweilige Anzahl der
TCB-Umschaltungen der einzelnen Komponenten sowie die Anzahl der
TCB-Umschaltungen, die von den Komponenten insgesamt verursacht wurden.
- PF-Tasten zur Online-Anzeige von zIIP-Komponenten-Statistikinformationen
ENTER oder PF5 Aktualisiert die Statistikdaten. PF7 Umschalten auf den Bericht zIIP Processing Information, siehe Informationen zur zIIP-Verarbeitung PF10 Umschalten zwischen den beiden Anzeigen, die bei SORTDESC
undSORTNAME
in Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik beschrieben sind.PF11 Umschalten zwischen den beiden Anzeigen, die bei SORTDESC
undSORTSWITCHES
in Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik beschrieben sind.
Im Online-Modus können Sie das Menü des Systemkommandos
ZIIP
benutzen, um Einstellungen für die Ausgabe des
Berichts entsprechend Ihren Erfordernissen vorzunehmen.
Um das ZIIP-Menü anzuzeigen
Geben Sie bei einer beliebigen Kommndoeingabeaufforderung folgendes Kommando ein:
ZIIP MENU
Das Menü (Syntax-Element-Beschreibung
) erscheint. Hier können Sie die Unterfunktion und Option(en) auswählen. Beschreibung der Menüpunkte sieheZur Angabe der Standardeinstellungen für die
PRINT
-Optionen des Systemkommandos ZIIP
können Sie den User Exit ZIIPUX01
benutzen. Der Quellcode wird im
Subprogramm ZIIPUS01
in der Natural-System-Library
SYSLIB
, SYSLIBS
oder SYSTEM
zur
Verfügung gestellt. Einzelheiten hierzu siehe Subprogramm ZIIPUS01
in der System-Library SYSEXT
.
Sie können über die Anwendungsprogrammierschnittstelle
USR8204N
alle Funktionen des Systemkommandos
ZIIP
ausführen. Einzelheiten siehe Textobjekt
USR8204T
und das Programm USR8204P
in der
Natural-System-Library SYSEXT
.