Launch an X Client Application Using the Sample Definitions

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

Troubleshooting

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

• When you upgrade from a previous version of Reflection X, 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.