6 performing fal operations, Fal requirements – HP XP P9500 Storage User Manual
Page 123
6 Performing FAL Operations
This chapter describes how to perform FAL operations using Data Exchange.
The FAL component of Data Exchange consists of the object module file fal.o (fal.obj for Windows
systems) and the header file dataset.h. The FAL provides several important C functions (Visual C++
for Windows systems) that enable user applications on the open-system hosts to access mainframe
data on the storage system volumes. There are two types of FAL: the 32-bit FAL and the 64-bit FAL.
The 64-bit FAL is provided by HP StorageWorks XP24000/XP20000 Disk Arrays and
XP12000/XP10000 Disk Arrays.
FAL Requirements
The FAL functions have the same dataset requirements as FCU (for example, SAM, standard R0 track
format). The FAL also has the following additional requirements:
•
The FAL functions support only the standard MVS VTOC. The FAL functions cannot access MVS
datasets managed by an index VTOC and cannot access VSE datasets when called from user
applications.
•
The FAL functions are not thread-safe. The FAL functions may not operate properly when used by
multiple threads within a single process.
•
The FAL functions cannot be used by a signal handler. If this accidentally happens and memory
space is occupied, use kill to cancel the processes, and use ipcrm to delete the shared memory
areas that have KEY=0 (see the OS manuals). Do not issue the following signals to a Data Exchange
process (UNIX only):
SIGUSR1, SIGUSR2, SIGILL, SIGTRAP, SIGIOT, SIGABRT, SIGEMT, SIGFPE, SIGKILL, SIGBUS,
SIGSEGV, SIGSYS, SIGALRM, SIGPOLL, SIGIO, SIGSTOP, SIGTSTP, SIGCONT, SIGTTIN, SIGT-
TOU, SIGVTALRM, SIGPROF, SIGXCPU, SIGXFSZ, SIGWAITING, SIGLWP, SIGFREEZE, SIGTHAW,
SIGCANCEL
•
The following terminology is reserved for the FAL functions and cannot be used in function names,
variable names, or constant symbols in the user application:
• Words that begin with dataset or fast_
• GetVolSers
HP StorageWorks P9000 Data Exchange User Guide
123