|
|
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
|