DAT_MOVE - Move object

Description:

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

Invocation:

CALL DAT_MOVE( LOC1, LOC2, NAME, STATUS )

Arguments:

LOC1 = CHARACTER * ( DAT__SZLOC ) (Given and Returned)

Object locator. A value of DAT__NOLOC is returned.

LOC2 = CHARACTER * ( DAT__SZLOC ) (Given)

Structure locator.

NAME = CHARACTER * ( DAT__SZNAM ) (Given)

Component name.

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

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.