Next: HDS_RUN - Run an HDS application subroutine
Up: OBSOLETE ROUTINES
Previous: DAT_TUNE - Set HDS parameter
- Description:
Annul the locator associated with the top-level object in a
container file, decrement the container file reference count by
one and close the file if the reference count reaches zero. If
the file is closed, all other locators associated with it (both
primary and secondary) will also be annulled.
- Invocation:
CALL HDS_CLOSE( LOC, STATUS )
- Arguments:
-
LOC = CHARACTER * ( DAT__SZLOC ) (Given)
-
Locator to the container file's top-level object.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
This routine is obsolete - its behaviour is flawed because it
does not recognise that some top-level locators are not
associated with a container file reference count (those created
with DAT_CLONE, for instance). HDS_CLOSE will always decrement
the reference count and, hence, may close a container file while
it is still in use via other locators. The dependence on
top-level locators to hold a container file open has been
superceded by the more general primary/secondary locator
attribute (see DAT_PRMRY) and the role previously played by
HDS_CLOSE is now incorporated in DAT_ANNUL.
Next: HDS_RUN - Run an HDS application subroutine
Up: OBSOLETE ROUTINES
Previous: DAT_TUNE - Set HDS parameter
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