HP FTAM/9000, Reference Manual

Page 1: ...HP FTAM 9000 Reference Manual Edition 4 B1033 90004 HP 9000 Networking E0597 Printed in U S A Copyright 1997 Hewlett Packard Company ...

Page 2: ...Data and Computer Software clause at DFARS 252 227 7013 for DOD agencies and subparagraphs c 1 and c 2 of the Commercial Computer Software Restricted Rights clause at FAR 52 227 19 for other agencies HEWLETT PACKARD COMPANY 3000 Hanover Street Palo Alto California 94304 U S A Use of this manual and flexible disk s or tape cartridge s supplied for this pack is restricted to this product only Additi...

Page 3: ...ornell University copyright 1989 1991 The University of Maryland copyright 1988 Carnegie Mellon University Trademark Notices UNIX is a registered trademark in the United States and other countries licensed exclusively through X Open Company Limited X Window System is a trademark of the Massachusetts Institute of Technology MS DOS and Microsoft are U S registered trademarks of Microsoft Corporation...

Page 4: ...4 ...

Page 5: ... extensive changes are made Manual updates may be issued between editions to correct errors or document product changes To ensure that you receive the updated or new editions you should subscribe to the appropriate product support service See your HP sales representative for details First Edition April 1991 HP UX Release 8 0 Second Edition November 1992 HP UX Release 9 0 Third Edition January 1995...

Page 6: ...6 ...

Page 7: ... lower level OSI protocol stack in conjunction with an 802 3 network link Audience This manual is for application programmers who are familiar with the C programming language and who need to correct errors in their applications This manual is also for programmers who need to consult the FTAM 9000 reference pages which are copies of the online man pages MAP 3 0 Interface Note Users should note that...

Page 8: ...pter 4 Event Management ErrorsThis chapter contains a list of values returned when calling em_wait em_fdmemory and em_gperror These errors return in the result return_code and result vendor_code fields Possible causes and recovery actions are also listed Chapter 5 HP FTAM 9000 PICSThis chapter contains information on how to obtain a copy of the Protocol Implementation Conformance Statement PICS fo...

Page 9: ...terconnection File Transfer Access and Management International Standards ISO 8571 ISO 8571 Information Processing Systems Open Systems Interconnection File Transfer Access and Management MAP 3 0 Interface Specifications MAP 3 0 Application Interface Specification NBS Phase III Implementation Agreements for Open Systems Interconnection Protocols from the NBS Workshop for Implementors of Open Syste...

Page 10: ...10 ...

Page 11: ..._dcb result vendor_code 55 3 Diagnostic error_ids inout_dcb diagnostic error_id 69 4 Event Management Errors EM return_codes 83 EM vendor_codes 86 result return_code 86 5 HP FTAM 9000 PICS 6 Installation Filesets Files Created During Software Installation 92 7 HP FTAM 9000 Reference Pages ...

Page 12: ...12 Contents ...

Page 13: ...13 1 FTAM return_codes This chapter lists the inout_dcb result return_codes The initiator and responder detect FTAM errors and return them in the user program as integer defined constants ...

Page 14: ...le contains defined constants for FTAM return_codes To obtain a printable character string for the error call ft_gperror Refer to the Handling Errors chapter in the HP FTAM 9000 Programmer s Guide for information on checking for and handling errors ...

Page 15: ...SSAGE FTE002_DUP_EVENT_NAME CAUSE You previously made an asynchronous call using the same value for return_event_name ACTION Call the function asynchronously with a return_event_name that is not already in use MESSAGE FTE003_ABORT_IND_RCVD CAUSE An abort indication was received on the connection_id specified in the call ACTION Call ft_ireceive to obtain abort information Perform error recovery bas...

Page 16: ...id not return the connection_id ACTION Call the function with a valid active connection_id returned from an ft_connect request MESSAGE FTE006_NETWORK_UNAVAIL CAUSE All contact with ftam_init was lost either because it was killed or exited ACTION Call ft_aeactivation to activate another ftam_init If the error still occurs terminate the application and refer to the OSI Troubleshooting Guide MESSAGE ...

Page 17: ...ablish a new connection and continue processing When calling functions always use an active connection_id returned from ft_connect MESSAGE FTE010_MY_DIR_NAME_UNKNOWN CAUSE The my_dir_name associated with ftam_init is unknown Either it does not exist or you incorrectly typed the name ACTION Call ft_aeactivation with a configured my_dir_name MESSAGE FTE011_AE_INVOC_EXHAUSTED CAUSE You reached the ma...

Page 18: ...nection and call ft_aedeactivation to deactivate ftam_init Call ft_aereset to abruptly abort all open connections and then call ft_aedeactivation to deactivate ftam_init MESSAGE FTE016_LACK_TARGET_INFO CAUSE Insufficient target address information either the called_dir_name or input_dcb called_presentation_address parameter is missing from ft_connect You must provide one or both EXAMPLE You called...

Page 19: ...alled_dir_name is not configured on your network or you incorrectly typed the name ACTION Call ft_connect with a configured called_dir_name that identifies the FTAM responder to which you are trying to connect MESSAGE FTE019_CONNECT_EXHAUSTED CAUSE You reached the maximum number of allowable connections between ftam_init and the responder ACTION You have three options Activate another ftam_init an...

Page 20: ...processing only on active connections MESSAGE FTE025_PROTOCOL_ERROR CAUSE A function call violated an FTAM protocol in one of the following ways You called a function outside the current regime You called an illegal function within a group EXAMPLE You called ft_rdata after receiving a data end indication ACTION Ensure you are in the correct regime for calling the function Call only functions that ...

Page 21: ...the pointer returned by ft_didcb to the FTAM function MESSAGE FTE028_NO_MIN_OUT_SPACE CAUSE You did not provide the minimum required inout_dcb space The inout_dcb size must be large enough to return the size and result structure 12 bytes ACTION You have two options Call the function with the address of a NULL inout_dcb buffer indicating the interface should dynamically initialize the DCB Call the ...

Page 22: ...buffer pointer you provided a NULL pointer instead of a valid address EXAMPLE You called ft_connect and passed a NULL output connection_id pointer ACTION Call the function with a valid non NULL pointer MESSAGE FTE032_IPC_ERROR CAUSE General IPC error communication between the user program and ftam_init is lost ACTION Refer to the troubleshooting OSI Troubleshooting Guide MESSAGE FTE034_PROVIDER_IN...

Page 23: ...of selectors or nsaps was exceeded EXAMPLE You called ft_connect and set the input_dcb called_presentation_ address n_nsaps field to a value greater than 8 ACTION Call ft_connect with valid fields within the presentation address struct P_address Max psap_selector length 16 octets Max ssap_selector length 16 octets Max tsap_selector length 32 octets Max nsap length 20 octets Max number of n_nsaps 8...

Page 24: ... in struct Dir_dn or struct Dir_rdn must be a positive value If you provide an attr_id and attr_value in struct Dir_ava each field must have a length greater than zero and the pointer set to a non NULL value If you do not provide these fields the length must be zero MESSAGE FTE041_INV_MY_AE_TITLE_OPT CAUSE Invalid my_ae_title_option parameter for ft_aeactivation the specified value is not within t...

Page 25: ...attr_value in struct Dir_ava each field must have a length greater than zero and the pointer set to a non NULL value If the ae_title is an object ID i e you supplied ae_object_id the length must be greater than zero and the pointer must be a non NULL value MESSAGE FTE043_INV_CALLED_DIR_NAME CAUSE Invalid called_dir_name parameter on ft_connect syntax is incorrect EXAMPLE You specified called_dir_n...

Page 26: ...id struct Object_id as the ae_object_id ACTION Call ft_connect with a syntactically correct my_ae_title If the ae_title is a directory distinguished name i e you supplied ae_dir_dn the n field in struct Dir_dn or struct Dir_rdn must be a positive value If you provide an attr_id and attr_value in struct Dir_ava each field must have a length greater than zero and the pointer set to a non NULL value ...

Page 27: ...was not allocated by ft_didcb EXAMPLE You called malloc to allocate memory for an Ft_fcopy_out_dcb and then called ft_dfdcb to free the pointer ACTION If you called ft_didcb to allocate the pointer call ft_dfdcb to free it If you called malloc to allocate the pointer call free to free it MESSAGE FTE095_NWC_REVOKED CAUSE The ft_nwcleared request was revoked you called a function on a specified conn...

Page 28: ...l ft_gperror with a valid defined return_code MESSAGE FTE099_NO_RESOURCE_OUTSTANDING CAUSE No resource outstanding you called ft_nwcleared without previously receiving the FTE008_NO_CON_RESOURCES error The ft_nwcleared function is valid only if an FTE008_NO_CON_RESOURCES error returns on an ft_sdata function ACTION Call ft_nwcleared only when you receive a FTE008_NO_CON_RESOURCES error MESSAGE FTE...

Page 29: ...a previous request in the group was detected and the end group confirm was immediately generated EXAMPLE You called the following sequence of functions ft_bgroup ft_select ft_open and ft_egroup After these passed across the network the responder detected an error on ft_select The ft_open was not processed and the ft_egroup confirm was sent This error would return on ft_open ACTION The error probab...

Page 30: ...nts_form FT_DOCUMENT_TYPE and contents_type contents_info document name indicates FTAM 1 FTAM 2 FTAM 3 or NBS 9 For ft_fopen and ft_open contents_type contents_form can be FT_CONTENTS_UNKNOWN MESSAGE FTE112_GROUP_NOT_OPEN CAUSE Grouping was not open on the connection You called ft_egroup before calling ft_bgroup ACTION Call ft_bgroup on a connection before calling ft_egroup MESSAGE FTE113_GROUP_AL...

Page 31: ...These ordinal values are 32 to 126 and 160 to 255 If used within escape sequences the values 27 142 and 143 are also available MESSAGE FTE116_INV_ACSCTL_PASSWDS CAUSE Invalid password in access_passwords field of struct Ft_access_control_element syntax is incorrect ACTION Call the function with a valid Ft_single_file_pw A password is invalid if the length field is greater than zero and the pointer...

Page 32: ...e Ft_action_result enumeration ACTION Call the function with a valid action_result MESSAGE FTE121_INV_DIRNAME CAUSE Invalid dirname parameter for ft_frattributes ft_fcattributes or ft_fdelete syntax is incorrect EXAMPLE You specified dirname with a negative number of avas ACTION Call the function with a syntactically correct dir_name The n field in struct Dir_dn or struct Dir_rdn must be a positiv...

Page 33: ...lds contains an invalid file lock The file lock is not in the Ft_file_lock enumeration ACTION Call the function with a valid file lock in each concurrency_control field MESSAGE FTE127_INV_CREATE_ID CAUSE Invalid identity_of_creator parameter syntax is incorrect ACTION Ensure characters in the parameter are part of the graphic string character set These ordinal values are 32 to 126 and 160 to 255 I...

Page 34: ...d ft_fmove and specified destination_dirname with a negative number of rdns ACTION Call the function with a syntactically correct destination_dirname The n field in struct Dir_dn or struct Dir_rdn must be a positive value If you provide an attr_id and attr_value in struct Dir_ava each field must have a length greater than zero and the pointer set to a non NULL value If you do not provide these fie...

Page 35: ... syntactically correct fields within struct Ft_diagnostic Ensure you set all required fields The error_source and error_observer must be in the Ft_entity_ref enumeration The diag_type must be in the Ft_diag_type enumeration The further_details characters must be part of the graphic string character set These ordinal values are 32 to 126 and 160 to 255 If used within escape sequences the values 27 ...

Page 36: ... 32 to 126 and 160 to 255 If used within escape sequences the values 27 142 and 143 are also available MESSAGE FTE138_INV_LEGAL_QUAL CAUSE Invalid legal_qualification parameter syntax is incorrect ACTION Ensure characters in the parameter are part of the graphic string character set These ordinal values are 32 to 126 and 160 to 255 If used within escape sequences the values 27 142 and 143 are also...

Page 37: ...access parameter for ft_create ft_fopen or ft_select EXAMPLE You set Bit 1 in the parameter but only Bits 8 to 15 are valid for the requested_access ACTION Correctly set the FT_FA_XXX bits for the requested_access parameter and call the function again MESSAGE FTE149_INV_SRC_ACCOUNT CAUSE Invalid input_dcb source_account parameter forft_fcopy or ft_fmove ACTION Ensure characters in the parameter ar...

Page 38: ... non NULL value If you do not provide these fields the length must be zero MESSAGE FTE151_INV_SRC_FNAME CAUSE Invalid source_filename parameter syntax is incorrect ACTION Ensure characters in the parameter are part of the graphic string character set These ordinal values are 32 to 126 and 160 to 255 If used within escape sequences the values 27 142 and 143 are also available MESSAGE FTE152_INV_SRC...

Page 39: ...id MESSAGE FTE155_NO_SYNCH_IN_GROUP CAUSE You made a synchronous call within a group you called a function with a synchronous return_event_name while grouping was open on the specified connection EXAMPLE You called ft_bgroup on a connection and then called ft_select synchronously on that same connection ACTION Call the function with an asynchronous return_event_name MESSAGE FTE156_INV_FUNC_UNITS C...

Page 40: ...tet_string is invalid if the length field is greater than zero and the pointer is NULL or if the length is greater than 65535 MESSAGE FTE159_INV_FADU_ID CAUSE Invalid fadu_identity fadu_form or fadu_identity fadu_info parameter for ft_read ft_write ft_erase or ft_locate ACTION Call the function with fadu_identity fadu_form equal to FT_FADU_LOCATION Additionally the fadu_identity fadu_info must be ...

Page 41: ...cate filenames when source and destination are identical you called ft_fcopy or ft_fmove but specified the same source and destination file store and the same source and destination file ACTION Call the function using different source and destination files MESSAGE FTE166_UNKN_ATTR_GROUP CAUSE The bits for the FT_AG_XXX defined constants are not set correctly in the input_dcb connect_in_info attrib...

Page 42: ...meter MESSAGE FTE169_INV_PRIVATE_USE CAUSE Invalid private_use parameter invalid struct Octet_string ACTION Call the function with a valid private_use The struct Octet_string is invalid if the length field is greater than zero and the pointer is NULL or if the length is greater than 65535 MESSAGE FTE170_INV_FUTURE_FILESIZE CAUSE The specified future_filesize parameter is less than zero ACTION Call...

Page 43: ...cb connect_in_info quality_of_service MESSAGE FTE174_ATTRIB_UNMODIFIABLE CAUSE A bit is set in the attributes mask that cannot be modified or set for the specified call EXAMPLE You called ft_cattributes and specified the contents_type as an attribute you want to change but contents_type is not modifiable ACTION Call the function with valid mask bits set Ensure you can change the specified attribut...

Page 44: ...meration ACTION Call the function with a valid class MESSAGE FTE178_INV_STRING_SIGN CAUSE Invalid string_significance parameter the specified value is not within the Ft_string_significance enumeration ACTION Call the function with a valid string_significance MESSAGE FTE181_INV_DE_PRIM_TYPE CAUSE Invalid data_unit data data_element prim_type parameter for ft_sdata the data_unit data data_element pr...

Page 45: ...CAUSE Invalid read password syntax is incorrect ACTION Call the function with a valid Ft_single_file_pw A password is invalid if the length field is greater than zero and the pointer is NULL or if the length is greater than 65535 MESSAGE FTE184_INV_INSERT_PASSWD CAUSE Invalid insert password syntax is incorrect ACTION Call the function with a valid Ft_single_file_pw A password is invalid if the le...

Page 46: ...rd is invalid if the length field is greater than zero and the pointer is NULL or if the length is greater than 65535 MESSAGE FTE188_INV_READATTR_PASSWD CAUSE Invalid read_attribute password syntax is incorrect ACTION Call the function with a valid Ft_single_file_pw A password is invalid if the length field is greater than zero and the pointer is NULL or if the length is greater than 65535 MESSAGE...

Page 47: ...w A password is invalid if the length field is greater than zero and the pointer is NULL or if the length is greater than 65535 MESSAGE FTE192_INV_CREATE_PASSWD CAUSE Invalid create_file_pw password syntax is incorrect ACTION Call the function with a valid Ft_single_file_pw A password is invalid if the length field is greater than zero and the pointer is NULL or if the length is greater than 65535...

Page 48: ... typed the name ACTION Call the function with a configured dirname that identifies the desired FTAM responder MESSAGE FTE197_DEST_DIRNAME_NO_ADDR CAUSE The destination_dirname parameter for ft_fcopy or ft_fmove has no associated presentation address Either it is not configured for your network or you incorrectly typed the name ACTION Call the function with a configured destination_dirname that ide...

Page 49: ...SE You canceled the data transfer This message returns on ft_rdata when you call ft_cancel a positive confirmation returns and ft_rdata requests are pending ACTION Informative message no action required MESSAGE FTE201_INV_SRC_CONCUR_CNTL CAUSE The input_dcb src_concur_cntl parameter is invalid for ft_fcopy or ft_fmove ACTION Call the function with a valid file lock in each input_dcb src_concur_cnt...

Page 50: ...ns on HLCF calls ACTION Refer to the OSI Troubleshooting Guide MESSAGE FTE503_REM_SYS_UNSUITABLE CAUSE A remote system negotiated below the minimal functional_units required to complete the request returns on HLCF calls ACTION Refer to the OSI Troubleshooting Guide MESSAGE FTE504_TRANSFER_CANCEL CAUSE The responder canceled the data transfer on a HLCF call ACTION Refer to the OSI Troubleshooting G...

Page 51: ...ed the data transfer on a HLCF call indicates an unsuccessful end data indication arrived at one of the nodes ACTION Refer to the OSI Troubleshooting Guide MESSAGE FTE507_TRANSFER_SRC_ABORT CAUSE The responder on the source node aborted the data transfer on a HLCF call ACTION Refer to the OSI Troubleshooting Guide ...

Page 52: ...52 Chapter1 FTAM return_codes inout_dcb result return_code ...

Page 53: ...This chapter contains a list of HP specific errors returned in the inout_dcb result vendor_code field The vendor_codes reflect HP specific error information you do not receive errors specific to other vendors in this field ...

Page 54: ...m h file contains defined constants for HP vendor_codes To receive a printable character string call ft_gperror Refer to the Handling Errors chapter in the HP FTAM 9000 Programmer s Guide for information on checking for and handling errors ...

Page 55: ...tam_init ACTION Collect relevant error information and contact your HP support representative MESSAGE FTV102_CANNOT_KILL_INITIATOR CAUSE Unable to deactivate ftam_init ACTION The kill function failed on ftam_init Check the log file for errors logged by ftam_init Find ftam_init s process ID PID and kill the ftam_init manually MESSAGE FTV103_INTERNAL_ERROR CAUSE An internal error occurred ACTION Che...

Page 56: ...ACTION Verify that applications are shutting down invocations when finished You cannot establish new AE invocation for presentation addressed that are not currently active When AE invocations terminate entries will become available MESSAGE FTV106_AE_LABEL_TABLE_FULL CAUSE The maximum number of ftam_inits for a single process was exceeded ACTION Deactivate all ftam_inits that are no longer in use M...

Page 57: ...t relevant error information and contact your HP support representative MESSAGE FTV110_VIRTUAL_MEMORY_EXHAUSTED CAUSE Current resources are insufficient to honor request virtual memory is exhausted ACTION Check your memory management Free any unused resources e g memory call ft_dfdcb to free initialized unused dcbs and call the function again MESSAGE FTV111_CID_TABLE_FULL CAUSE Connection_id table...

Page 58: ...rror messages Collect relevant error information and contact your HP support representative MESSAGE FTV202_EM_EVENT_MAX_EXCD CAUSE Event management error maximum number of events was exceeded ACTION Free some memory resources and call the function again If the error still occurs collect relevant error information and contact your HP support representative MESSAGE FTV203_EM_INTERNAL_ERROR CAUSE Eve...

Page 59: ...relevant error information and contact your HP support representative MESSAGE FTV303_CANNOT_ADD_TO_DCB_TABLE CAUSE Unable to add to DCB table ACTION Free some memory resources and call the function again If the error still occurs collect relevant error information and contact your HP support representative MESSAGE FTV304_CANNOT_INIT_ICS CAUSE The FTAM library cannot initialize the initial configur...

Page 60: ...ack ACTION Re link the application with the version of libmapftam a on the system experiencing the error MESSAGE FTV308_STACK_NOT_INITIALIZED CAUSE The underlying OSI network software or stack has not been started ACTION Start the underlying OSI network software MESSAGE FTV401_ERROR_IN_GROUP_CAUSED_STATE_FAILURE CAUSE After making a grouped request one of the requests within the threshold set for ...

Page 61: ...ion returned on a connection before the responder confirmed the request ACTION Check the inout_dcb diagnostic to determine the reason for the abort and call the function again MESSAGE FTV404_NEG_CNF_ON_CON_REQ CAUSE The responder sent a negative confirmation on an ft_connect request ACTION Check Association Control Service Element ACSE errors and inout_dcb diagnostic to determine the reason for th...

Page 62: ... again MESSAGE FTV408_EXTRA_RDATA_REQ_AT_TRANS_END CAUSE Extra ft_rdata request remained after a DATA_END_IND indication ACTION Informative message no action required MESSAGE FTV409_NEG_SELECT_CNF_ON_HLCF_REQ CAUSE The responder sent a negative confirmation on the select request within a HLCF call ACTION Check the inout_dcb diagnostic to determine the reason for the failure and call the function a...

Page 63: ... call the function again MESSAGE FTV413_NEG_CATTR_CNF_ON_HLCF_REQ CAUSE The responder sent a negative confirmation on the change attributes request within a HLCF call ACTION Check the inout_dcb diagnostic to determine the reason for the failure and call the function again MESSAGE FTV414_NEG_EDATA_IND_ON_HLCF_REQ CAUSE Negative data end indication on an HLCF call ACTION Check the inout_dcb diagnost...

Page 64: ...n for the failure and call the function again MESSAGE FTV418_NEG_DESELECT_CNF_ON_HLCF_REQ CAUSE The responder sent a negative confirmation on the deselect request within a HLCF call ACTION Check the inout_dcb diagnostic to determine the reason for the failure and call the function again MESSAGE FTV419_NEG_RELEASE_CNF_ON_HLCF_REQ CAUSE The responder sent a negative confirmation on the release reque...

Page 65: ...ult vendor_code MESSAGE FTV421_NOT_IN_DATA_TRANS_PHASE CAUSE You called ft_rdata while in a regime other than data transfer ACTION Call ft_rdata in the Data Transfer regime only after an ft_read request and before the transferring of data ends ...

Page 66: ...66 Chapter2 HP vendor_codes inout_dcb result vendor_code ...

Page 67: ...ns a list of diagnostic values returned in theinout_dcb diagnostic error_id field These errors are generated in the FTAM protocol machine FPM and the Virtual Filestore VFS not in the interface This chapter includes only those diagnostic error_ids ...

Page 68: ... actions listed are specific to HP s implementation The f_error h file contains defined constants for all FTAM diagnostic error_ids To receive a printable character string review the information in inout_dcb diagnostic further_details Refer to the Handling Errors chapter in the HP FTAM 9000 Programmer s Guide for information on checking for and handling errors ...

Page 69: ...d before a state_result failure is detected a negative re sponse is made for the group All grouped functions after the ft_bgroup response and before the state_result failure will have an action_result of failure and will have a diagnostic error_id of F_SUBSEQ_ERR ACTION Check inout_dcb diagnostic to determine which function caused the group to fail Refer to the appropriate section in this manual f...

Page 70: ... reasons The parameter values could not be encoded You issued the calls in an incorrect order ACTION Use the appropriate corrective action as follows Call the function with valid parameters Call the functions in the correct order 1009 MESSAGE F_FTAM_PROTO_ERR_FUNCU CAUSE FTAM protocol error You issued a request using a functional_unit that was not negotiated between ftam_init and the responder on ...

Page 71: ...on and contact your HP support representative 1015 MESSAGE F_ILLEGAL_GRP_SEQ CAUSE The grouping sequence is illegal Depending on the service_class negotiated only certain sequences of PDUs can be in a grouped request ACTION Call the grouped functions in a valid sequence Refer to the HP FTAM 9000 Programmer s Guide for acceptable sequences when grouping functions 2008 MESSAGE F_ASSOC_MGT CAUSE Asso...

Page 72: ... Call the function with a valid filestore_pw The filestore_pw is the HP UX password associated with the initiator identity that is the HP UX login 3000 MESSAGE F_FILE_NOT_FOUND CAUSE The filename specified on ft_select does not exist or you entered it incorrectly ACTION Call ft_select with a correct and existing filename 3002 MESSAGE F_INIT_ATTRIB_NOT_POSSIBLECAUSE CAUSE The initial attributes do ...

Page 73: ...eates the shadow file 3005 MESSAGE F_FILE_ALREADY_EXISTS CAUSE You called ft_create with file_status set to FT_NEW and a file by that same name already exists in the filestore ACTION Call ft_create with a different filename 3007 MESSAGE F_CANNOT_DELETE_FILE CAUSE On an ft_select ft_create or ft_fopen function you selected a file without setting the FT_FA_DELETE_FILE bit in the requested_access fie...

Page 74: ...access and concurrency_control parameters are not compatible EXAMPLES The requested_access for an action is not set and you request a concurrency_control other than FT_NOT_REQUIRED or FT_NO_ACCESS Someone has the file selected with the FT_FA_INSERT action set to FT_EXCLUSIVE and you request an FT_FA_INSERT action of FT_SHARED ACTION Call the function again after the file is closed by the other app...

Page 75: ... in the Ft_access_control_element corresponding to the current initiator identity ACTION Change the file attributes so that the access control element corresponding to your initiator identity allows you to perform the necessary actions requested_access conc_access file_passwords 3020 MESSAGE F_CREATE_SLCTD_EXIST_FILE CAUSE On an ft_create call the file already exists and the file_status is set to ...

Page 76: ...ON Correctly set the FT_FA_XXX bits or call the function with a valid requested_access The requested_access must be a subset of the permitted_actions values on ft_select or ft_create 4001 MESSAGE F_ATTRIB_CANNOT_READ CAUSE You cannot read the file attributes because when you selected the file you did not set requested_access to include FT_FA_READ_ATTRIBUTE ACTION Deselect the file and select it ag...

Page 77: ...a file that already exists ACTION Use the appropriate corrective action as follows Deselect the file and select it again with requested_access set to include FT_FA_CHANGE_ATTRIBUTE Remove the access control element for the existing initiator identity and insert one for the initiator identity you want Change the name of the file to one that does not exist 5002 MESSAGE F_BAD_FADU_TYPE_ERR CAUSE The ...

Page 78: ... types prim_type must be OCTET_STRING For INTAP 1 document types prim_type must be RECORD_END or RECORD_CONT 5017 MESSAGE F_OPR_INCONSISTENT CAUSE The operation is inconsistent Causes may include the following cases You called ft_read though the processing_mode on ft_open did not have the FT_PM_READ bit set to ON 1 You called ft_write though the processing_mode on ft_open did not have FT_PM_INSERT...

Page 79: ... access_context is not available Given a particular document type a VFS implementation may not support certain access_contexts EXAMPLE You tried accessing an FTAM 2 file with an access_context of HA Hierarchical All ACTION Use an access_context value that is consistent with the file document type 5026 MESSAGE F_BAD_WRITE CAUSE On an ft_write function the Ft_fadu_location in Ft_fadu_identity points...

Page 80: ...AM 1 FTAM 3 and INTAP 1 document types fadu_identity must be FT_FIRST For FTAM 2 document types fadu_identity must be FT_BEGIN 5031 MESSAGE F_LCL_FAIL_DVC_FAIL CAUSE Local device failure An I O error occurred when trying to write the file via an HP UX system call For example you may be out of disc space ACTION If needed create disc space on the real file system responder where the write failure oc...

Page 81: ...ontains a list of values that may be returned when calling em_wait em_fdmemory and em_gperror These errors return in the result return_code and result vendor_code fields To receive a printable character string for returned errors call em_gperror ...

Page 82: ...82 Chapter4 Event Management Errors Refer to the Handling Errors chapter in the HP FTAM 9000 Programmer s Guide for information on checking for and handling errors ...

Page 83: ...return_code or vendor_code MESSAGE SUCCESS CAUSE Successful function execution no error ACTION Informative message no action required MESSAGE EME002_EXP_EMPTY CAUSE No events were posted therefore there is no reason to wait ACTION Call a function asynchronously before calling em_wait MESSAGE EME004_TIME_INV CAUSE The timeout parameter is invalid ACTION Call em_wait with a valid timeout parameter V...

Page 84: ...f the result parameter is invalid ACTION Set the return_event_name and result parameters to valid non NULL values MESSAGE EME032_IPC_ERROR CAUSE Your program could not access the ftam_init processing the return_event_name ACTION Refer to the result vendor_code for the actual IPC error value Call em_gperror to translate the value into a message and refer to the log file to determine why you could n...

Page 85: ...ic memory that is no longer needed and call the function again EXAMPLE You made multiple calls to em_gperror requesting that the interface allocate memory however you did not call em_fdmemory to free the memory after em_gperror completed MESSAGE EME098_INVALID_RETURN_CODE CAUSE The input_results structure contains a return_code that does not exist ACTION Only call em_gperror with an input_result r...

Page 86: ... provides sufficient information ACTION Informative message no action required MESSAGE EMV002_PARAM_EVENT_NAME CAUSE The return_event_name buffer pointer is set to NULL ACTION Set the return_event_name parameter to a valid non NULL value MESSAGE EMV003_PARAM_IN_RESULT CAUSE The input_result buffer pointer is set to NULL ACTION Set the input_result parameter to a valid non NULL value MESSAGE EMV004...

Page 87: ...hapter 4 87 Event Management Errors EM vendor_codes MESSAGE EMV005_PARAM_VEN_STRING CAUSE The vendor_string buffer pointer is set to NULL ACTION Set the vendor_string parameter to a valid non NULL value ...

Page 88: ...88 Chapter4 Event Management Errors EM vendor_codes ...

Page 89: ...89 5 HP FTAM 9000 PICS For a copy of the Protocol Implementation Conformance Statement PICS for the HP FTAM 9000 product please contact your HP support representative ...

Page 90: ...90 Chapter5 HP FTAM 9000 PICS ...

Page 91: ...esets The files listed in this chapter are installed in the indicated directories at the time you install FTAM Installing the reference page man page files is recommended but omitting them will not operationally affect FTAM ...

Page 92: ...ftam sbin osiinitshm OTS startup utility for FTAM opt ftam sbin osirmshm OTS startup utility for FTAM opt ftam sbin osistat OTS startup utility for FTAM opt ftam sbin id conf OTS startup utility for FTAM opt ftam lbin ftam_resp FTAM responder daemon process opt ftam lbin ftam_init FTAM initiator service provider process opt ftam include map h Include file for common MAP library opt ftam include ma...

Page 93: ...t Message catalog used by FTAM user interface commands opt ftam lib nls C ftamfmt cat Network tracing and logging NLS catalog opt ftam lib nls C hps cat Network tracing and logging NLS catalog opt ftam lib nls C mapftam cat Message catalog used by ft_gperror and FTAM user interface commands opt ftam lib nls C mapem cat NLS catalog for em_gperror opt ftam lib nls C osistat cat NLS catalog for osist...

Page 94: ...pt ftam demos ftm_hlcopy c Demo file copy using high level functions opt ftam demos ftm_llcopy c Demo file copy using low level functions opt ftam demos ftm_parm c Source file for demo programs opt ftam demos ftm_util c Source file for demo programs opt ftam demos resp_api Makefile Source file for demo programs opt ftam demos resp_api test_resp Source file for demo programs opt ftam demos resp_api...

Page 95: ...d function opt ftam man man3 Z ft_aereset 3n Man page for indicated function opt ftam man man3 Z ft_bgroup 3n Man page for indicated function opt ftam man man3 Z ft_cancel 3n Man page for indicated function opt ftam man man3 Z ft_cattribu 3n Man page for indicated function opt ftam man man3 Z ft_close 3n Man page for indicated function opt ftam man man3 Z ft_connect 3n Man page for indicated funct...

Page 96: ... ftam man man3 Z ft_fopen 3n Man page for indicated function opt ftam man man3 Z ft_frattrib 3n Man page for indicated function opt ftam man man3 Z ft_gperror 3n Man page for indicated function opt ftam man man3 Z ft_ireceive 3n Man page for indicated function opt ftam man man3 Z ft_locate 3n Man page for indicated function opt ftam man man3 Z ft_nwcleare 3n Man page for indicated function opt fta...

Page 97: ... for indicated function opt ftam man man3 Z em_wait 3n Man page for indicated function opt ftam man man3 Z em_gperror 3n Man page for indicated function opt ftam man man3 Z em_fdmemory 3n Man page for indicated function opt ftam man man3 Z em_hp_sigio 3n Man page for indicated function opt ftam man man3 Z ftam 3n Man page for overview of programmatic FTAM opt ftam man man4 Z ftamrc 4 Man page for ...

Page 98: ...98 Chapter6 Installation Filesets Files Created During Software Installation ...

Page 99: ...000 Reference Pages The following are the HP FTAM 9000 reference pages man pages available online If you have loaded the reference page filesets you can view them online by using the man 1 command at the HP UX prompt ...

Page 100: ...r directory ft_abort 3 abort an FTAM connection ft_aeactivation 3 activate an FTAM initiator ft_aedeactivation 3 deactivate an FTAM initiator ft_aereset 3 reset an FTAM initiator ft_bgroup 3 begin a group of FTAM functions ft_cancel 3 cancel FTAM data transfer in progress ft_cattributes 3 change the file attributes of an FTAM file ft_close 3 close an FTAM file ft_connect 3 establish a connection w...

Page 101: ..._fdelete_aet 3 delete an FTAM file ft_fdmemory 3 free dynamic memory allocated by FTAM ft_fmove 3 move an FTAM file ft_fmove_aet 3 move an FTAM file ft_fopen 3 select or create and then open an FTAM file ft_frattributes 3 read the file attributes of an FTAM file ft_frattributes_aet 3 read the file attributes of an FTAM file ft_gperror 3 translate an FTAM error to a printable string ft_ireceive 3 r...

Page 102: ...est transfer of data from FTAM ft_rrequest 3 release an FTAM connection ft_sdata 3 send a block of FTAM data ft_select 3 select an FTAM file ft_write 3 request transfer of data to an FTAM file ftam 1 OSI file transfer access and management program ftamrc 3 FTAM security file Entry Name Description ...