Sie müssen CTRACE-Steuerelemente und -Ressourcen vorbereiten, bevor Sie sie für Tracedaten verwenden können.
Vorbereitende Schritte
Bevor Sie die Komponententraceaktivität (CTRACE-Aktivität) für Server mit WebSphere Application Server for z/OS
starten, müssen Sie Entscheidungen zu einigen Werten für CTRACE-Steuerelemente und -Ressourcen treffen sowie ein externes Ausgabeprogramm erstellen, wenn für die Tracedatenerfassung eines erforderlich ist.
Informationen zu diesem Vorgang
Führen Sie die folgenden Schritte aus, um CTRACE-Steuerelemente und -Ressourcen vorzubereiten:
Vorgehensweise
- Entscheiden Sie, ob CTRACE-Daten in Tracedateien (empfohlen) geschrieben oder ob die
CTRACE-Daten nur in Speicherpuffern gehalten werden sollen.
- Wenn Sie Tracedateien verwenden möchten, führen Sie die folgenden Schritte aus:
- Entscheiden Sie, ob eine Tracedatei für alle Aktivitäten von WebSphere Application Server auf einem einzelnen z/OS-System oder separate Tracedateien für jede Zelle oder jedes Release von WebSphere Application Server erstellt werden soll.
Tracedateien können nicht von verschiedenen z/OS-Systemen gemeinsam genutzt werden. Jedes System muss über eigene Tracedateien verfügen.
- Wählen Sie die Namen für die Tracedateien aus.
Schließen Sie den z/OS-Systemnamen in den Dateinamen ein, um die Konfiguration des externen Ausgabeprogramms zu vereinfachen.
Empfehlung: Verwenden Sie für eine einzelne Tracedatei für alle Aktivitäten von WebSphere Application Server einen Namen, der ungefähr wie folgt lautet: SYS1.Systemname.WAS390.CTRACE.
- Ordnen Sie auf jedem z/OS-System eine Tracedatei zu.
Bewährtes Verfahren: Verwenden Sie nicht
die DCB-Parameter RECFM, LRECL und BLKSIZE. Das externe Ausgabeprogramm
reserviert den Speicherplatz für die Dateien mit dem Satzformat VB und einer für das System optimalen Blockgröße und logischen Satzlänge. Für Tracedateien auf der Festplatte müssen sie mindestens 10 Zylinder (3390) verwenden. Sekundärbereiche werden ignoriert, sofern die Option NOWRAP beim Starten des externen Ausgabeprogramms nicht angegeben wird. Beispiel:
bprac
// EXEC PGM=IEFBR14
//TRACE DD DSN=SYS1.MVSS14.WAS390.CTRACE,UNIT=3390,VOL=SER=HPK19A,
// SPACE=(CYL,(20,0)),DISP=(NEW,CATLG),DCB=DSORG=PS
- Wählen Sie einen Jobnamen für das externe Ausgabeprogramm aus.
Empfehlung: Verwenden Sie BBOWTR, wenn für alle Aktivitäten von WebSphere Application
Server auf allen z/OS-Systemen dieselbe Tracedatei verwendet werden soll.
- Erstellen Sie eine katalogisierte Prozedur für das externe Ausgabeprogramm.
- Kopieren Sie das Member BBOWTR aus dem Produktverzeichnis von WebSphere Application
Server for z/OS, /util/zos/JCL/,
in SYS1.PROCLIB oder eine andere Prozedurenbibliothek, die für den Master-Scheduler definiert ist.
- Benennen Sie die Prozedur in den ausgewählten Jobnamen für das externe Ausgabeprogramm um.
- Passen Sie die katalogisierte Prozedur an, indem Sie den Namen der Tracedatei an den entsprechenden
Stellen angeben.
- Wenn die katalogisierte Prozedur von mehreren z/OS-Systemen gemeinsam genutzt wird, stellen Sie sicher, dass die Datendefinitionsanweisungen für Tracedateien auf die entsprechenden Tracedateien auf den einzelnen Systemen verweisen.
- Wählen Sie eine Systembenutzer-ID aus, unter der das externe Ausgabeprogramm ausgeführt wird.
Diese Benutzer-ID muss Schreib-/Lesezugriff auf die Tracedateien haben.
Sie können auch die Benutzer-ID einer vorhandenen gestarteten Task verwenden, z. B. die
Standardbenutzer-ID Ihres Systems für gestartete Tasks.
Verwenden Sie den folgenden RACF-Befehl oder einen äquivalenten Befehl, um zu erreichen, dass die katalogisierte Prozedur des externen Ausgabeprogramms unter der Benutzer-ID der gestarteten Task ausgeführt wird:
RDEFINE STARTED Prozedurname_des_externen_Ausgabeprogramms.* STDATA(USER(Systembenutzer-ID)) TRACE(YES)
Die gestartete Task für das externe Ausgabeprogramm sollte mit einer Zuteilungspriorität ausgeführt werden, die mindestens so hoch ist wie für die Adressräume von WebSphere Application Server, die sie für die Traceerstellung verwenden.
- Starten Sie das externe Ausgabeprogramm, um sicherzustellen, dass die vorangegangenen Schritte korrekt ausgeführt wurden.
Geben Sie den folgenden MVS-Konsolenbefehl ein:
TRACE CT,WTRSTART=Prozedurname_des_externen_Ausgabeprogramms
- Erstellen Sie ein CTRACE-parmlib-Member.
- Kopieren Sie das Member BBOCTI00 aus dem Produktverzeichnis von WebSphere Application
Server for z/OS, /util/zos/JCL/, in eine Datei in der PARMLIB-Verknüpfung Ihres Systems.
- Benennen Sie das parmlib-Member in CTIBBOxx um, wobei xx für ein zweistelliges
Suffix steht, das dem externen Ausgabeprogramm zugeordnet wird.
Dieser Wert wird während der Anpassung von WebSphere Application Server
for z/OS angegeben.
- Passen Sie das PARMLIB-Member CTIBBOxx an, um anzugeben, ob Tracedateien und ein externes Ausgabeprogramm verwendet werden sollen und, wenn dies der Fall ist, ob das externe Ausgabeprogramm automatisch gestartet wird, wenn WebSphere Application Server den Komponententrace (CTRACE) aktiviert.
- Wenn Sie für verschiedene Zellen oder Releases von WebSphere Application Server separate Tracedateien verwenden möchten, wiederholen Sie all diese Schritte aber wählen Sie jeweils einen neuen Namen für das externe Ausgabeprogramm und ein neues Suffix für das PARMLIB-Member aus.
Ergebnisse
Der Komponententrace (CTRACE) für WebSphere Application Server ist nun konfiguriert. Verwenden Sie das Suffix des PARMLIB-Members, um eine bestimmte Zelle von WebSphere Application Server for z/OS den CTRACE-Optionen zuzuordnen, die Sie ausgewählt haben.