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.