HP 3000 Manuals

NLS Intrinsics [ MPE XL Native Language Programmer's Guide ] MPE/iX 5.0 Documentation


MPE XL Native Language Programmer's Guide

NLS Intrinsics 

Application programs and Hewlett-Packard subsystems call NLS to obtain
language-dependent information for any language installed on a system.
The following table lists the NLS intrinsics and their functions:

          Table 3-1.  NLS Intrinsic Categories 

-----------------------------------------------------------------------------------------------
|                   |                   |                                                     |
|     Function      |     Intrinsic     |                     Description                     |
|                   |                   |                                                     |
-----------------------------------------------------------------------------------------------
|                   |                   |                                                     |
| Information       | ALMANAC           | Returns numeric data information.                   |
| Retrieving        |                   |                                                     |
|                   |                   |                                                     |
|                   | NLGETLANG         | Returns the current language.                       |
|                   |                   |                                                     |
|                   | NLINFO            | Returns language-dependent information.             |
|                   |                   |                                                     |
-----------------------------------------------------------------------------------------------
|                   |                   |                                                     |
| Character         | NLCOLLATE         | Compares two character strings.                     |
| Handling          |                   |                                                     |
|                   |                   |                                                     |
|                   | NLFINDSTR         | Searches for a string.                              |
|                   |                   |                                                     |
|                   | NLJUDGE           | Determines whether a character is a one-byte or     |
|                   |                   | two-byte Asian character.                           |
|                   |                   |                                                     |
|                   | NLKEYCOMPARE      | Compares strings of different length.               |
|                   |                   |                                                     |
|                   | NLREPCHAR         | Replaces nondisplayable characters.                 |
|                   |                   |                                                     |
|                   | NLSCANMOVE        | Moves and scans character strings.                  |
|                   |                   |                                                     |
|                   | NLSTRANSLATE      | Translates strings to/from EBCDIC.                  |
|                   |                   |                                                     |
|                   | NLSUBSTR          | Returns a string.                                   |
|                   |                   |                                                     |
|                   | NLSWITCHBUF       | Converts a string of characters from phonetic order |
|                   |                   | to screen order and vice versa.                     |
|                   |                   |                                                     |
-----------------------------------------------------------------------------------------------
|                   |                   |                                                     |
| Number Formatting | NLCONVNUM         | Converts numbers from native to internal form.      |
|                   |                   |                                                     |
|                   | NLFMTNUM          | Formats an internal number in native form.          |
|                   |                   |                                                     |
|                   | NLNUMSPEC         | Returns information needed for formatting and       |
|                   |                   | converting numbers.                                 |
|                   |                   |                                                     |
-----------------------------------------------------------------------------------------------

          Table 3-1.  NLS Intrinsic Categories (continued) 

-----------------------------------------------------------------------------------------------
|                   |                   |                                                     |
|     Function      |     Intrinsic     |                     Description                     |
|                   |                   |                                                     |
-----------------------------------------------------------------------------------------------
|                   |                   |                                                     |
| Application       | CATCLOSE          | Closes a message catalog.                           |
| Message Catalog   |                   |                                                     |
|                   |                   |                                                     |
|                   | CATOPEN           | Opens a message catalog.                            |
|                   |                   |                                                     |
|                   | CATREAD           | Reads information from a message catalog.           |
|                   |                   |                                                     |
|                   | NLAPPEND          | Concatenates a file name and a language number.     |
|                   |                   |                                                     |
-----------------------------------------------------------------------------------------------

Refer to the MPE XL Intrinsics Reference Manual (32650- 90028) for a
complete description of each intrinsic.

NLS provides support features for language data and local custom formats
in FCOPY, IMAGE, KSAM, QUERY, SORT-MERGE, and VPLUS. The emphasis of NLS
in the subsystems is on providing the end user, rather than the
application designer, with local language data and formats.  User
interface (prompts, commands, and messages) of the subsystem utility
programs are not localized (for example, FORMSPEC and DBUTIL).


NOTE None of these changes are automatic. All existing applications and jobs work the same way they did prior to the NLS installation unless they are modified to request NLS functions.


MPE/iX 5.0 Documentation