XL Fortran Enterprise Edition for AIX : User's Guide - IBM

However, the libmassvp4.a library provides newer, consistent versions of certain
functions. These consistent functions are: vsqrt, vssqrt, vlog, vrec, vdiv, vexp, vsin,
vcos, vacos, vasin, vatan2, vrsqrt, vscos, vsdiv, vsrec, vssin.
The accuracy of the vector functions is comparable to that of the corresponding
scalar functions in libmass.a, though results may not be bit-wise identical.
For more information on consistency and avoiding inconsistency with the vector
libraries, as well as performance and accuracy data, see the MASS Web site at URL
http://www.ibm.com/software/awdtools/fortran/xlfortran/mass.
Compiling and Linking a Program with MASS
To compile an application that calls the routines in these libraries, specify mass
and massv (or massvp3 or massvp4) on the -l linker option. For example, if the
MASS libraries are installed in the default directory, you could specify:
xlf progf.f -o progf -lmass -lmassv
The MASS functions must run in the round-to-nearest rounding mode and with
floating-point exception trapping disabled. (These are the default compilation
settings.)
Using libmass.a with the Standard Intrinsic Functions
If you wish to use the libmass.a scalar library for some functions and the normal
intrinsic functions, follow this procedure to compile and link your program:
1. Create an export list (this can be a flat text file) containing the names of the
desired functions. For example, to select only the fast tangent function from
libmass.a for use with the program sample.f, create a file called fast_tan.exp
with the following line:
tan
2. Create a shared object from the export list with the ld command, linking with
the libmass.a library. For example:
ld -bexport:fast_tan.exp -o fast_tan.o -bnoentry -lmass -bmodtype:SRE
3. Archive the shared object into a library with the ar command. For example:
ar -q libfasttan.a fast_tan.o
4. Create the final executable using xlf. This links only the functions specified in
the object file (in this example, the tan function) and the remainder of the math
functions from the standard system library. For example:
xlf -o sample sample.f -Ldir_containing_libfasttan.a -lfasttan
Note: The MASS cos function is automatically linked if you export MASS sin;
MASS atan2 is automatically linked if you export MASS atan.
Related Information
v ld and ar in AIX Commands Reference
Appendix C. Using the Mathematical Acceleration Subsystem (MASS) 423