next up previous 199
Next: AMS_PLOOKUP - Look up a taskname given a path to it
Up: Function Descriptions
Previous: AMS_KICK - Send a KICK message to this task.


AMS_PATH - Get a communications path to another task

Invocation:
(void)ams_path( other_task_name, path, status )

Arguments:

other_task_name = char * (given)
name of task to which path is required

path = int * (returned)
the path number

status = int * (given and returned)
global status


Description:
Open a path to the task whose name is 'other_task_name' and return the path index in 'path'. The other task may be local or remote, indicated by a name of the form machine::name, where :: may be any of the permitted separator pairs and defines the ADAMNET process to be used.

Implementation:
A temporary transaction acknowledge queue is obtained, a MESSYS__INIT message sent via the path just obtained, and the reply obtained.

If this short transaction fails to complete, the path and any associated transactions are freed; otherwise the path (index) is returned.




next up previous 199
Next: AMS_PLOOKUP - Look up a taskname given a path to it
Up: Function Descriptions
Previous: AMS_KICK - Send a KICK message to this 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