beautypg.com

Using the fal functions -14, Using the fal functions – HP XP20000XP24000 Disk Array User Manual

Page 168

background image

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