Befehl "probevctrl"

Zweck

Ändert die dynamischen ProbeVue-Traceparameter und ProbeVue-Sitzungen und zeigt diese an.

Syntax

probevctrl [ -c Attribut = Wert ] [ -C ] [ -f { milli|micro }] [ -d sessionID ] [ -l ] [ -n Attribut = Wert ] [ -p ] [-s { probevue_session_id }] [ -t ] [ -u Benutzerliste ] [-T { show|start|stop|reset }]

Beschreibung

Mit dem Befehl probevctrl können Sie die dynamischen ProbeVue-Traceparameter, die prozessorspezifische Tracepuffergröße, den genutzten fixierten Speicher, den Benutzer, der Sitzungseigner ist, die ID des Prozesses, der die Sitzung gestartet hat, und Informationen dazu, ob die Sitzung Kerneltestmonitore für die ProbeVue-Sitzungen hat, geändert und angezeigt.

Standardmäßig ist ProbeVue aktiviert. Der Versuch, die ProbeVue zu inaktivieren, wenn ProbeVue-Sitzungen aktiv sind, schlägt fehl.

Flags

-c

Gibt nicht benutzerorientierte ProbeVue-Parameter an. Die Argumente für dieses Flag müssen durch Kommas getrennt oder in doppelte Anführungszeichen eingeschlossen und durch Kommas oder Leerzeichen getrennt werden. Wenn entweder das Flag -p oder das Flag -t nicht zusammen mit diesem Flag angegeben wird, werden neue Werte in der aktuellen Bootsitzung und bei den nächsten Bootsitzungen wirksam. Die gültigen Attribut=Wert-Paare sind im Folgenden beschrieben:

trace= {on | off}

Gibt an, ob ProbeVue aktiviert oder inaktiviert werden muss.

default_buffer_size=Standardpuffergröße

Gibt die Standardgröße der prozessorspezifischen Tracepuffer in KB an. Diese Größe wird auf die nächste 4-KB-Seite gerundet.

max_total_mem_size=maximale_Gesamtspeichergröße

Gibt den maximalen fixierten Speicher in MB an, der vom gesamten ProbeVue-Framework verwendet werden kann.

default_read_rate=Standardleserate

Gibt den Standardzeitraum in Millisekunden an, in dem die ProbeVue-Puffer vom Tracekonsumenten gelesen werden.

stack_size=Stackgröße_in_4-KB-Seiten

Gibt die Größe des prozessorspezifischen Rechenstacks in KB an. Diese Größe wird auf die nächste 4-KB-Seite gerundet.

local_table_size=Wert

Gibt die Größe der prozessorspezifischen lokalen Tabelle in KB an. Die Hälfte des für die lokale Tabelle zugeordneten Speicherplatzes wird von temporären Zeichenfolgen genutzt. Der Standardwert ist 4 KB.

min_interval=Intervall in Millisekunden

Gibt das zulässige Mindestintervall für den globalen Rootbenutzer in Intervalltestmonitoren an.

num_pagefaults=Anzahl

Gibt die Anzahl der Fehlseitenbedingungskontexte für die Behandlung von Fehlseitenbedingungen an. Die angegebene Anzahl von Fehlseitenbedingungskontexten wird während der Initialisierung des ProbeVue-Frameworks vorab zugeordnet.

num_threads_traced=Anzahl

Gibt die maximale Anzahl von Threads an, die eine ProbeVue-Sitzung unterstützen kann, wenn sie lokale Threadvariablen enthält. Das ProbeVue-Framework ordnet alle lokalen Threadvariablen am Anfang einer Sitzung für die mit diesem Attribut angegebene maximale Anzahl von Threads vorab zu.

max_net_buf_size=Wert

Gibt die maximale Größe der CPU-spezifischen Puffer für eine net-Testmonitoraktion in Byte an.

max_intr_systrcprb_time=Wert

Gibt die maximale Ausführungsdauer für eine Testmonitoraktion in Millisekunden an, wenn die Testmonitoraktion systrace im Interruptkontext gestartet wird.

max_intr_sysprocprb_time=Wert

Gibt die maximale Ausführungsdauer für eine Testmonitoraktion in Millisekunden an, wenn die Testmonitoraktion sysproc im Interruptkontext gestartet wird.

max_intr_ioprb_time=Wert

Gibt die maximale Ausführungsdauer für eine Testmonitoraktion in Millisekunden an, wenn die Testmonitoraktion io im Interruptkontext gestartet wird.

max_intr_netprb_time=Wert

Gibt die maximale Ausführungsdauer für eine Testmonitoraktion in Millisekunden an, wenn die Testmonitoraktion net im Interruptkontext gestartet wird.

async_stats_fetch_interval=Wert

Gibt das asynchrone Abrufintervall für den Abruf von Systemstatistiken in Millisekunden an. Dieses Attribut ist ein globaler Wert, der für alle ProbeVue-Sitzungen gilt. ProbeVue legt das asynchrone Abrufintervall basierend auf diesem Wert fest. Der Standardwert für den optimierbaren Parameter ist 1000 Millisekunden. Eine Änderung des Werts dieses optimierbaren Parameter hat keine Auswirkung auf die aktiven Sitzungen und der angegebene Wert wird nur für die neuen Sitzungen verwendet.

fetch_stats_async_only={yes | no}

Gibt an, dass alle Systemstatistiken im asynchronen Modus abgerufen werden müssen, selbst wenn ein synchroner Abruf möglich ist. Der Standardwert für diesen Parameter ist 'no'. Änderungen am optimierbaren Wert wirken sich nicht auf die aktiven Sitzungen aus und der angegebene Wert wird nur für die neuen Sitzungen verwendet.

max_intr_cpuboundprb_time=Wert

Gibt die maximale Ausführungsdauer für eine Testmonitoraktion in Millisekunden an, wenn die Testmonitoraktion CPU-bound interval im Interruptkontext gestartet wird.

-C

Setzt die optimierbaren Parameter für ProbeVue-Sitzungen auf die Anfangswerte. Die Option -C verwendet die aktuelle Konfiguration des Systems, um die festzulegenden Anfangskonfigurationswerte (hoher Konfigurationswert oder niedriger Konfigurationswert) zu bestimmen, und aktualisiert sowohl die aktuellen Bootparameter als auch Parameter für den nächsten Bootvorgang. Weitere Informationen zu hohen und niedrigen Konfigurationswerten optimierbarer Parameter finden Sie im Abschnitt ProbeVue Dynamic Tracing Facility .

Hinweis: Stellen Sie vor Verwendung des Flags -C sicher, dass keine aktive ProbeVue -Sitzung vorhanden ist.

-d sessionId

Zeigt die Liste der Testmonitore an, die für die angegebene Sitzung aktiviert sind. Wenn Sie all als Sitzungs-ID angeben, werden die Testmonitore für alle ProbeVue-Sitzungen angezeigt, die vom Benutzer angezeigt werden können. Eine Liste der ProbeVue-Sitzungen und der zugehörigen Sitzungs-IDs können Sie mit dem Befehl probevctrl abrufen.

-f

Gibt das Format an, in dem die Datennutzungszeiten für Testmonitoraktionen angezeigt werden sollen. Die Option -f kann zusammen mit der Option -T verwendet werden und zeigt die Aktionen für eine bestimmte Sitzung an. Die gültigen Formate sind im Folgenden beschrieben:

milli

Zeigt die Zeit in Millisekunden an.

micro

Zeigt die Zeit in Mikrosekunden an.

Das Standardformat ist milli.

-l

Listet die aktuellen Werte der ProbeVue-Konfigurationsparameter auf. Wenn das Flag -p oder das Flag -t nicht angegeben ist, werden die Parameterwerte für die aktuelle Bootsitzung angezeigt.

-n

Gibt die konfigurierbaren Parameter für reguläre Benutzer an. Die Argumente für diese Option müssen durch Kommas getrennt oder in doppelte Anführungszeichen eingeschlossen und durch Kommas oder Leerzeichen getrennt werden. Wenn entweder das Flag -p oder das Flag -t nicht zusammen mit diesem Flag angegeben wird, werden neue Werte in der aktuellen Bootsitzung und bei den nächsten Bootsitzungen wirksam. Die gültigen Attribut=Wert-Paare sind im Folgenden beschrieben:

max_mem_size=maximale_Speichergröße

Gibt den maximalen fixierten Speicher in MB an, der von einer ProbeVue-Sitzung verwendet werden kann.

max_sessions=maximale_Anzahl_Sitzungen

Gibt die maximal zulässige Anzahl gleichzeitiger Sitzungen an.

min_read_rate=Mindestleserate

Gibt den Mindestzeitraum in Millisekunden an, in dem ein regulärer Benutzer den Tracekonsumenten auffordern kann, aus seinen Tracepuffern zu lesen

pin_mem_dvar_pc=fixierter_Speicher_für_dvars_in_Prozent

Gibt den Prozentsatz des Speichers an, der der dynamischen Datenstruktur für dynamische Typvariablen zugewiesen werden kann. Dieser Speicher kann für die dynamische Variablen für Stack-Traces und assoziative Arrays verwendet werden. Die gültigen Werte für diesen Parameter sind 10-100. Der Standardwert ist 50.

-p

Gibt an, dass die Standardwerte für den nächsten Bootvorgang aktualisiert und angezeigt werden sollen.

-s ID_der_ProbeVue-Sitzung

Gibt die Sitzung an, in der die Aktion ausgeführt werden soll. Dieses Flag muss zusmmen mit dem Flag -T verwendet werden.

-u

Gibt eine durch Kommas getrennte Benutzerliste an, deren ProbeVue-Sitzungen aufgelistet werden sollen. Wenn das Flag -u nicht angegeben ist, werden alle ProbeVue-Sitzungen angezeigt, die der Benutzer anzeigen kann. Ein Benutzer mit der Berechtigung aix.ras.probevue.manage kann alle ProbeVue-Sitzungen im System anzeigen. Benutzer, die diese Berechtigung nicht haben, können nur die ProbeVue-Sitzungen anzeigen, die ihnen gehören.

-t

Gibt an, dass die Standardwerte für die aktuelle Bootsitzung aktualisiert und angezeigt werden sollen.

-T show | start | stop | reset

Gibt an, ob die Profilerstellung für die Testmonitoraktionen für die mit dem Flag -s angegebene Sitzung angezeigt, gestartet, gestoppt oder zurückgesetzt werden soll. Das Flag -s muss zusammen mit diesem Flag verwendet werden.

Beispiele

1. Geben Sie Folgendes ein, um die Standardpuffergröße für den nächsten Bootvorgang zu ändern und die dynamische Traceerstellung zu aktivieren:

   probevctrl -c trace=on,default_buffer_size=8 -p

   oder

   probevctrl -c "trace=on default_buffer_size=8" -p

2. Geben Sie Folgendes ein, um die ProbeVue-Konfiguration für den nächsten Bootvorgang aufzulisten:

   probevctrl -l -p

3. Geben Sie Folgendes ein, um die aktuelle ProbeVue-Konfiguration aufzulisten:

   probevctrl -l -t

4. Geben Sie Folgendes ein, um alle ProbeVue-Sitzungen aufzulisten:

   probevctrl

5. Geben Sie Folgendes ein, um alle ProbeVue-Sitzungen aufzulisten, die dem Benutzer "guest" gehören:

   probevctrl -u guest

6. Geben Sie Folgendes ein, um den Prozentsatz des fixierten (pinned) Speichers zu erhöhen, der für die dynamischen Datenstrukturen (Stack-Trace und assoziative Arrays) für den nächsten Bootvorgang vom Standardwert 50 auf 75 zu erhöhen:

   probevctrl -n  pin_mem_dvar_pc = 75