FTAM/9000 Programmer's Guide

Chapter 4 201
Using Support Functions
Determining Available Resources
ft_nwcleared() Parameters
EXAMPLE: This example shows the use of ft_nwcleared(). The
connection_id and data_unit parameters were
previously set.
Connection_id connection_id;
struct Ft_data_unit data_unit;
Local_event_name sda_event_name, nwc_event_name;
struct Ft_sdata_out_dcb *sda_inout_dcb;
struct Ft_nwcleared_out_dcb *nwc_inout_dcb;
Result_code res;
sda_event_name = 1;
sda_inout_dcb = NULL;
res = ft_sdata(connection_id, & data_unit, sda_event_name, & sda_inout_dcb);
if (res == FTE008_NO_CON_RESOURCES) {
nwc_event_name = 0;
nwc_inout_dcb = NULL;
res = ft_nwcleared(connection_id, nwc_event_name, & nwc_inout_dcb);
if (res == SUCCESS) {
res = ft_sdata(connection_id, & data_unit, sda_event_name,
& sda_inout_dcb);
}
}
ft_nwcleared()
Parameter
Type Description
connection_id Mandatory
Input
Uniquely identifies a specific connection to the
filestore
local_event_na
me
Mandatory
Input
If the call is asynchronous, uniquely identifies the
function call; if the call is synchronous, the value is 0
(zero)
inout_dcb.size Mandatory
input if using
inout_dcb
Size (in Octets) of the inout_dcb structure and data
inout_dcb.result Output Pointer to the struct Api_rc containing the outcome
of the operation: result_code (MAP 3.0 error) and
vendor_code (HP–UX—specific error)