Command Reference Guide

Chapter 2: mx Commands 57

NOTE: Although the mx and mxconsole commands can access clusters

running different versions of Matrix Server, the .matrixrc file can

include groups and wildcards only when connecting to servers

running Matrix Server 3.0 or later. Also, earlier versions of Matrix

Server require that a default server be specified in the matrixrc file.

If you will be connecting to a matrix running an earlier version of

Matrix Server and want to use grouping or wildcards, you can create a

separate matrixrc file for that matrix and specify it with --config.

mx syntax

The mx utility has the following syntax:

mx [mx_options] class command [command_options]

The mx_options affect an entire mx command session. The options are:

--help

Displays a command summary.

--matrix <matrix>

Specifies the matrix that you want to connect with. matrix can be any node

in the matrix.

--config <file>

Specifies the configuration file to be consulted for server, user, and

password information. The file must have the same format as matrixrc.

--file <file>

Executes the commands from the specified file. If you specify – instead of a

file, the commands will be read from standard input. You can also specify

--continue to tell mx to continue processing the batch file if an error

occurs.

--prompt <prompt>

Specifies the prompt string that will be printed when mx is ready for

another command. This option is useful when you initiate an interactive

session with the option --file -. For example, if you invoke an interactive

session with the following command, mx will print a % prompt when it

completes a command.

mx --prompt ’%’ --file –