Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄Key► ◄Summary►                             ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
  Description:
 
     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.
 
  Parameters on Entry:
 
     msg-file-name             The name of the message file to be opened.
 
     msg-file-name-length      The length of msg-file-name. If this
                               parameter is set to zero, the default
                               message file will be opened regardless of
                               the contents of msg-file-name.
 
  Parameters on Exit:
 
     msg-file-handle           The identifying handle.
 
     status-code             Indicates whether the routine was successful:
 
                               0 = Success
                              40 = NLS module not initialized
 
                             If status-code contains a value other than
                             these, it will be the number of a run-time
                             error message.
 
     This routine can be used only from a program that was compiled with
     the NLS directive. For more details on National Language Support see
     the chapter National Language Support in your COBOL System Reference.
 
     See also ◄NLS directive►
                                    -♦-