a00acf provides a convenient means of checking the availability of a valid licence key on licence-managed implementations before starting computations that will use NAG Library routines. In particular, the use of this function is highly recommended in programs that call NAG Library routines within multithreaded sections (e.g., OpenMP parallel regions). The function need only be called once, before the start of the first multithreaded section.
2Specification
Fortran Interface
Function a00acf (
)
Logical
::
a00acf
C Header Interface
#include <nag.h>
Nag_Boolean
a00acf_ ()
C++ Header Interface
#include <nag.h>
extern "C" {
Nag_Boolean
a00acf_ ()
}
The routine may be called by the names a00acf or nagf_info_licence.
3Description
a00acf returns the logical value .TRUE. if a valid licence is found, otherwise .FALSE. is returned.
On non licence-managed implementations, .TRUE. is always returned.
4References
None.
5Arguments
None.
6Error Indicators and Warnings
None.
7Accuracy
Not applicable.
8Parallelism and Performance
Background information to multithreading can be found in the Multithreading documentation.
Not applicable.
9Further Comments
None.
10Example
This example prints an appropriate message depending upon the value returned by a00acf.