Next: DAT_REFCT - Enquire the reference count for a container file
Up: ROUTINE DESCRIPTIONS
Previous: DAT_PUTVx - Write vectorised primitive
- 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: 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