IBM Support

Mathematical Acceleration Subsystem (MASS) Libraries for AIX - Latest Version

Download


Abstract

The MASS libraries for AIX consist of a set of mathematical functions for C, C++, and Fortran-language applications that are tuned for specific POWER architectures.

Download Description

The MASS libraries v8.1.3 for AIX 6.1 are packaged as a compressed tar file, MASS_8.1.3_aix61.tar.gz.

Version 8.1.3:


- Adds a new vector library libmassvp8.a that contains the following routines tuned for POWER8 processors: vacos, vacosh, vasin, vasinh, vatan2, vatan, vatanh, vcbrt, vcos, vcosisin, vcosh, vdint, vdiv, vdnint, verfc, verf, vexp2, vexp2m1, vexp, vexpm1, vhypot, vlgamma, vlog10, vlog1p, vlog2, vlog21p, vlog, vpow, vqdrt, vrcbrt, vrec, vrqdrt, vrsqrt, vsin, vsincos, vsinh, vsqrt, vtan, vtanh, vsacos, vsacosh, vsasin, vsasinh, vsatan2, vsatan, vsatanh, vscbrt, vscos, vscosisin, vscosh, vsdiv, vserfc, vserf, vsexp2, vsexp2m1, vsexp, vsexpm1, vshypot, vslog10, vslog1p, vslog, vslog21p, vslog, vspow, vsqdrt, vsrcbrt, vsrec, vsrqdrt, vsrsqrt, vssin, vssincos, vssinh, vssqrt, vstan, vstanh, vpopcnt4, vpopcnt8.

- Adds a new SIMD library libmass_simdp8.a that contains the following routines tuned for POWER8 processors: acosd2, asind2, atan2d2, atand2, atanhd2, cbrtd2, cosd2, coshd2, divd2, erfcd2, erfd2, exp2d2, exp2m1d2, expd2, expm1d2, hypotd2, lgammad2, log10d2, log1pd2, log2d2, log21pd2, logd2, powd2, qdrtd2, rcbrtd2, recipd2, rqdrtd2, rsqrtd2, sind2,


sincosd2, sinhd2, sqrtd2, tand2, tanhd2, acosf4, acoshf4, asinf4, asinhf4, atan2f4, atanf4, atanhf4, cbrtf4, cosf4, coshf4, divf4, erfcf4, erff4, expf4, exp2f4, expm1f4, exp2m1f4, hypotf4, log10f4, log1pf4, log2f4, log21pf4, logf4, powf4, qdrtf4, rcbrtf4, recipf4, rqdrtf4, rsqrtf4, sinf4, sincosf4, sinhf4, sqrtf4, tanf4, tanhf4.

Prerequisites

If you are using any of the following IBM compilers, be aware that a version of the MASS libraries is shipped with the compiler. For these, follow the normal support process for your compiler.

* IBM XL C/C++ for AIX, V7.0 or higher
* IBM XL C for AIX, V7.0 or higher
* IBM XL Fortran for AIX, V9.1 or higher

We recommend using MASS with the IBM XL compilers, since they provide optimizations closely-coupled to MASS for ease of use and enhanced performance.

Installation Instructions

The MASS libraries for AIX are packaged as a compressed tar file, MASS_8.1.3_aix61.tar.gz. The license documents are included in the tar package, and are also provided for separate download.

The tar file creates the directory mass/8.1.0/aix61 with subdirectories LICENSE, lib, include, and src. These directories contain the following files:

* LICENSE/
* The MASS license documents.

* lib/
* libmass.a - MASS scalar library for general use.
* libmassvp4.a - MASS vector library with functions tuned for the POWER4+ architecture.
* libmassvp5.a - MASS vector library with functions tuned for the POWER5 architecture.
* libmassvp6.a - MASS vector library with functions tuned for the POWER6 architecture.
* libmassvp7.a - MASS vector library with functions tuned for the POWER7 architecture.
* libmassvp8.a - MASS vector library with functions tuned for the POWER8 architecture.
* libmass_simdp7.a - MASS SIMD library with functions tuned for the POWER7 architecture.
* libmass_simdp8.a - MASS SIMD library with functions tuned for the POWER8 architecture.

* src/
* libmassv.f - Fortran source file of simple loops for the MASS vector functions, for use on non-IBM machines.
* libmassv.c - C/C++ source file of simple loops for the MASS vector functions, for use on non-IBM machines.

* include/
* mass.include - Header file containing the Fortran interface block for scalar functions that are not Fortran intrinsics.
* massv.include - Header file containing the Fortran interface blocks for the vector functions.
* mass_simd.include - Header file containing the Fortran interface blocks for the SIMD functions.
* mass_simdp7.include - Deprecated version of mass_simd.include.
* mass.h - Header file containing the C/C++ prototypes for scalar functions not in math.h.
* massv.h - Header file containing C/C++ prototypes for the vector functions.
* mass_simd.h - Header file containing C/C++ prototypes for the SIMD functions.
* mass_simdp7.h - Deprecated version of mass_simd.h.

The MASS libraries are more convenient to use when they are installed with root access and linked to the conventional /usr/lib/ directory because the user can specify the shorthand -lmass flags during compilation, instead of specifying an explicit path for the libraries. If you have root access, follow the instructions for installing as root. Otherwise, follow the instructions for installing as non-root.

The .tar file creates the subdirectory mass/8.1.3/aix61 in the current directory.

Installing as Root
----------------------
1. login as root
-- or --
su to root

2. Change to the /usr/lpp/ directory:
cd /usr/lpp

3. Uncompress the .tar file (the instructions below assume it is located in /tmp):

tar -xzvf /tmp/MASS_8.1.3_aix61.tar.gz
-- or --
gunzip /tmp/MASS_8.1.3_aix61.tar.gz
tar -xvf /tmp/MASS_8.1.3_aix61.tar

MASS files are restored to the directory /usr/lpp/mass/8.1.3/aix61

4. Create symbolic links from the installation directory to /usr/lib/ so that users can specify a flag, such as -lmass, to link MASS libraries:

ln -s /usr/lpp/mass/8.1.3/aix61/lib/libmass.a /usr/lib/libmass.a
ln -s /usr/lpp/mass/8.1.3/aix61/lib/libmassv.a /usr/lib/libmassv.a
ln -s /usr/lpp/mass/8.1.3/aix61/lib/libmassvp3.a /usr/lib/libmassvp3.a
ln -s /usr/lpp/mass/8.1.3/aix61/lib/libmassvp4.a /usr/lib/libmassvp4.a
ln -s /usr/lpp/mass/8.1.3/aix61/lib/libmassvp5.a /usr/lib/libmassvp5.a
ln -s /usr/lpp/mass/8.1.3/aix61/lib/libmassvp6.a /usr/lib/libmassvp6.a
ln -s /usr/lpp/mass/8.1.3/aix61/lib/libmassvp7.a /usr/lib/libmassvp7.a
ln -s /usr/lpp/mass/8.1.3/aix61/lib/libmassvp8.a /usr/lib/libmassvp8.a
ln -s /usr/lpp/mass/8.1.3/aix61/lib/libmass_simdp7.a /usr/lib/libmass_simdp7.a
ln -s /usr/lpp/mass/8.1.3/aix61/lib/libmass_simdp8.a /usr/lib/libmass_simdp8.a

Installing as Non-Root
----------------------------
1. Go to the directory where the MASS subdirectory should be created.

2. tar -xzvf /tmp/MASS_8.1.3_aix61.tar.gz
-- or --
gunzip /tmp/MASS_8.1.3_aix61.tar.gz
tar -xvf /tmp/MASS_8.1.3_aix61.tar


Note: Some Web browsers will uncompress the tar file before restoring. If the previous instructions result in the error message:

MASS_8.1.3_aix61.tar.gz: not in compressed format

then try the following:

mv MASS_8.1.3_aix61.tar.gz MASS_8.1.3_aix61.tar
tar -xvf /tmp/MASS_8.1.3_aix61.tar

Off
[{"DNLabel":"LICENSE","DNDate":"16-5-9","DNLang":"English","DNSize":"272384","DNPlat":{"label":"AIX","code":"PF002"},"DNURL":"https://public.dhe.ibm.com/aix/products/ccpp/mass/license.tar","DNURL_FTP":" ","DDURL":null},{"DNLabel":"MASS Version 8.1.3 for AIX 6.1","DNDate":"10-4-23","DNLang":"English","DNSize":"20264458","DNPlat":{"label":"AIX","code":"PF002"},"DNURL":"https://public.dhe.ibm.com/aix/products/ccpp/mass/aix/MASS_8.1.3_aix61.tar.gz","DNURL_FTP":" ","DDURL":null}]

Technical Support

If you are using any of the following IBM compilers, be aware that a version of the MASS libraries is shipped with the compiler. For these, follow the normal support process for your compiler.

* IBM XL C/C++ for AIX, V7.0 or higher
* IBM XL C for AIX, V7.0 or higher
* IBM XL Fortran for AIX, V9.1 or higher

We recommend using MASS with the IBM XL compilers, since they provide optimizations closely-coupled to MASS for ease of use and enhanced performance.

The software provided in this Web download is not officially supported by IBM. However, you can send queries to the following e-mail address:

[email protected]

[{"Product":{"code":"SSVKBV","label":"Mathematical Acceleration Subsystem"},"Business Unit":{"code":"BU050","label":"BU NOT IDENTIFIED"},"Component":"Downloads","Platform":[{"code":"PF002","label":"AIX"}],"Version":"8.1.3","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
25 October 2021

UID

swg24026515