Utility Statements › EXPAND PAGE › Usage

Usage

How EXPAND PAGE works

A page at a time from the old file is read. The page is expanded adding the new space before the footer section of the page. The space management entry for the page is adjusted to reflect the added space. The space management pages are also expanded, but they continue to have the same number of entries as before.

How to submit the EXPAND PAGE statement

You submit the EXPAND PAGE statement only through the batch command facility. You must be running CA IDMS/DB in local mode. You must also vary affected areas to retrieval mode or offline in all currently executing DC/UCF systems.

If an area maps to more than one file

You can expand pages in only one file at a time. If you are expanding the pages for an area that maps to more than one file, you must run the EXPAND PAGE utility once for each file the area is associated with.

Regenerate DMCL modules

After running the EXPAND PAGE utility, you must:

• Alter the page size of the area to the new page size in all files where the area is used. Please remember that you should only change the PAGE SIZE on the ALTER AREA segment, because altering the PRIMARY SPACE even to the current value can result in any EXTEND SPACE attribute being removed.
• Regenerate all DMCLs containing the file's segment.

The pages are expanded but the space management pages are not relocated. Therefore, when you redefine an area whose page size has been expanded, you must use the ORIGINAL PAGE SIZE clause of the AREA statement.