Install Secondary Language (QLPISLNG) API


  Required Parameter Group:

1 NLV language ID Input Char(4)
2 Device Input Char(10)
3 Interactive mode screen I/O indicator Input Char(1)
4 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The Install Secondary Language (QLPISLNG) API installs the secondary language that is specified in the NLV language ID parameter. It allows both an interactive mode and a batch mode of installation to install the secondary language.


Authorities and Locks

Public API authority
*EXCLUDE
User authority
*SAVSYS
Device lock
*EXCLRD
Secondary language library lock
*SHRUPD

Required Parameter Group

NLV language ID
INPUT; CHAR(4)

The national language version (NLV) language identifier of the secondary language to install.

Notes:

  1. For a list of secondary languages, see the Installing, upgrading, or deleting IBM® i and related software topic collection.

  2. For convenience, you can enter the language identifier in the form of a primary language ID (29xx). Both primary and secondary language IDs are accepted for this parameter.


Device
INPUT; CHAR(10)

The name of the device from which to install.

Interactive mode screen I/O indicator
INPUT; CHAR(1)

An indicator as to whether screen I/O is desired in interactive mode. Valid values are:

0 Screen I/O is not desired
1 Screen I/O is desired

Note: When the API runs in batch mode, no screen I/O is provided regardless of the value of this indicator.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

Message ID Error Message Text
CPD3DAC E Device &1 is not a valid installation device.
CPF24B4 E Severe error while addressing parameter list.
CPF3C90 E Literal value cannot be changed.
CPF3CF1 E Error code parameter not valid.
CPF3DAA E NLV language ID &1 is not valid.
CPF3DAB E Secondary language installation is not complete.
CPF3DAC E Language ID specified is the primary language ID.
CPF3DAD E Screen I/O parameter value is not valid.
CPF3DAE E Not authorized to the secondary language installation process.
CPF9814 E Device &1 not found.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V3R6

[ Back to top | Software Product APIs | APIs by category ]