Die Profiler Utility im Online-Modus dient dazu, einen schnellen Überblick über die letzten Aktionen einer Natural-Online-Anwendung zu erhalten. Die Utility ist menübasiert und bietet Funktionen zur Steuerung des Profiler-Tracing, zur Auswahl der erforderlichen Ereignistypen, zur Pflege und Anzeige von Trace-Datensätzen, zum Herunterladen der Ereignisdaten auf den PC und zum Speichern der Ereignisdaten als Profiler-Ressourcendatei.

Mit der Profiler Utility können Sie den logischen Ablauf von Natural-Anwendungen analysieren und die Nutzung von Ressourcen verfolgen.

Dieses Dokument behandelt die folgenden Themen:

• Voraussetzungen

• Profiler Utility im Online-Modus aufrufen und beenden

• Ereignisse (Events)

• Funktionen

Voraussetzungen

Damit Sie die Profiler Utility im Online-Modus verwenden können, muss der Schlüsselwort-Subparameter SIZE des Profilparameters RDC auf einen Wert größer als 2 gesetzt werden, siehe RDC - Konfiguration des Natural Data Collector in der Parameter-Referenz-Dokumentation.

Darüber hinaus steuert der RDC-Parameter das folgende Standardverhalten der Profiler Utility:

• Durch die Einstellung RDC=ON ist das Profiler-Tracing bereits aktiv, wenn die Profiler Utility gestartet wird. Standardmäßig ist RDC auf OFF gesetzt und das Profiler-Tracing muss separat aktiviert werden, siehe Profiler Tracing starten/stoppen.

• Der Schlüsselwort-Subparameter EVENT bestimmt, welche Ereignistypen für das Profiler-Tracing ausgewählt werden. Standardmäßig ist EVENT auf ALL gesetzt, was alle verfügbaren Ereignistypen abdeckt (siehe Datenerfassung auslösende Ereignisse in der SYSRDC Utility-Dokumentation).

• Informationen zu Ereignistypen, die von der Profiler Utility abgedeckt werden, finden Sie unter Ereignisse.

Profiler Utility im Online-Modus aufrufen und beenden

Dieser Abschnitt enthält eine Anleitung zum Aufrufen und Beenden der Profiler Utility im Online-Modus.

Um die Profiler Utility aufzurufen:

• Geben Sie das folgende Systemkommando ein:

  PROFILER

  Das Hauptmenü der Profiler Utility (Beispiel siehe unten) erscheint. In der Kopfzeile des Menüs wird der aktuelle Status in Bezug auf das Profiler-Tracing angezeigt (Trace started/Trace stopped). Wenn das Profiler-Tracing gestoppt wird, wird auch die Anzahl der Trace-Datensätze angezeigt, die im Puffer des Natural Data Collector gesammelt wurden.

  12:30:57 ***** NATURAL PROFILER UTILITY ***** 2016-03-07 User SAG - Main Menu - 1035 records Trace stopped Code Function S Select Profiler events L List trace records D Display trace record T Start/Stop Profiler tracing P Print trace records W Download trace records B Save data as resource ? Help . Exit Code .. _ Record from .. 1_____ to .. 1035__ Profiler tracing successfully stopped. Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Canc

Um die Profiler Utility zu beenden:

• Drücken Sie PF3 oder PF12.

  Oder:
  Geben Sie einen Punkt (.) in das Feld Code ein.

  Oder:
  Geben Sie EXIT in der Kommandozeile Command ein.

Ereignisse (Events)

Während einer Natural-Session können verschiedene Arten von Ereignissen auftreten, z.B. ein Programmstart. Daten, die für ein Ereignis spezifisch sind, können in einem Trace-Datensatz gesammelt werden. Jedes Ereignis ist mit einem Ereignistyp verknüpft, d.h. einem ein- oder zweibuchstabigen Code. Folgende Ereignisse und Ereignistypen stehen zur Verfügung:

Funktionen

Die Funktionen, die von der Profiler Utility im Online-Modus abgedeckt werden, können in drei Kategorien unterteilt werden:

• Funktion Select Profiler Events, um Profiler-Ereignisse auszuwählen.

• Die Anzeigefunktionen List Trace Records, Display Trace Record, Print Trace Records, Download Trace Records und Save Data as Resource, um Trace-Datensätze aufzulisten, anzuzeigen, zu drucken, herunterzuladen bzw. zu speichern.

• Funktion Start/Stop Profiler Tracing, um das Profiler-Tracing zu starten oder zu stoppen.

Alle Funktionen der Profiler Utility können über das Hauptmenü aufgerufen werden.

Um eine Funktion aufzurufen:

• Geben Sie einen Funktionscode in das Feld Code ein.

  Anmerkung
  Die Eingabefelder Record from und Record to können geändert werden, um einen Bereich von Datensätzen zu definieren, der zuerst von den Funktionen List Trace Records und Display Trace Record aufgelistet bzw. angezeigt wird, oder um Datensätze für die Funktionen Print Trace Records und Download Trace Records zu filtern.

Dieser Abschnitt behandelt die folgenden Funktionen:

• Profiler-Ereignisse auswählen (Select Profiler Events)

• Trace-Datensätze auflisten (List Trace Records)

• Trace-Datensatz anzeigen (Display Trace Record)

• Profiler-Tracing starten/stoppen

• Trace-Datensätze drucken

• Trace Records herunterladen (Download Trace Records)

• Daten als Ressource speichern (Save Data as Resource)

Profiler-Ereignisse auswählen (Select Profiler Events)

Diese Funktion wird verwendet, um Ereignistypen für das Profiler-Tracing in der Spalte Collect (Sammeln) und als Filter für die Anzeigefunktionen in der Spalte Display (Anzeigen) auszuwählen.

Um einen Ereignistyp für das Profiler-Tracing auszuwählen:

• Geben Sie einen beliebigen Schlüssel in das entsprechende Eingabefeld in der Spalte Collect ein. Sie müssen mindestens einen Ereignistyp auswählen.

  Infolgedessen wird der Natural Data Collector dynamisch entsprechend Ihrer Auswahl aktualisiert. Wenn das Profiler-Tracing aktiv ist, wird es mit den von Ihnen getroffenen Auswahlen fortgesetzt.

Anmerkungen:

1. Um das Profiler-Tracing für den Ereignistyp Natural Statement (NS) zu aktivieren, müssen der Profilparameter TRACE auf NATPROX und der der Profilparameter ITRACE auf ON gesetzt sein, siehe Parameter-Referenz-Dokumentation. Wenn Sie diese Werte nicht angeben, bevor Sie Ihre Natural-Sitzung starten, werden Sie dazu aufgefordert, wenn Sie diesen Ereignistyp auswählen.
2. Zu Beginn der Sitzung werden die für das Profiler-Tracing ausgewählten Ereignistypen durch den Schlüsselwort-Subparameter EVENT des Profilparameters RDC angegeben. Siehe EVENT - Natural Data Collector-Ereignisse, die aufgezeichnet werden sollen in der Parameter Referenz-Dokumentation. Jede Änderung dieser Standardauswahl gilt für die gesamte Natural-Session.

Um einen Ereignistyp als Filter für Anzeigefunktionen auszuwählen:

• Geben Sie einen beliebigen Schlüssel in das entsprechende Eingabefeld in der Spalte Display ein. Sie müssen mindestens einen Ereignistyp auswählen.

PF-Tasten

Folgende PF-Tasten stehen zur Verfügung:

Beispiel für die Auswahl von Ereignistypen:

Im folgenden Beispiel-Bildschirm werden die folgenden Ereignistypen für das Profiler-Tracing ausgewählt: PL, PS, PT, DB, DA, CB, CA, NS und U. Die Ereignistypen PL, PS, PT, DA, CB, CA und U werden als Filter für Anzeigefunktionen ausgewählt.

10:13:24              ***** NATURAL PROFILER UTILITY *****           2011-03-29
User SAG                   - Select Profiler Events -                79 records
                                                                  Trace stopped

              Collect Display Type Profiler Event
              ------- ------- ---- ----------------------------
                 X       X     PL  Program load
                 X       X     PS  Program start
                 X       X     PT  Program termination
                 X       _     DB  Before database call
                 X       X     DA  After database call
                 _       _     IB  Before terminal I/O
                 _       _     IA  After terminal I/O
                 X       X     CB  Before external program call
                 X       X     CA  After external program call
                 _       _     E   Runtime error
                 X       _     NS  Natural statement
                 X       X     U   User-defined event



Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit                          Reset All               Canc

Trace-Datensätze auflisten (List Trace Records)

Die Funktion List Trace Records wird verwendet, um alle Trace-Datensätze aufzulisten, die im Natural Data Collector-Puffer gesammelt wurden. Zu diesem Zweck wird das Profiler-Tracing gestoppt. Ein Trace-Datensatz kann nur angezeigt werden, wenn der entsprechende Ereignistyp in der Funktion Select Profiler Events (Profiler-Ereignisse auswählen) für die Anzeigefunktionen ausgewählt wurde.

Wenn die Funktion aufgerufen wird, wird der zuerst angezeigte Trace-Datensatz durch das Feld Record from angegeben, siehe Hauptmenü. Zusätzlich ist dieser Trace-Datensatz auch mit einem X und der Trace-Datensatz, der durch das Feld Record to angegeben wird, mit einem Y markiert.

Dieser Abschnitt behandelt die folgenden Themen:

• Struktur der angezeigten Trace-Datensätze
• Navigation
• Auswahl der anzuzeigende Ereignistypen aktualisieren
• Zeilenkommandos
• Lokale Kommandos
• PF-Tasten
• Beispiel für Trace-Datensätze auflisten

Struktur der angezeigten Trace-Datensätze

Jeder Trace-Datensatz wird in einer separaten Zeile angezeigt, die von einem Eingabefeld für Zeilenbefehle (C) eingeleitet wird. Der Datensatz selbst enthält allgemeine und ereignisspezifische Daten:

• Allgemeine Daten umfassen Merkmale, die allen Datensätzen gemeinsam sind.

  Zum Beispiel Datensatznummer (Record), Ereignistyp (Ev) oder Ereigniszeit (Time).

• Ereignisspezifische Daten umfassen Merkmale, die für eine Ansicht spezifisch sind, d.h. eine Gruppe verwandter Ereignisse.

  Beispielsweise bilden die Ereignistypen PL, PS und PT die Ansicht Program Load/Start/Termination. Die Ansicht General Information umfasst alle Ereignistypen und deckt die allgemeinen Daten ab.

Die folgende Tabelle gibt einen Überblick über die verfügbaren Ansichten und die damit verbundenen Ereignistypen:

Anmerkungen:

1. General Information (G) ist standardmäßig die aktuelle Ansicht.
2. Wenn es eine Ansicht gibt, für die kein anzuzeigender Ereignistyp ausgewählt wurde, wird der Buchstabencode für diese Ansicht durch ein Minuszeichen (-) ersetzt.

Navigation

Die Liste der Trace-Datensätze, die von der Funktion List Trace Records (Datensätze auflisten) angezeigt werden, kann hinsichtlich Größe der angezeigten Datensätze und Anzahl der aufgelisteten Datensätze recht umfangreich sein.

Dieser Abschnitt behandelt die folgenden Optionen:

• Navigation innerhalb eines Datensatzes
• Innerhalb einer Liste von Datensätzen navigieren

Navigation innerhalb eines Datensatzes

Um innerhalb eines Datensatzes zu navigieren, müssen Sie die aktuelle Ansicht ändern.

Um die aktuelle Ansicht zu ändern:

• Markieren Sie mit dem Cursor in View einen Buchstabencode und drücken Sie Enter. In der obigen Tabelle finden Sie verfügbare Buchstabencodes.

  Oder:
  Drücken Sie PF10 (<), um die benachbarte Ansicht auf der linken Seite auszuwählen. Drücken Sie PF11 (>), um die benachbarte Ansicht auf der rechten Seite auszuwählen.

Innerhalb einer Liste von Datensätzen navigieren

Um innerhalb einer Liste von Datensätzen zu navigieren:

• Geben Sie eine Datensatznummer in das Eingabefeld Record ein, um auf dem entsprechenden Trace-Datensatz zu positionieren. Beachten Sie, dass der ausgewählte Trace-Datensatz einen Ereignistyp haben muss, der in der Funktion Select Profiler Events (Profiler-Ereignisse auswählen) für die Anzeigefunktionen ausgewählt wurde.

  Oder:
  Geben Sie einen Ereignistyp in das Eingabefeld Ev ein, um zum nächsten Trace-Datensatz zu gelangen, der mit einem solchen Ereignistyp markiert ist. Drücken Sie von dieser Position aus weiterhin Enter, um zum nächsten übereinstimmenden Vorkommen zu gelangen. Verwenden Sie Stern-Notation (*), um eine Gruppe von Ereignistypen zu wählen, z.B. D* für alle Datenbankaufrufe.

  Oder:
  Drücken Sie PF6 (--), PF7 (-), PF8 (+) oder PF9 (++), um in der Liste zu blättern.

Auswahl der anzuzeigende Ereignistypen aktualisieren

Eine Auswahl von Ereignistypen für Anzeigefunktionen kann durch Drücken von PF4 (DiEv) aktualisiert werden. Dies öffnet ein Menü ähnlich dem Menü, das bei der Auswahl der Funktion Select Profiler Events (Profiler-Ereignisse auswählen) geöffnet wird, mit der Ausnahme, dass Ereignistypen nur für Anzeigefunktionen ausgewählt werden können. Siehe PF-Tasten in Profiler-Ereignisse auswählen.

Zeilenkommandos

Sie können ein Zeilenkommando in der Spalte C neben dem von Ihnen ausgewählten Trace-Datensatz eingeben. Folgende Zeilenkommandos stehen zur Verfügung:

Lokale Kommandos

Sie können ein lokales Kommando in der Kommandozeile Command eingeben. Die folgenden lokalen Kommandos stehen zur Verfügung:

PF-Tasten

Folgende PF-Tasten stehen zur Verfügung:

Beispiel für Trace-Datensätze auflisten

Das folgende Menü listet Trace-Datensätze für die Ereignistypen PL, PS, PT und DA auf, die im Beispiel für Beispiel für Ereignistypauswahl ausgewählt wurden, und zeigt Trace-Informationen für die Ansicht P an, die die ereignisspezifischen Daten der Ereignistypen PL, PS und PT abdecken.

10:13:39              ***** NATURAL PROFILER UTILITY *****           2011-03-29
User SAG                    - List Trace Records -                   79 records
                      View:  G P D - C - - U
                             PL/PS/PT - Program Load/Start/Termination

  C Record Ev Library  Program  Type DBID  FNR
  - ______ __ -------- -------- ---- ----- -----
X _ 000001 PL SYSEXPG  DYNAMX06
  _ 000002 PS SYSEXPG  DYNAMX06  P      10  2430
  _ 000010 PL SYSEXPG  DYNAMX05
  _ 000011 PS SYSEXPG  DYNAMX05  N      10  2430
  _ 000018 PT SYSEXPG  DYNAMX05  N      10  2430
  _ 000025 PT SYSEXPG  DYNAMX06  P      10  2430
  _ 000026 PL SYSEXPG  EDITMX02
  _ 000027 PS SYSEXPG  EDITMX02  P      10  2430
  _ 000031 DA
  _ 000040 DA
  _ 000047 DA
  _ 000054 DA
  _ 000057 PT SYSEXPG  EDITMX02  P      10  2430
Use PF10/PF11 to show event-specific data of the trace records.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help  Disp  Exit  DiEv  Struc --    -     +     ++    <     >     Canc

Trace-Datensatz anzeigen (Display Trace Record)

Die Funktion Display Trace Record wird verwendet, um alle Tracing-Informationen für jeden Trace-Datensatz separat anzuzeigen. Zu diesem Zweck wird das Profiler-Tracing gestoppt. Wenn die Funktion aufgerufen wird, wird der zuerst angezeigte Trace-Datensatz durch das Feld Record from angegeben, siehe Hauptmenü.

Dieser Abschnitt behandelt die folgenden Themen:

• Navigation
• PF-Tasten
• Beispiel:

Navigation

Um zu einem anderen Trace-Datensatz zu navigieren:

• Geben Sie eine Datensatznummer in das Eingabefeld Record ein, um auf dem entsprechenden Trace-Datensatz zu positionieren. Beachten Sie, dass der ausgewählte Trace-Datensatz einen Ereignistyp haben muss, der von der Funktion Select Profiler Events (Profiler-Ereignisse auswählen) für die Anzeigefunktionen ausgewählt wurde.

  Oder:
  Drücken Sie PF6 (--), PF7 (-), PF8 (+) oder PF9 (++), um durch die angezeigten Trace-Datensätze zu blättern.

PF-Tasten

Folgende PF-Tasten stehen zur Verfügung:

Beispiel:

Im folgenden Beispiel wird der Trace-Datensatz 10, der bereits im Beispiel für Trace-Datensätze auflisten aufgeführt wurde, mit allen Trace-Informationen angezeigt.

10:14:01              ***** NATURAL PROFILER UTILITY *****           2011-03-29
User SAG                    - Display Trace Record -                 79 records


Record / Event .... 10____  /  PL - Program load

Event time ........ 10:12:14.130696    Elapsed time ....... 0.000157
CPU time .......... 0
Current user ID ... SAG                Current group ID ...
Current program ... DYNAMX06           Library ............ SYSEXPG
Program level .....                    Program line ....... 0160

Loaded program .... DYNAMX05           Invocation type .... CALLNAT
Library ........... SYSEXPG






Enter required record number, or use PF6 - PF9 for paging.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit              --    -     +     ++                Canc

Profiler-Tracing starten/stoppen

Diese Funktion wird verwendet, um die Profil-Erstellung ein- oder auszuschalten. Wenn das Profiler-Tracing aktiv war, wird es gestoppt. Umgekehrt, wenn es inaktiv war, wird es gestartet. Der neue Status wird in der Kopfzeile des Hauptmenüs angezeigt.

Um das Profiler-Tracing zu starten oder zu stoppen:

• Geben Sie T in das Feld Code ein und drücken Sie Enter.

Trace-Datensätze drucken

Die Funktion Print Trace Records wird verwendet, um die Trace-Datensätze innerhalb des Bereichs zu drucken, der durch die Eingabefelder Record from und Record to definiert ist. Zu diesem Zweck wird das Profiler-Tracing gestoppt. Beachten Sie, dass ein Trace-Datensatz nur gedruckt werden kann, wenn der entsprechende Ereignistyp für die Anzeigefunktionen in der Funktion Select Profiler Events (Profiler-Ereignisse auswählen) ausgewählt wurde.

Um Trace-Datensätze zu drucken:

1. Geben Sie P in das Feld Code ein.

   Es wird ein separates Fenster geöffnet, in dem Sie den (Standard-) Druckernamen oder den Bereich der zu druckenden Trace-Datensätze ändern können. Sie können auch angeben, ob die Trace-Datensätze mit Header-Informationen gedruckt werden. Der verwendete Drucker wird durch die Arbeitsdatei 1 (print file 1) identifiziert.

2. Drücken Sie Enter.

Trace Records herunterladen (Download Trace Records)

Die Funktion Download Trace Records dient dazu, die Trace-Datensätze innerhalb des Bereichs herunterzuladen, der durch die Eingabefelder Record from und Record to definiert ist. Dazu wird das Profiler-Tracing gestoppt. Beachten Sie, dass ein Trace-Datensatz nur heruntergeladen werden kann, wenn der entsprechende Ereignistyp in der Funktion Select Profiler Events (Profiler-Ereignisse auswählen) für die Anzeigefunktionen ausgewählt wurde.

Um Trace-Datensätze herunterzuladen:

1. Geben Sie W in das Feld Code ein.

   Es wird ein separates Fenster geöffnet, in dem Sie den Bereich der herunterzuladenden Trace-Datensätze ändern können. Die verwendete Download-Datei wird durch die Arbeitsdatei 7 (work file 7) identifiziert. Zum Herunterladen auf den PC empfehlen wir Ihnen, Natural Connection zu verwenden.

2. Drücken Sie Enter.

   Anmerkungen:

   1. Geben Sie .htm als Erweiterung der heruntergeladenen Datei an.
   2. Wir empfehlen Ihnen, MS Excel zu verwenden, um die heruntergeladenen Trace-Datensätze anzuzeigen. Dies erfordert, dass MS Excel und Natural kompatible Einstellungen haben, z. B. in Bezug auf das verwendete Dezimalzeichen.

Daten als Ressource speichern (Save Data as Resource)

Die Funktion Save Data as Resource dient dazu, alle Trace-Datensätze in einer Profiler-Ressourcendatei (Erweiterung .nprf) zu speichern. Dazu wird die Profiler-Nachverfolgung gestoppt.

Die Profiler-Ressourcendatei kann aus NaturalONE von der Profiler Rich GUI-Schnittstelle und von der Profiler Utility im Batch-Modus gelesen werden. Die Tools bieten eine Performance-Analyse (Hot Spots) und andere Auswertungen. Weitere Informationen finden Sie in der NaturalONE-Dokumentation und unter Profiler Utility im Batch-Modus benutzen.

Anmerkungen:

1. Wenn die Profiler Utility unter CICS oder Com-plete ausgeführt wird, wird nur die verstrichene (elapsed) Zeit angegeben, aber nicht die CPU-Zeit.
2. Die von der Profiler Utility im Online-Modus gesammelten Ereignisdaten enthalten keine Copycode-Informationen.

Um die Daten als Ressource zu speichern:

1. Geben Sie B in das Feld Code ein.

   Es wird ein separates Fenster geöffnet, in dem Sie den (Standard-)Ressourcennamen und die Library ändern können. Sie können außerdem angeben, ob die Ressource ersetzt werden soll, falls sie bereits vorhanden ist.

   Der Standard-Ressourcenname ist *INIT-USER_yyyymmdd_hhiiss, wobei *INIT-USER die Benutzerkennung ist, unter der die Natural-Session ausgeführt wird, und yyyymmdd_hhiiss das aktuelle Datum und die aktuelle Uhrzeit ist. Wenn die Erweiterung .nprf (Natural Profiler-Ressourcendatei) nicht mit dem Ressourcennamen angegeben wurde, wird sie automatisch hinzugefügt.

   Die Standard-Library ist die aktuelle Library.

2. Drücken Sie Enter.