MQParms parameter file - server installation

A parameter file is an ASCII text file that contains sections (stanzas) with parameters that can be used by the MQParms command. Typically, this is an initialization file such as MQParms.ini.

The MQParms command takes parameters from the following stanzas in the file:

[MSI]: Contains general properties related to how the MQParms command runs and to the installation of IBM MQ . The properties that you can set in this stanza are listed in Install the server using msiexec, and Table 1.
[Services]: Contains properties related to IBM MQ account configuration, in particular, the user account required for IBM MQ Services. If you are installing IBM MQ on a network where the domain controller is on a Windows 2003 server, you probably need details of a special domain account. For more information, see Configure IBM MQ with the Prepare IBM MQ Wizard and Creating and setting up Windows domain accounts for IBM MQ. The properties that we can set in this stanza are listed in Table 3.

MQParms ignores any other stanzas in the file. The stanza parameters are in the form property=value, where property is always interpreted as uppercase, but value is case sensitive. If a value string includes a blank, it must be enclosed in double quotation marks. Most other values can be enclosed in double quotation marks. Some properties can take more than one value, for example:

ADDLOCAL="Server,Client"

To clear a property, set its value to an empty string, for example:

REINSTALL=""

The following tables show the properties that we can set. The default is shown in bold.

For the [MSI] stanza, we can enter standard MSI command line options and properties. For example:

- /q
- ADDLOCAL="server"
- REBOOT=Suppress

Refer to Table 1, Table 2, and Table 3 for the properties used to install IBM MQ. Table 1 shows additional properties in the stanza that affect how the MQParms command runs, but that do not affect the installation.

Table 1. Properties used by MQParms in the MSI stanza
Property	Values	Description
MQPLOG	path \| file_name	MQParms generates a text log file with the specified name and location.
MQPLANGUAGE	system \|user\| transform_value \|existing	The installation language. system. Install using the language of the default system locale (the default). user. Install using the language of the default locale of the user. transform_value. Install using the language specified by this value. See Table 2. existing. If IBM MQ already exists on the system, the same language will be used by default, otherwise system is used.
MQPSMS	0 \|no	0 or no. MQParms does not wait for the msiexec command to end (the default). Any other value. MQParms waits for the msiexec command to end.
MQPINUSE	0 \|1	If MQPINUSE is set to 1, MQParms continues installing even if IBM MQ files are in use. If this option is used a reboot will be required to complete the installation.

Table 2. Valid values for the MQPLANGUAGE property
Language	Valid values
U.S. English	English	en_us	1033
German	German	de_de	1031
French	French	fr_fr	1036
Spanish	Spanish	es_es	1034
Italian	Italian	it_it	1040
Brazilian Portuguese	Brazilian Portuguese	pt_br	1046
Japanese	Japanese	ja_jp	1041
Korean	Korean	ko_kr	1042
Simplified Chinese	Simplified Chinese	zh_cn	2052
Traditional Chinese	Traditional Chinese	zh_tw	1028
Czech	Czech	cs_cz	1029
Russian	Russian	ru_ru	1049
Hungarian	Hungarian	hu_hu	1038
Polish	Polish	pl_pl	1045

For the [Services] stanza, we can enter parameters in property=value format. You might want to encrypt the values in this stanza. See Encrypting a parameter file.

Table 3. Properties used in the Services stanza
Property	Values	Description
USERTYPE	local \| domain \| onlydomain	The type of user account to use: local Creates a local user account. domain Creates a local user account. If this does not have the required security authorities, it uses the domain user account specified by DOMAINNAME, USERNAME, and PASSWORD. onlydomain Does not create a local user account, but immediately uses the domain user account specified by DOMAINNAME, USERNAME and PASSWORD. If any of these three properties are missing, a USERTYPE of local is assumed. The properties DOMAINNAME, USERNAME, and PASSWORD are required if USERTYPE is set to onlydomain.
DOMAINNAME	domain_name ¹	The domain for the domain user account. Required if USERTYPE is set to domain or onlydomain.
USERNAME	user_name ¹	The user name for the domain user account. Required if USERTYPE is set to domain or onlydomain..
PASSWORD	password ¹	The password for the domain user account. Required if USERTYPE is set to domain or onlydomain.
Do not enclose this value in double quotation marks.

A typical example of a parameter file is:

[MSI]
MQPLANGUAGE=1033
MQPLOG=%temp%\MQParms.log
MQPSMS=no
ADDLOCAL=Server
/m miffile
REMOVE=""
/l*v c:\install.log

[Services]
USERTYPE=domain
DOMAINNAME=mqm*df349edfcab12
USERNAME=mqm*a087ed4b9e9c
PASSWORD=mqm*d7eba3463bd0a3