ZIIP

ZIIP

ziip-subfunction-and-option
MENU

Dieses Systemkommando gilt nur in z/OS Batch-, Batch-Server-, Com-plete-, CICS-, TSO- und IMS-Umgebungen, welche die Verwendung des IBM System z Integrated Information Processor (zIIP) unterstützen. Das bzw. die erforderlichen Natural for zIIP-Produkte müssen an Ihrem Standort installiert sein.

Falls das Kommando aus einer anderen Umgebung und/oder aus einer Umgebung ohne zIIP-Unterstützung abgesetzt wird und/oder falls das erforderliche zIIP-Produkt nicht installiert ist, erfolgen entsprechende Fehlermeldungen.

Das Systemkommando ZIIP liefert Status- und Verarbeitungsinformationen zu den in Ihrer Umgebung verwendeten zIIPs und zu der Lizenzdatei, die für das an Ihrem Standort installierte zIIP-Produkt erforderlich ist. Darüber hinaus können Sie mit diesem Kommando statistische Informationen zu den Natural-Komponenten abrufen, die ein Umschalten auf den General Central Processor (GCP) verursachen, und Sie können die Zählung der Komponenten-Umschaltvorgänge verwalten.

Weitere Informationen zur zIIP-Unterstützung und Überwachung erhalten Sie in der Natural for zIIP-Dokumentation.

Syntax der ziip-subfunction-and-option
Syntax-Element-Beschreibung
zIIP-Berichte
ZIIP-Kommando-Menü für Berichtausgabe-Optionen
User Exit für ZIIP PRINT-Kommando-Optionen
Anwendungsprogrammierschnittstelle (API) für ZIIP-Kommando-Funktionen

Dieses Dokument behandelt folgende Themen:

Syntax der `ziip-subfunction-and-option`

PRINT

INFO
ROLL

STAT
ALL

SORTDESC
SORTNAME
SORTPRODUCT
SORTSWITCHES

[PRODUCT product-range]
[PARAMETER {*|Y|N}]

STAT

ON
OFF
CLR

LIC

ASIS
XML
FORMATTED

Syntax-Element-Beschreibung

Subfunktion	Option	Erklärung
`PRINT`	`INFO`	Zeigt den Bericht Informationen zur zIIP-Verarbeitung an.
	`ROLL`	Zeigt den Bericht zIIP-Komponenten-Umschaltstatistik 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` (Standardeinstellung)	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). 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` (Standardeinstellung)	Bewirkt die Anzeige der zIIP-Lizenzdatei im freien Format ohne Klammern.

^* Alternativ können Sie die Schlüsselwort-Subparameter 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.

Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik

Schlüsselwort	Sortierreihenfolge
`SORTDESC`	Der Bericht wird aufsteigend nach Komponentenbeschreibungen sortiert.
`SORTNAME`	Der Bericht wird aufsteigend nach Komponentennamen sortiert.
`SORTPRODUCT`	Der Bericht wird aufsteigend nach Produktnamen sortiert.
`SORTSWITCHES` (Standardeinstellung)	Der Bericht wird absteigend nach TCB-Umschaltungen (TCB = Task Control Block) sortiert.

Auswahlkriterien für zIIP-Komponenten-Umschaltstatistik

Schlüsselwort	Erklärung
`PRODUCT`	Erzeugt eine Liste der Komponenten eines einzelnen Produkts oder eines Bereichs von Produkten wie mit `product-range` angegeben. Gültige Werte für `product-range`:
	`ppp`	Ein gültiger Produktschlüssel. Wählen Sie das Produkt aus, das dem aus drei Zeichen bestehenden Produktschlüssel `ppp` entspricht, so wie er in der Spalte Prd des zIIP-Komponenten-Umschaltstatistik-Berichts (zIIP Component Switch Statistics) angezeigt wird.
	`p` oder `pp`	Ein oder zwei voranstehende Zeichen. Auswahl aller Produkte, deren Produktschlüssel mit `p` oder `pp` beginnt.
	`ppp>`	Ein Startwert. Auswahl aller Produkte mit Produktschlüsseln größer als oder gleich `ppp`.
	`ppp<`	Ein Endwert. Auswahl aller Produkte mit Produktschlüsseln kleiner als oder gleich `ppp`.
`PARAMETER`	Angabe der aufzulistenden Komponenten. Gültige Werte:
	*	Auswahl aller Komponenten (Standardeinstellung).
	`Y`	Auswahl nur von Komponenten mit Kennzeichen `P`, was bedeutet, dass Komponenten-Umschaltungen mittels eines Parameters beeinflusst werden können.
	`N`	Auswahl nur von Komponenten (ohne Kennzeichen `P`), deren Komponenten-Umschaltungen nicht mittels eines Parameters beeinflusst werden können.

zIIP-Berichte

Dieser Abschnitt beschreibt die vom Systemkommando ZIIP zur Verfügung gestellten Berichte und Statistikdaten.

Informationen zur zIIP-Verarbeitung
Roll Server-zIIP-Informationen
zIIP-Komponenten-Umschaltstatistik

Informationen zur zIIP-Verarbeitung

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)                                   |
|                                                            |
|                                                            |
+------------------------------------------------------------+

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	Anzahl der in z/OS verfügbaren GPs, die unter Ihrem z/OS-System laufen.
Integrated Information Processors (zIIPs)	Integrierte Informationsprozessoren (zIIPs)	Anzahl der zIIPs, die unter Ihrem z/OS-System laufen.
zIIP SMT threads	zIIP SMT Threads	Anzahl der logischen zIIPs, die unter Ihrem z/OS-System laufen, wenn SMT (Simultaneous Multi-Threading) aktiv ist.
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 Wert `3.48`, dass der zIIP mehr als dreimal so schnell ist wie 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 Natural-WLM-Enklave verbrauchte CPU-Gesamtzeit (GP plus zIIP).
Enclave GP time	GP-Zeit der Enklave	Die innerhalb der Natural-WLM-Enklave verbrauchte GP-Gesamtzeit.
Enclave zIIP time	zIIP-Zeit der Enklave	Die innerhalb der Natural-WLM-Enklave verbrauchte zIIP-Gesamtzeit.
Eligible zIIP CPU time	In Frage kommende zIIP-CPU-Zeit	Die CPU-Zeit, die für einen zIIP in Frage kommt.
Eligible zIIP time on GP	In Frage kommende zIIP-CPU-Zeit beim GP	Die CPU-Zeit innerhalb der Natural-WLM-Enklave beim GP, 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.

PF-Tasten zur Online-Anzeige von zIIP-Verarbeitungsinformationen

Taste	Funktion
ENTER oder PF5	Aktualisieren der Berichtdaten.
PF7	Umschalten auf die Anzeige der zIIP-Komponenten-Umschaltstatistik. (Gilt nur bei `PRINT ALL`.)
PF8	Umschalten auf die Anzeige der Roll Server-zIIP-Informationen. (Gilt nur bei `PRINT ALL`.)

Roll Server-zIIP-Informationen

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.

zIIP-Komponenten-Umschaltstatistik

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 -------------------------+
!                                                                             !
! Prd Component Description                              TCB Switches   %   P !
! --------------------------------------------------------------------------- !
! NAT CMDBAS   Call Adabas ...............................     321587 37.43 P !
! NSB NSBCNXP  DB2 ConnecX access ........................     140356 16.33   !
! NVS NVSEXSH  VSAM I/O scheduler ........................     120904 14.07   !
! RPC RPC2ETB  RPC interface to EntireX Broker Stub ......     108488 12.62 P !
! NAT NATGWSTG Request handler for Natural Development Ser      94914 11.04 P !
! NAT CMPINIT  Session initialization exit ...............      58361  6.79   !
! ADA LNKDWA_Z TP dependent wait .........................      10947  1.27   !
! NAT CMWAIT   Wait for specified interval ...............       1234  0.14 P !
! COR COR00009 Program delete ............................        612  0.07   !
! NDB NDBWLI   DB2 IFI calls (DSNWLI) and RRSAF (DSNRLI) a        527  0.06 P !
! NAT CMFREMP  Release working storage ...................        373  0.04 P !
! COR COR00001 Lock contention ...........................        261  0.03   !
! NAT CMDLET   Release external module ...................        213  0.02 P !
! NAT ZPINIT   Initialization of zIIP support ............        193  0.02   !
! NAT CMABEND  Controlled abend routine ..................        133  0.01   !
! --------------------------------------------------------------------------- !
!     Total                                                    859103         !
!-----------------------------------------------------------------------------+

Komponenten sind Service-Routinen des Natural-Nukleus, der Natural-Add-on-Produkte oder sonstiger 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 Folgendes:

Produktschlüssel des Produkts (zum Beispiel NAT für das Produkt Natural), zu dem die Komponente gehört.
Name und Beschreibung der Komponente.
Anzahl der Umschaltungen pro Komponente.
Prozentualer Anteil der Komponentenumschaltungen.
Kennzeichen P, gesetzt bei Komponentenumschaltungen, die mittels eines Parameters beeinflusst werden können.
Gesamtzahl der Komponentenumschaltungen.

PF-Tasten im Bildschirm zur Anzeige der zIIP-Komponenten-Umschaltstatistik

Taste Funktion

ENTER oder PF5 Aktualisieren der Statistikdaten.

PF4 Aufruf eines Fensters zur Eingabe von Auswahlkriterien (Produktbereich und Komponentenumschaltungen, die mittels eines Parameters beeinflusst werden können) für den zIIP-Komponenten-Umschaltstatistik-Bericht zIIP Component Switch Statistics.

PF7 Um eine Seite rückwärts blättern (in einer langen Liste) oder Umschalten auf den Bericht zIIP Processing Information, siehe Informationen zur zIIP-Verarbeitung
(Gilt nur auf der ersten Seite einer Liste und wenn PRINT ALL benutzt wird.)

PF8 Um eine Seite vorwärts blättern (in einer langen Liste) oder Umschalten auf den Bericht zIIP Processing Information.
(Gilt nur auf der ersten Seite einer Liste und wenn PRINT ALL benutzt wird.)

PF9 Umschalten zwischen den beiden Anzeigen, die bei SORTPRODUCT und SORTSWITCHES in Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik beschrieben sind.

PF10 Umschalten zwischen den beiden Anzeigen, die bei SORTDESC und SORTNAME in Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik beschrieben sind.

PF11 Umschalten zwischen den beiden Anzeigen, die bei SORTDESC und SORTSWITCHES in Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik beschrieben sind.

Taste	Funktion
ENTER oder PF5	Aktualisieren der Statistikdaten.
PF4	Aufruf eines Fensters zur Eingabe von Auswahlkriterien (Produktbereich und Komponentenumschaltungen, die mittels eines Parameters beeinflusst werden können) für den zIIP-Komponenten-Umschaltstatistik-Bericht zIIP Component Switch Statistics.
PF7	Um eine Seite rückwärts blättern (in einer langen Liste) oder Umschalten auf den Bericht zIIP Processing Information, siehe Informationen zur zIIP-Verarbeitung (Gilt nur auf der ersten Seite einer Liste und wenn `PRINT ALL` benutzt wird.)
PF8	Um eine Seite vorwärts blättern (in einer langen Liste) oder Umschalten auf den Bericht zIIP Processing Information. (Gilt nur auf der ersten Seite einer Liste und wenn `PRINT ALL` benutzt wird.)
PF9	Umschalten zwischen den beiden Anzeigen, die bei `SORTPRODUCT` und `SORTSWITCHES` in Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik beschrieben sind.
PF10	Umschalten zwischen den beiden Anzeigen, die bei `SORTDESC` und `SORTNAME` in Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik beschrieben sind.
PF11	Umschalten zwischen den beiden Anzeigen, die bei `SORTDESC` und `SORTSWITCHES` in Sortieroptionen für die zIIP-Komponenten-Umschaltstatistik beschrieben sind.

ZIIP-Kommando-Menü für Berichtausgabe-Optionen

Im Online-Modus können Sie das Menü des Systemkommandos ZIIP benutzen, um Einstellungen für die Ausgabe des Berichts entsprechend Ihren Erfordernissen vorzunehmen.

Beginn der Anweisungsliste Um das ZIIP-Menü anzuzeigen

Geben Sie bei einer beliebigen Kommandoeingabeaufforderung folgendes Kommando ein:
```
ZIIP MENU
```
Das Menü (Main Menu) für das ZIIP-Kommando wird angezeigt. Hier können Sie die benötigte Unterfunktion und Option(en) auswählen. Beschreibung der Menüpunkte siehe Syntax-Element-Beschreibung

User Exit für ZIIP PRINT-Kommando-Optionen

Zur Angabe der Standardeinstellungen für die PRINT-Optionen des Systemkommandos ZIIP können Sie den User Exit ZIIPUX01 benutzen. Der Quellcode wird im Unterprogramm ZIIPUS01 in der Natural-System-Library SYSEXT zur Verfügung gestellt.

Kopieren Sie das katalogisierte Objekt von ZIIPUX01 in die Natural-System-Library SYSLIB, SYSLIBS oder SYSTEM. Einzelheiten hierzu siehe Unterprogramm ZIIPUS01 in der System-Library SYSEXT.

Anwendungsprogrammierschnittstelle (API) für ZIIP-Kommando-Funktionen

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.