FTAM/9000 Programmer's Guide

200 Chapter 4

Using Support Functions

Determining Available Resources

While sending data, limited ﬂow control resources may prevent the

operation from completing. This circumstance is indicated by the error

FTE008_NO_CON_RESOURCES returning on ft_sdata() function calls.

To determine when the resource clears, call ft_nwcleared().

ft_nwcleared()

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

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

Return_code

ft_nwcleared (connection_id, local_event_name, inout_dcb)

Connection_id connection_id;

Local_event_name local_event_name;

struct Ft_nwcleared_out_dcb **inout_dcb;

Use ft_nwcleared() to determine when the

FTE008_NO_CON_RESOURCES error condition (on ft_sdata()) clears

and there are enough resources to continue.

• The ft_nwcleared() connection_id must be the same as the connection

that returned the FTE008_NO_CON_RESOURCES error.

• If you invoke ft_nwcleared() synchronously, the function does not

return until a resource is acquired. Though resources clear, there is

no guarantee they will be available for a subsequent ft_sdata()

request.

• If you invoke ft_nwcleared() asynchronously, you cannot call other

functions on that connection_id until the ft_nwcleared() is noted by

em_wait(). If you call another function before ft_nwcleared() is noted,

you are not informed when the resource is available (i.e., the

ft_nwcleared() is revoked).

• When calling ft_sdata() a second time, all parameters must be the

same as those of the initial ft_sdata() request.