ZIIP

ZIIP

../graphics/sbo2.gif

ziip-subfunction-and-option
MENU

../graphics/sbc2.gif

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 zIIP Enabler-Dokumentation.

Dieses Dokument behandelt folgende Themen:

Syntax der ziip-subfunction-and-option

../graphics/cbo12.gif

 PRINT

../graphics/sbo4.gif

 INFO    

../graphics/sbc4.gif

../graphics/cbc12.gif

../graphics/cbo2.gif

STAT
ALL

../graphics/cbc2.gif

../graphics/sbo3.gif

SORTDESC
SORTNAME
SORTSWITCHES

../graphics/sbc3.gif
STAT

../graphics/cbo3.gif

ON
OFF
CLR

../graphics/cbc3.gif

  
LIC

../graphics/cbo3.gif

ASIS
XML
FORMATTED

../graphics/cbc3.gif

  

Syntax-Element-Beschreibung

Subfunktion Option Erklärung
PRINT INFO Zeigt den Bericht Informationen zur zIIP-Verarbeitung an.
  STAT Zeigt den Bericht zIIP-Komponenten-Umschaltstatistik an, wenn die Zählung der Komponentenumschaltvorgä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, und danach den Bericht zIIP-Komponenten-Umschaltstatistik.

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 Komponentenumschaltvorgänge.
  OFF Deaktiviert die Zählung der Komponentenumschaltvorgänge.
  CLR Löscht die Tabelle mit den Komponentenumschaltvorgä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.

* 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.

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.
SORTSWITCHES Der Bericht wird absteigend nach TCB-Umschaltungen (TCB = Task Control Block) sortiert.

Dies ist die Standardeinstellung.

zIIP-Berichte

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

Informationen zur zIIP-Verarbeitung

Die folgende Maske zeigt ein Beispiel eines zIIP-Verarbeitungsberichts: 

+------------ zIIP Processing Information ------------+
|                                                     |
|           Advanced zIIP Support Enabled             |
|                                                     |
| Number of GCPs                                   3  |
| Number of zIIPs                                  1  |
| zIIP normalization factor                     3.48  |
|                                                     |
| Number of switches into TCB mode               105  |
| Number of SRB starts                             1  |
|                                                     |
| Total enclave CPU time                          24  |
| Qualified zIIP CPU time                         12  |
| Eligible zIIP CPU time on GCP                    0  |
| Total enclave zIIP CPU time                     12  |
| Total enclave zIIP CPU time (%)              50.00  |
|                                                     |
| (All times in milliseconds; zIIP times normalized)  |
|                                                     |
+-----------------------------------------------------+

Der Bericht enthält folgende Status- und Verbeitungsinformationen:

Statistikpunkt Erklärung
Advanced zIIP Support Enabled Zeigt an, dass die aktuelle Natural-Session mit aktivierter zIIP-Unterstützung läuft.
Anzahl der GCPs Anzahl der in z/OS verfügbaren General Central Processors (GCPs), die unter Ihrem z/OS-System laufen.
Anzahl der zIIPs Anzahl der zIIPs, die unter Ihrem z/OS-System laufen.
zIIP-Normalisierungsfaktor Der zIIP-Normalisierungsfaktor gibt das Verhältnis der zIIP-Geschwindigkeit zur GCP-Geschwindigkeit an.

Dieser Faktor gibt an, wie schnell Ihr zIIP im Vergleich zu einem gedrosselten GCP 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 GCP.
Anzahl der Umschaltungen in den TCB-Modus Anzahl der Umschaltungen vom SRB-Modus (SRB = Service Request Block) in den TCB-Verarbeitungsmodus aufgrund von Systemdienstaufrufen, die abgesetzt werden mussten. Die entsprechenden Umschaltungen zurück in den SRB-Modus werden nicht mitgezählt.
Anzahl der SRB-Starts Gibt an, wie oft ein SRB-Vorgang gestartet wurde.
CPU-Gesamtzeit der Enklaven Die von der aktuellen WLM-Enklave verbrauchte CPU-Gesamtzeit (GCP plus zIIP).
Qualifizierte zIIP-CPU-Zeit Die für den zIIP-Gebrauch bei SRB qualifizierte CPU-Zeit, welche die Summe der in Frage kommenden und der gesamten zIIP-CPU-Zeit ist.
In Frage kommende zIIP-CPU-Zeit beim GCP Die CPU-Zeit beim GCP, die für den zIIP-Gebrauch 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.

zIIP-CPU-Gesamtzeit der Enklave Die von der aktuellen WLM-Enklave verbrauchte zIIP-CPU-Gesamtzeit.
zIIP-CPU-Gesamtzeit der Enklave (%) Die von der aktuellen WLM-Enklave prozentual verbrauchte zIIP-CPU-Gesamtzeit. Im obigen Beispiel konnte Natural 50 % der CPU-Gesamtlast an einen zIIP abgeben.

Ausführliche Informationen zu den Statistikangaben siehe Natural zIIP Processing: TCBs, SRBs and Enclaves und Calculating the CPU Time in der Natural zIIP Enabler-Dokumentation.

Hinweise, wie Sie die zIIP-Nutzung verbessern können, finden Sie im Abschnitt Tuning zIIP Usage in der Natural zIIP Enabler-Dokumentation.

PF-Tasten zur Online-Anzeige von zIIP-Verarbeitungsinformationen
ENTER oder PF5 Aktualisieren der Berichtdaten.
PF8 Umschalten auf die Anzeige der zIIP-Komponenten-Umschaltstatistik.

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 -----------------+
|                                                                    |
| 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 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 AnweisungslisteUm das ZIIP-Menü anzuzeigen

  • Geben Sie bei einer beliebigen Kommndoeingabeaufforderung folgendes Kommando ein: 

    ZIIP MENU

    Das Menü (Main Menu) erscheint. Hier können Sie die 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 SYSLIB, SYSLIBS oder SYSTEM zur Verfügung gestellt. 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.