FTAM/9000 Programmer's Guide

Chapter 6 257
Managing HP FTAM/9000 Connections
Establishing and Removing Connections
Establishing and Removing Connections
Use the ft_connect(), ft_rrequest(), and ft_aereset() functions to connect,
release connections, and reset connections in an orderly manner.
ft_connect()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_connect(ae_label, return_event_name, called_dir_name,
input_dcb, inout_dcb, connection_id)
Ae_label ae_label;
Local_event_name return_event_name;
Ae_dir_name called_dir_name;
struct Ft_connect_in_dcb *input_dcb;
struct Ft_connect_out_dcb **inout_dcb;
Connection_id *connection_id;
Use ft_connect() to establish a connection from ftam_init to an FTAM
responder. Remember, you must first invoke ft_aeactivation() to start
ftam_init.
You will use the returned connection_id on all subsequent, context
sensitive FTAM calls to uniquely identify the connection to the desired
filestore.
• When invoking ft_connect(), the document types, functional_units,
and service_classes are negotiated with the responder. When the
request is complete, check these fields in the inout_dcb to see if the
responder accepted these values, accepted a subset of these values, or
rejected these values.
• You must set either the input_dcb->called_presentation_address or
the called_dir_name. If you set both fields,
input_dcb->called_presentation_address takes precedence. Refer to
the “FTAM Data Structures” chapter to set either of these
parameters.
Specifying these fields requires that you set up the appropriate
structures. You can do so manually (as explained in the “FTAM Data
Structures” chapter) or you can call one of the following utilities.
• To have the system set the P_address, call convert_paddr; the source
is in /opt/ftam/demos/cnvrt_addr.c.