Next: DAT_MSG - Assign the name of an HDS object to a message token
Up: ROUTINE DESCRIPTIONS
Previous: DAT_MOULD - Alter object shape
- 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: 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