5.3 Options for MathLM
The following options are available using the mathlm command. On Windows, a slash (/) or a dash (-) may be used to indicate options. To ensure that MathLM can locate the password file, you must use the -pwfile option.
-formatlog 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 5.4.
-help. Prints the MathID and a list of all command-line options. On Windows, this option can also be specified as -?.
-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.
-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 -formatlog. The user running MathLM must have write permission to this location. Otherwise, an error will be reported to stdout and the event log or syslog.
-logginglevel n. Specifies the level of verbosity of server messages written to the file specified by -logfile. The argument n is an integer from 1 to 4. The four levels of verbosity are the same as for the -verbose option.
-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 5.5 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.
-trlang lang. Specifies the language in which to display server messages. The argument lang can be set to English, German, French, or Japanese.
-uninstall. On Windows, stops any currently running mathlm processes and removes mathlm from the list of services.
-verbose n. Prints server messages to stdout and keeps mathlm in the foreground. The numeric argument specifies the level of verbosity with 1 being the least and 4 the most verbose. For each level, startup/shutdown errors will be copied to the event log or syslog. The default value depends on the value of the -logfile and -logginglevel options.
The four levels of verbosity are:
1 - Reports the 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.
2 - Reports everything from level 1 plus all runtime error messages (license denied, restricted, and so on).
3 - 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.
4 - 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 -logfile option is specified but not the -logginglevel option, the default verbosity level is set to 3.
- If -logginglevel is specified without a level, the default is set to 4.
- If -verbose is used without specifying a level, the default is set to 4.
- If -verbose is not used, there is no output to stdout.