SYSEDT Utility

Das Dienstprogramm SYSEDT (im Folgenden "SYSEDT Utility") bietet Verwaltungsfunktionen für den Editor Buffer Pool, der als Datencontainer für den Software AG Editor dient. Die SYSEDT Utility kann für Folgendes verwendet werden:

  • Anzeigen von Parametern und Laufzeitinformationen des Editor Buffer Pools.

  • Ändern von Parametern zur Steuerung und Initialisierung des Editor Buffer Pools und seiner Arbeitsdatei.

  • Löschen von logischen Arbeitsdateien und Wiederherstellungsdateien.

Die Dokumentation für die SYSEDT Utility ist in folgende Kapitel gegliedert:

Verwandte Dokumente:


Library-Profil für Natural Security definieren

Wenn bei Ihnen Natural Security verwendet wird, müssen Sie ein Library-Sicherheitsprofil (Library Security Profile) für das Dienstprogramm SYSEDT erstellen.

Weitere Informationen siehe Library Maintenance in der Natural Security-Dokumentation.

SYSEDT Utility aufrufen und eine Funktion ausführen

Dieser Abschnitt beschreibt, wie Sie die SYSEDT Utility aufrufen und eine SYSEDT-Funktion ausführen.

Beginn der Anweisungsliste Um die SYSEDT Utility aufzurufen:

  • Geben Sie das folgende Natural-System-Kommando ein:

    SYSEDT

    Es erscheint das SYSEDT-Hauptmenü (Main Menu).

    Beispiel:

     15:47:50             ***** NATURAL SYSEDT UTILITY *****             2009-01-29
     User MMO                       - Main Menu -                    TID 1     33  
                                                                                   
                                                                                   
                                                                                   
                        Code   Function                                            
                                                                                   
                          G    General Information                                 
                          P    Generation Parameters                               
                          U    Users                                               
                          F    Logical Files                                       
                          R    Recovery Files                                      
                          A    Administration Facilities                           
                          .    Exit                                                
                                                                                   
                 Code ..                                                           
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
    Command ===>                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
    Cont  Help  Menu  Exit        Admin Files Users Recov       GInfo Parms Canc

    Im Hauptmenü verfügbare Funktionen werden in anschließenden Kapiteln beschrieben.

Beginn der Anweisungsliste Um eine SYSEDT-Funktion auszuführen:

  • Geben Sie im Feld Code des SYSEDT-Hauptmenüs den aus einem einzelnen Zeichen bestehenden Code ein, der der auszuführenden Funktion entspricht, und drücken Sie Enter. Zum Beispiel:

    G

    Die Funktion General Information (Allgemeine Informationen) wird ausgeführt.

    Oder:
    Drücken Sie im SYSEDT-Hauptmenü die PF-Taste, die der Funktion entspricht, die Sie ausführen möchten. Zum Beispiel:

    PF10 (GInfo)

    Die Funktion General Information (Allgemeine Informationen) wird ausgeführt.

    Oder:
    Geben Sie das Systemkommando SYSEDT gefolgt von einem beliebigen Funktionscode aus dem SYSEDT-Hauptmenü ein. Zum Beispiel:

    SYSEDT G

    Die Funktion General Information (Allgemeine Informationen) wird ausgeführt.

    Eine Liste aller verfügbaren SYSERR-Direktbefehle finden Sie in der Hilfefunktion, die unter Hilfe zu Direktkommandos und Menüfunktionen beschrieben ist.

General Information - Allgemeine Informationen

Diese Funktion ruft den Bildschirm General Information auf, der einen Überblick über den aktuellen Status des Editor Buffer Pools gibt. Die auf dem Bildschirm vorhandenen Felder werden in der folgenden Tabelle beschrieben. Ausführliche Informationen zu diesen Feldern finden Sie unter Editor Work File und Editor Buffer Pool in der Operations-Dokumentation.

Feld Beschreibung
Usage Statistics   Nutzungsstatistik

Die aktuell verfügbare Gesamtzahl, die aktuell genutzte Anzahl und der aktuell genutzte Prozentsatz der verfügbaren Anzahl der nachfolgenden Elemente.

Buffer Pool Blocks   Buffer Pool-Blöcke

Die Anzahl der Blöcke im Editor Buffer Pool. Siehe auch Obtaining Free Blocks.*

Work File Records Arbeitsdatei-Datensätze

Die Anzahl der Datensätze in der Arbeitsdatei des Editors. Siehe auch Editor Work File.*

Control   Steuerung

Die Anzahl der Steuerungsdatensätze, die immer eins ist. Siehe auch Control Record.*

Work Work-Sätze

Die Anzahl der Work-Datensätze. Siehe auch Work Record .*

Recovery Wiederherstellung

Die Anzahl der Wiederherstellungssätze. Siehe auch Recovery Records.*

Logical Files   Logische Dateien

Die Anzahl der logischen Dateien.

Requests   Anforderungen

Die Gesamtzahl der Lese- und Schreibanforderungen, die Anzahl der Lese- und Schreibanforderungen für Buffer Pool-Blöcke (Spalte Pool) und die Anzahl der Lese- und Schreibanforderungen für Work- oder Recovery-Dateien (Spalte File). Die Spalte Copy zeigt die Leseanforderungen, die (im Gegensatz zu den gesperrten Leseanforderungen) zur Löschung des entsprechenden Puffer Pool-Blocks führen.

Read Work Anzahl der Leseanforderungen

Die Anzahl der Leseanforderungen für logische Dateisätze. Ein logischer Dateisatz kann sich im Buffer Pool (Spalte Pool) oder in der Arbeitsdatei (Spalte File) befinden. Er kann durch eine gesperrte oder eine Kopieranforderung gelesen werden: gesperrt bedeutet, dass der Datensatz für eine bestimmte Zeit im Buffer Pool gehalten wird; kopieren bedeutet, dass er aus dem Buffer Pool gelöscht wird, nachdem er gelesen wurde.

Write Work Anzahl der Schreibanforderungen

Die Anzahl der Schreibanforderungen für logische Dateisätze. Ein Datensatz kann entweder in den Buffer Pool (Pool) geschrieben oder in die Arbeitsdatei (File) verschoben werden, wenn keine freien Blöcke verfügbar sind.

Read Recovery Wiederherstellungssätze lesen

Die Anzahl der Leseanforderungen für Wiederherstellungssätze in der Arbeitsdatei des Editors.

Write Recovery Wiederherstellungssätze schreiben

Die Anzahl der Schreibanforderungen für Wiederherstellungsdatensätze in der Arbeitsdatei des Editors.

Timeout Values in Seconds   Zeitüberschreitungswerte

Elemente mit Timeout-Werten, die in Sekunden angegeben werden. Diese Timeout-Werte können nach Drücken von PF5 (Update/Ändern) geändert und nach erneutem Drücken von PF5 (Save/Speichern) dynamisch gesetzt werden. Die geänderten Werte werden bei einem Neustart des Buffer Pool nicht beibehalten. Stattdessen werden die Werte aus dem Workfile-Steuerungsdatensatz verwendet. Siehe auch Obtaining Free Blocks.*

Logical Files   Löschung logischer Dateien

Die Zeit, nach der eine logische Datei gelöscht wird, wenn während dieser Zeit nicht auf sie zugegriffen wurde.

Files Delete Check Löschung aller Dateien

Die Zeit, nach der alle logischen Dateien periodisch überprüft werden, ob sie gelöscht werden können.

Changed Blocks Geänderte Blöcke

Die Zeit, nach der Blöcke, die geändert wurden, durch Schreiben in die Arbeitsdatei freigegeben werden können.

Unchanged Blocks Unveränderte Blöcke

Die Zeit, nach der Blöcke, die nicht verändert wurden, durch Schreiben in die Arbeitsdatei freigegeben werden können.

Locked Blocks Gesperrte Blöcke

Die Zeit, nach der Blöcke, die mit gesperrt gelesen wurden, durch Schreiben in die Arbeitsdatei freigegeben werden können.

* Beschreibung siehe Operations-Dokumentation

Generation Parameters - Generierungs-Parameter

Die Funktion Generation Parameters ruft einen Bildschirm auf, der die aktuellen Parametereinstellungen des Editor-Buffer-Pools anzeigt. Sie können die vorhandenen Parameterwerte ändern.

Parameter Beschreibung
DDNAME   Der Name der Editor-Arbeitsdatei für die JCL-Definition.
DSNAME   Der Name des Dataset (Datei) der Arbeitsdatei.

Dieser Parameter wird in einer Com-plete- oder z/VSE-Batch-Umgebung nicht angezeigt.

RECNUM   Die Gesamtzahl der Sätze der Arbeitsdatei.
LRECL   Die Länge der Arbeitsdatei-Datensätze.
PWORK   Der Prozentsatz der Arbeitsdatei-Datensätze, die als Arbeitsdatei-Datensätze verwendet werden.
RWORK   Der Prozentsatz der für reguläre logische Dateien verwendeten Arbeitsdatensätze.
MAXLF   Die maximale Anzahl der logischen Dateien im Editor Buffer-Pool.
FTOUT   Der Timeout-Wert (in Sekunden), nach dem eine logische Datei, auf die nicht zugegriffen wurde, gelöscht werden soll.
DTOUT   Die Zeitspanne (in Sekunden), in der logische Dateien auf Löschung geprüft werden sollen.
CTOUT   Der Timeout-Wert (in Sekunden) für geänderte Buffer Pool-Blöcke.
UTOUT   Der Timeout-Wert (in Sekunden) für unveränderte Buffer Pool-Blöcke.
LTOUT   Der Timeout-Wert (in Sekunden) für gesperrte Buffer Pool-Blöcke.
ITOUT   Der Timeout-Wert (in Sekunden) für die Buffer Pool-Initialisierung.

Bei den oben genannten Parametern handelt es sich um Schlüsselwort-Subparameter des Profilparameters EDBP (oder des entsprechenden Makros NTEDBP), der zur Definition der anfänglichen Editor Buffer Pool-Einstellungen verwendet wird.

Ausführliche Informationen zu EDBP und allen verfügbaren Schlüsselwort-Subparametern finden Sie unter EDBP - Software AG Editor Buffer Pool-Definitionen in der Parameter-Referenz-Dokumentation.

Die Spalte Start auf dem Bildschirm Generation Parameters bezieht sich auf den Neustart des Buffer Pools (siehe auch Initializing the Editor Buffer Pool in der Operations-Dokumentation).

Die folgenden Startwerte können für die Parameter angezeigt werden:

Wert Beschreibung
L   Der Wert für den entsprechenden Parameter wird entweder aus dem Editor-Parametermodul oder aus der Arbeitsdatei-Definition übernommen.
C   Eine Änderung des entsprechenden Parameterwertes erzwingt einen Kaltstart des Buffer Pool. Wiederherstellungssätze gehen verloren.
W   Eine Änderung des entsprechenden Parameterwerts führt zu einem Warmstart des Buffer Pool. Wiederherstellungssätze werden beibehalten.

Beginn der AnweisungslisteUm Parameterwerte zu ändern:

  1. Drücken Sie im Bildschirm Generation Parameters PF5 (Update/Ändern).

    Die schreibgeschützten Felder neben den Parametern werden zu Eingabefeldern.

  2. Ersetzen Sie den/die gewünschten Parameterwert(e) und drücken Sie PF5 (Save/Speichern), um die neuen Werte im Steuerungsdatensatz der Editor-Arbeitsdatei zu speichern. Sie werden aktiviert, wenn der Editor Buffer Pool erneut gestartet wird.

    Wenn Sie den Wert von PWORK ändern, werden Sie in einem Fenster aufgefordert, den Kaltstart der Editor-Arbeitsdatei zu bestätigen. Geben Sie YES ein, um den neuen Parameterwert zu bestätigen und einen Buffer Pool-Kaltstart für die Initialisierung der Arbeitsdatei durchzuführen. (Jede andere Eingabe oder keine Eingabe setzt den Parameter auf seinen vorherigen Wert zurück).

Users - Benutzer

Die Funktion Users ruft einen Bildschirm auf, der die folgenden Informationen enthält:

Spalte Beschreibung
User ID   Die Natural-Benutzerkennung.
Logical Files   Die Anzahl der logischen Dateien, die pro Benutzer definiert sind.
Pool Blocks   Die Anzahl der Buffer Pool-Blöcke pro Benutzer.
Work Records   Die Anzahl der Arbeitsdatensätze pro Benutzer.
Recovery Files   Die Anzahl der Wiederherstellungsdateien pro Benutzer.
Recovery Records   Die Anzahl der Wiederherstellungsdatensätze pro Benutzer.

Bei jedem aufgeführten Benutzer können Sie eines der folgenden Zeilenkommandos ausführen. Geben Sie das Zeilenkommando in der Spalte C neben dem gewünschten Benutzer ein.

Zeilenkommando Beschreibung
?

oder

*
Öffnet ein Fenster mit einer Liste aller gültigen Zeilenkommandos und den entsprechenden PF-Tasten, falls vorhanden.
. Bewirkt das Verlassen des aktuellen Bildschirms und Rückkehr zum vorherigen Bildschirm.
/

oder

P
Setzt die Zeile an den oberen Rand des Bildschirms.
F   Wählt die logischen Dateien dieses Benutzers aus.
R   Wählt die Wiederherstellungsdateien dieses Benutzers aus.
D   Löscht alle logischen Dateien und/oder Wiederherstellungsdateien für diesen Benutzer.

Logical Files - Logische Dateien

Die Funktion Logical Files ruft einen Bildschirm auf, der die folgenden Informationen enthält:

Spalte Beschreibung
File No.   Die Nummer der logischen Datei.
User ID   Die Natural-Benutzerkennung.
Type   Der Typ der logischen Datei.
Pool Blks   Die Anzahl der Buffer Pool-Blöcke, die derzeit pro logischer Datei verwendet werden.
File Recs   Die Anzahl der aktuell pro logischer Datei zugewiesenen Arbeitsdateisätze.
Last Access   Das Datum und die Uhrzeit der letzten Lese- oder Schreibanforderung pro logischer Datei.

Bei jeder aufgeführten logischen Datei können Sie eines der folgenden Zeilenkommandos ausführen. Geben Sie das Zeilenkommando in der Spalte C neben dem gewünschten Benutzer ein.

Zeilenkommando Beschreibung
?

oder

*
Öffnet ein Fenster mit einer Liste aller gültigen Zeilenkommandos und den entsprechenden PF-Tasten, falls vorhanden.
. Bewirkt das Verlassen des aktuellen Bildschirms und Rückkehr zum vorherigen Bildschirm.
/

oder

P
Positioniert die Zeile an den oberen Rand des Bildschirms.
S   Wählt die logischen Dateien dieses Benutzers aus.
D   Löscht die logische Datei.

Recovery Files - Wiederherstellungsdateien

Die Funktion Recovery Files ruft einen Bildschirm auf, der die folgenden Informationen enthält:

Column Beschreibung
User ID   Die Natural-Benutzerkennung.
Member   Der Name des Library Members.
Library   Der Name der Library.
Type   Der Library-Typ.
Recs   Die Anzahl der Wiederherstellungsdatensätze pro Wiederherstellungsdatei.
Creation Date Das Datum der Erstellung der Wiederherstellungsdatei.
Creation Time Die Uhrzeit der Erstellung der Wiederherstellungsdatei.

Bei jeder aufgeführten Wiederherstellungsdatei können Sie eines der folgenden Zeilenkommandos ausführen. Geben Sie das Zeilenkommando in der Spalte C neben dem gewünschten Benutzer ein.

Zeilenkommando Beschreibung
?

oder

*
Öffnet ein Fenster mit einer Liste aller gültigen Zeilenkommandos und den entsprechenden PF-Tasten, falls vorhanden.
. Bewirkt das Verlassen des aktuellen Bildschirms und Rückkehr zum vorherigen Bildschirm.
/

oder

P
Positioniert die Zeile an den oberen Rand des Bildschirms.
S   Wählt die Wiederherstellungsdateien dieses Benutzers aus.
D   Löscht die Wiederherstellungsdatei.

Administration Facilities - Verwaltungsfunktionen

Die Funktion Administration Facilities ruft einen Bildschirm auf, den Sie benutzen können, um den Editor Buffer Pool oder die Utility SYSEDT zu beenden oder den Inhalt des Editor Buffer Pool zur Problemdiagnose im Dump-Format (hexadezimal) anzuzeigen.

Beginn der AnweisungslisteUm den Bildschirm Administration Facilities zu benutzen:

  • Beenden Sie den Editor Buffer Pool, indem Sie den Funktionscode T eingeben.

    Es erscheint ein Fenster, in dem Sie zur Bestätigung aufgefordert werden:

    • Wenn Sie YES eingeben, öffnet sich ein zusätzliches Fenster, in dem Sie gefragt werden, ob der Editor Buffer Pool sofort neu gestartet werden soll oder nicht.

      Wenn Sie erneut YES eingeben, wird der Buffer Pool sofort neu gestartet, was Ihnen die Möglichkeit gibt, geänderte Generierungsparameter sofort zu aktivieren.

      Wenn Sie NO eingeben, verlassen Sie die Utility SYSEDT und können Aktionen außerhalb Ihrer TP-Umgebung durchführen, z.B. die Größe Ihrer Editor-Arbeitsdatei ändern.

    Oder:
    Zeigen Sie den Speicherauszug (Dump) des Editor Buffer Pool an, indem Sie den Funktionscode D eingeben.

    Die Offsets und Adressen des Editor Buffer Pool werden auf dem Bildschirm angezeigt.

    Drücken Sie bei Bedarf PF10 (RelO), um den Offset 00000000 an den oberen Rand des Bildschirms zu setzen. PF1 (Help) ruft eine Liste aller verfügbaren PF-Tasten auf.

    Oder:
    Rückkehr zum SYSEDT-Hauptmenü durch Eingabe eines Punktes (.).

Hilfe zu Direktkommandos und Menüfunktionen

Sie können Online-Hilfe-Informationen zu allen verfügbaren SYSEDT-Direktkommandos oder zu der aktuell verwendeten Funktion erhalten.

Beginn der AnweisungslisteUm alle SYSEDT-Direktkommandos anzuzeigen:

  • Geben Sie in der Kommandozeile eines beliebigen SYSEDT-Bildschirms eines der folgenden Zeichen ein:

    ?

    oder

    *

    Alle in der SYSEDT Utility verfügbaren Direktkommandos werden in alphabetischer Reihenfolge aufgelistet.

Beginn der AnweisungslisteUm die Hilfe zu einer bestimmten SYSEDT-Funktion anzuzeigen:

  • Geben Sie in der Kommandozeile eines SYSEDT-Bildschirms, der durch eine SYSEDT-Funktion aufgerufen wurde, Folgendes ein:

    H

    Oder:
    Drücken Sie PF1 (Help).

    Es werden Hilfe-Informationen zu den auf dem aktuellen SYSEDT-Bildschirm enthaltenen Feldern und Spalten angezeigt.