### 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

Object locator.
##### NLEV = INTEGER (Returned)
Number of path levels.
##### PATH = CHARACTER $\ast$ ( $\ast$ ) (Returned)
Object path name within container file.
##### FILE = CHARACTER $\ast$ ( $\ast$ ) (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)