QM Command Options

Top  Previous  Next

 

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.

 

-nLogs 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 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.

 

-ACauses QM to prompt for the account name on entry.

 

-AnameEnters 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.

 

-K nKill the QM process for user n.

 

-K userKill all QM processes for login id user.

 

-K allKill all QM processes.

 

-LApply a new licence.

 

-UList current QM users.

 

-QUIETSuppresses display of release information, etc on entry to QM. Useful in some scripted sessions.

 

-RESTARTRestart QM (not Windows).

 

-RESUMEResume database updates.

 

-STARTStart 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.

 

-STOPStop QM (not Windows).

 

-SUSPENDSuspend database updates.

 

-TERM xxxSets 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.

 

--HELPDisplay usage help.

 

--VERSIONDisplays 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.