Trace the path of an object and return the fully resolved name as a text string.

CALL HDS_TRACE( LOC, NLEV, PATH, FILE, STATUS )

LOC = CHARACTER $\ast$ ( DAT__SZLOC ) (Given)

NLEV = INTEGER (Returned)

PATH = CHARACTER $\ast$ ( $\ast$ ) (Returned)

FILE = CHARACTER $\ast$ ( $\ast$ ) (Returned)

STATUS = INTEGER (Given and Returned)

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)