LAPI_Resume_totask Subroutine

Purpose

Re-enables the sending of messages to the task.

Library

Availability Library (liblapi_r.a)

C Syntax

#include <lapi.h>
 
int LAPI_Resume_totask(hndl, dest)
lapi_handle_t hndl;
uint    dest; 

FORTRAN Syntax

include 'lapif.h'
 
int LAPI_RESUME_TOTASK(hndl, dest, ierror)
INTEGER hndl
INTEGER dest
INTEGER ierror

Description

Type of call: recovery

This subroutine is used in conjunction with LAPI_Purge_totask. It enables LAPI communication to be reestablished for a task that had previously been purged. The purged task must either restart LAPI or execute a LAPI_Purge_totask/LAPI_Resume_totask sequence for this task.

Parameters

INPUT

hndl

Specifies the LAPI handle.

dest

Specifies the destination instance ID with which to resume communication.

OUTPUT

ierror

Specifies a FORTRAN return code. This is always the last parameter.

Restrictions

Use of this subroutine is not recommmended on a system that is running Parallel Environment (PE).

Return Values

LAPI_SUCCESS

Indicates that the function call completed successfully.

LAPI_ERR_HNDL_INVALID

Indicates that the hndl passed in is not valid (not initialized or in terminated state).

LAPI_ERR_TGT

Indicates that the tgt passed in is outside the range of tasks defined in the job.

Location

/usr/lib/liblapi_r.a