Next: HDS_TUNE - Set HDS tuning parameter
Up: ROUTINE DESCRIPTIONS
Previous: HDS_STOP - Close down HDS
- Description:
Trace the path of an object and return the fully resolved name as
a text string.
- Invocation:
CALL HDS_TRACE( LOC, NLEV, PATH, FILE, STATUS )
- Arguments:
-
LOC = CHARACTER * ( DAT__SZLOC ) (Given)
-
Object locator.
-
NLEV = INTEGER (Returned)
-
Number of path levels.
-
PATH = CHARACTER * ( * ) (Returned)
-
Object path name within container file.
-
FILE = CHARACTER * ( * ) (Returned)
-
Container file name.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
The path name is constructed as a sequence of "node"
specifications thus: node.node......node.object such as:
NGC1365.SKYPOS.RA.MINUTES where MINUTES is the name of the object
associated with the specified locator and NGC1365 is the
top-level object in the structure. If any of the nodes are
non-scalar the appropriate subscript expression is included thus:
AAO.OBS(6).IMAGE_DATA If the bottom-level object is a slice or
cell of an array, the appropriate subscript expression is
appended thus: M87.MAP(100:412,200:312) or CENA(3,2)
Next: HDS_TUNE - Set HDS tuning parameter
Up: ROUTINE DESCRIPTIONS
Previous: HDS_STOP - Close down HDS
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