|
The QM executable stored in the bin subdirectory of the QMSYS account has a number of command line options. The command option letters shown below are all case insensitive. Note that to comply with Linux conventions, some of the options have a double hyphen prefix.
| -n | Logs the user in as user n where the value of n must be in the range of user numbers reserved with the FIXUSERS configuration parameter. If the FIXUSERS parameter has not been set, the full range of QM user numbers is available for use in this way. If there is already a user logged in with this user number, the login fails. If the value of n is not within the reserved range, the parameter is ignored. |
| -A | Causes QM to prompt for the account name on entry. |
| -Aname | Enters account name unless there is a fixed account name defined for the user name of the user entering QM. Note that there is no space before the account name. |
| -DL | Initiate device licensing negotiation for entry to QM from the operating system command prompt. |
| -K n | Kill the QM process for user n. |
| -K PID n | Kill the QM process for operating system process id n. |
| -K user | Kill all QM processes for login id user. |
| -K all | Kill all QM processes. |
| -CLEANUP | Scans QM's internal list of users to identify any processes that have terminated abnormally and, if found, tidies up from the lost process. |
| -QUIET | Suppresses display of release information, etc on entry to QM. Useful in some scripted sessions. |
| -RESTART | Restart QM (not Windows). |
| -RESUME | Resume database updates. |
| -START | Start QM (not Windows). |
| -STDOUT | (Windows only) QM normally uses the Windows console APIs to output data to the screen. This option causes it to use the stdout file handle and is of use when capturing the output or piping it into other processes. It should not be used for normal terminal output as some display features may not work with this option. |
| -STOP | Stop QM (not Windows). |
| -SUSPEND | Suspend database updates. |
| -TERM xxx | Sets the initial terminal type. This may be changed later from within the application. If this option is not used, QM defaults to the value of the operating system TERM environment variable or, if this is not defined, vt100. |
| -UTF8 | Sets the terminal mode as UTF-8 (Not Windows). |
| --HELP | Display usage help. |
| --VERSION | Displays version information. |
It is also possible to execute a QM command directly from the operating system command prompt by appending it to the start up of the QM session, after any other command options. For example:
qm RUN OVERNIGHT
Note that quotes may be needed if the QM command contains any characters with special meaning to the operating system. Use of QM in this way can be detected by use of the SYSTEM(1026) function that will return the command (e.g. RUN OVERNIGHT in the above example).
Environment Variables
| QMDL | If defined, entry to QM from the operating system command prompt behaves as though the -DL option had been used. |
| QMSYS | Normally the location of the QMSYS directory is derived from the pathname of the QM executable as this is installed in the bin subdirectory of the QMSYS account. Specifies alternative default location for QMSYS account directory. Also used by QMConnectLocal() if a non-default location is used. |
| TMP | Specifies location of temporary directory if the TEMP configuration parameter is not set. |
|
