HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, September 2010)

The datasetGetRecfmString function converts the RF type to a 5-byte character string. The RF
type is specified by recfm in DATASET_FIND_DATA. Table 51 on page 132 lists the
datasetGetRecfmString arguments and return values.
Table 51 DatasetGetRecfmString Function
DescriptionTypeValueItem
Record type value (1 byte)
Sets value of recfm, a member of
DATASET_FIND_DATA, which is obtained
by datasetGetFileInformation/
datasetFindFirstFile/
datasetFindNextFile, to recfm.
u_charrecfm
Argument
Record type character string (5 bytes):
text[0]
F: fixed-length record
V: variable-length record
U: unknown-length record
text[1]
B: blocking record
sp: spanned record
st: standard format record
char [5]text
Normal end0
Return value
Abnormal end-1
Using the FAL Functions
The FAL functions can be executed by any C program on the UNIX host. The FAL does not support
C++. The mainframe datasets accessed by the FAL functions must be located on the Data Exchange
volumes. The Data Exchange volumes must be installed and configured correctly (see “Installing and
Configuring the Data Exchange Volumes” on page 55), the Data Exchange software must be installed
properly (see “Installing the Data Exchange Software” on page 60), and the Data Exchange volume
definition file must be available and configured correctly. Since FAL operations do not involve GUI
windows, the X windows environment and FcuMf resource file are not required.
Figure 79 on page 135 shows an example of reading data using the FAL functions.
Figure 80 on page 136 shows an example of acquiring attribute information using the FAL functions.
To use the FAL functions in a C program (Visual C++ for Windows systems):
1. Copy the Data Exchange volume definition file (datasetmount.dat) to the directory containing
the C program that will call the FAL C functions.
2. Include the FAL header file (dataset.h) within the C program that will call the FAL functions
(for example, copy dataset.h to /usr/include).
Performing FAL Operations132