FTAM/9000 Programmer's Guide

Chapter 3 161
HP FTAM/9000 Data Structures
input_dcb
You pass large amounts of data to the FTAM interface. To reduce the
number of exposed parameters, the Ft_xxx_in_dcb contains optional and
function-specific parameters.
The input_dcb parameters may be mandatory or optional; they must
occur after the exposed input parameters and before the inout_dcb
parameters. If any of the input_dcb parameters are mandatory, you must
pass the address of an input_dcb; otherwise, you may pass a NULL
value.
You can allocate memory for Ft_xxx_in_dcb two ways. If you are using
optional parameters, remember to allocate memory for them.
• Allocate the memory yourself (e.g., using malloc() and free(), or C
variables).
• Before the request, a recommended practice is to invoke ft_didcb() to
allocate memory for Ft_xxx_in_dcb and then set the appropriate
Ft_xxx_in_dcb fields. After the request completes, invoke ft_dfdcb() to
free the memory used by Ft_xxx_in_dcb.