next up previous 199
Next: AMS_RECEIVE - Receive any incoming message
Up: Function Descriptions
Previous: AMS_PATH - Get a communications path to another task


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.



next up previous 199
Next: AMS_RECEIVE - Receive any incoming message
Up: Function Descriptions
Previous: AMS_PATH - Get a communications path to another task

AMS The Unix ADAM Message System
Starlink User Note 241
B D Kelly (ROE)
A J Chipperfield (RAL)
16 August 2001
E-mail:ussc@star.rl.ac.uk

Copyright © 2000 Council for the Central Laboratory of the Research Councils