3.6.0 Matrix Server Command Reference (5697-7083, December 2007)

Chapter 3: mx Commands 52

• The first field, machine, is either the name or IP address of the server.

•The second field, user, is optional. It is the name of a user on that server or

the name of a user on a domain to which the server belongs (for example,

mydomain\john).

• The third field is also optional and contains the Matrix Server password for

that user. The password is encrypted automatically when you use the

Matrix Server Connect window to specify the password. A utility is also

available to encrypt the password. (See

“Encrypted passwords in the

.matrixrc file” on page 54.)

• The fourth field, default, specifies that this server will be connected to by

default if a server name is not specified on the command line. Specifying a

default server is optional in Matrix Server 3.2.x and later releases.

Blank lines and lines beginning with a # character are ignored.

Notes regarding the .matrixrc file

When working with the .matrixrc file, you should be aware of the following:

• When editing the .matrixrc file by hand, you need to put quotation marks

around user names or passwords that contain spaces. If there are

backslashes or quotation marks inside the quotation marks, they must be

escaped with the backslash character. For example, if the password is

fr”12 \ad, enter it as “fr\”12 \\ad”. When saving a bookmark on the Matrix

Server Connect dialog, the escape characters are added automatically as

necessary.

• Comments can be lost when the .matrixrc file is edited via the Matrix

Server Connect dialog.

• In Matrix Server releases earlier than 3.x, the mx command cannot

interpret encrypted passwords. If you are using mx and connect to a

matrix running one of these versions of Matrix Server, you will be asked

whether you want Matrix Server to create a temporary .matrixrc file that

contains clear passwords. The temporary file will be deleted when the mx

command is complete.

Specify servers in the .matrixrc file

If you need to control which server is used for the mx connection, list the

servers individually in the matrixrc file or use the mx --matrix command-line