2.1 Command-Line Options

The mathlm command supports the following command-line options. On Windows, a slash (/) or a dash (-) may be used to indicate options.

-foreground

Keeps mathlm in the foreground and prints server messages to stdout.

-help

Prints the MathID number and a list of all command-line options. On Windows, this option can also be specified as -? or /?.

-install

On Windows only, installs mathlm as a service program and automatically starts the service. When this option is specified, all additional arguments are stored as part of the mathlm command and used when starting mathlm automatically.

-language lang

Specifies the language in which to display server messages. The argument lang can be set to English, German, French, or Japanese.

-localtime

Uses local time instead of GMT in server messages.

-logfile file

Writes server messages to file. The format for server messages is determined by the option -logformat. The user running MathLM must have write permission to file. Otherwise, an error will be reported to stdout. On Windows, this error is also written to the event log.

-logformat string

Specifies the format for displaying server messages. The default format is the W3C Common Logfile Format. For information on editing the string argument to change the display format, see Section 2.2, Monitoring License Activity.

-loglevel n

Specifies the level of verbosity of server messages written to the file specified by -logfile. The numeric argument specifies the level of verbosity with 1 being the least and 4 the most verbose. For each level, startup/shutdown errors are copied to the event log on Windows. The default verbosity level depends on the settings of other options.

The four levels are as follows.

Reports server startup/shutdown errors (password file could not be found, log file could not be written to, and so on). A message stating that MathLM has been started is also displayed.
Reports everything from level 1 plus all runtime error messages (license denied, restricted, and so on).
Reports everything from level 2 plus all license activity (license requests, returns, and so on). This level also displays startup messages showing the process ID, socket number, and so on.
Reports everything from level 3 plus debugging information (network communication) and a license table for every license transaction. This level is designed mainly for interactive debugging.

If the -foreground option is used, the default verbosity level is set to 4.

If the -logfile option is specified without the -loglevel option, the default is set to 3.

If the -loglevel option is specified without a level, the default is set to 4.

-noremotemonitor

Specifies that MathLM cannot be remotely monitored via MonitorLM.

-pwfile file

Specifies a file in which to look for Mathematica passwords.

-restrict file

Uses the script contained in file to limit or deny access to specified users or machines. See Section 2.3, Restricting and Reserving Licenses, for information on how to write a restriction script.

-timeout n

Returns a suspended license after n hours. The default is infinity.

-trfile file

Specifies a file that defines substitutions for the text of error messages. This provides a simple way of replacing error messages by their translated equivalents.

-uninstall

On Windows only, stops any currently running mathlm processes and removes mathlm from the list of services.