The LOAD.LANGUAGE command loads a new set of message definitions into the QM message library.
QM includes support for text message output in multiple languages. The standard message library installed with QM contains English messages texts. Additional language libraries may be available from Ladybridge Systems or from QM dealers. Users can also perform their own translations of the source text downloaded from the product web site.
The default message text source file is available for download from the openqm.com web site and includes comment lines detailing the rules for successful translation. It is strongly recommended that users should use the two letter international country code as the language identifier in the PREFIX line (e.g. FR for French) but variations are permitted such as, perhaps, CHF for Swiss French.
A set of message texts obtained by download of a pre-translated file or by translation of the default English messages can be installed by executing
in the QMSYS account where pathname points to the message text file to be installed. A single system may have any number of languages installed and the non-English messages will be preserved at an upgrade.
The message text source file uses UTF-8 encoding for any characters with codepoint values over 127. The LOAD.LANGUAGE command will read the named file using this encoding. On non-ECS mode systems, all characters in the source text must, after decoding, lie in the 8-bit character set. Any characters outside the 8-bit character set will be written to the message library incorrectly.
Message text are stored in a file named MESSAGES in the QMSYS account. On first installation of QM, this file will be created in either ECS or non-ECS mode depending on the mode of the underlying QM system. Installing an ECS mode version of QM over a non-ECS mode version will automatically reconfigure the messages file to ECS mode. The reverse action, installing a non-ECS mode version of QM over an ECS mode version will delete and recreate the file, populating it only with the standard English messages. Any locally applied alternative messages would need to be reloaded.