Next: DAT_RENAM - Rename object
Up: ROUTINE DESCRIPTIONS
Previous: DAT_REF - Obtain a reference for an HDS object
DAT_REFCT
- Enquire the reference count for a container file
- Description:
The routine returns a count of the number of "primary"
locators
associated with an HDS container file (its reference count). The
file will remain open for as long as this number is greater than
zero.
- Invocation:
CALL DAT_REFCT( LOC, REFCT, STATUS )
- Arguments:
-
LOC = CHARACTER * ( DAT__SZLOC ) (Given)
-
Locator associated with any object in the container file.
-
REFCT = INTEGER (Returned)
-
Number of primary locators currently associated with the file.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
This routine may be used to determine whether annulling a primary
locator will cause a container file to be closed (also see the
routine DAT_PRMRY).
Next: DAT_RENAM - Rename object
Up: ROUTINE DESCRIPTIONS
Previous: DAT_REF - Obtain a reference for an HDS object
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