FTAM/9000 Programmer's Guide

254 Chapter 6

Managing HP FTAM/9000 Connections

Starting and Stopping Application Entities

Starting and Stopping Application

Entities

Use ft_aeactivation() and ft_aedeactivation() to respectively start and

stop ftam_init.

ft_aeactivation()

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

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

Return_code

ft_aeactivation(my_dir_name, return_event_name, input_dcb,

inout_dcb, ae_label)

Ae_dir_name my_dir_name;

Local_event_name return_event_name;

struct Ft_aeactivate_in_dcb *input_dcb;

struct Ft_output **inout_dcb;

Ae_label *ae_label;

You must invoke ft_aeactivation() before establishing a connection. By

passing my_dir_name (the local ftam_init directory distinguished name)

as input, the interface returns the ae_label of the activated ftam_init.

Note, directory distinguished names are in the Initial Conﬁguration

Store (ICS); they are deﬁned during system conﬁguration and when

nodes are added to the network.

Using my_dir_name requires that you set up Ae_dir_dn. You can do so

manually (as explained in the “FTAM Data Structures” chapter) or you

can call the convert_ddn utility. This utility eases the setting of

Ae_dir_dn by automatically setting it and its sub-structures for you. The

source for convert_ddn is in /opt/ftam/demos/cnvrt_addr.c. (For

instructions, read the on-line README document in this directory.) The

“Example Programs” chapter also contains the source for convert_ddn.

Ft_aeactivation_in_dcb

struct Ft_aeactivate_in_dcb {

struct Octet_string authentication;

enum Ae_title_option my_ae_title_option;

Ae_title *my_ae_title;

};