Move an object to a new location (ie. copy and erase the original).

CALL DAT_MOVE( LOC1, LOC2, NAME, STATUS )

LOC1 = CHARACTER $\ast$ ( DAT__SZLOC ) (Given and Returned)

LOC2 = CHARACTER $\ast$ ( DAT__SZLOC ) (Given)

NAME = CHARACTER $\ast$ ( DAT__SZNAM ) (Given)

STATUS = INTEGER (Given and Returned)

If the object is an array, loc1 must point to the complete array, not a slice or cell. loc1 is annulled if the operation is successful (if it is the last primary locator associated with a container file, then the container file will be closed – see DAT_PRMRY). The operation will fail if a component of the same name already exists in the structure. The object to be moved need not be in the same container file as the structure.