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.