FTAM/9000 Programmer's Guide

Chapter 9 351
Handling Errors
Using API Tracing
the integer value of the return code for that call. A value of 0 indicates
that there were no errors. If an integer other than 0 is returned, refer to
the /opt/ftam/includei/mapftam.h file to determine which return code
corresponds to the integer, and then refer to the “FTAM return_codes”
chapter of the HP FTAM/9000 Reference Manual for the cause of the
return code and corrective actions you can take.
The following is an example trace file for an HP FTAM session.
Tue Sep 1 08:55:14 1992 ->ft_aeactivation()
my_ae_name = 0x5a718
return_event_name = 0
input_dcb->authentication = NULL
input_dcb->my ae_title_option = User_object_id_option
input_dcb->my ae_title = 0x5a908
Tue Sep 1 08:55:15 1992 %<-ft_aeactivation() = 0
Tue Sep 1 08:55:15 1992 ->ft_connect()
ae_label = 0x202c0006
return_even_name = 0
called_ae_name = 0x5a9bc
input_dcb->called_presentation_address = 0x0
input_dcb->called_ae_title_option = User_object_id_option
input_dcb->called_ae_title = 0x5ac14
input_dcb->called_ae_invoke_id = 0x80000000
input_dcb->called_ap_invoke_id = 0x80000000
input_dcb->number_of_retry = 0
input_dcb->delay_between_retry = 0
input_dcb->connection_resource_wait_timer = 0
input_dcb->context_name = 1 0 8571 1 1
input_dcb->connect_in_info.service_class:
FT_SC_TRANSFER
FT_SC_TRANSFER_AND_MGMT
input_dcb->connect_in_info.functional_units:
FT_FU_READ
FT_FU_WRITE
input_dcb->connect_in_info.attribute_groups
FT_AG_STORAGE
FT_AG_PRIVATE
input_dcb->connect_in_info.quality_of_service = FT_NO_RECOVERY
input_dcb->connect_in_info.contents_type_list: 0x5ac74
input_dcb->connect_in_info.contents_type_list.contents_type.connects_form =
FT_DOCUMENT_TYPE
contents_type->contents_info.document.name.length = 5
contents_type->contents_info.document.name.element: 1 0 8571 5 3
input_dcb->connect_in_info.initiator_identity = “root”
input_dcb->connect_in_info.account = “account”
input_dcb->connect_in_info.file_store_pw = “ftam”
Tue Sep 1 08:55:17 1992 %<-ft_connect() = 0