rxmgr Command Line for Standalone X Manager

You can run X Manager and start and run clients and sessions from the command line. You can also use the command line to remove clients and sessions.

Starting Clients and Sessions

You can run X Manager and start clients and sessions from a command line using the following syntax:

rxmgr [-client client_name] [-xdmcp xdmcp_definition | [direct|indirect|broadcast,[host_address],[timeout ],[onLastClient ],[sessionName ]] [-launchGroup launchGroup_Name] [-session session_name ] [-minimize] [-trayOnly] [-noUI] [-execOnly] [-import filename_or_URL ] [-noStart] [-noMigrate] [-?]

This example starts the xterm client and the session associated with it. In this example X Manager runs minimized.

rxmgr -client xterm -minimize

These examples show two ways to start multiple clients (and any sessions associated with these clients). You can include all the clients on the command line or use a saved launch group definition. Quotation marks are required around the client and launch group definition names in these examples because the names include spaces.

rxmgr -client "Client 1" -client "Client 2" -client "Client 3"

-or-

rxmgr -launchGroup "Work Group"

This example starts an XDMCP connection to "Myhost" without using an existing definition and without showing the X Manager for Domains window. When the user logs out of the XDMCP session, the session stops and X Manager exits.

rxmgr -xdmcp direct,Myhost,,Exit, -noUI

This example launches X Manager with limited functionality. The user can launch existing definitions, but not add or modify definitions:

rxmgr -execOnly

Removing Clients or Sessions

You can remove clients or sessions from the Reflection X database using the following syntax:

rxmgr -noStart [-delClient client_name1] [-delClient client_name2] [-delSession session_name1] [-delSession session_name2]

You can list as many client and session names as you want. Sessions or clients with duplicate names are deleted from the database. Client and session names with spaces must reside within quotes.

Importing Definitions

You can import definition files to the Reflection X database using the following syntax:

rxmgr \[-import definition_file] -noStart

You can also specify to delete client and session definitions in the database that have the same names as those contained in the definition file you are importing.

rxmgr [-importdefinition_file] -delDupClients -delDupSessions -noStart

Command Line Options

The following command line options are all optional.

note

Use the following syntax rules for the rxmgr command line:

Options are not case sensitive.
Session and client names are case sensitive.
Paths and definition names that include spaces must be enclosed in double quotation marks (" ").

Option	Description
`-client` `client_name`	Specify a client definition to start. To start multiple clients, use multiple client parameters (or configure a launch group.)
`-xdmcp` `xdmcp_definition`	Start an XDMCP connection using an existing definition name.
-or-	-or-
`-xdmcp direct`\|`indirect`\|`broadcast,[``host_address``],[``timeout``],[``onLastClient``],[``sessionName``]`	Specify XDMCP connection information directly on the command line. Specify host address using a DNS name or IP address. If the host address is omitted, the user is prompted. Specify timeout in seconds; the default is 15. Valid values for onLastClient are Nothing(or N), Reset (or R), Stop (or S), or Exit (or E). The default is Reset. Specify an existing session definition; the default will create a temporary session definition. Do not use spaces after the commas in this option, and include a comma as placeholder for any option you don't need to specify. For example: `-xdmcp direct,myhost,,E,`
`-launchGroup` `group_name`	Launch all X clients and/or XDMCP connections in the specified launch group definition.
`-session` `session_name`	Specify a session definition to start. To start multiple sessions, use multiple session parameters.
`-minimize`	Start in a minimized state. This option is ignored if it's not supported by the operating system. This option is ignored if trayOnly is also specified.
`-trayOnly`	Start with a tray icon but without opening the X Manager window.
	Note: When a session is started with this option, you can use either the tray icon or the Start menu to open the X Manager window.
`-noUI`	Start with an icon in the tray area and without allowing the user to open the X Manager window. With this option, the Open X Manager option is disabled from the tray icon; the Exit and Help Topics options remain available.
	Note: When a session is started with this option, it is not possible to open the X Manager window from the Start menu until the session is closed and you stop X Manager using the tray icon's Exit option.
`-execOnly`	Start with the user interface restricted to a list of definitions (X Clients, XDMCP Connections, Launch Groups, Sessions) and the basic controls to start, stop, leave and join. Items that allow creating new definitions, deleting definitions, or accessing other features (such as keyboard maps and color maps) related to definitions are not available.
`-import` `filename_or_URL`	X Manager imports the specified Reflection X definition file before starting the user interface. You can specify a file path or a URL (for example `"http://localhost/settings.rxd"`). Quotation marks are required if the file or path includes spaces.
`-noStart`	X Manager will terminate instead of starting the user interface. Use `noStart` in combination with `import` if you want to import settings without starting X Manager. If `noStart` is specified, all other command line options except `import` are ignored.
`-noMigrate`	Affects initial startup actions as follows: Disables automatic import of the Sample Definitions in the template `generic_templates.rxd`, and any added templates configured for automatic import on first run. Disables migration of settings from legacy Reflection X and Exceed. Disables display of the Import Migrated Settings and Templates dialog box.
`-noMigrate`	Affects initial startup actions as follows: Disables automatic import of the Sample Definitions in the template `generic_templates.rxd`, and any added templates configured for automatic import on first run. Disables migration of settings from legacy Reflection X and Exceed. Disables display of the Import Migrated Settings and Templates dialog box.
`-delClient` `client_name`	Specify a client definition to delete.
`-delSession` `session_name`	Specify a session definition to delete.
`-delDupClients`	Deletes preexisting client definitions that have identical names to any client definitions being imported.
`-delDupSessions`	Deletes preexisting session definitions that have identical names to any session definitions being imported.
`-? or -help`	Displays a summary of command line options.

More information

rxmgrdomains Command Line for X Manager for Domains