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)