Performing a relocation (RELOCATE)

---

RELOCATE

---

The RELOCATE statement sends a RELOCATE DML to the DBH which executes the relocation of records and tables.

The number of relocations to be performed with a DML is determined by the PAGES-PER-DML parameter in the SET-RELOCATE-PARAMETERS statement (see section “Defining the properties of a RELOCATE DML (SET-RELOCATE-PARAMETERS)”).

The DML returns a status code which is available in the predefined variables RCODE and STATUSCODE (see section “Predefined variables”). In addition, when the DML terminates normally the predefined variables RELOCDESTINATION, RELOC-ORIGIN, RELOC-FREED-PAGES and RELOC-LOCKED-PAGES are supplied with values and can be used to control - among other things - the progress of the relocation.