You can create messages as text files in any environment outside Natural and convert them into message files to be maintained with the SYSERR utility. Message files are created and maintained with the import and export functions of the SYSERR utility.
Message files are created in a platform-independent format, which is portable across any Natural-supported UNIX, OpenVMS and Windows platforms. For example, a message file created in a Natural for Windows environment, can be copied onto a UNIX or an OpenVMS platform without manual conversion; the necessary endian conversion is performed by Natural. For further information, see Portable Natural System Files in the Operations documentation and Transferring Natural Generated Programs in the Programming Guide.
This section covers the following topics:
The message files must be stored with the file extension .MSG in the Natural Err directories.
The message files are stored in the following Natural directories:
Natural\NATAPPS\FUSER\library-ID\Err
Natural\Natural
version\FNAT\library-ID\Err
Natural\Natural version\Err
User-defined message files are stored in the Err subdirectory of the library in the FNAT or FUSER system file from which the application is executed, the steplib, or the SYSTEM library.
For Natural system messages, the message files must be stored in the Err subdirectory in the Natural root directory. Natural system messages are stored in eight message files.
For Natural system or user-defined messages, the import function of the SYSERR utility generates a message file from one text file.
To create such a text file, you must use a specific layout, as shown in the following example:
NAT 0010 0100 0010E NO MESSAGE TEXT DEFINED! 0020E MISSING/INVALID SYNTAX; UNDEFINED VARIABLE-NAME. 0025E ERROR IN ENTRY FOR NUMBER OF RECORDS TO BE PROCESSED. 0050E INCORRECT FIELD SPECIFICATION IN 'WHERE' CLAUSE. #PLEASE CHECK PROGRAM #FOR ERRORS 0100E FUNCTION NOT AVAILABLE.
NAT
or
|
The prefix of the message number to be
displayed with the message. The default prefix is NAT for Natural
system messages and the library ID for user-defined messages.
|
0010 |
The four-digit starting number of a range of messages. |
0100 |
The four-digit ending number of a range of messages. All message numbers that are defined in this text file must be within this range. |
0010E |
NO MESSAGE TEXT DEFINED!
This is the short message for message number 0010. The
Explanatory long messages must be placed immediately below this short message; each of these additional lines must start with a hash/number (#) sign. Up to 20 additional lines of long message text are allowed for each short message. |
The SYSERR utility provides the option to generate a message file from a text file.
For user-defined messages, one output message file can be created in one language for each library. Each message file must be stored in the Err subdirectory of that library.
For user-defined messages, the name of the message file must be:
NnnAPMSL.MSG
where nn is the language code
(01 - 60), for example 01 for
English.
For Natural system messages, the name of the message file must be:
NnnLmmmm.MSG
where nn is the language code to be used and mmmm the starting number of the message range. The ranges of message numbers are fixed, as defined during Natural system installation, for example:
N01L0000
|
Messages 1 - 1999 |
N01L2000 |
Messages 2000 - 2999 |
To generate a message file
The SYSERR utility provides the option to recreate a text file for message text maintenance. This is done by reconverting a messages file into a text file.
To recreate a message text file