Starting and Stopping RTgms

RTgms is normally started and stopped using the rtgms command, which works very much like the rtserver command you use to start an RTserver, which is covered in Starting and Stopping RTserver. Unlike the RTserver, RTgms cannot be automatically started by an RTclient through the use of the start prefix.

where arg_list is optional and consists of one or more arguments, separated by a space:


`-check`	starts the non-optimized version of RTgms.
`-command` `filename`	specifies that RTgms uses the local startup command file named `filename`. This overrides the name of the default local startup command file, `rtgms.cm`, but does not change the search order described in RTgms Startup Command Files.
`-help`	displays a description of the `rtgms` command arguments.
`-install -demandstart` `-autostart`	installs the RTgms process as a Windows service. You can specify either `demandstart` or `autostart` as the startup mode of the service. If you install RTgms as an autostart Windows service, RTgms starts automatically only when the machine is rebooted. This option is supported only on Windows systems.
-no_console	does not display a Windows console associated with the detached process. This option is supported only on Windows systems.
-no_daemon	runs RTgms as a foreground process.
`-password` `pword`	provides the password used by RTgms, along with a password, to connect to RTserver when RTserver has Basic Security enabled. Use with the `-username` argument. `pword` size is unlimited. To specify no password, use empty quotation marks (`""`)
`-server_names` `server_list`	provides a list of RTservers to connect to. This overrides the list provided in the Server_Names option. The list is also used when you specify `-stop_all` or `-stop_rtgms`. `server_list` is a list of logical connection names for RTservers.
`-stop_all`	stops all RTgms processes. If specified together with `-server_names`, the list of servers provided is used to connect to those RTservers and stop all RTgms processes connected to those RTservers.
`-stop_rtgms` `unique_subject`	stops the RTgms process identified by that unique subject. The location of the RTservers to use when looking for the RTgms to stop is specified in `-server_names`.
`-uninstall`	removes the RTgms as a Windows service. This option is only supported on Windows systems.
-username `name`	provides the username used by RTgms, along with a password, to connect to RTserver when RTserver has Basic Security enabled. Use with the `-password` argument. `name` size is restricted to 64 characters.
`-verbose`	informs RTgms to output additional information messages such as, group up, group down, new member join, and member leave.
`-version`	prints a string that displays the latest build information.

Starting RTgms on UNIX

When the startup processing is complete, the operating system prompt displays again.

Starting RTgms as a Service on Windows

If you installed RTgms on a Windows system, the RTgms process can be configured as a Windows service by adding the -install option to the start command.

This example configures the RTgms process to use the autostart mode of a Windows service:

Once configured as a service, the RTgms process is managed through the standard service control manager of Windows.

If you use the -install or -uninstall options when starting an RTgms process on a non-Windows system, such as Sun Solaris, you receive an error message indicating an invalid command line argument, and the process does not start.

Stopping RTgms

To stop a single RTgms, specify the unique subject of that RTgms in your -stop command and specify location of the RTserver to which it is connected in the -server_names argument. For example: