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.