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 Configuration Store (ICS); they are defined during system configuration 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;
};

Ft_output

struct  Ft_output {
        Uint32                size;
        struct  Api_rc        result;
};

ft_aeactivation() Parameters

ft_aeactivation() Parameter	Type	Description
my_dir_name	Mandatory Input	Directory distinguished name identifying the AE (ftam_init) you want to activate
return_event_name	Mandatory Input	If the call is asynchronous, uniquely identifies the function call; if the call is synchronous, the value is 0 (zero)
input_dcb-> authentication	Optional Input	ftam_init accepts, but ignores, this value
input_dcb-> my_ae_title_option	Optional Input	Dictates the interpretation of my_ae_title If it indicates Dir_dist_name_option, my_dir_name must be usable as an address for the local ftam_init Default is No_value_option
input_dcb-> my_ae_title	Optional Input	Optional ae_title sent to the peer AE, which can be either a directory distinguished name or an object_id; determined by how you set my_ae_title_option
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)
ae_label	Output	Uniquely identifies the AE (ftam_init) that serviced the request

ft_aedeactivation()

#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_aedeactivation(ae_label, return_event_name, inout_dcb)
Ae_label                       *ae_label;
Local_event_name               return_event_name;
struct Ft_output               **inout_dcb;

Use ft_aedeactivation() to deactivate the AE (ftam_init) servicing the request.

Ft_output

struct  Ft_output {
        Uint32                size;
        struct  Api_rc        result;
};

ft_aedeactivation() Parameters

ft_aedeactivation() Parameter	Type	Description
ae_label	Mandatory Input	Uniquely identifies the AE (ftam_init) you want to deactivate
return_event_name	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 and vendor_code (HP-UX—specific error)

Starting and Stopping Application Entities

Technical documentation

» Table of Contents

» Glossary

» Index

ft_aeactivation()

Ft_aeactivation_in_dcb

Ft_output

ft_aeactivation() Parameters

ft_aedeactivation()

Ft_output

ft_aedeactivation() Parameters