FTAM/9000 Programmer's Guide

286 Chapter 7
Managing and Accessing HP FTAM/9000 Files
Gaining Access to FTAM Files
ft_deselect()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_deselect (connection_id, return_event_name, input_dcb,
inout_dcb)
Connection_id connection_id;
Local_event_name return_event_name;
char *input_dcb;
struct Ft_deselect_out_dcb **inout_dcb;
Use ft_deselect() to deselect a file when you finish processing, but do not
want to remove it. You must re-select the file to perform further actions
on it.
• The ft_deselect() input_dcb parameter does not contain information;
therefore, pass a NULL pointer for the input_dcb parameter.
• Invoke ft_deselect() in the File Selection regime to move back to the
FTAM regime.
Ft_deselect_out_dcb
struct Ft_deselect_out_dcb {
Uint32 size;
struct Api_rc result;
enum Ft_action_result action_result;
struct Ft_charging *charging;
struct Ft_diagnostic *diagnostic;
};
ft_deselect() Parameters
ft_deselect()
Parameter
Type Description
connection_id Mandatory
Input
Uniquely identifies a specific connection to the
filestore
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 Optional input Contains no information; pass a NULL pointer