Launch an X Client Application Using the Sample Definitions

Reflection X Advantage installs several sample definitions by default. In many cases you can get connected without making any changes to these sample settings, then use the sample as a model for making additional connections.

To connect using a sample X client definition

  1. Start X Manager or X Manager for Domains.
  2. Under X Clients on the left, select one of the sample definitions. You can use the generic "xterm" definition. Or, if you imported templates for your host type, select one of these (such as "Linux - xterm" or "VMS - DECterm"). Connect using any of these methods:
    • Double-click the definition name.
    • Select the definition, then in the toolbar click Start.
    • Right-click the definition name and click Start
  3. Enter your host and user name in reply to the prompt.

    If the host is available and supports Secure Shell connections, you see the Host Key Unknown message the first time you connect. Click Always to trust the host key. Reflection X Advantage saves this key and uses it in subsequent connections to confirm that you're connecting to the correct host.

  4. Enter your password in response to the prompt.

    If your connection is successful, a window opens on your desktop showing your host command prompt.

You can clone the sample client definition to create a duplicate copy. By cloning a definition, you create a new definition with the same settings and preserve the original definition to use as a reference. To clone a definition:

  • Right-click the client definition and select Clone Client.

Edit the cloned definition. Changes are saved automatically as you work. For example:

  • Enter values for Host name and User name.
  • Change the value of Host type. This changes the list of sample commands available to you.
  • Edit the Command to start a different X client application. Use the drop-down arrow to view sample commands that typically work for the host type you selected. For more information about client commands, see Configure an X Client.


If you don't see sample definitions listed under X Clients:

  • When you upgrade from a previous version of Reflection X Advantage, no changes are made to your existing settings. This means that after an upgrade, the sample definitions are not imported, even if the correct template is installed. You can use the Import command to manually import templates. Look for installed templates in the templates subfolder in the installation folder, typically:

    C:\Program Files\Attachmate\Reflection\templates

  • For help creating a new definition without using the sample definitions, see Configure an X Client.

If you're unable to make a connection using one of the sample definitions:

  • Look at the status bar at the bottom of the X Manager window for information. For additional information about each error, click the information button, Taskbar information icon.
  • Error messages remain in the status bar. Click the delete button,status delete button, to clear messages between tests.

Here are a few common errors.


Error Message

Troubleshooting help

Secure Shell connection refused.

The host was reached but does not support Secure Shell connections. Try changing the Connection method.

Unknown host: <hostname>

The host name you specified isn't reachable. Check your entry or try specifying a host IP address instead of using the host name.

User does not exist.

You entered an invalid user name. This error also shows up if you leave the username blank in response to the logon information prompt.

Client failed to connect to the X server

The specified Command isn't valid on your host. Try one of the other sample commands, or manually edit the command to match your host configuration. Note that the sample commands listed change based on one the current value for Host type. If Host type is set to Generic UNIX, change it to match your host type before you select another sample command.

Related Topics

Configure an X Client

Set Up Secure Shell (SSH) Connections

Connection Problems