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