1 Themenübersicht
Mithilfe von Profiling-Protokollen können Sie den Datenbankzugriff und die Verwendung des Persistenzdienstes in Ihren Anwendungen prüfen. Mit dem Tool „Mit Profiling arbeiten“ (wrkprf) können Sie die Aufzeichnung von Profiling-Protokollen steuern.
2 Zielgruppe
- Anwendungsentwickler
- System-Administratoren
- Technische Berater
3 Beschreibung
Dieses Steuerelement enthält Metadaten und darf nicht gelöscht werden.Mithilfe von Profiling-Protokollen können Sie den Datenbankzugriff und die Verwendung des Persistenzdienstes in Ihrer Anwendung prüfen. Mit dem Tool „Mit Profiling arbeiten“ (wrkprf) kann die Aufzeichnung eines Profiling-Protokolls gestartet, angehalten und abgeschlossen werden. Die Auswertung von Profiling-Protokollen erfolgt mit der Anwendung „Profiling-Protokolle abfragen“. Siehe dazu diese Dokumentation: Profiling-Protokolle abfragen
Ein Profiling-Protokoll wird nur erstellt, wenn Sie sich nach dem Aktivieren des Profilings erneut anmelden.
3.1 Befehl
Nachfolgend finden Sie den Befehl inklusive aller möglichen Parameter.
| wrkprf | [-start:<str>] [-stop] [-attachToolShell] [-pause] [-resume] [-buffer:<int>] [-noGetObject] [-noGetObjectArray] [-noGetObjectIterator] [-noGetResultSet] [-noDatabaseAccess] [-user:<str>][-stackFrame:<str>] |
3.2 Parameter
Die Parameter des Befehls werden in der folgenden Tabelle erläutert. Die in eckigen Klammern gesetzten Parameter sind optional, die anderen hingegen sind Pflichtparameter. Für einige Parameter kann ein Stern (*) als Platzhalter angegeben werden, um damit alle möglichen Werte ausgeben zu können. Nicht alle Parameter können mehrfach genannt werden, nur die, die folgenden Zusatz an den Parametervariablen aufweisen, sind für die Mehrfachnennung zugelassen: „<str-1> … <str–n>“.
| Parameter | Erläuterung |
| -start:<str> | Start der Aufzeichnung eines Profiling-Protokolls. Erfassen Sie den Dateinamen für das Profiling-Protokoll als Parameter. Während der aktiven Aufzeichnung kann das Profiling-Protokoll nicht ausgewertet werden. |
| -stop | Beendet die Aufzeichnung des aktiven Profiling-Protokolls. Nach dem Ende der Aufzeichnung können Sie das Profiling-Protokoll mit der Anwendung „Profiling-Protokolle abfragen“ auswerten.
Weitere Informationen dazu finden Sie in dieser Dokumentation: Profiling-Protokolle abfragen |
| -attachToolShell | Sie können Tool-Befehle mit diesem Parameter im Profiling-Protokoll aufzeichnen. |
| -pause | Setzt die Aufzeichnung des Profiling-Protokolls aus. Ist die Aufzeichnung ausgesetzt, dann werden keine weiteren Operationen aufgezeichnet. |
| -resume | Setzt die ausgesetzte Aufzeichnung des Profiling-Protokolls fort. Alle Operationen werden wieder aufgezeichnet. |
| -buffer:<int> | Mit diesem Parameter legen Sie fest, in welcher Blockgröße das Profiling-Protokoll geschrieben wird. |
| -noGetObject | Die Methode „getObject“ am Objekt-Manager wird nicht aufgezeichnet. |
| -noGetObjectArray | Die Methode „getObjectArray“ am Objekt-Manager wird nicht aufgezeichnet. |
| -noGetObjectIterator | Die Methode „getObjectIterator“ am Objekt-Manager wird nicht aufgezeichnet. |
| -noGetResultSet | Die Methode „getResultSet“ am Objekt-Manager wird nicht aufgezeichnet. |
| -noDatabaseAccess | Datenbankzugriffe werden nicht aufgezeichnet. |
| -user:<str> | Erfassen Sie die Identifikation des Benutzers, dessen Aktionen im Profiling-Protokoll aufgezeichnet werden sollen. Wenn Sie keinen Benutzer angeben, dann werden die Aktionen aller Benutzer im Profiling-Protokoll aufgezeichnet. |
| -stackFrame:<str-n> | Mithilfe dieses Parameters können Sie gezielte Objekte im Profiling-Protokoll aufzeichnen. Erfassen Sie dazu den vollqualifizierten Namen des Objektes, welches bei der jeweilig aufgezeichneten Aktion ebenfalls aufgezeichnet werden soll.
Beispiel: Sie erfassen mit dem Parameter „stackFrame“ folgendes Business Object: com.cisag.app.general.obj.Item Dann wird z. B. bei der Aktion „getObject“ auch aufgezeichnet, wenn das Business Object „Artikel“ geöffnet wird. |