9.7.1 rxmgr Command Line - 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 [-clientclient_name] [-xdmcpxdmcp_definition| [direct|indirect|broadcast,[host_address],[timeout],[onLastClient]][-launchGrouplaunchGroup_Name] [-session session_name][-minimize] [-trayOnly] [-noUI] [‑execOnly] [-importfilename_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 Advantage 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 Advantage 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 [-import definition_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]

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.

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