Prüfung und Überwachung mit z/OS Connect

Sie können Anforderungen mit z/OS® Connect prüfen und überwachen. z/OS® Connect enthält einen Interceptor, der Daten im z/OS-SMF-Datenspeicher aufzeichnet.

Informationen zu diesem Vorgang

Sie können den Interceptor in z/OS Connect in einem einzigen z/OS Connect-Service oder in einer Gruppe von Services aktivieren. Der z/OS Connect-Prüfinterceptor zeichnet Anforderungsaktivitäten unter dem Betriebssytem z/OS im SMF-Datenspeicher auf. Es werden Datensätze mit SMF-Typ 120, Untertyp 11 generiert.

Die SMF-Daten im 120-11-Datensatz enthalten den Standardheader für SMF-Datensätze. Dann gibt es zwei Triplets. Das erste Triplet verweist auf den Abschnitt mit der Serveridentifikation, von dem es eine einzige Instanz gibt. Das zweite Triplet verweist auf den Abschnitt mit den Benutzerdaten, von dem es mehrere Instanzen geben kann.

Der Abschnitt mit den Serverdaten setzt sich aus den folgenden Parametern zusammen (Werte in Dezimalzahlen):
  • Offset Length Data
  • 0 4 Version (1)
  • 4 8 System name
  • 12 8 Sysplex name
  • 20 8 Job id(jsabjbid)
  • 28 8 Job name (jsabjbnm)
  • 36 8 SToken (assbstkn)
Die Benutzerdaten setzen sich aus den folgenden Parametern zusammen (Werte in Dezimalzahlen):
  • Offset Length Data
  • 0 4 Version (1)
  • 4 4 Type
  • 8 4 Length of data (Benutzerdatenabschnitte sind 2 K, dieses Feld gibt an, wieviel davon verwendet wird)
  • 12 ? Data
Die Benutzerdaten setzen sich aus den folgenden Parametern zusammen (Werte in Dezimalzahlen):

Für z/OS Connect ist der Benutzerdatentyp 102 (dezimal). Die Daten enthalten die folgenden Parameter:

  • Offset length Data
  • 0 4 Version (3)
  • 4 8 Arrival time (STCK-Format)
  • 12 8 Completion time (STCK-Format)
  • 20 64 Target URI (EBCDIC, rechts mit Leerzeichen aufgefüllt)
  • 84 4 Input payload (Länge in Byte)
  • 88 64 Service name (EBCDIC, rechts mit Leerzeichen aufgefüllt)
  • 152 8 Method (EBCDIC)
  • 160 4 Respond length (in Byte)
  • 164 64 User name (EBCDIC, rechts mit Leerzeichen aufgefüllt)
  • 228 23 Request id (Byte, rechts mit Nullen aufgefüllt)
  • 251 1 Boundary padding (Null)
  • 252 64 Service grouping name (EBCDIC, rechts mit Leerzeichen aufgefüllt)
  • 316 8 Mapped user name (EBCDIC, rechts mit Leerzeichen aufgefüllt) Nur gültig in Version 3 und höher.

Vorgehensweise

  1. Aktivieren Sie den von z/OS Connect bereitgestellten Prüfungsinterceptor für einen Service oder ein Servicepaket. Der von z/OS Connect bereitgestellte Prüfungsinterceptor implementiert die SPI com.ibm.wsspi.zos.connect.Interceptor, um Prüfungs- oder Verfolgungsinformationen in den z/OS System Management Facility (SMF)-Dateien zu speichern. Im folgenden Beispiel wird gezeigt, wie der Prüfungsinterceptor für einen einzelnen Service aktiviert wird:
    <!-- Konfiguration des Prüfungsinterceptors -->
    <auditInterceptor id="auditInterceptor" sequence="1"/> 
    
    <!-- Konfiguration der Interceptorliste -->
    <zosConnectInterceptors id="interceptorList1" interceptorRef="auditInterceptor"/> 
    
    <!-- z/OS Connect-Servicedefinitionen -->
    <zosConnectService id="zcs1" serviceName="recordOpsCreate" serviceRef="wolaOpsCreateService"        
    	interceptorsRef="interceptorList1"/>   
  2. Rufen Sie statistische Daten zeitnah ab. Diese Funktionalität ermöglicht es, Featurestartzeit, Gesamtzahl der Serviceanforderungen und Verteilung der Anforderungen abzurufen. Gültige authentifizierte Clients können HTTP GET für eine der folgenden URIs verwenden, um Statistikdaten zum z/OS Connect-Server abzurufen:
    • Statistikdaten für einen einzelnen Service abrufen:
      https://<Hostname:Port>/zosConnect/services/HelloWorld?action=getStatistics
    • Statistikdaten für alle Services im Server abrufen:
      https://<Hostname:Port>/zosConnect/operations/getStatistics
    • Statistikdaten für alle Services unter einem einzelnen Service-Provider mit dem Abfrageparameter provider="<Service-Provider-Name>" abrufen. Um beispielsweise die Statistikdaten für alle Services abzurufen, die dem Provider-Namen WOLA-1.0 zugeordnet sind, verwenden Sie folgende URL:
      https://<Hostname:Port>/zosConnect/operations/getStatistics?provider=WOLA-1.0" 
    • Die Antwortdaten werden im JSON-Objektformat zurückgegeben.


Symbol das den Typ des Artikels anzeigt. Taskartikel

Dateiname: twlp_zconnect_audit.html