next up previous
Next: HDS_RUN - Run an HDS application subroutine
Up: OBSOLETE ROUTINES
Previous: DAT_TUNE - Set HDS parameter

HDS_CLOSE - Close container file   

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 up previous
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