HPlogo MPE/iX Intrinsics Reference Manual > Chapter 9 Command Definitions (MAIL-PUTJCW)

NLGETLANG

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

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:

ValueMeaning
1The user-interface language; specifies the language used for communication between the program and user
2The data language; determines how the subsystem performs various language-dependent data manipulation functions (for example, sorting, upshifting)
3The 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:

ValueMeaning
0Successful
1NLS not installed
2Found language requested, but not configured on system
3Invalid langtype value
4No 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
Manuals Native Language Programmer's Guide




NLFMTNUM


NLINFO