Die Funktion RESET macht Modifikationen von Fensterseiten rückgängig, die einem durch SPAN und OFFSET definierten Dateibereich angehören.
Dies geschieht so, dass eine modifizierte Seite in ihren Initialzustand gebracht wird, was zur Folge hat, dass sie bei einem Zugriff aus der Datei gelesen wird. Gehört die Seite zu einem mit DISPOS=*UNCHNG definierten Fenster, wird sie bei einem Zugriff nur dann aus der Datei gelesen, wenn sie schon einmal durch SAVE in die Datei geschrieben wurde, sonst wird sie mit X'00' initialisiert.
Durch die Angabe RELEASE=*YES werden alle Seiten des definierten Bereichs (nicht nur modifizierte Seiten) in ihren Initialzustand gebracht. Dies bietet die Möglichkeit, einen durch einen parallelen Schreiber erzeugten neuen Zustand der Dateiseiten in Fenstern erscheinen zu lassen.
Von der Funktion RESET werden nur die nachfolgend beschriebenen Funktionsoperanden ausgewertet.
Format FCT=*RESET
Operation | Operanden |
|
|
| |
| |
|
Operandenbeschreibung
FCT
Bestimmt die auszuführende DIV-Funktion.
Bei der Form MF=L ist nur die direkte Angabe erlaubt.
= *RESET
Mit der DIV-Funktion RESET werden Modifikationen von Fensterseiten rückgängig gemacht, die einem durch SPAN und OFFSET definierten Dateibereich angehören (ausführliche Beschreibung siehe "Funktion RESET").
= adr
Ist die symbolische Adresse eines 1 Byte langen Feldes, das den Wert für die Funktion RESET enthält (Feld DIVPRES, siehe Layout der der Parameterliste, "Funktion CLOSE").
= (r)
Ist ein Register, das den Wert für die Funktion RESET enthält.
ID
Mit ID wird der OPEN spezifiziert, für den die Funktion RESET ausgeführt werden soll.
Wird dieselbe Parameterliste benutzt wie bei OPEN, ist die Angabe von ID nicht erforderlich, da sich dann die Identifikation des OPEN bereits in der Parameterliste befindet.
Wird eine andere Parameterliste benutzt wie bei OPEN, kann durch ID die Identifikation zur Verfügung gestellt und in die neue Parameterliste übertragen werden (mit der Form MF=M des Makros DIV).
Bei der Form MF=L kann ID nicht angegeben werden.
= adr
Ist die symbolischen Adresse eines 8 Byte langen Feldes, das die Identifikation enthält.
= (r)
Ist ein Register mit der Adresse des 8 Byte langen Feldes.
MACID
Zu MACID siehe Beschreibung beim Format FCT=*OPEN, "Funktion OPEN".
MF
Die Formen des MF-Operanden sind detailliert im Anhang ("Typen von Makroaufrufen") beschrieben.
OFFSET
OFFSET spezifiziert zusammen mit SPAN den Dateibereich im Fenster, für den die Fensterseiten in ihren Initialzustand zurückgesetzt werden sollen.
OFFSET spezifiziert den Beginn des Dateibereiches. Mit OFFSET wird angegeben, ab welchem Block (ab welcher 4-KB-Seite) der Dateibereich beginnt.
SPAN gibt an, aus wie vielen 4-KB-Blöcken der Dateibereich (Bereichslänge) bestehen soll.
Auf alle Fensterseiten des mit OFFSET und SPAN definierten Dateibereichs wird die RESET-Funktion angewendet.
Voreinstellung: OFFSET = 0
Falls für SPAN kein Wert angegeben ist (oder SPAN = 0), wird der Bereich so gewählt, dass die letzte Seite des letzten Fensters im Bereich enthalten ist. Falls weder OFFSET noch SPAN spezifiziert ist, werden also alle Seiten aller für den OPEN definierten Fenster berücksichtigt.
Bei der Form MF=L ist nur die direkte Angabe erlaubt.
= anzahl
Gibt die Länge des Dateibereiches in 4-KB-Blöcken an. Der Wert für OFFSET ist begrenzt durch die maximale Größe einer Datei in 4-KB-Seiten minus 1:
0 <= anzahl <= 8388606 bei LARGE_FILE=*FORBIDDEN
0 <= anzahl <= 1073741823 bei LARGE_FILE=*ALLOWED
= adr
Ist die symbolische Adresse eines 4 Byte langen Feldes, das die Länge des Dateibereiches in 4-KB-Blöcken (binär) enthält.
= *equ
Ist ein Equate, das die Länge des Dateibereiches in 4-KB-Blöcken (binär) angibt. Dem Namen des Equates muss das Zeichen „*“ vorausgehen.
= (r)
Ist ein Register, das die Länge des Dateibereiches in 4-KB-Blöcken (binär) enthält.
PARAM
Zu PARAM siehe Beschreibung beim Format FCT=*OPEN, "Funktion OPEN".
PREFIX
Zu PREFIX siehe Beschreibung beim Format FCT=*OPEN, "Funktion OPEN".
RELEASE
Durch den Operanden RELEASE wird angegeben, ob nur modifizierte Seiten in den Initialzustand gebracht werden sollen.
Voreinstellung: RELEASE=*NO
Bei der Form MF=L ist nur die direkte Angabe erlaubt.
= *NO
Alle modifizierten Seiten werden in den Initialzustand gebracht.
Dies hat zur Folge, dass bei einem Zugriff auf eine solche Seite die entsprechende Seite aus der Datei gelesen wird, wenn sie in einem mit DISPOS=*OBJECT definierten Fenster liegt. Liegt die Seite in einem mit DISPOS=*UNCHNG definierten Fenster, wird sie bei einem Zugriff mit X'00' initialisiert, wenn sie noch nicht durch SAVE in die Datei geschrieben wurde, sonst wird sie bei einem Zugriff aus der Datei gelesen.
Eine Seite im Initialzustand, die hinter der logisch letzten Seite der Datei liegt, erscheint bei einem Zugriff immer mit X'00' initialisiert.
= *YES
Alle Fensterseiten – geänderte wie nicht geänderte – im angegebenen Bereich werden in den Initialzustand gebracht, mit den oben beschriebenen Folgen.
= adr
Ist die symbolische Adresse eines 1 Byte langen Feldes, das einen Wert für RELEASE enthält (DIVPRNO | DIVPRYES; siehe Layout der Parameterliste, "Funktion CLOSE").
= (r)
Ist ein Register, das einen Wert für RELEASE enthält.
SPAN
SPAN definiert zusammen mit OFFSET den Dateibereich, auf den sich die RESET-Funktion bezieht.
Voreinstellung: SPAN = 0
Zur Beschreibung von SPAN siehe auch Beschreibung beim Operanden OFFSET.
Bei der Form MF=L ist nur die direkte Angabe erlaubt.
= anzahl
Gibt die Länge des Dateibereiches in 4-KB-Blöcken an. Der Wert für SPAN ist begrenzt durch die maximale Größe einer Datei in 4-KB-Seiten:
0 <= anzahl <= 8388607 bei LARGE_FILE=*FORBIDDEN
0 <= anzahl <= 1073741824 bei LARGE_FILE=*ALLOWED
= adr
Ist die symbolische Adresse eines 4 Byte langen Feldes, das die Länge des Dateibereiches in 4-KB-Blöcken (binär) enthält.
= *equ
Ist ein Equate, das die Länge des Dateibereiches in 4-KB-Blöcken (binär) angibt. Dem Namen des Equates muss das Zeichen „*“ vorausgehen.
= (r)
Ist ein Register, das die Länge des Dateibereiches in 4-KB-Blöcken (binär) enthält.