|
|
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
- Manual
Native Language Programmer's Guide
|