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:
Operating the Software AG Editor in der Operations-Dokumentation
EDBP - Software AG Editor Buffer Pool-Definitionen und EDPSIZE - Größe des Software AG Editor-Hilfs-Buffer-Pool in der Parameter-Referenz-Dokumentation
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.
Dieser Abschnitt beschreibt, wie Sie die SYSEDT Utility aufrufen und eine SYSEDT-Funktion ausführen.
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.
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 (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 (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 (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.
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
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. |
Um Parameterwerte zu ändern:
Drücken Sie im Bildschirm Generation Parameters PF5 (Update/Ändern).
Die schreibgeschützten Felder neben den Parametern werden zu Eingabefeldern.
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).
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. |
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. |
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. |
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.
Um 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
(.).
Sie können Online-Hilfe-Informationen zu allen verfügbaren SYSEDT-Direktkommandos oder zu der aktuell verwendeten Funktion erhalten.
Um 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.
Um 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.