CBL_NLS_OPEN_MSG_FILE

Open a National Language Support (NLS) message file.

Syntax:
call "CBL_NLS_OPEN_MSG_FILE" using     msg-filename
                                       msg-filename-ln
                                       msg-file-handle
                             returning status-code
Parameters:
Using call prototype (see Library Routines - Key) Picture (32-bit systems)
msg-filename pic x(n). pic x(n).
msg-filename-ln cblt-x1-compx. pic x comp-x.
msg-file-handle cblt-x4-compx. pic x(4).
status-code See Library Routines - Key.
On Entry:
msg-filename The name of the message file to be opened.
msg-filename-ln The length of msg-filename.
On Exit:
msg-file-handle The identifying handle.
status-code Indicates whether the routine was successful:
0 Success
403 Resulting message too long
405 Illegal or empty supplied file name

If status-code contains a value other than these, it is the number of a run-time error message.

Comments:

This routine opens an NLS message file, returning an identifying handle that you can use with the CBL_NLS_READ_MSG and CBL_NLS_CLOSE_MSG_FILE routines. You can create different message files for each language you want your program to work with, using the same call to access each message in the appropriate national language. You can use a default message file, or create your own.

See Also: