AMS_PLOOKUP

Look up a taskname given a path to it

Invocation

(void)ams_plookup( path, name, status )

Arguments

path = int (given)
the path number

name = char * (returned)

the task name

status = int * (given and returned)

global status

Description:

Returns the name of the task connected via the given path.

If the task is remote, a name of the form xxxxx::yyyyyy is returned, where xxxxxx:: is the machine and ADAMNET indicator, and yyyyyy is the task name.

Implementation

Given a path ’path’, we check that the path is legal and then use it to ascertain whether the path is linked to a remote task or a local task. A name of the appropriate form is returned.