next up previous
Next: DAT_REFCT - Enquire the reference count for a container file
Up: ROUTINE DESCRIPTIONS
Previous: DAT_PUTVx - Write vectorised primitive

DAT_REF - Obtain a reference for an HDS object   

Description:
The routine returns a "reference name" for an HDS object whose locator is supplied. This name identifies the object uniquely by including both the name of the container file and the "path name" which locates the object within this file. If a locator to a cell or a slice is supplied, then subscript information will also be included. Appropriate syntax is used to represent file names which do not have the standard `.sdf' file extension.

Invocation:
CALL DAT_REF( LOC, REF, LREF, STATUS )

Arguments:
LOC = CHARACTER * ( DAT__SZLOC ) (Given)
Locator to the HDS object.
REF = CHARACTER * ( * ) (Returned)
The object's reference name.
LREF = INTEGER (Returned)
Number of significant characters in the reference name.
STATUS = INTEGER (Given and Returned)
The global status.



next up previous
Next: DAT_REFCT - Enquire the reference count for a container file
Up: ROUTINE DESCRIPTIONS
Previous: DAT_PUTVx - Write vectorised primitive

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