IBM Support

How to enable runtime error messages with LANG and NLSPATH

Technote (FAQ)


How do you enable runtime error messages using XL Fortran for Linux?


Runtime error messages are kept in message catalog files and are loaded at run time. This allows error messages in different languages and character sets to be loaded depending on the system's locale. The executable file uses an environment variable, NLSPATH, to find the locations of the required files, or uses the default installation location.
This issue occurs if the runtime error message catalog is not installed in the default location, and the LANG or NLSPATH environment variables are not set. This is common on systems where non-default compiler installations are used. If the catalog is not installed or found at run time, only the error number is given.


To enable runtime error messages, use the following command to export the NLSPATH environment variable in your work environment:

    export NLSPATH=$NLSPATH:
      xlsmprt_path /msg/%L/%N:
      xlrte_path /msg/%L/%N:
      xlcmp_path /xlf/14.1/msg/%L/%N
    xlsmprt_path is the installation location of the SMP packages. By default, this is /opt/ibmcmp/.

    is the installation location of the IBM® XL Fortran for Linux, V14.1 runtime packages. By default, this is /opt/ibmcmp/.

    is the installation location of the IBM® XL Fortran for Linux, V14.1 compiler packages, if installed. By default, this is /opt/ibmcmp/.

Supported languages are listed in the compiler documentation for the release being used, and are selected with the LANG locale environment variable, which is used to substitute the %L parameter in the NLSPATH value. At a minimum, the English language is supported by two locales:
  • en_US
  • en_US.utf8

Note: The en_US.utf8 naming convention may also be defined as en_US.UTF-8 on some systems. In this case, set the system LANG value to en_US.utf8.

For more information, refer to the "Enabling the error messages" section in the XL Fortran Installation Guide.

Related information

The installation image - National language support
Selecting the language for messages
Environment variables for national language support
Enabling the error messages

Cross reference information
Segment Product Component Platform Version Edition
Software Development XL Fortran for Blue Gene/Q General Information Blue Gene/Q 14.1

Document information

More support for: XL Fortran for Linux

Software version: 12.1, 13.1, 14.1

Operating system(s): Linux

Reference #: 1621644

Modified date: 06 December 2014

Translate this page: