next up previous
Next: DAT_MSG - Assign the name of an HDS object to a message token
Up: ROUTINE DESCRIPTIONS
Previous: DAT_MOULD - Alter object shape

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.



next up previous
Next: DAT_MSG - Assign the name of an HDS object to a message token
Up: ROUTINE DESCRIPTIONS
Previous: DAT_MOULD - Alter object shape

HDS Hierarchical Data System
Starlink User Note 92
R.F. Warren-Smith & M.D. Lawden
23rd February 1999
E-mail:rfws@star.rl.ac.uk

Copyright (C) 1999 Central Laboratory of the Research Councils