next up previous
Next: HDS_TUNE - Set HDS tuning parameter
Up: ROUTINE DESCRIPTIONS
Previous: HDS_STOP - Close down HDS

HDS_TRACE - Trace object path   

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