Call Statistics Maintenance (Statistiken über gerufene Objekte)

#### Search Results

Search

# Call Statistics Maintenance (Statistiken über gerufene Objekte)

Mit dieser Funktion erhalten Sie Statistikinformationen darüber, welche Natural-Objekte während der Ausführung einer Anwendung gerufen wurden und wie oft ein Objekt gerufen wurde. Die Call-Statistikinformationen werden nach dem Zurücksetzen der Debug-Umgebung gelöscht.

Um die Funktion Call Statistics Maintenance aufzurufen:

- Geben Sie Im Menü Debug Main Menu den Funktionscode `C` ein.

  Oder:
  Geben Sie folgendes Direktkommando ein:

      CS

  Das Menü Call Statistics Maintenance wird angezeigt.

Die im Menü Call Statistics Maintenance zur Verfügung stehenden Funktionen werden in den folgenden Abschnitten erklärt. Alle zugehörigen Druckfunktionen sind jedoch im Abschnitt Objekte drucken beschrieben.

- Test-Modus ON/OFF setzen

- Call-Statistik ON/OFF setzen

- Alle Objekte anzeigen

- Aufgerufene Objekte anzeigen

- Nicht aufgerufene Objekte anzeigen

- Objekte drucken

## Test-Modus ON/OFF setzen

Siehe Abschnitt Test-Modus ein- und ausschalten.

## Call-Statistik ON/OFF setzen

Wenn während der Ausführung eines Natural-Objekts die Funktion Call Statistics auf `ON` gesetzt ist, werden alle Calls, die an ein bestimmtes Objekt gehen, gezählt und die resultierenden Statistikinformationen können anschließend angezeigt oder gedruckt werden.

Um die Funktion Call Statistics auf ON oder OFF zu setzen:

- Geben Sie im Menü Call Statistics Maintenance den Funktionscode `C` ein, um alle Call-Statistiken zu aktivieren oder zu deaktivieren.

  Oder:
  Geben Sie folgendes Direktkommando ein:

      SET CALL ON

  oder

      SET CALL OFF

Anmerkung
Ist die die Funktion Call Statistics ausgeschaltet und wurde keine Call-Statistik erstellt oder wurden alle Call-Statistiken durch Zurücksetzen der Debug-Umgebung gelöscht, dann werden die für Statements-Ausführungsstatistik gespeicherten Informationen (siehe Statement Execution Statistics Maintenance (Statistiken über ausgeführte Statement-Zeilen)) für die Anzeige verwendet. Damit können Sie die während der Ausführung einer Natural-Anwendung nicht aufgerufenen Natural-Objekte auffinden.

## Alle Objekte anzeigen

Diese Funktion liefert eine Übersicht über die Aufrufhäufigkeit (Call Frequency) aller in einer Library enthaltenen Objekte.

Um die Aufrufhäufigkeit (Call Frequency) aller in einer Library enthaltenen Objekte anzuzeigen:

- Geben Sie im Menü Call Statistics Maintenance den Funktionscode `1` und einen Library-Namen ein.

  Oder:
  Geben Sie folgendes Direktkommando ein:

      DISPLAY OBJECT library

  Siehe auch die Syntax des Direktkommandos `DISPLAY` in Debug-Kommandoübersicht und -syntax.

  Wenn Sie keinen Library-Namen angeben, wird standardmäßig die Library angenommen, bei der Sie gerade angemeldet sind.

  Der Bildschirm Display Called Objects erscheint. Siehe Beispiel für Display Called Objects weiter unten.

  Der Bildschirm Display Called Objects enthält eine Auflistung aller Objekte in der angegebenen Library und zeigt in der Spalte Calls (ganz rechts) ihre Aufrufhäufigkeit. Für jedes Call-Statement, z.B. `FETCH` oder `CALLNAT` wird ein Eintrag mit dem Namen und einer Zählervariablen in den Debug-Pufferspeicher geschrieben. Der Zähler wird dann bei jedem Aufruf (Call) des entsprechenden Objekts erhöht.

## Aufgerufene Objekte anzeigen

Der von dieser Funktion aufgerufene Bildschirm entspricht dem Display Call Statistics-Bildschirm, es werden jedoch nur diejenigen Objekte angezeigt, die aufgerufen worden sind.

Um aufgerufene Objekte einer Library anzuzeigen:

- Geben Sie im Menü Call Statistics Maintenance den Funktionscode `2` und einen Library-Namen ein.

  Oder:
  Geben Sie folgendes Direktkommando ein:

      DISPLAY CALL library

  Siehe auch die Syntax des Direktkommandos `DISPLAY` in Debug-Kommandoübersicht und -syntax.

  Der Bildschirm Display Called Objects erscheint (Beispiel):

      16:06:53              ***** NATURAL TEST UTILITIES *****             2002-02-15
      Test mode ON              - Display Called Objects -
                                                                               All
      Object   Library  Type         DBID   FNR S/C Ver Cat Date   Time       Calls
      *_______ SAG_____
      MAINPGM  SAG      Program        10    32 S/C 3.1 2002-02-15 11:51          1
      SUBPGM   SAG      Subprogram     10    32 S/C 3.1 2002-02-15 11:50          3
      EMP-PGM  SAG      Program        10    32 S/C 3.1 2002-01-22 11:49          2
      EMPLIND  SAG      Program        10    32 S/C 3.1 2001-08-13 11:18          1

Wenn Sie keinen Library-Namen angeben, wird standardmäßig die Library angenommen, bei der Sie gerade angemeldet sind.

## Nicht aufgerufene Objekte anzeigen

Der von dieser Funktion aufgerufene Bildschirm entspricht dem Display Call Statistics-Bildschirm, es werden jedoch nur diejenigen Objekte angezeigt, die nicht aufgerufen worden sind.

Um nicht aufgerufene Objekte anzuzeigen:

- Geben Sie im Menü Call Statistics Maintenance den Funktionscode `3` und einen Library-Namen ein.

  Oder:
  Geben Sie folgendes Direktkommando ein:

      DISPLAY NOCALL library

  Siehe auch die Syntax des Direktkommandos `DISPLAY` in Debug-Kommandoübersicht und -syntax.

Wenn Sie keinen Library-Namen angeben, wird standardmäßig die Library angenommen, bei der Sie gerade angemeldet sind.

Siehe Beispiel-Bildschirm für Display Called Objects.

## Objekte drucken

Mit den Druckfunktionen können Sie eine generierte Liste der Aufrufstatistiken direkt an einen Drucker weiterleiten oder die Liste auf einen PC herunterladen. Sie geben einen Drucker als Ausgabegerät im Bildschirm User Profile (Benutzerprofil) des Debuggers an. Benutzen Sie das Debugger-Kommando `PROFILE` (siehe Abschnitt Kommandos zum Navigieren und Anzeigen von Informationen), um diesen Bildschirm aufzurufen.

Wenn Sie keinen Library-Namen angeben, wird standardmäßig die Library angenommen, bei der Sie gerade angemeldet sind.

Wie unter Druckoptionen weiter unten angegeben, können Sie zum Aufrufen einer Druckfunktion entweder einen Funktionscode im Menü Statement Execution Statistics Maintenance, ein Zeilenkommando im Bildschirm Display Statement Lines oder ein Direktkommando an der Eingabeaufforderung eingeben.

### Druckoptionen

Druckfunktion | Funktionscode | Direktkommando
--- | --- | ---
All Objects (alle Objekte) | 4 | `PRINT OBJECT library`
Called Objects (gerufene Objekte) | 5 | `PRINT CALL library`
Non-Called Objects (nicht gerufene Objekte) | 6 | `PRINT NOCALL library`

Siehe auch die Syntax des Direktkommandos `PRINT` in Debug-Kommandoübersicht und -syntax.

#### Verwandtes Thema

- Beispiel für das Erstellen und Drucken von Statistiken im Batch-Modus im Abschnitt Batch-Verarbeitung

### Beispiel für einen PC Download

Wenn in Ihrer Umgebung die Produkte Entire Connection und Natural Connection installiert sind, können Sie, wie nachfolgend beschrieben, eine Statistikliste auf einen PC herunterladen.

Um eine Liste auf einen PC herunterzuladen:

1. Beim Start der Sitzung: Geben Sie den Profilparameter `PRINT` folgendermaßen ein:

       PRINT=((1),AM=PC)

2. Nach dem Start der Sitzung: Benutzen Sie das folgende Terminalkommando, um die Verbindung zum PC zu aktivieren:

       %+

3. Rufen Sie den Debugger auf und aktivieren Sie ihn.

4. Rufen Sie den Bildschirm User Profile auf, indem Sie das Debugger-Kommando `PROFILE` eingeben (siehe Kommandos zum Navigieren und Anzeigen von Informationen).

5. Ersetzen Sie im Bildschirm User Profile im Feld Output device den aktuellen Eintrag durch `PCPRNT01` und drücken Sie PF3 (Exit), um die Einstellungen zu speichern.

6. Aktivieren Sie die Funktion Call Statistics und führen Sie die Anwendung aus, für die der Debugger Statistikdaten sammeln soll.

7. Wählen Sie im Statistik-Bildschirm eine Druckfunktion aus.

   In dem Entire Connection-Fenster, das dann erscheint, können Sie die Ausgabedatei und das PC-Verzeichnis angeben.

### On this page

- Test-Modus ON/OFF setzen
- Call-Statistik ON/OFF setzen
- Alle Objekte anzeigen
- Aufgerufene Objekte anzeigen
- Nicht aufgerufene Objekte anzeigen
- Objekte drucken