Hitachi MK-96RD647-01 manual Using the FAL Functions

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-3shows an example of reading data using the FAL functions. Figure 6-4shows 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

6-14 Performing File Access Library (FAL) Operations

Hitachi USP V Cross-OS File Exchange User’s Guide