3.3 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. You can then use the samples 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 .

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

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


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 File > Import command to manually import templates. Look for installed templates in the templates subfolder in the installation folder, typically:

    C:\Program Files\Micro Focus\Reflection\templates

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

  • Error messages remain in the status bar. Click the 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.