|
dbname
Name der Datenbank des Realms, für den die Realmerweiterung durchgeführt werden soll.
realmref
Nummer des Realms, für den die Erweiterung durchgeführt werden soll. Zulässig sind alle Realm-Nummern außer derjenigen für den DBCOM.
nr-pages
Anzahl von Datenbankseiten, um die der Realm erweitert werden soll.
nr-pages=0, 64 ... 16777215
Beachten Sie bitte, dass gegebenenfalls bis zu 64 PAM-Seiten zusätzlich angefordert werden, falls zur Verwaltung der neu hinzukommenden Seiten ein oder mehrere neue FPA-Extents benötigt werden.
Mit der speziellen Angabe nr-pages=0 kann ein vorheriger EXTEND REALM-Auftrag zurückgenommen werden, allerdings nur, wenn nicht schon mit der Ausführung begonnen wurde. Da nach einer derartigen Auftragsrücknahme kein EXTEND REALM mehr ansteht, wird keine weitere Meldung ausgegeben.
Mit dem Kommando EXTEND REALM können Sie bei der nächsten Freiplatzsuche eine einmalige Realmerweiterung um die angegebene Seitenzahl durchführen lassen, unabhängig davon, ob keine freien Seiten mehr oder nur noch weniger freie Seiten als der per ACT INCR spezifizierte Grenzwert verfügbar sind. Das Kommando erfordert keine PERFORM-Anweisung.
Für die erfolgreiche Ausführung des EXTEND REALM-Kommandos ist es notwendig, dass der Administrator dem Realm genügend Speicherplatz oder eine Sekundärzuweisung größer 0 zugewiesen hat.
Das Kommando kann auch dann ausgeführt werden, wenn die ONLINE-Realmerweiterung nicht mit ACT INCR aktiviert ist.
Nach der durchgeführten Erweiterung (ob mit oder ohne Erfolg) ist die unbedingte Realmerweiterung erledigt, eine evtl. mit ACT INCR aktivierte ONLINE-Realmerweiterung bleibt aber weiterhin aktiviert.
Wird ein EXTEND REALM-Kommando abgesetzt, solange für ein vorheriges EXTEND REALM-Kommando noch nicht mit der Ausführung begonnen wurde, so wird das vorherige EXTEND REALM-Kommando durch das neuere ersetzt, d.h. die Erweiterung findet mit der zuletzt angegebenen Größe statt.
Unabhängig von nr-pages erfolgt eine Realmerweiterung höchstens bis zur Anzahl maximal möglicher Datenbankseiten im Realm.
Die Ausführung des EXTEND REALM-Kommandos wird mit einer entsprechenden Meldung quittiert.
Das Kommando EXTEND REALM wird in den folgenden Fällen sofort zurückgewiesen:
die Datenbank dbname ist nicht zugeschaltet.
die Realm-Nummer realmref existiert nicht.
als Realm-Nummer wurde die Realm-Nummer des DBCOM angegeben.
der angegebene Realm ist nicht zugeschaltet.