rxmgr Command Line - Standalone X Manager

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]][-launchGroup launchGroup_Name] [-session session_name][-minimize] [-trayOnly] [-noUI] [‑execOnly] [-import filename_or_URL][-noStart] [-noMigrate] [-?]

Examples

The following example starts the xterm client and the session associated with it. In this example X Manager will run minimized.

rxmgr -client xterm -minimize

The following 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.

The following 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 will stop and X Manager will exit.

rxmgr -xdmcp direct,Myhost,,Exit -noUI

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

rxmgr -execOnly

Options

The command line options are all optional. Options are case-insensitive. Use quotation marks around paths and definition names that include spaces.

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]

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.

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

-? or -help

Displays a summary of command line options.