iim.conf File Syntax

This file is a plain ASCII text file, with each line defining a server parameter and its value(s):

• A parameter and its value(s) are separated by an equal sign (=) with spaces and tabs allowed before or after the equal sign.

• A value can be enclosed in double quotes (" "). If a parameter allows multiple values, the entire value string must be enclosed in double quotes.

• A comment line must have an exclamation point (!) as the first character of the line. Comment lines are for informational purposes and are ignored by the server.

• If a parameter appears more than once, the value of the last parameter listed overrides the previous value.

• A backslash (\) is used for continuation and indicates the value(s) are longer than one line.

• Each line is terminated by a line terminator (\n, \r, or \r\n).

• The key consists of all the characters in the line starting with the first non-whitespace character and up to the first ASCII equal sign (=) or semi-colon (;). If the key is terminated by a semi-colon, it is followed by “lang-” and a tag that indicates the language in which this value is to be interpreted. The language tag is followed by an equal sign (=). All whitespace characters before and after the equal sign are ignored. All remaining characters on the line become part of the associated value string.

• Multiple values in the value string are separated using commas (,).

• Within a value, if any special characters like comma, space, newline, tab, double quotes, or backslash are present, the entire value needs to be within double quotes. In addition, every carriage return, line feed, tab, backslash, and double quotes within the value must specified with a backslash (\).

• If you make changes to iim.conf, you must refresh the Instant Messaging server in order for the new configuration settings to take effect.

The iim.conf file is initialized by the installation process and should be modified only as described in this guide.