Set Install National Language Version (NLV) (QINSTLNG) API

This API should be conditionally used prior to installing if you are using IBM supplied media, changing your primary language, and performing an automatic installation. The API will set the install language you plan to install. This value will be reset upon successful completion of the install.

Authorities and Locks

You are required to have system configuration (*IOSYSCFG) special authority to use this API.

Required Parameter Group

NLV language ID

INPUT; CHAR(4)

The national language version (NLV) language identifier to be used for the next upgrade or install.

Notes:

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

Optional Parameter Group

Install language

OUTPUT; CHAR(4)

The 4 character identifier for the selected install NLV language id. If this parameter is not specified, informational message CPIBC09 (NLV &1 is set for the next installation from IBM supplied media) will be sent to the joblog. The following special value may also be returned:

*DFT

No install NLV language id is set. The install will default to the system language unless the optical media was user created by using the SAVSYS command or Create distribution media option of the LICPGM panel. These media are single language media and the install will default to the language on the media.

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

The following messages may be sent from this function:

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