locate_task_id

Gamma: Version 4.0
Prev |  | Next

# `locate_task_id`

`locate_task_id` -- finds and connects to tasks by task ID and network node.

## Syntax

    locate_task_id (task_id, node_id, channel_id, async_reqd)

## Arguments

`task_id`

  The task ID for this task (as a number).

`node_id`

  The network node number for this task.

`channel_id`

  The task ID for this task. This is required for QNX 6, ignored in QNX 4 and Linux.

`async_reqd`

  t if `locate_task` should automatically call `init_async_ipc` for this task.

## Returns

A task if successful, otherwise nil.

## Description

This function makes a TCP/IP connection or QNX 4 virtual circuit to the named task based on the `task_id` and the `node` number on which the task is running. If `async_reqd` is t, then `init_async_ipc` is also called. If the `node` number is zero, the current node is used.

## Example

Task 1:

        Gamma> init_ipc("Task 1","14");
        t
        Gamma> getpid();
        9271
        Gamma>

Task 2:

        Gamma> init_ipc("Task 2","25");
        t
        Gamma> locate_task_id(9271,1,nil);
        #<Task:9271>
        Gamma>

## See Also

`locate_task`

Prev | Home | Next
`locate_task` | Up | `name_attach`

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.