|
dbname
Name of the database of the realm for which realm extension is to be performed.
realmref
Number of the realm for which extension is to be performed. All realm numbers are permissible except those for the DBCOM.
no-pages
Number of database pages by which the realm is to be extended.
no-pages=0, 64 ... 16777215
Please note that up to 64 PAM pages may possibly be requested in addition if one or more new FPA extents are needed to manage the newly added pages.
The special specification no-pages=0 enables a previous EXTEND REALM request to be revoked, but only if execution has not already begun. As no further EXTEND REALM is outstanding after such a request cancelation, no further message is displayed.
The EXTEND REALM command allows you to perform a one-off realm extension by the specified number of pages during the next free page search irrespective of whether no more free pages are available or only fewer free pages than the limit value specified using ACT INCR. This command does not require a PERFORM statement.
For the EXTEND REALM command to execute successfully it is necessary for the administrator to have assigned the realm adequate storage space or a secondary allocation greater than 0.
The command can also be executed if ONLINE realm extension is not activated with ACT INCR.
After the extension has been performed (whether successfully or not), the unconditional realm extension is concluded, but any ONLINE realm extension activated with ACT INCR is still retained.
When an EXTEND REALM command is issued, the previous EXTEND REALM command is replaced by the newer one provided execution of the previous EXTEND REALM command has not yet begun, i.e. the size specified most recently is used for the extension.
Irrespective of no-pages, a realm extension takes place at most up to the maximum possible number of database pages in the realm.
Execution of the EXTEND REALM command is acknowledged with a corresponding message.
The EXTEND REALM command is rejected immediately in the following cases:
The dbname database is not attached.
The realm number realmref does not exist.
The realm number of the DBCOM was specified as the realm number.
The specified realm is not attached.