RDB/VMS RMU/ALTER AREA-PAGE — VMS RDB_4.0B
Specifies a storage area or a storage page of the current attached database that you intend to alter, or both.
Additional information available:
Format
AREA ──┬─> storage-area-name ───┬─┬───────────>─────────┬─ └─> storage-area-number ─┘ └─>
P
A
G
E page-number ─┘
Additional information available:
storage-area-namestorage-area-numberpage-number
storage-area-name
Specifies an area of the current database by the storage area name, which is the name given by the AREA clause in the database.
storage-area-number
Specifies an area of the current database by the storage area number, which is assigned when the database is created and is given on the first line of a page display.
page-number
Identifies the page to be altered. Express it as an integer from 1 to the number of pages in the area.
More
Only one page of one area is accessible to RdbALTER at a time. This command switches you from one page of the currently attached database to another. When you ATTACH to a database, RdbALTER automatically makes Area 1 the current area and Page 1 of that area the current page. To work on any other area and page, you must use the AREA...PAGE command. If you specify AREA but not PAGE, RdbALTER makes the area you specify current and fetches Page 1 of that area. If you specify both AREA and PAGE, RdbALTER makes the area you specify current and fetches the page you specify from the new current area. If you specify an area or page that does not exist, an error occurs.
Examples
Example 1 The following example specifies the area JOBS of the currently attached database. No page number has been specified, so RdbALTER fetches page 1 of the area. RdbALTER> AREA JOBS Example 2 The following example is similar to the previous example, except it specifies the area by its area number instead of its area name. If area 4 is the area named JOBS in the database, either command produces the same result. RdbALTER> AREA 4 Example 3 The following example fetches area 3, page 100. RdbALTER> AREA 3 PAGE 100