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:
- For a list of secondary languages, see the Installing, upgrading, or deleting IBM® i and related software topic collection.
- 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.
- For a list of secondary languages, see the Installing, upgrading, or deleting IBM® i and related software topic collection.
- 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