Befehl "modify"

Sie können den Befehl modify über die MVS-Konsole absetzen, um Produktoperationen dynamisch zu ändern.

Sie können den Befehl modify verwenden, um den Status verschiedener Serverkomponenten und -aktivitäten anzuzeigen, wie z. B. für die folgenden Komponenten:
  • aktive Controller
  • Traceeinstellungen
  • Servants
  • Sitzungen
  • JVM-Heapspeicher (Java™ Virtual Machine)
  • Java-Trace

Verwenden Sie zur Eingabe des Befehls modify das folgende Format.

f <Server>, Parameter

Server: Steht für den Kurznamen des Servers, an den der Befehl modify abgesetzt wird. Dieser Parameter ist erforderlich.

Parameter

Die folgenden Parameter können für den Parameter modify angegeben werden:

DISABLEFAILOVER,'<JNDI-Name>'
Wird verwendet, um die Unterstützung des Ressourcenfailovers für die mit dem JNDI-Namen angegebene Ressource zu inaktivieren. Der angegebene JNDI-Name gibt die primäre Ressource an und muss in einfache Anführungszeichen eingeschlossen werden, um die Groß-/Kleinschreibung beizubehalten.
ENABLEFAILOVER,'<JNDI-Name>'
Wird verwendet, um die Unterstützung des Ressourcenfailovers für die mit dem JNDI-Namen angegebene Ressource zu aktivieren. Der angegebene JNDI-Name gibt die primäre Ressource an und muss in einfache Anführungszeichen eingeschlossen werden, um die Groß-/Kleinschreibung beizubehalten.
FAILOVER,'<JNDI-Name>'
Wird verwendet, um Anforderungen, die für die primäre Ressource bestimmt sind, manuell an die konfigurierte alternative Ressource weiterzuleiten. Der angegebene JNDI-Name gibt die primäre Ressource an und muss in einfache Anführungszeichen eingeschlossen werden, um die Groß-/Kleinschreibung beizubehalten. Damit Anforderungen zurück an die primäre Ressource übertragen werden, setzen Sie den Befehl modify mit dem Parameter FAILBACK,'<JNDI-Name>' ab.
FAILBACK,'<JNDI-Name>'
Wird verwendet, um Anforderungen manuell an die mit dem JNDI-Namen angegebene konfigurierte primäre Ressource weiterzuleiten. Der angegebene JNDI-Name gibt die primäre Ressource an und muss in einfache Anführungszeichen eingeschlossen werden, um die Groß-/Kleinschreibung beizubehalten. Dieser Befehl aktiviert automatisch die automatische Funktionsübernahme (Failover). Wenn die automatische Funktionsübernahme nach der Rückübertragung nicht gewünscht ist, setzen Sie den Befehl modify mit dem Parameter DISABLEFAILOVER,'<JNDI-Name>' ab.
Achtung: Bei der Eingabe des JNDI-Namen muss die Groß-/Kleinschreibung beachtet werden.
CANCEL
Wird verwendet, um den angegebenen Server abzubrechen.

Sie können die folgenden Optionen für den Parameter CANCEL angeben:

ARMRESTART
Gibt an, ob Sie mit ARM (Application Response Management) arbeiten und ARM für den Neustart des Servers verwenden möchten. Wenn Sie den Parameter CANCEL nicht mit der Option ARMRESTART angeben, führt ARM keinen Neustart des Servers durch.
HELP
Gibt an, dass Hilfeinformationen angezeigt werden sollen, die die Syntax von CANCEL beschreiben.
Fehler vermeiden Fehler vermeiden: Mit dem Parameter CANCEL können Sie in der MVS-Konsole keinen Cluster abbrechen. Stattdessen müssen Sie jeden einzelnen, zum Cluster gehörenden Server abbrechen. gotcha
DPM,[IIOP=nnn | HTTP=nnn | HTTPS=nnn | MDB=nnn | SIP=nnn | CRA=nnn | SIPS=nnn | OLA=nnn | INTERVAL=nnn | dump_action={SVCDUMP|JAVACORE|HEAPDUMP|TRACEBACK|JAVATDUMP|NONE|RESET} | clear_all | reset_all]

Der Platzhalter nnn gibt die Länge des Zeitintervalls in Sekunden für einen bestimmten Protokolltyp an. Der Wert für den Platzhalter nnn muss eine ganze Zahl zwischen 0 und 255 oder reset sein. Der Wert 0 bedeutet, dass das Protokoll kein Intervall hat und dass DPM für Anforderungen, die dieses Protokoll verwenden, inaktiviert ist. Der Wert reset bedeutet, dass die Steuerung des DPM-Intervalls an das Klassifikationsattribut "dpm_interval" in der Workload-Klassifikationsdatei zurückgegeben wird.

Der Befehl DPM INTERVAL modify überschreibt das Klassifikationsattribut "dpm_interval". Der Befehl DPM dump_action modify überschreibt das Klassifikationsattribut "dpm_dump_action" und die Eigenschaft auf Serverebene "server_region_dpm_dump_action".

Wird RESET für die Speicherauszugsaktion angegeben, wird die Speicherauszugsaktion für den Befehl modify inaktiviert. Die Einstellungen für das Klassifikationsattribut "dpm_dump_action" und die Eigenschaft auf Serverebene "server_region_dpm_dump_action" sind wieder wirksam.

Ein im Parameter INTERVAL angegebener Wert setzt das DPM-Intervall für alle sechs Protokolle auf denselben Wert.

Der Wert clear_all setzt die Zeitintervalle für alle zugehörigen Anforderungsprotokolle auf 0 und die Speicherauszugsaktion auf None.

Der Wert reset_all setzt alle DPM-Intervalle und den Parameter dump_action zurück. Die Steuerung der DPM-Intervalle und der Speicherauszugsaktion wird an die WLM-Klassifikationsdatei zurückgegeben.

HEAPDUMP
Wird verwendet, um einen JVM-Kernspeicherauszug für den Controller und für alle Servants zu generieren, die diesem Controller zugeordnet sind.
JAVACORE
Wird verwendet, um einen JVM-Kernspeicherauszug für den Controller und für alle Servants zu generieren, die diesem Controller zugeordnet sind.
JAVATDUMP
Wird verwendet, um einen von der JVM eingeleiteten TDUMP für alle Servant-Adressräume zu generieren. Sie können die native Umgebungsvariable JAVA_DUMP_TDUMP_PATTERN auch verwenden, um den Namen der TDUMP-Datei anzugeben.
JAVAOOM,[INTERVAL=nnn | ACTION=xxx | RESET]
Wird verwendet, um die Diagnoseaktion, die ausgeführt wird, wenn auf diesem Server eine abnormale Speicherbedingung in der JVM (Java Virtual Machine) auftritt, dynamisch zu ändern. Wird auch verwendet, um das Zeitintervall, in dem die Diagnoseaktion wiederholt wird, dynamisch zu ändern.

Bei Angabe von INTERVAL wird der Zeitraum in Sekunden angegeben, während der eine Diagnoseaktion nicht wiederholt wird. Dieses Attribut überschreibt den für die Umgebungsvariable ras_java_oom_interval angegebenen Wert.

Mit ACTION wird die Diagnoseaktion festgelegt, die ausgeführt wird, wenn auf diesem Server eine abnormale Speicherbedingung in der JVM auftritt. Dieses Attribut überschreibt den für die Umgebungsvariable ras_java_oom_action angegebenen Wert. Für xxx kann einer der folgenden Werte angegeben werden:

NONE
Es wird keine Diagnoseaktion ausgeführt.
WTO
Die Fehlernachricht BBOO0404E wird in die Hardcopy geschrieben.
SVCDUMP
Ein SVC-Speicherauszug (SVCDUMP) des betroffenen Adressraums mit dem Nebencode C9C2704B wird erzeugt.

Bei Angabe von RESET werden Diagnoseaktion und -intervall auf die für die Umgebungsvariablem ras_java_oom_action und ras_java_oom_interval angegebenen Werte zurückgesetzt.

MSGROUTE,{ERRORLOG|HARDCOPY|CONSOLE|COPYERRORLOG|COPYHARDCOPY|COPYCONSOLE|NONE}{[=xxx][,RESET][,CLEAR]}
Wird verwendet, um die Ausgabeposition von Nachrichten-IDs dynamisch zu ändern.

Der Platzhalter "xxx" ist eine durch Kommas begrenzte Liste mit Produktnachrichten-IDs, die der Anwendungsserver weiterleiten soll. Nachrichten können an mehrere Positionen weitergeleitet werden.

Wenn Sie den Befehl zum ersten Mal für eine Position und eine Nachrichtengruppe absetzen, ist die Nachrichtenliste für die betreffende Position die Nachrichtenliste des ersten Befehls. Wenn für die Umgebungsvariable der Position Nachrichten definiert wurden, werden diese Nachrichten an die Nachrichtenliste der Position angefügt. Wenn Sie den Befehl danach für dieselbe Position und eine andere Nachrichtengruppe absetzen, fügt der Anwendungsserver die Nachrichten des nachfolgenden Befehls an die vorhandene Nachrichtenliste an.

Bei Angabe von ERRORLOG werden die Nachrichten an das Fehlerprotokoll und nicht an die Standardposition weitergeleitet.

Bei Angabe von HARDCOPY werden die Nachrichten an das Systemprotokoll SYSLOG (wird auch als Hardcopy bezeichnet) und nicht an die Standardposition weitergeleitet.

Bei Angabe von CONSOLE werden die Nachrichten an die MVS-Bedienerkonsole und nicht an die Standardposition weitergeleitet.

Bei Angabe von COPYERRORLOG werden die Nachrichten in das Fehlerprotokoll und an die Standardposition kopiert.

Bei Angabe von COPYHARDCOPY werden die Nachrichten an das Systemprotokoll SYSLOG (wird auch als Hardcopy bezeichnet) und an die Standardposition kopiert.

Bei Angabe von COPYCONSOLE werden die Nachrichten in die MVS-Bedienerkonsole und an die Standardposition kopiert.

Bei Angabe von NONE wird die Weiterleitung der Nachrichten unterdrückt. Der Wert NONE hat Vorrang vor der Weiterleitung von Nachrichten an das Fehlerprotokoll, das Systemprotokoll oder die MVS-Bedienerkonsole.

Bei Angabe von RESET mit ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLE oder NONE kommen die Nachrichten, die weitergeleitet oder unterdrückt werden, aus der Datei was.env und nicht vom Befehl "MSGROUTE modify".
  • Bei Angabe von RESET mit ERRORLOG werden Nachrichten, die in der Umgebungsvariable "ras_message_routing_errorlog" angegeben sind, an das Fehlerprotokoll und nicht an die Standardposition weitergeleitet.
  • Bei Angabe von RESET mit HARDCOPY werden Nachrichten, die in der Umgebungsvariable "ras_message_routing_hardcopy" angegeben sind, an das Systemprotokoll SYSLOG und nicht an die Standardposition weitergeleitet.
  • Bei Angabe von RESET mit CONSOLE werden Nachrichten, die in der Umgebungsvariable "ras_message_routing_console" angegeben sind, an das MVS-Bedienerkonsole und nicht an die Standardposition weitergeleitet.
  • Bei Angabe von RESET mit COPYERRORLOG werden Nachrichten, die in der Umgebungsvariable "ras_message_routing_copy_errorlog" angegeben sind, in das Fehlerprotokoll und an die Standardposition kopiert.
  • Bei Angabe von RESET mit COPYHARDCOPY werden Nachrichten, die in der Umgebungsvariable "ras_message_routing_copy_hardcopy" angegeben sind, in das Systemprotokoll SYSLOG und an die Standardposition kopiert.
  • Bei Angabe von RESET mit COPYCONSOLE werden Nachrichten, die in der Umgebungsvariable "ras_message_routing_copy_console" angegeben sind, in die MVS-Bedienerkonsole und an die Standardposition kopiert.
  • Bei Angabe von RESET mit NONE wird die Weiterleitung von Nachrichten, die in der Umgebungsvariable "ras_message_routing_hardcopy" angegeben sind, unterdrückt.
Die Angabe von CLEAR mit ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLE oder NONE bedeutet, dass die Nachrichten an eine Standardposition weitergeleitet bzw. nicht weiter unterdrückt werden.
  • Die Angabe von CLEAR mit ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG, COPYHARDCOPY, COPYCONSOLE oder NONE bedeutet, dass die Nachrichten an eine Standardposition weitergeleitet und nicht weiter unterdrückt werden.
  • Bei Angabe von CLEAR mit ERRORLOG oder COPYERRORLOG werden die Nachrichten an die Standardposition und nicht an das Fehlerprotokoll weitergeleitet.
  • Bei Angabe von CLEAR mit HARDCOPY oder COPYERRORLOG werden die Nachrichten an die Standardposition und nicht an das Systemprotokoll SYSLOG weitergeleitet.
  • Bei Angabe von CLEAR mit CONSOLE oder COPYCONSOLE werden die Nachrichten an die Standardposition und nicht an die MVS-Bedienerkonsole weitergeleitet.
  • Bei Angabe von CLEAR mit NONE wird die Unterdrückung der Nachrichten aufgehoben.
RECLASSIFY[,FILE=['/Pfad/zur/Datei.xml']]
Wird verwendet, um das Workload-Klassifikationsdokument ohne Neustart des Servers dynamisch erneut zu laden. Die Einstellungen für die neu geladene Workload-Klassifikation werden sofort wirksam.

Bei Angabe von RECLASSIFY wird die erneute Klassifikation mit der Workload-Klassifikationsdatei, die in der Variable "wlm_classification_file" angegeben ist, durchgeführt.

Wenn Sie einen Dateinamen mit dem Parameter "reclassify", wie z. B. RECLASSIFY,FILE='/Pfad/zur/neuen_Datei.xml', angeben, wird die erneute Klassifikation mit der angegebenen Klassifikationsdatei durchgeführt. Der Wert für die Variable "wlm_classification_file" wird in die Datei, die über die Option FILE angegeben ist, geändert. Alle nachfolgenden Befehle vom Typ "reclassify modify", die die Variable "wlm_classification_file" verwenden, verwenden für das erneute Laden die neue, in der Variable angegebene Datei und nicht die ursprüngliche Datei.

Bei Angabe von RECLASSIFY,FILE= wird die Klassifikation inaktiviert. Die Variable "wlm_classification_file" wird auf "null" gesetzt. Alle nachfolgenden Befehle vom Typ "reclassify modify", die die Variable "wlm_classification_file" verwenden, haben keine Auswirkungen auf den Server, da die Variable "wlm_classification_file" keinen Wert hat.

Achtung: Wenn die neue Workload-Klassifikationsdatei nicht geladen werden kann, löscht der Anwendungsserver die erneut geladenen Klassifikationseinstellungen. Der Anwendungsserver wird weiter mit den Klassifikationseinstellungen ausgeführt, die gültig waren, bevor der Befehl vom Typ "reclassify modify" ausgeführt wurde.
Tipp: Wenn die Workload-Klassifikationsdatei fehlerfrei geladen wird, setzt der Anwendungsserver eine Nachricht wie die unten genannte an das Systemprotokoll SYSLOG ab. Die Nachricht wird auch in der Bedienerkonsole als Antwort auf den Anzeigebefehl DISPLAY,WORK,CLINFO angezeigt.
BBOJ0129I: The /tmp/wlm4.class.xml workload classification file 
was loaded at 2009/07/14 19:33:35.297 (GMT)
ROLL_LOGS
Wird verwendet, um die Weiterleitung von Servantausgabeprotokollen in das USS-Dateisystem erneut durchzuführen. Eine neue Gruppe von Ausgabeprotokolldateien wird dann unter demselben Ausgabeverzeichnis erstellt, und ältere Dateien werden beibehalten. Es werden Nachrichten am Ende vorheriger Protokolle und am Anfang neuer Protokolle geschrieben, wodurch eine logische Verbindung zwischen den Dateien entsteht.
STACKTRACE
Wird verwendet, um den Java-Stack-Traceback für alle Java-Threads im Server im Fehlerprotokoll aufzuzeichnen.
SMF,REQUEST,{ON|OFF|RESET}
Wird verwendet, um die Erstellung von SMF-Datensätzen vom Typ 120-9 zu steuern.

Der Befehl "SMF,REQUEST modify" überschreibt das Klassifikationsattribut "SMF_request_activity_enabled" und die Eigenschaft auf Serverebene "server_SMF_request_activity_enabled".

Wenn Sie ON angeben, wird die Erstellung von SMF-Datensätzen vom Typ 120-9 aktiviert.

Wenn Sie OFF angeben, wird die Erstellung von SMF-Datensätzen vom Typ 120-9 inaktiviert.

Bei Angabe von RESET wird die Einstellung des Befehls "modify" für die Erstellung von SMF-Datensätzen vom Typ 120-9 inaktiviert. Die Einstellungen für das Klassifikationsattribut "SMF_request_activity_enabled" und die Eigenschaft auf Serverebene "server_SMF_request_activity_enabled" zum Zeitpunkt der Zurücksetzung sind wirksam.

SMF,REQUEST,ASYNC,{ON|OFF|RESET}
Wird verwendet, um die Datenerfassung für den formatierten ASYNC-Abschnitt in SMF-Datensätzen des Typs 120-9 zu aktivieren, wenn solche Datensätze erstellt werden.

Der Befehl "SMF,REQUEST,ASYNC modify" überschreibt die Eigenschaft auf Serverebene "server_SMF_request_activity_async".

Wenn Sie ON angeben, wird die Datenerfassung aktiviert.

Wenn Sie OFF angeben, wird die Datenerfassung inaktiviert. Bei Angabe dieses Werts haben erstellte Datensätze Nullen in den Positionstriplets für diesen Abschnitt oben im Datensatz.

Bei Angabe von RESET wird die Einstellung des Befehls "modify" für die Datenerfassung inaktiviert. Die Einstellungen für die Eigenschaft auf Serverebene "server_SMF_request_activity_async" zum Zeitpunkt der Zurücksetzung sind wirksam.

SMF,REQUEST,CPU,{ON|OFF|RESET}
Wird bei der Datenerfassung für den Abschnitt für die Aufgliederung der CPU-Belastung in SMF-Datensätzen des Typs 120-9 zu aktivieren, wenn solche Datensätze erstellt werden.

Der Befehl "SMF,REQUEST,CPU modify" überschreibt das Klassifikationsattribut "SMF_request_activity_CPU_detail" und die Eigenschaft auf Serverebene "server_SMF_request_activity_CPU_detail".

Wenn Sie ON angeben, wird die Datenerfassung aktiviert.

Wenn Sie OFF angeben, wird die Datenerfassung inaktiviert. Bei Angabe dieses Werts haben erstellte Datensätze Nullen in den Positionstriplets für diesen Abschnitt oben im Datensatz.

Bei Angabe von RESET wird die Einstellung des Befehls "modify" für die Datenerfassung inaktiviert. Die Einstellungen für das Klassifikationsattribut "SMF_request_activity_CPU_detail" und die Eigenschaft auf Serverebene "server_SMF_request_activity_CPU_detail" zum Zeitpunkt der Zurücksetzung sind wirksam.

SMF,REQUEST,SECURITY,{ON|OFF|RESET}
Wird verwendet, um die Datenerfassung für den Abschnitt für die Sicherheitsdaten in SMF-Datensätzen des Typs 120-9 zu aktivieren, wenn solche Datensätze erstellt werden.

Der Befehl "SMF,REQUEST,SECURITY modify" überschreibt das Klassifikationsattribut "SMF_request_activity_security" und die Eigenschaft auf Serverebene "server_SMF_request_activity_security".

Wenn Sie ON angeben, wird die Datenerfassung aktiviert.

Wenn Sie OFF angeben, wird die Datenerfassung inaktiviert. Bei Angabe dieses Werts haben erstellte Datensätze Nullen in den Positionstriplets für diesen Abschnitt oben im Datensatz.

Bei Angabe von RESET wird die Einstellung des Befehls "modify" für die Datenerfassung inaktiviert. Die Einstellungen für das Klassifikationsattribut "SMF_request_activity_security" und die Eigenschaft auf Serverebene "server_SMF_request_activity_security" zum Zeitpunkt der Zurücksetzung sind wirksam.

SMF,REQUEST,TIMESTAMPS,{ON|OFF|RESET}
Wird verwendet, um die Datenerfassung für den Abschnitt für die formatierten Zeitmarken in SMF-Datensätzen des Typs 120-9 zu aktivieren, wenn solche Datensätze erstellt werden.

Der Befehl "SMF,REQUEST,TIMESTAMPS modify" überschreibt das Klassifikationsattribut "SMF_request_activity_timestamps" und die Eigenschaft auf Serverebene "server_SMF_request_activity_timestamps".

Wenn Sie ON angeben, wird die Datenerfassung aktiviert.

Wenn Sie OFF angeben, wird die Datenerfassung inaktiviert. Bei Angabe dieses Werts haben erstellte Datensätze Nullen in den Positionstriplets für diesen Abschnitt oben im Datensatz.

Bei Angabe von RESET wird die Einstellung des Befehls "modify" für die Datenerfassung inaktiviert. Die Einstellungen für das Klassifikationsattribut "SMF_request_activity_timestamps" und die Eigenschaft auf Serverebene "server_SMF_request_activity_timestamps" zum Zeitpunkt der Zurücksetzung sind wirksam.

SMF,OUTBOUND,ON
Wird verwendet, um die Erstellung von SMF-Datensätzen vom Typ SMF 120-10 zu aktivieren.
SMF,OUTBOUND,OFF
Wird verwendet, um die Erstellung von SMF-Datensätzen vom Typ SMF 120-10 zu inaktivieren.
SMF,OUTBOUND,RESET
Wird verwendet, um die Erstellung von Datensätzen vom Typ SMF 120-10 über den Wert zu steuern, der in der Umgebungsvariablen "server_SMF_outbound_enabled" angegebenen ist.
TIMEOUT_DELAY=n
Wird verwendet, um die Variable für die Zeitlimitverzögerung, "control_region_timeout_delay", dynamisch in n Sekunden zu ändern. Dieser modify-Befehl wird zusammen mit dem Befehl TIMEOUTDUMPACTION modify verwendet, um eine Zeitlimitverzögerung festzulegen, die die Ausführung der angegebenen Speicherauszugsaktion (z. B. JAVACORE) ermöglicht, wenn das zulässige Zeitlimit abläuft. Die im Befehl TIMEOUTDUMPACTION modify angegebenen Speicherauszugsaktionen erfordern eine Zeitlimitverzögerung, die dem Servant ermöglicht, die Speicherauszugsaktion auszuführen, bevor der Servant beendet wird.

Nach der Verarbeitung des angegebenen Speicherauszugs können Sie diesen Befehl erneut absetzen, um den Wert der Variablen "control_region_timeout_delay" auf die vorherige Einstellung zurückzusetzen, ohne den Server stoppen und erneut starten zu müssen.

TIMEOUTDUMPACTION=n
Zeigt an, welche der folgenden Aktionen ausgeführt wird, wenn ein Zeitlimit für Arbeitsvorgänge, die einem Servant zugeteilt sind, überschritten wird, falls die Eigenschaft "control_region_timeout_delay" auf einen Wert ungleich null gesetzt ist:
  • Wenn NONE oder none angegeben ist, wird kein Speicherauszug erstellt.
  • Ist JAVACORE oder javacore angegeben, wird ein Java-Kernspeicherauszug erstellt.
  • Ist SVCDUMP oder svcdump angegeben, wird ein SVC-Speicherauszug erstellt.
  • Ist JAVATDUMP oder javatdump angegeben, wird ein von der JVM eingeleiteter TDUMP erstellt.
    Anmerkung: Für die Eigenschaft "control_region_timeout_delay" muss eine Zeit konfiguriert werden, die ausreicht, damit der Servant den JAVATDUMP erstellen kann, bevor der Controller den Servant beendet. Mit dem Befehl TIMEOUT_DELAY modify kann der Wert der Eigenschaft "control_region_timeout_delay" dynamisch geändert werden.
TIMEOUTDUMPACTIONSESSION=n
Wird verwendet, um anzuzeigen, welche der folgenden Aktionen ausgeführt wird, wenn ein Zeitlimit für eine HTTP-, HTTPS-, SIP- oder SIPS-Anforderung, die einem Servant zugeteilt ist, überschritten wird und die entsprechende Eigenschaft für Wiederherstellung auf SESSION gesetzt ist:
  • Wenn NONE oder none angegeben ist, wird kein Speicherauszug erstellt.
  • Ist JAVACORE oder javacore angegeben, wird ein Java-Kernspeicherauszug erstellt.
  • Ist SVCDUMP oder svcdump angegeben, wird ein SVC-Speicherauszug erstellt.
  • Ist JAVATDUMP oder javatdump angegeben, wird ein von der JVM eingeleiteter TDUMP erstellt.
Es folgt eine Liste der entsprechenden Eigenschaften für die Wiederherstellung:
  • protocol_http_timeout_output_recovery
  • protocol_https_timeout_output_recovery
  • protocol_sip_timeout_output_recovery
  • protocol_sips_timeout_output_recovery
TRACEALL=n
Mit TRACEALL können Sie die allgemeine Tracestufe für den Server festlegen.
Die folgenden Tracestufen sind gültig. Im Normalfall sollten Sie den Wert 1 angeben.
  • 0: Es wird kein Trace erstellt.
  • 1: Bei Auftreten einer Ausnahmebedingung wird ein Trace erstellt.
  • 2: Es wird ein Trace auf der Basisstufe erstellt.
  • 3: Es wird ein detaillierter Trace für alle Komponenten erstellt.
Fehler vermeiden Fehler vermeiden: Die Verwendung der Stufe 3 sollte sorgfältig überlegt werden, da diese Stufe potenziell mehr Daten generiert, als für eine Prüfung praktisch ist. gotcha
TRACEBASIC=n
Wird zum Angeben der Produktkomponenten verwendet, für die Sie die Basisstufe des Trace aktivieren möchten.
Dieser Befehl kann für die angegebenen Komponenten eine abweichende Tracestufe, die mit TRACEALL angegeben wurde, überschreiben.
Fehler vermeiden Fehler vermeiden: Ändern Sie diese Variable nur, wenn Sie dazu vom IBM Support aufgefordert werden.gotcha

In der folgenden Tabelle sind die Werte aufgeführt, die Sie für diesen Parameter angeben können. Für TRACEBASIC oder TRACEDETAIL können Sie einen oder mehrere der folgenden Werte angeben:

Wert Produktkomponente
0 RAS
1 allgemeine Dienstprogramme
3 COMM
4 ORB
6 OTS
7 Shasta
9 z/OS-Wrapper
A Dämon
E Sicherheit
F Auslagerung
J (sollte nur unter Anleitung der IBM Unterstützungsfunktion verwendet werden) JRas
L Java EE
TRACEDETAIL=n
Wird zum Angeben der Produktkomponenten verwendet, für die Sie die Basisstufe des Trace aktivieren möchten.
Dieser Befehl aktiviert den ausführlichsten Traceumfang für die angegebenen Produktkomponenten und überschreibt mit TRACEALL abweichende Einstellungen. Die ausgewählten Komponenten werden durch die Komponenten-IDs identifiziert. Diese IDs sind mit den für den Parameter TRACEBASIC aufgelisteten IDs identisch. Die mit Nummern angegebenen Unterkomponenten empfangen ausführliche Traces. Die übrigen Komponenten des Produkts empfangen die beim Parameter TRACEALL angegebenen Traces.
Fehler vermeiden Fehler vermeiden: Ändern Sie diese Variable nur, wenn Sie dazu vom IBM Support aufgefordert werden.gotcha
TRACESPECIFIC=xxyyyzzz
Gibt Traceüberschreibungen für bestimmte Tracepunkte des Produkts an.
Tracepunkte werden als achtstellige Hexadezimalzahlen angegeben. Wenn Sie mehrere Tracepunkte angeben möchten, setzen Sie sie in Klammern und trennen Sie die Punkte durch Kommas voneinander. Sie können auch den Namen einer Umgebungsvariablen angeben, den Sie in einfache Anführungszeichen setzen müssen. Der Wert der Umgebungsvariablen wird wie ein für TRACESPECIFIC angegebener Wert bearbeitet.
Fehler vermeiden Fehler vermeiden: Verwenden Sie TRACESPECIFIC nur auf Anweisung der IBM Unterstützungsfunktion.gotcha
TRACE_EXCLUDE_SPECIFIC=xxyyyzzz
Gibt die auszuschließenden Tracepunkte des Produkts an.
Tracepunkte, die ausgeschlossen werden sollen, werden als achtstellige Hexadezimalzahlen angegeben. Wenn Sie mehrere Tracepunkte angeben möchten, setzen Sie sie in Klammern und trennen Sie die Punkte durch Kommas voneinander. Sie können auch den Namen einer Umgebungsvariablen angeben, den Sie in einfache Anführungszeichen setzen müssen. Der Wert der Eigenschaft wird so behandelt, als hätten Sie ihn mit "TRACE_EXCLUDE_SPECIFIC" angegeben. Sie können den Parameter "TRACE_EXCLUDE_SPECIFIC" als Maske verwenden, um momentan aktivierte Traces zu inaktivieren. Mit dem Parameter "TRACESPECIFIC" können Sie beispielsweise den Trace für eine ganze Produktkomponente aktivieren und dann den Parameter "TRACE_EXCLUDE_SPECIFIC" verwenden, um innerhalb dieser Komponente einen einzelnen Trace zu inaktivieren.
Fehler vermeiden Fehler vermeiden: Verwenden Sie den Parameter "TRACE_EXCLUDE_SPECIFIC" nur auf Anweisung der IBM Unterstützungsfunktion.gotcha
TRACEINIT
Zurücksetzen auf die anfänglichen Traceeinstellungen.
TRACENONE
Inaktiviert alle Traceeinstellungen.
TRACETOSYSPRINT={YES|NO}
Bestimmt, ob der Trace an SYSPRINT gesendet werden soll.

YES gibt an, dass der Trace an SYSPRINT gesendet wird, und NO stoppt das Senden des Trace an SYSPRINT.

TRACETOTRCFILE={YES|NO}
Bestimmt, ob der Trace an die "TRCFILE DD"-Karte gesendet werden soll.

YES gibt an, dass der Trace an die "TRCFILE DD"-Karte gesendet wird, und NO stoppt das Senden des Trace an die "TRCFILE DD"-Karte.

TRACEJAVA
Wird zum Ändern der Java-Tracezeichenfolge verwendet.

Mit der regelkonformen Java-Tracespezifikation wird der Java-Trace gesteuert. *=all=enabled bedeutet die Aktivierung aller Tracetypen für alle registrierten Tracekomponenten.

TRACERECORD,{ON|OFF|RESET}
Wird verwendet, um die Erstellung von Tracedatensätzen zu steuern. Der Parameter wird mit dem in der Workload-Klassifikationsdatei definierten Attribut classification_only_trace verwendet.

Die Angabe von ON bewirkt, dass die Tracedatensätze auf der Basis der aktuellen Tracespezifikation geschrieben werden. Alle Attribute vom Typ "classification_only_trace" werden ignoriert.

Die Angabe von OFF verhindert, dass Tracedatensätze geschrieben werden.
Vorsicht:
Tracedatensätze, die auf der aktuellen Tracespezifikation basieren oder als Teil der normalen Laufzeitverarbeitung erstellt werden, werden nicht geschrieben.
Die Angabe von RESET bewirkt, dass Tracedatensätze für die aktuelle Tracespezifikation wie folgt geschrieben werden:
  • Wenn keine Attribute vom Typ "classification_only_trace" definiert sind, werden Tracedatensätze für alle Verarbeitungsthreads geschrieben. Diese Situation ist funktional äquivalent zur Einstellung ON für TRACERECORD.
  • Wenn ein oder mehrere Attribute vom Typ "classification_only_trace" definiert sind, werden Tracedatensätze ausschließlich für die Verarbeitung der Threads geschrieben, deren Klassifikation ein Attribut vom Typ "classification_only_trace" mit dem Wert 1 enthält.

Der Standardwert ist RESET.

HELP
Anzeigen einer Liste aller Schlüsselwörter, die mit dem Befehl modify verwendet werden können.

Sie können auch den Parameter HELP nach dem Parameter CANCEL oder DISPLAY angeben, um die Liste der Schlüsselwörter anzuzeigen, die mit diesen Parametern verwendet werden können.

PAUSELISTENERS
Verhindert, dass Anforderungen im Server angenommen werden. Verwenden Sie diesen Parameter, wenn Sie die Kommunikationslistener beenden und alle anstehenden Anforderungen in der Arbeitsregistry löschen möchten.
Fehler vermeiden Fehler vermeiden: Der Befehl "MODIFY Server,PAUSELISTENERS stoppt die Empfangsbereitschaft des Controllers für alle Ports mit Ausnahme von IIOP (ORB_TCP_SECURE und ORB_TCP_LISTENER). Bei IIOP stoppt beim Absetzen dieses Modify-Befehls der Dämon das Senden von Anforderungen an die IIOP-Transportkanäle. Wenn Sie jedoch Clientanwendungen ausführen, die zwischenspeichern, ist es möglich, dass Anforderungen aus diesen Anwendungen direkt an den offenen IIOP-Port gesendet werden. Dieser Fall tritt möglicherweise ein, weil die IIOP-Listener beim Serverstartvorgang zeitig gestartet werden und auf diese Weise unter Umständen der IIOP-Port bereits geöffnet wurde, bevor der modify-Befehl abgesetzt werden konnte. gotcha
WLM_MIN_MAX=min,max
Wird verwendet, um die Mindestanzahl und maximale Anzahl an Servants dynamisch zu ändern (wlm_minimumSRCount und wlm_maximumSRCount). WLM passt die aktuelle Anzahl aktiver Servants dynamisch an die neuen Vorgaben an. Beachten Sie, dass die neuen Einstellungen nicht unbedingt sofort wirksam werden. WLM versucht, die neuen Mindest- und Maximalziele so schnell wie möglich zu erreichen, muss dabei jedoch auf Faktoren wie Ressourcenverfügbarkeit und Workload Rücksicht nehmen.
Fehler vermeiden Fehler vermeiden: Der Befehl WLM_MIN_MAX wird für Server, die mit einer dynamischen Anwendungsumgebung mit nur einem einzigen Server konfiguriert sind (d. h. die Eigenschaft "wlm_dynapplenv_single_server" ist auf 1 gesetzt), ignoriert.gotcha
WORKERTHREADMAX=n
Wird verwendet, um das Maximum für den Worker-Thread-Pool der Controller-Region zu erhöhen. Der im Befehl "modify" angegebene Wert überschreibt den für die Umgebungsvariable control_region_thread_pool_maximum_size angegebenen Wert. Das Maximum kann lediglich erhöht werden. Anforderungen zum Verringern des Maximums werden abgelehnt. Wenn Sie ein Maximum angeben, vergewissern Sie sich, dass genügend Ressourcen dafür verfügbar sind. Ein Beispiel für eine Ressource, die Sie berücksichtigen müssen, ist die Größe des JVM-Heapspeichers.
RESUMELISTENERS
Verwenden Sie diesen Befehl, um die Kommunikationslistener nach dem Absetzen eines Befehls modify mit dem Parameter "PAUSELISTENERS" erneut zu starten. Dieser Befehl bewirkt, dass Anforderungen im Server wieder akzeptiert werden.
DISPLAY
Zeigt den Namen des Servers, den Namen des Systems, auf dem der Server ausgeführt wird, und die aktuelle Codeversion an.

Sie können folgende Optionen für diesen Parameter angeben:

  • SERVERS: Zeigt den Namen des Servers, an den der Befehl adressiert wird, den Systemnamen und die Codeversion für alle aktiven Server des Sysplex, die sich in einer Zelle befinden, an.
  • SERVANTS: Zeigt eine Liste mit Adressraumkennungen (ASID, Address Space Identifier) der Servants an, die mit dem Server verbunden sind, für den Sie den Befehl display abgesetzt haben.
  • TRACE: Zeigt Traceinformationen für einen Server-Controller an. Mit den folgenden Optionen können Sie diesen Befehl weiter modifizieren:
    • SRS: Zeigt nacheinander Traceinformationen für die einzelnen Servants an.
    • ALL: Zeigt nacheinander Traceinformationen für den Controller und alle Servants an.
    • JAVA: Zeigt die Einstellungen für die Java-Tracezeichenfolgen für einen Servercontroller an. Mit den folgenden Optionen können Sie diesen Befehl weiter modifizieren:
      • SRS: Zeigt nacheinander Java-Traceinformationen für alle Servants an.
      • ALL: Zeigt nacheinander Java-Traceinformationen für den Controller und alle Servants an.
      • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display trace Java verwendet werden können.
    • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display trace verwendet werden können.
  • JVMHEAP: Zeigt die Informationen zum JVM-Heapspeicher für einen Servercontroller an. Mit den folgenden Optionen können Sie diesen Befehl weiter modifizieren:
    • SRS: Zeigt nacheinander die Informationen zum JVM-Heapspeicher für alle Servants an.
    • ALL: Zeigt nacheinander die Informationen zum JVM-Heapspeicher für den Controller und alle Servants an.
    • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display Javaheap verwendet werden können.
  • LISTENERS: Zeigt den Namen der Verbindungsinstanz, die zugehörige IP-Adresse und die Nummer des Empfangsports an. In der zugeordneten IP-Adresse kann ein Stern (*) als Platzhalterzeichen angezeigt werden.
  • CONNECTIONS: Zeigt den Namen jeder Verbindungsinstanz und einen Zähler für die Verbindungsanzahl an. Jede Verbindungsinstanz wird in einer separaten Zeile angezeigt. Mit den folgenden Optionen können Sie diesen Befehl weiter modifizieren:
    • NAME='Name': Zeigt die Anzahl der zugeordneten Verbindungen für die angegebene Verbindungsinstanz 'Name' an. Wenn der Verbindungsname zwar gefunden wird, aber keine Verbindungen hat, gibt der Befehl den Zähler null zurück. Wenn der Verbindungsname nicht gefunden wird, gibt der Befehl eine Fehlernachricht zurück.
    • LIST: Zeigt Informationen zum fernen Host für alle Verbindungen aller Verbindungsinstanzen an. Wenn eine Verbindungsinstanz keine Verbindungen hat, gibt der Befehl nur den Namen der Verbindungsinstanz zurück.
    • LIST, NAME='Name': Zeigt Informationen zu fernen Hosts für alle Verbindungen der angegebenen Verbindungsinstanz 'Name' an.
  • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify verwendet werden können.
  • ERRLOG: Zeigt die letzten zehn Einträge im Fehlerprotokoll an. Mit den folgenden Optionen können Sie diese Option weiter modifizieren:
    • SRS: Zeigt die letzten zehn Einträge im Fehlerprotokoll für alle Servants nacheinander an.
    • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display error log verwendet werden können.
  • MODE: Zeigt den Bitmodus an.
  • MSGROUTE: Zeigt die Liste mit Nachrichten für alle Routing-Positionen und zu unterdrückenden Nachrichten an. Die Weiterleitung von Nachrichten kann an das Fehlerprotokoll, das Systemprotokoll oder die MVS-Bedienerkonsole erfolgen.
    • ERRORLOG: Zeigt eine Liste mit Nachrichten an, die an das Fehlerprotokoll weitergeleitet werden sollen.
    • HARDCOPY: Zeigt eine Liste mit Nachrichten an, die an das Systemprotokoll SYSLOG (wird auch als Hardcopy bezeichnet) weitergeleitet werden sollen.
    • CONSOLE: Zeigt eine Liste mit Nachrichten an, die an die MVS-Bedienerkonsole weitergeleitet werden sollen.
    • NONE: Zeigt eine Liste mit Nachrichten an, die unterdrückt werden sollen.
  • SMF: Zeigt den Status der SMF-120-9-Datensatzerstellung für einen Server an.
    • ASYNC: Zeigt den Status der SMF-120-9-Datensatzerstellung für asynchrone Arbeit für alle Servants und zwar jeweils einen Servant zur Zeit an.
    • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display SMF verwendet werden können.
  • WORK: Zeigt die Anzahl der Arbeitselemente für den Server an. Mit den folgenden Optionen können Sie diese Option weiter modifizieren:
    • CRA: Zeigt Informationen zur Anzahl der CRA-MDB-Anforderungen an. Mit den folgenden Optionen können Sie diesen Befehl weiter modifizieren:
      • SRS: Zeigt Informationen zur Anzahl der CRA-Anforderungen für alle Servants nacheinander an.
      • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display work CRA verwendet werden können.
    • ASYNCSERVLET: Zeigt die Gesamtzahl von asynchronen Servletanforderungen und die aktuelle Anzahl asynchroner Servletanforderungen an, die gerade verarbeitet werden. Die Gesamtzahl asynchroner Servletanforderungen besteht nur aus Anforderungen, die seit dem letzten Start oder Neustart des gesamten Servers entstanden sind. Diese Zahl kann sich jedoch verringern, wenn einer oder mehrere der Servants gestoppt oder erneut gestartet wurden.
      • SRS: Zeigt die Gesamtzahl von asynchronen Servletanforderungen für jeden Servant und die aktuelle Anzahl asynchroner Servletanforderungen an, die gerade verarbeitet werden. Die Gesamtzahl ist die Anzahl asynchroner Servletanforderungen, die seit dem letzten Start oder Neustart des Servant entstanden sind.
      • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display work asyncservlets verwendet werden können.
    • EJB: Zeigt Informationen zur Anzahl der EJB-Anforderungen an. Mit den folgenden Optionen können Sie diese Option weiter modifizieren:
      • SRS: Zeigt Informationen zur Anzahl der EJB-Anforderungen für alle Servants nacheinander an.
      • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display work EJB verwendet werden können.
    • SERVLET: Zeigt Informationen zur Anzahl der Servletanforderungen an. Mit den folgenden Optionen können Sie diese Option weiter modifizieren:
      • SRS: Zeigt Informationen zur Anzahl der Servletanforderungen für alle Servants nacheinander an.
      • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display work servlet verwendet werden können.
    • MDB: Zeigt Informationen zur Anzahl der MDB-Anforderungen an. Mit den folgenden Optionen können Sie diesen Befehl weiter modifizieren:
      • SRS: Zeigt Informationen zur Anzahl der MDB-Anforderungen für alle Servants nacheinander an.
      • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display work MDB verwendet werden können.
    • SIP: Zeigt Informationen zur Anzahl der SIP-Anforderungen an. Mit den folgenden Optionen können Sie diese Option weiter modifizieren:
      • SRS: Zeigt Informationen zur Anzahl der SIP-Anforderungen für alle Servants nacheinander an.
      • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display work SIP verwendet werden können.
    • SUMMARY: Zeigt zusammenfassende Informationen zu den Anforderungszahlen an.
      • SRS: Zeigt zusammenfassende Informationen zur Anforderungsanzahl für alle Servants nacheinander an.
      • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display work summary verwendet werden können.
    • ALL: Zeigt alle Informationen zur Anforderungsanzahl an.
      • SRS: Zeigt alle Informationen zur Anforderungsanzahl für alle Servants nacheinander an.
      • STATS: Zeigt alle detaillierten Statistiken an.
      • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display work all verwendet werden können.
    • CLINFO: Zeigt Informationen zur Arbeitsklassifikation an.
    • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display work verwendet werden können.
    • OLA: Zeigt eingehende OLA-Anforderungen (Optimized Local Adapter, optimierter lokaler Adapter) an, die von den Services BBOA1INV und BBOA1SRQ gesteuert werden. Mit den folgenden Optionen können Sie diesen Befehl weiter modifizieren:
      • SRS: Zeigt Informationen zur Anzahl der OLA-Anforderungen für alle Servants nacheinander an.
      • HELP: Zeigt eine Liste aller Schlüsselwörter an, die mit dem Befehl modify display work all verwendet werden können.
  • Fast Response Cache Accelerator (FRCA). Sie können FRCA-Cachestatistiken wie folgt anzeigen:
    • f <Servername>,display,frca
    • f <Servername>,display,frca,content
    • f <Servername>,display,frca,stats
  • ADAPTER
    • STATUS zeigt den Status der optimierten lokalen Adapterkomponente an.
    • REGISTRATIONS zeigt eine Liste der Clients optimierter lokaler Adapter an, die mit diesem Server verbunden sind.
    • DAEMONRGES zeigt eine Liste der Clients optimierter lokaler Adapter an, die mit einem Server aus dieser Dämongruppe verbunden sind.
    • SEARCHRGES zeigt eine Liste der Clients optimierter lokaler Adapter an, die mit einem beliebigen Server dieser Dämongruppe verbunden sind, der den Suchkriterien entspricht.
ASIDX=
Geben Sie nach dem Befehl "modify" ASIDX= mit dem zugehörigen ASID (hexadezimale Angabe) einer Servantregion, für die Sie einen Speicherauszug erstellen möchten.
Beispiel:
MODIFY server,JAVACORE,ASIDX=F4
In diesem Beispiel übergibt der Befehl ein JAVACORE-Objekt der Servantregion mit dem ASID-Wert 'F4'.

Beispiel: Failover inaktivieren

Beispiel 1: Der folgende Befehl inaktiviert das Failover für die mit "jdbc/MySampleDataSource" auf dem Server "bbos001" angegebene primäre Ressource:
f bbos001,DISABLEFAILOVER,'jdbc/MySampleDataSource'

Beispiel: Anwendungscluster und -server mit dem Befehl modify abbrechen

Sie können in der MVS-Konsole keinen Cluster abbrechen. Stattdessen müssen Sie jeden zum Cluster gehörenden Server abbrechen.

Beispiel 1: Der folgende Befehl bricht den Server "bbo6acr" ab:
f bbo6acr,cancel
Beispiel 2: Der folgende Befehl bricht den Server "bbo6acr" ab und weist ARM an, den Server "bbo6acr" nach Abschluss des Beendigungsprozesses erneut zu starten:
f bbo6acr,cancel,armrestart

Beispiel: Allgemeine Tracestufe mit Scripting konfigurieren

Verwenden Sie den folgenden Befehl, um eine allgemeine Tracestufe für den Server zu konfigurieren:
f Server,traceall=n

Die gültigen Tracestufen sind 0 (keine), 1 (Ausnahme), 2 (Basis) und 3 (detaillierter Trace). Verwenden Sie unter normalen Bedingungen und in Produktionsumgebungen die Stufe 1 (Ausnahmetrace).

Beispiel: Der folgende Befehl aktiviert die Tracestufe 1 (Ausnahme) für den Server bbo6acr:
f bbo6acr,traceall=1
Beispielausgabe:
f bbo6acr,traceall=1BBOO0211I MODIFY COMMAND TRACEALL=1 COMPLETED SUCCESSFULLY

Beispiel: Basis- und detaillierte Tracestufen für WebSphere-z/OS-Komponenten konfigurieren

Verwenden Sie für die Installation den folgenden Befehl:
f Server,tracebasic=(n,...)
Beispiel 1: Der folgende Befehl aktiviert einen Basistrace für die Dämonkomponente in Server bbo6acr:
f bbo6acr,tracebasic=a
Beispielausgabe:
f bbo6acr,TRACEBASIC=A
BBOO0211I MODIFY COMMAND TRACEBASIC=A COMPLETED SUCCESSFULLY
Verwenden Sie den folgenden Befehl, um die Komponenten von WebSphere for z/OS anzugeben, für die Sie einen detaillierten Trace einstellen möchten:
f Server,tracedetail=(n,...)
Beispiel 2: Der folgende Befehl aktiviert einen detaillierten Trace für die Sicherheit in Server bbo6acr:
f bbo6acr,tracedetail=e
Beispielausgabe:
f bbo6acr,TRACEDETAIL=E
BBOO0211I MODIFY COMMAND TRACEDETAIL=E COMPLETED SUCCESSFULLY

Beispiel: Spezifische Tracepunkte mit Scripting konfigurieren

Verwenden Sie den folgenden Befehl, um spezifische Tracepunkte zu konfigurieren:
f Server,tracespecific=n | (n,...)
Beispiel 1: Der folgende Befehl aktiviert den spezifischen Tracepunkt 04006001:
f bbo6acr,tracespecific=04006001
Beispiel 2: Der folgende Befehl aktiviert die spezifischen Tracepunkte 04006001 und 04006027:
f bbo6acr,tracespecific=(04006001,04006027)
Beispiel 3: Der folgende Befehl aktiviert die mit der Umgebungsvariablen tracepoints angegebenen Tracepunkte:
f bbo6acr,tracespecific='tracepoints'

Beispiel: Spezifische Tracepunkte mit Scripting ausschließen

Verwenden Sie den folgenden Befehl, um spezifische Tracepunkte auszuschließen:
f Server,trace_exclude_specific=n | (n,...)
Beispiel: Der Befehl tracespecific aktiviert die Traceerstellung für einen vollständigen Teil und anschließend inaktiviert trace_exclude_specific die Traceerstellung für den Punkt 04006031 in diesem Teil:
f bbo6acr,tracespecific=04006000

f bbo6acr,trace_exclude_specific=04006031

Beispiel: Ursprüngliche Traceeinstellungen mit Scripting wiederherstellen

Verwenden Sie zum Zurücksetzen der Anfangseinstellungen für den Trace den folgenden Befehl:
f server,traceinit

Beispiel: Befehl zum Inaktivieren der Traceerstellung über eine Befehlszeile

Verwenden Sie zum Inaktivieren der Traceerstellung den folgenden Befehl:
f Server,tracenone

Beispiel: Trace mit Scripting an SYSPRINT senden

Verwenden Sie den folgenden Befehl, um den Trace an SYSPRINT zu senden:
f Server,tracetosysprint=yes
Verwenden Sie den folgenden Befehl, um das Senden des Trace an SYSPRINT zu stoppen:
f Server,tracetosysprint=no

Beispiel: Anwendungscluster und -server mit dem Befehl modify abbrechen

Dieses Beispiel veranschaulicht, wie Anwendungscluster und Server mit dem Befehl modify abgebrochen werden.

Vorbereitungen: Ein Cluster kann nicht über die MVS-Konsole abgebrochen werden. Stattdessen müssen Sie jeden zum Cluster gehörenden Server abbrechen.

Beispiel 1: Der folgende Befehl bricht die Ausführung von Server bbo6acr ab:


f bbo6acr,cancel
Beispiel 2: Der folgende Befehl bricht den Server "bbo6acr" ab und weist ARM an, den Server nach der Beendigung erneut zu starten:


f bbo6acr,cancel,armrestart

Beispiel: Hilfe zum Befehl modify anfordern

Sie können für die verschiedenen Versionen des Befehls modify eine Syntaxhilfe aufrufen.

Beispiel 1: Geben Sie den folgenden Befehl ein, um eine Liste aller Schlüsselwörter anzuzeigen, die Sie mit dem Befehl modify verwenden können:
f bbo6acr,help
Das folgende Beispiel veranschaulicht, wie die Ausgabe aussehen könnte:
F bbo6acr,HELP
BBOO0178I THE COMMAND MODIFY  MAY BE FOLLOWED BY ONE OF THE FOLLOWING KEYWORDS:
BBOO0179I CANCEL - CANCEL THIS CONTROL REGION
BBOO0179I TRACEALL - SET OVERALL TRACE LEVEL
BBOO0179I TRACEBASIC - SET BASIC TRACE COMPONENTS
BBOO0179I TRACEDETAIL - SET DETAILED TRACE COMPONENTS
BBOO0179I TRACESPECIFIC - SET SPECIFIC TRACE POINTS
BBOO0179I TRACEINIT - RESET TO INITIAL TRACE SETTINGS
BBOO0179I TRACENONE - TURN OFF ALL TRACING
BBOO0179I TRACETOSYSPRINT - SEND TRACE OUTPUT TO SYSPRINT (YES/NO)
BBOO0179I TRACETOTRCFILE - SEND TRACE OUTPUT TO TRCFILE DD CARD (YES/NO)
BBOO0179I DISPLAY - DISPLAY STATUS
BBOO0179I TRACE_EXCLUDE_SPECIFIC - EXCLUDE SPECIFIC TRACE POINTS
BBOO0179I TRACEJAVA - SET JAVA TRACE OPTIONS
BBOO0179I TRACETOTRCFILE - SEND TRACE OUTPUT TO TRCFILE (YES/NO)   
BBOO0179I MDBSTATS - MDB DETAILED STATISTICSBBOO0179I PAUSELISTENERS - PAUSE THE COMMUNICATION LISTENERS       
BBOO0179I RESUMELISTENERS - RESUME THE COMMUNICATION LISTENERS                 
BBOO0179I STACKTRACE - LOG JAVA THREAD STACK TRACEBACKS              
BBOO0179I TIMEOUTDUMPACTION - SET TIMEOUT DUMP ACTION               
BBOO0179I TIMEOUTDUMPACTIONSESSION - SET TIMEOUT DUMP ACTION SESSION
BBOO0179I WLM_MIN_MAX - RESET WLM MIN/MAX SERVANT SETTINGS 
Beispiel 2: Geben Sie den folgende Befehl ein, um eine Liste aller Schlüsselwörter anzuzeigen, die Sie mit dem Befehl "modify display" angeben können:
f bbo6acr,display,help
Das folgende Beispiel veranschaulicht, wie die Ausgabe aussehen könnte:
 F BBOS001,DISPLAY,HELP                                                   
 BBOO0178I THE COMMAND DISPLAY, MAY BE FOLLOWED BY ONE OF THE FOLLOWING   
 124 KEYWORDS:                                                                
 BBOO0179I SERVERS - DISPLAY ACTIVE CONTROL PROCESSES
 BBOO0179I SERVANTS - DISPLAY SERVANT PROCESSES OWNED BY THIS CONTROL 126 
 PROCESS                                                                  
 BBOO0179I LISTENERS - DISPLAY LISTENERS                                  
 BBOO0179I CONNECTIONS - DISPLAY CONNECTION INFORMATION                   
 BBOO0179I TRACE - DISPLAY INFORMATION ABOUT TRACE SETTINGS
 BBOO0179I JVMHEAP - DISPLAY JVM HEAP STATISTICS
 BBOO0179I WORK - DISPLAY WORK ELEMENTS
 BBOO0179I ERRLOG - DISPLAY THE LAST 10 ENTRIES IN THE ERROR LOG
 BBOO0179I MODE - DISPLAY THE EXECUTION BITMODE                           
 BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,HELP
Beispiel 3: Geben Sie den folgenden Befehl ein, um eine Liste aller Schlüsselwörter anzuzeigen, die Sie mit dem Befehl modify timeoutdumpaction oder modify timeoutdumpactionsession verwenden können:
f bbos001,timeoutdumpactionsession=help
Das folgende Beispiel veranschaulicht, wie die Ausgabe aussehen könnte:
BBOO0178I THE COMMAND MODIFY TIMEOUTDUMPACTIONSESSION= MAY BE FOLLOWED BY
ONE OF the FOLLOWING KEYWORDS:   
BBOO0179I SVCDUMP - SVC DUMP  
BBOO0179I JAVACORE - JAVA CORE DUMP   
BBOO0179I NONE - NO DUMP                   
Beispiel 4: Geben Sie den folgenden Befehl ein, um eine Liste aller Schlüsselwörter anzuzeigen, die Sie mit dem Befehl modify display dpm verwenden können:
f bbos001,dpm,help                                                  
Das folgende Beispiel veranschaulicht, wie die Ausgabe aussehen könnte:
BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE  
FOLLOWING KEYWORDS:                                            
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL            
BBOO0179I HTTP - HTTP DISPATCH PROGRESS MONITOR INTERVAL         
BBOO0179I HTTPS - HTTPS DISPATCH PROGRESS MONITOR INTERVAL       
BBOO0179I MDB - MDB DISPATCH PROGRESS MONITOR INTERVAL           
BBOO0179I SIP - SIP DISPATCH PROGRESS MONITOR INTERVAL           
BBOO0179I SIPS - SIPS DISPATCH PROGRESS MONITOR INTERVAL         
BBOO0179I INTERVAL - ALL DISPATCH PROGRESS MONITOR INTERVALS     
BBOO0179I OLA - OLA DISPATCH PROGRESS MONITOR INTERVAL   
BBOO0179I DUMP_ACTION - DISPATCH PROGRESS MONITOR DUMP ACTION    
BBOO0179I CLEAR_ALL - CLEAR ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I RESET_ALL - RESET ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0211I MODIFY COMMAND DPM, COMPLETED SUCCESSFULLY 
Wenn Fixpack 8.5.5.1 oder höher installiert ist, könnte die Ausgabe wie im folgenden Beispiel aussehen:
BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE   
FOLLOWING KEYWORDS:                                            
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL            
BBOO0179I HTTP - HTTP DISPATCH PROGRESS MONITOR INTERVAL         
BBOO0179I HTTPS - HTTPS DISPATCH PROGRESS MONITOR INTERVAL       
BBOO0179I MDB - MDB DISPATCH PROGRESS MONITOR INTERVAL           
BBOO0179I SIP - SIP DISPATCH PROGRESS MONITOR INTERVAL           
BBOO0179I SIPS - SIPS DISPATCH PROGRESS MONITOR INTERVAL         
BBOO0179I OLA - OLA DISPATCH PROGRESS MONITOR INTERVAL   
BBOO0179I INTERVAL - ALL DISPATCH PROGRESS MONITOR INTERVALS     
BBOO0179I DUMP_ACTION - DISPATCH PROGRESS MONITOR DUMP ACTION    
BBOO0179I CLEAR_ALL - CLEAR ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I RESET_ALL - RESET ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I CRA - MDB CRA DISPATCH PROGRESS MONITOR INTERVAL 
BBOO0211I MODIFY COMMAND DPM, COMPLETED SUCCESSFULLY 

Beispiel: Java-Tracezeichenfolge ändern

Dieses Beispiel veranschaulicht, wie Sie mit einem Konsolbefehl eine Java-Tracezeichenfolge ändern.

Verwenden Sie zum Ändern der Java-Tracezeichenfolge den folgenden Befehl:
f Server, tracejava='Tracespezifikation'
Beispiel: Der folgende Befehl aktiviert alle Arten von Trace für alle registrierten Tracekomponenten:
f bbo6acr,tracejava='*=all'
Anmerkung: Die Anführungszeichen sind ein erforderlicher Teil der Syntax.

Beispiel: Diagnoseaktion ändern, die beim Auftreten einer abnormalen Speicherbedingung in der JVM ausgeführt wird

In diesem Beispiel wird gezeigt, wie der Konsolenbefehl verwendet wird, um die Diagnoseaktion zu ändern, die ausgeführt wird, wenn auf diesem Server eine abnormale Speicherbedingung in der JVM auftritt. Verwenden Sie folgenden Befehl:

f server,javaoom,[interval=xxx | action=xxx]
Beispiel: Mit dem folgenden Befehl wird ein SVC-Speicherauszug (SVCDUMP) des betroffenen Adressraums mit dem Nebencode C9C2704B erzeugt, falls eine abnormale Speicherbedingung in der JVM auftritt: Dieser Befehl verhindert außerdem, dass Diagnoseaktionen ausgeführt werden, bevor ein Zeitintervall von 1200 Sekunden (20 Minuten) abgelaufen ist.
f bbo6acr,,javaoom,[interval=1200 | action=svcdump]
Anmerkung: Die Anführungszeichen sind ein erforderlicher Teil der Syntax.

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_mvsmodify
Dateiname:rxml_mvsmodify.html