Generating Message and Text Files

#### Search Results

Search

# Generating Message and Text Files

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 Linux and Windows platforms. For example, a message file created in a Natural for Windows environment, can be copied onto a Linux 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:

- Storing a Message File

- Creating a Text File

- Generating a Message File

- Recreating a Text File

## Storing a Message File

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.

## Creating a Text File

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:

#### 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.

#### Explanation:

`NAT` or `library-ID` | 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 `E` is mandatory and means error. This message will be issued with the following Natural statement: `REINPUT *0010` 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.

## Generating a Message File

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.

### Naming Conventions

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

- See the Import Text File function of the Options menu described in the section SYSERR Utility Window and Functions.

## Recreating a Text 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

- See the Export Message File function of the Options menu described in the section SYSERR Utility Window and Functions.

### On this page

- Storing a Message File
- Creating a Text File
- Generating a Message File
- Recreating a Text File