FTAM/9000 Programmer's Guide

Chapter 6 267
Managing HP FTAM/9000 Connections
Aborting Connections
ft_abort() Parameters
ft_ireceive()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_ireceive(connection_id, return_event_name, inout_dcb,
indication_name)
Connection_id connection_id;
Local_event_name return_event_name;
struct Ft_indication_out_dcb *inout_dcb;
Uint32 *indication_name;
If you receive the FTE003_ABORT_IND_RCVD error, call ft_ireceive()
• to determine whether the abort was caused by the system (initiator,
responder, or network) or by a user, and
• to receive diagnostics.
ft_abort()
Parameter
Type Description
connection_id Mandatory
Input
Uniquely identifies the specific filestore connection
to abort
return_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)
input_dcb->
info.action_result
Mandatory
Input
Conveys the reason for the abort
input_dcb->
info.diagnostic
Optional Input ISO-specific error information; HP-UX responders
accept, but ignore, this value
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 and vendor_code
(HP-UX—specific error)