HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

NLGETLANG

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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

Commands

None

Manuals

Native Language Programmer's Guide (32650-90022)

Feedback to webmaster