FTAM/9000 Programmer's Guide

Chapter 4 177

Using Support Functions

Responding to Asynchronous Calls

Using em_wait()

#include %</opt/ftam/include/map.h>

Return_code

em_wait (timeout, return_event_name, result)

Em_t timeout;

Local_event_name *return_event_name;

Api_rc *result;

This section describes general use of asynchronous calls with em_wait().

For additional details on em_wait(), refer to the HP FTAM/9000

Reference Manual.

Call functions asynchronously when making multiple requests and when

the order in which results are processed does not matter. If you make an

asynchronous call, you can perform other operations while your request

is being processed. Following are examples of when to call functions

asynchronously or synchronously.

• If you cannot call function B before function A completes, you should

call function A synchronously.

• If copying a ﬁle to four different nodes and the processing order does

not matter, you would call ft_copy)) asynchronously and then wait on

the return_event_names to know when each ft_copy() completed

successfully.