Install Secondary Language (QLPISLNG) API

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 Software Installation book.

2. Both 29xx and 57xx are accepted for this parameter. The Software Installation book lists secondary language IDs as 57xx and primary language IDs as 29xx. Therefore, to eliminate the possibility of failing the installation when the calling program passes a 57xx language ID, the API accepts both the 29xx and 57xx language IDs.

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 follow:

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

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.