HP 3000 Manuals

NLGETLANG [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

NLGETLANG 

NM and CM callable.

Returns a language ID number that characterizes the current user, data,
or system.  Hewlett-Packard subsystems and application programs use
NLGETLANG for automatic configuration.

Syntax 
__________________________________________
|                                        |
|       I16                I16V   U16A   |
|     langnum:=NLGETLANG(langtype,error);|
__________________________________________

            

Functional Return 

langnum               16-bit signed integer (assigned functional return) 

                      Returns the language ID number of the current user,
                      data, or system.  If an error occurs, langnum 
                      returns a value of 0 (NATIVE3000/XL).

Parameters 

langtype              16-bit signed integer by value (required) 

                      Contains the function number indicating which type
                      of language ID number is returned.  The possible
                      values are:

                         Value    Meaning 

                           1      The user-interface language; specifies the language
                                  used for communication between the program and user

                           2      The data language; determines how the subsystem
                                  performs various language-dependent data manipulation
                                  functions (for example, sorting, upshifting)

                           3      The system default language

error                 16-bit unsigned integer array (required) 

                      Returns two elements:  the first element is the
                      error number; the second element is reserved and
                      always returns 0.  The possible error number values
                      are:

                         Value    Meaning 

                           0      Successful

                           1      NLS not installed

                           2      Found language requested, but not configured on system

                           3      Invalid langtype value

                           4      No language specified

Operation Notes 

The NLGETLANG intrinsic locates the language ID numbers requested by
langtype 1 and 2 by referring to the Hewlett-Packard defined job control
words (JCWs), NLUSERLANG and NLDATALANG respectively.  If the required
JCW does not exist or has a value greater than or equal to FATAL (32768),
The error value of 4 is returned.

Related Information 

Intrinsics            ALMANAC, NLINFO

Commands              None

Manuals               Native Language Programmer's Guide (32650-90022)



MPE/iX 5.0 Documentation