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:

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




NLFMTNUM


NLINFO