Sie können Eigenschaftendateien verwenden, um Eigenschaften des Trace-Service
und das zugehörige Traceprotokoll
unter einem Server zu erstellen oder
ändern.
Vorbereitende Schritte
Stellen Sie fest, welche Änderungen Sie an der Konfiguration des Trace-Service
oder an den zugehörigen Konfigurationsobjekten
vornehmen möchten.
Starten Sie das Scripting-Tool "wsadmin".
Zum Starten von
"wsadmin" in der Sprache Jython führen Sie im Verzeichnis bin
des Serverprofils den Befehl wsadmin -lang jython
aus.
Anmerkung: Dieser Artikel referenziert eine oder mehrere Protokolldateien des Anwendungsservers. Alternativ dazu wird empfohlen, den Server
so zu konfigurieren, dass er die HPEL-Protokoll- und -Traceinfrastruktur (High Performance Extensible Logging) verwendet und nicht die Dateien SystemOut.log , SystemErr.log,
trace.log und activity.log auf verteilten oder IBM® i-Systemen. Sie können HPEL auch in Verbindung
mit Ihren nativen z/OS-Protokolleinrichtungen verwenden. Wenn Sie HPEL verwenden, können Sie
mit dem Befehlszeilentool LogViewer im Verzeichnis "bin" des Serverprofils auf alle Ihre Protokoll- und Tracedaten zugreifen. Weitere Informationen zur Verwendung von
HPEL finden Sie in der Dokumentation zum Einsatz von HPEL für die Fehlerbehebung in Anwendungen.
Informationen zu diesem Vorgang
Mit einer Eigenschaftendatei können Sie ein Trace-Service-Objekt
und seine Konfigurationseigenschaften
erstellen, ändern oder löschen.
Führen Sie mit
"wsadmin" Verwaltungsbefehle aus, um eine Eigenschaftendatei für einen Trace-Service
zu ändern, die Eigenschaften auszuwerten und sie auf Ihre Konfiguration anzuwenden.
Tabelle 1. Aktionen für Eigenschaftendateien des Trace-Service. Sie können Eigenschaften des Trace-Service
erstellen, ändern und löschen.Aktion |
Prozedur |
create |
Nicht zutreffend |
modify |
Bearbeiten Sie Eigenschaften, und führen Sie dann den Befehl applyConfigProperties aus. |
delete |
Nicht zutreffend |
create Property |
Legen Sie Eigenschaften fest, und führen Sie dann den Befehl applyConfigProperties aus. |
delete Property |
Geben Sie die zu löschenden
Eigenschaften in der Eigenschaftendatei an,
und führen Sie dann den Befehl
deleteConfigProperties aus. |
Sie können wahlweise den Dialogmodus mit den Befehlen verwenden:
AdminTask.Befehlsname('-interactive')
Vorgehensweise
- Erstellen Sie Eigenschaften des Trace-Service.
- Geben Sie die Eigenschaften für den Trace-Service ("TraceService")
in einer Eigenschaftendatei an.
Öffnen Sie einen Editor und geben Sie die Eigenschaften des Trace-Service
und ein zugehöriges Traceprotokoll ("TraceLog") unter einem Server
in einer Eigenschaftendatei an.
Sie können die folgenden Beispieleigenschaften in einen Editor kopieren und die Eigenschaften entsprechend Ihrer Situation ändern.
Das Beispiel zeigt eine Eigenschaft unter
"TraceService" mit dem Namen
myName und dem Wert
myVal.
#
# Header
#
ResourceType=TraceService
ImplementingResourceType=GenericType
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:TraceService=
AttributeInfo=services
#
#
#Eigenschaften
#
startupTraceSpecification="*=info"
enable=true #boolean,default(false)
context=!{serverName}
memoryBufferSize=8 #integer,required,default(8)
traceFormat=BASIC #ENUM(LOG_ANALYZER|BASIC|ADVANCED),default(BASIC)
traceOutputType=SPECIFIED_FILE #ENUM(SPECIFIED_FILE|MEMORY_BUFFER),default(MEMORY_BUFFER)
#
# Header
#
ResourceType=TraceLog
ImplementingResourceType=GenericType
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:TraceService=:TraceLog=
AttributeInfo=traceLog
#
#
#Eigenschaften
#
maxNumberOfBackupFiles=5 #integer,default(1)
rolloverSize=20 #integer,default(100)
fileName="${SERVER_LOG_ROOT}/trace.log"
#
# Header
#
ResourceType=TraceService
ImplementingResourceType=GenericType
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:TraceService=
AttributeInfo=properties(name,value)
#
#
#Eigenschaften
myName=myVal
#
#
EnvironmentVariablesSection
#
#Umgebungsvariablen
cellName=WASCell06
serverName=myServer
nodeName=WASNode04
- Führen Sie den Befehl
applyConfigProperties aus, um eine TraceService-Konfiguration zu erstellen.
Der Befehl applyConfigProperties
wendet die Eigenschaftendatei auf die Konfiguration an.
In diesem Beispiel für
Jython erzeugt der optionale Parameter -reportFileName einen Bericht mit dem Namen
report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt '])
- Ändern Sie vorhandene Eigenschaften des Trace-Service oder des zugehörigen Traceprotokolls.
- Rufen Sie für den Trace-Service
eine Eigenschaftendatei ab, die
Sie ändern möchten.
Sie können mit dem Befehl extractConfigProperties
eine Eigenschaftendatei für eine TraceService-Konfiguration extrahieren.
- Öffnen Sie die Eigenschaftendatei in einem Editor, und ändern Sie die Eigenschaften in der gewünschten Weise.
Stellen Sie sicher, dass die Umgebungsvariablen in der Eigenschaftendatei mit den Umgebungsvariablen Ihres Systems übereinstimmen.
- Führen Sie den Befehl applyConfigProperties aus.
- Löschen Sie die Eigenschaften des Trace-Service.
Zum Löschen einer oder mehrere Eigenschaften
geben Sie nur die Eigenschaften in der Eigenschaftendatei an, die gelöscht werden sollen, und führen
Sie den Befehl
deleteConfigProperties aus.
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
Ergebnisse
Sie können die Eigenschaftendatei verwenden, um das Trace-Service-Objekt
zu konfigurieren und zu verwalten.
Nächste Schritte
Speichern Sie die Änderungen in Ihrer Konfiguration.