Using the fal functions -14, Using the fal functions – HP XP20000XP24000 Disk Array User Manual
Page 168
6-14
Performing File Access Library (FAL) Operations
Hitachi USP V Cross-OS File Exchange User’s Guide
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 z/OS datasets accessed by the FAL functions
must be located on TagmaStore USP or NSC FX volumes. The FX volumes
must be installed and configured correctly (see section Installing and
Configuring the FX Volumes), the FAL/FCU software must be installed properly
(see section Installing the FAL/FCU Software), and the FX 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 6-3 shows an example of reading data using the FAL functions.
Figure 6-4 shows an example of acquiring attribute information using the FAL
functions. To use the FAL functions in a C program (Visual C++ for Windows
2000/2003/Windows NT systems):
1. Copy the FX volume definition file (datasetmount.dat) to the directory
containing the C program that will call the FAL C function(s).
2. Include the FAL header file (dataset.h) within the C program that will call
the FAL function(s) (e.g., copy dataset.h to /usr/include).
3. Using 32bit FAL, compile the C program as follows:
IBM AIX
# cc -qlanglvl=ansi —D_NO_MT -o Output file name Source file
name /usr/lib/libfal.a
libfal.a = file name of FAL object module
HP-UX
# cc -Ae +DAportable —D_NO_MT -o Output file name Source
file name /usr/lib/libfal.sl
libfal.sl = file name of FAL object module
Solaris
# cc —D_NO_MT -o Output file name Source file name
/usr/lib/libfal.so.1
libfal.so.1 = file name of FAL object module
DIGITAL UNIX/Tru64
# c89 —D_NO_MT -o Output file name Source file name
/usr/lib/libfal.so
libfal.so = file name of FAL object module
Linux
# gcc —D_NO_MT -o Output file name Source file name
/usr/lib/libfal.so.1
libfal.so.1 = file name of FAL object module
4. Using 64bit FAL, compile the C program as follows:
IBM AIX