Using Native IME Support in Reflection X Advantage

  • 7021822
  • 14-Oct-2010
  • 24-Mar-2018

Environment

Reflection X Advantage

Situation

You can configure Reflection X Advantage to use your local input method editor (IME). This technical note describes how to configure native IME support and lists troubleshooting methods to resolve IME issues.

Resolution

Reflection X Advantage Native IME Support

If you already use an IME that is available on your workstation, you may want to enable Native IME Support in Reflection X Advantage. This feature lets you use your workstation's IME to compose text. The XIM server provided by Reflection X obtains the composed text from your IME and passes it to XIM-aware clients. This means that you can work with varied X clients without having to learn new input techniques.

The Reflection XIM server supports:

  • On-the-spot and over-the-spot editing.
  • All Unicode characters, including Japanese, Chinese, and Korean characters.

Before you begin, review the following requirements:

  • You must have a native IME (such as Windows IME) installed on your workstation.
  • The X client must use the XIM protocol.
  • The client locale (usually specified by the LANG environment variable) must be one of the following: ja_JP.UTF-8, ja_JP.EUC-JP, ja_JP, C, en_US.UTF-8, ko_KR.UTF-8, ko_KR. (Additional locales can be specified using the Reflection X tcommand-line parameter, “rxaim.locales".)

Configure Reflection X Advantage to Use Your Local IME

Follow these steps to configure Reflection X Advantage to use your local IME:

Version 5.x

  1. Under Session Definitions, select an existing session or create a new one.
  2. In the Session Definition pane, on the Keyboard tab, select Launch XIM server.
  3. Select Force X clients to use Reflection’s XIM server.
  4. Under X Clients, select an existing client or create a new one.
  5. In the Client Definition pane:
    1. Under Default session, select the session you just configured.
    2. In the command line, add XMODIFIERS=@im=RXAIM to the beginning of your command line. This configures the XMODIFIERS environment variable to identify the Reflection X XIM server. For example:
XMODIFIERS=@im=RXAIM /usr/bin/gedit --display=%IP#%

Note: In some cases, you may not need to set the XMODIFIERS variable. If your client is already configured to use a different XIM server, selecting "Force X clients to use Reflection's XIM server" automatically redirects the client to the Reflection X XIM server. In other cases, additional modifications may be required.

  1. Start your client.

You can now start your local input editor and enter text as you usually do. Depending on your X client, you may see on-the-spot or over-the-spot editing.

Version 4.x

  1. Under My sessions, select an existing session or create a new one.
  2. In the Session Definition pane, expand Native IME Support.
  3. Select Launch XIM Server.
  4. Select Force X clients to use Reflection's XIM server.
  5. If you start the X client using a client definition:
    1. Add your client to your session definition.
    2. Display the Client Definition pane and add XMODIFIERS=@im=RXAIM to the beginning of your command line. This configures the XMODIFIERS environment variable to identify the Reflection X XIM server. For example:
XMODIFIERS=@im=RXAIM /usr/bin/gedit --display=%IP#%

Note: In some cases, you may not need to set the XMODIFIERS variable. If your client is already configured to use a different XIM server, selecting "Force X clients to use Reflection's XIM server" automatically redirects the client to the Reflection X XIM server. In other cases, additional modifications may be required.

  1. Start your session.

You can now start your local input editor and enter text as you usually do. Depending on your X client, you may see on-the-spot or over-the-spot editing.

Troubleshooting IME

If after configuring your workstation to use your local IME, you are unable to use your local IME to enter text into the X client, review the following troubleshooting information.

Logging XIM Activity

Enable X input method (XIM) logging and review the X Manager log to determine if your X client is XIM-aware and to see if it is configured to use the Reflection X IME server.

To log XIM activity:

  1. Select the session you have configured to use native IME support.
  2. In the Session Definition pane, click the Logging tab (version 5.x) or expand Logging (version 4.2 and earlier), then select Log XIM activity.
  3. Start your session and attempt to use the local input editor.
  4. Review the log information in xmanager.log.

Configuring Hosts to Support Use of Your Local IME

Use the following platform-specific steps to configure X clients to use the X input method (XIM), which is a requirement for configuring Reflection X to use your local IME.

RedHat 4

Desktop clients (such as gnome-terminal and gedit) on RedHat 4 use an IIIM server by default. To be able to use your local IME with these clients, you need to configure them to use the X Input method (XIM). Use the following procedure.

To configure X clients on RedHat4 to use the XIM server:

  1. Start your session.
  2. Right-click in the client window.
  3. Select X input method from the context menu.

RedHat 5

The RedHat 5 desktop is configured to use SCIM (Smart Common Input Method), and all GTK (Gnome Toolkit) applications use SCIM by default. To be able to use your local IME with these clients, you need to configure them to use the X Input method (XIM). You can configure clients to use XIM by using a context menu that allows you to change the input method, however the context menu is not available by default. Use the following procedure to enable and use this context menu.

To enable the context menu and configure a client to use the XIM server:

  1. Start your session
  2. Execute the following command to enable the context menu.
gconftool-2 --type bool --set '/desktop/gnome/interface/show_input_method_menu' true

Note: You need to execute this command only once for each user of the system; doing this will make the context menu available for subsequent sessions. Be sure to use an apostrophe, not a grave accent in the command.

  1. Right-click in the client window.
  2. Select X input method from the context menu.

HP CDE

Select a supported language before you log on to your XDMCP session. Supported languages are:

ja_JP.UTF-8
ja_JP.EUC-JP
ja_JP
C
en_US.UTF-8
ko_KR.UTF-8
ko_KR
Related Technical Notes

Additional Information

Legacy KB ID

This document was originally published as Attachmate Technical Note 2504.