Next: DAT_BASIC - Map primitive as basic units
Up: ROUTINE DESCRIPTIONS
Previous: DAT_ALTER - Alter object size
- Description:
Cancel the association between a locator and an object. Any
primitive value currently mapped to the locator is automatically
unmapped. If the last primary locator associated with a container
file is annulled, then the container file will be closed.
- Invocation:
CALL DAT_ANNUL( LOC, STATUS )
- Arguments:
-
LOC = CHARACTER * ( DAT__SZLOC ) (Given and Returned)
-
Object locator. A value of DAT__NOLOC is returned.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
This routine attempts to execute even if status is set on entry,
although no further error report will be made if it subsequently
fails under these circumstances. In particular, it will fail if
the locator supplied is not valid, but this will only be reported
if status is set to SAI__OK on entry.
Next: DAT_BASIC - Map primitive as basic units
Up: ROUTINE DESCRIPTIONS
Previous: DAT_ALTER - Alter object size
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