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