Profiler Utility im Online-Modus benutzen

#### Search Results

Search

# Profiler Utility im Online-Modus benutzen

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:

Ereignis | Ereignistyp | Auftreten des Ereignisses
--- | --- | ---
Program Load | PL | Wenn ein Programm (Natural-Objekt) geladen wird oder wenn es sich bereits im Bufferpool befindet.
Program Start | PS | Wenn ein Programm (Natural-Objekt) gestartet wird.
Program Termination | PT | Wenn ein Programm (Natural-Objekt) beendet wird.
Before Database Call | DB | Bevor ein Datenbankaufruf ausgeführt wird.
After Database Call | DA | Nachdem ein Datenbankaufruf ausgeführt worden ist.
Before Terminal I/O | IB | Bevor eine Terminal-Ein-/Ausgabe ausgeführt wird.
After Terminal I/O | IA | Nachdem eine Terminal-Ein-/Ausgabe ausgeführt worden ist.
Before External Program Call | CB | Bevor ein externer Programmaufruf (`CALL`-Statement) ausgeführt wird.
After External Program Call | CA | Nachdem ein externer Programmaufruf (`CALL`-Statement) ausgeführt worden ist.
Runtime Error | E | Wenn ein Natural-Laufzeitfehler aufgetreten ist.
Natural Statement | NS | Wenn ein Natural-Statement ausgeführt wird. Aus technischen Gründen gibt es keine Eins-zu-Eins-Beziehung zwischen einem Natural-Quellcode-Statement und einem Objektcode im katalogisierten Objekt. Daher können mehrere Natural-Statement zu einem `NS`-Ereignis zusammengeführt werden, und umgekehrt kann ein Natural-Statement mehrere `NS`-Ereignisse abdecken.
User-Defined Event | U | Wenn ein benutzerdefiniertes Ereignis mit dem Natural-Statement `CALL 'CMRDC' 'U'` generiert wird (siehe Benutzerdefinierte Ereignisse in der SYSRDC Utility-Dokumentation). Das erste Byte der Benutzerdaten wird als Subtyp interpretiert. Daher wird ein zweibuchstabiger Code für ein benutzerdefiniertes Ereignis angezeigt, wenn die Trace-Datensätze aufgelistet werden.

## 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.

Anmerkung
Beim Start der Session werden die für Anzeigefunktionen ausgewählten Ereignistypen durch den Schlüsselwort-Subparameter `EVENT` des Profilparameters `RDC` (siehe oben) angegeben. Jede Änderung dieser Standardauswahl ist bis zum nächsten `LOGON` gültig. Danach ist der Satz der ausgewählten Ereignistypen gleich dem Satz der Ereignistypen, die für das Profiler-Tracing ausgewählt wurden (siehe oben).

#### PF-Tasten

Folgende PF-Tasten stehen zur Verfügung:

PF-Taste | Name | Funktion
--- | --- | ---
PF1 | Help (Hilfe) | Zeigt die kontextsensitive Hilfe an. Für jedes Eingabefeld gibt es einen spezifischen Hilfetext. In anderen Kontexten, z. B. in der Kommandozeile, wird ein allgemeiner Hilfetext angezeigt.
PF3 | Exit (Verlassen) | Aktuelles Menü verlassen.
PF8 | Reset (Zurücksetzen) | Auswahl aller Ereignistypen rückgängig machen.
PF9 | All (Alle) | Alle Ereignistypen auswählen.
PF12 | Canc (Abbruch) | Aktuelles Menü verlassen.

#### 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` and `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:

Ansicht | Code | Ereignistypen
--- | --- | ---
General Information | G | Alle
Program Load/Start/Termination | P | PL, PS, PT
Before/After Database Call | D | DB, DA
Before/After Terminal I/O | I | IB, IA
Before/After External Program Call | C | CB, CA
Runtime Error | E | E
Natural Statement | N | NS
User-Defined Event | U | U

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 | Funktion
--- | ---
`D` | Alle für den ausgewählten Datensatz verfügbaren Informationen anzeigen. Siehe Trace-Datensätze anzeigen.
`X` | Wenn Sie die Zeile mit einem X markieren, wird der Inhalt des Feldes Record from im Hauptmenü entsprechend aktualisiert.
`Y` | Wenn Sie die Zeile mit einem Y markieren, wird der Inhalt des Feldes Record to im Hauptmenü entsprechend aktualisiert.

#### Lokale Kommandos

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

Lokales Kommando | Funktion
--- | ---
`X` | Blättern bis zur Zeile, die mit einem X markiert ist (und im Feld Record from angezeigt wird).
`Y` | Blättern bis zur Zeile, die mit einem Y markiert ist (und im Feld Record from angezeigt wird).

#### PF-Tasten

Folgende PF-Tasten stehen zur Verfügung:

PF-Taste | Name | Funktion
--- | --- | ---
PF1 | Help (Hilfe) | Kontextsensitive Hilfe anzeigen. Siehe oben.
PF2 | Disp (Anzeigen) | Alle Informationen anzeigen, die für den ausgewählten Trace-Datensatz verfügbar sind. Siehe auch Trace-Datensätze anzeigen.
PF3 | Exit (Verlassen) | Aktuelles Menü verlassen.
PF4 | DiEv (Ändern) | Auswahl der anzuzeigenden Ereignistypen ändern. Siehe Abschnitt Auswahl der anzuzeigenden Ereignistypen aktualisieren.
PF5 | Hex (Hexadezimal) | Benutzerdaten im Hexadezimalmodus anzeigen (nur für Ereignistyp U).
Struc (Struktur) | Programmstruktur anzeigen (nur für die Ereignistypen PL, PS und PT).
PF6 | -- | Zum Anfang der Liste blättern.
PF7 | - | Eine Seite nach oben blättern.
PF8 | + | Eine Seite nach unten blättern.
PF9 | ++ | Zum Ende der Liste blättern.
PF10 | < | Ansicht auf der linken Seite der aktuellen Ansicht auswählen.
PF11 | > | Ansicht auf der rechten Seite der aktuellen Ansicht auswählen.
PF12 | Canc (Abbruch) | Aktuelles Menü verlassen.

#### 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:

PF-Taste | Name | Funktion
--- | --- | ---
PF1 | Help | Kontextsensitive Hilfe anzeigen. Siehe oben.
PF3 | Exit | Aktuelles Menü verlassen.
PF5 | Hex | Benutzerdaten im Hexadezimalmodus anzeigen (nur für Ereignistyp U).
PF6 | -- | Ersten Trace-Datensatz anzeigen.
PF7 | - | Vorherigen Trace-Datensatz anzeigen.
PF8 | + | Nachfolgenden Trace-Datensatz anzeigen.
PF9 | ++ | Letzten Trace-Datensatz anzeigen.
PF10 | LongE | Langtext einer Fehlermeldung anzeigen (nur für den Ereignistyp E definiert).
PF12 | Canc | Aktuelles Menü verlassen.

#### 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.

Anmerkung
Alternativ können Sie auch die im Abschnitt Trace Recording-Funktion der SYSRDC Utility-Dokumentation beschriebenen Kommandos verwenden.

### 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.

### On this page

- Voraussetzungen
- Profiler Utility im Online-Modus aufrufen und beenden
- Ereignisse (Events)
- Funktionen