5.2. SSL II library

The SSL II library is a thread-safe numerical calculation library that provides 10 sub-routines.

The thread parallel version is provided with parallel processing algorithms and interfaces for important functions that can have parallel effects.

1. Linear calculation

2. Eigenvalue eigenvector

3. Nonlinear calculation

4. Extreme value problem

5. Interpolation, approximation

6. Conversion

7. Numerical calculus

8. Differential equation

9. Special functions

10. Pseudo random number

5.2.1. How to Fortran compile

To use SSL II from a Fortran program, specify -SSL2 or -SSL2BLAMP option.

To link SSL II/MPI library, specify -SSL2MPI option to mpifrtpx command and also specify -SSL2 or -SSL2BLAMP.

Compile example is as following:

1. MPI / Auto parallel / SSL II (Mainly multi node job)

[_LNlogin]$ mpifrtpx -Kfast,parallel,SVE sample.f90 -SSL2MPI -SSL2

2. MPI / OpenMP / SSL II (Mainly multi node job)

[_LNlogin]$ mpifrtpx -Kfast,parallel,openmp,SVE sample.f90 -SSL2MPI -SSL2

3. Sequential / SSL II (Single node job)

[_LNlogin]$ frtpx  -Kfast,SVE sample.f90  -SSL2

4. Auto parallel / SSL II (Single node job)

[_LNlogin]$ frtpx  -Kfast,parallel,SVE sample.f90 -SSL2

5. OpenMP / SSL II (Single node job)

[_LNlogin]$ frtpx -Kfast,openmp,SVE sample.f90 -SSL2

See also

• The subroutine name and interface of the SSL II subroutine are different between the thread parallel version and the serial version.

• When performing separate compilation, specify these options when linking.

• When joining with a login node, if –KSVE is enabled, combine libraries that are using SVE.

• When joining with a login node, if –KNOSVE is enabled, combine general purpose libraries.

• If combine with computing node, specifying -KSVE or -KNOSVE combine library using SVE.

• -KSVE option’s default (when omitted) will be -KSVE.

• To translate the user program with the native compiler and combine SSL II, use frt command.

• To translate a user program written in MPI using a native compiler and combine SSL II / MPI, use mpifrt command.

5.2.2. Sample program (SSL2 / Fortran)

This indicates compile example using sample program.

1. Prepare a source program.

   Prepare a sample program as /home/system/sample/SSL2/sample_SSL2.f.

   (Download a sample code)

2. Compile a sample program.

[_LNlogin]$ frtpx -V -Kfast,optmsg=2,SVE -Nlst=t -o sample_SSL2 sample_SSL2.f -SSL2

3. Prepare a job script.

   Prepare a job script as /home/system/sample/SSL2/sample_SSL2.sh.

   (Download a sample code)

4. Submit a job with pjsub command.

[_LNlogin]$ pjsub sample_SSL2.sh
[INFO] PJM 0000 pjsub Job 140 submitted.

5.2.3. Program return value when used from C language

SSL II is a Fortran library, but it can also be used from the C language.

When SSL II is used from C language, the return value of the program differs depending on the function name executed at the beginning of C.

Keep this in mind if you want to use the C return value.

For details, refer to “7.2 Linking with Fortran” in the “C User’s Guide”.

Function name	Return value of program
main	C return value
MAIN__	Fortran return value However, if the Fortran return value is 0, the C return value is returned.