cde/doc/C/guides/man/man1_dt/imsstart.sgm

   1 <!-- $XConsortium: imsstart.sgm /main/8 1996/09/08 19:53:40 rws $ -->
   2 <!-- (c) Copyright 1996 Digital Equipment Corporation. -->
   3 <!-- (c) Copyright 1996 Hewlett-Packard Company. -->
   4 <!-- (c) Copyright 1996 International Business Machines Corp. -->
   5 <!-- (c) Copyright 1996 Sun Microsystems, Inc. -->
   6 <!-- (c) Copyright 1996 Novell, Inc. -->
   7 <!-- (c) Copyright 1996 FUJITSU LIMITED. -->
   8 <!-- (c) Copyright 1996 Hitachi. -->
   9 <![ %CDE.C.CDE; [<refentry id="cde.IMS.dtimsstart">]]>
  10 <refmeta><refentrytitle>dtimsstart</refentrytitle><manvolnum>user cmd</manvolnum>
  11 </refmeta>
  12 <refnamediv><refname><command>dtimsstart</command></refname><refpurpose>launches
  13 an input method server</refpurpose></refnamediv>
  14 <refsynopsisdiv>
  15 <cmdsynopsis>
  16 <command>dtimsstart</command><arg choice="opt">&minus;env</arg><arg choice="opt">&minus;ims <replaceable>name</replaceable></arg><arg choice="opt">&minus;shell <replaceable>name</replaceable></arg><arg choice="opt">&minus;host <replaceable>hostname</replaceable></arg><arg choice="opt">&minus;imsopt <replaceable>options</replaceable></arg>
  17 <arg choice="opt">&minus;list</arg>
  18 </cmdsynopsis>
  19 </refsynopsisdiv>
  20 <refsect1>
  21 <title>DESCRIPTION</title>
  22 <para>The <command>dtimsstart</command> command launches an IMS (Input Method
  23 Server). <command>dtimsstart</command> is normally invoked automatically
  24 at Xsession startup (user login) by the script <filename>/usr/dt/config/Xsession.d/0020.dtims</filename>.</para>
  25 <para>Depending on the currently selected locale, environment variables,
  26 configuration files, and command-line options, <command>dtimsstart</command>
  27 displays a selection window from which you can select the IMS you want to
  28 use. Once you select the IMS, <command>dtimsstart</command> starts it and
  29 waits until the IMS completes its startup. This is to ensure that applications
  30 wishing to connect to the IMS can do so. <command>dtimsstart</command> then
  31 sets the <Symbol>XMODIFIERS</Symbol> environment variable to ensure that
  32 clients can connect to the selected IMS. Finally, <command>dtimsstart</command>
  33 exits.</para>
  34 <para>Once you select an IMS from the selection window, <command>dtimsstart</command> saves the selection in the IMS Selection File. To have <command>dtimsstart</command> automatically start the previously selected IMS, set
  35 the IMS Selection Mode to <literal>resume-current-input-method</literal>.
  36 You access the IMS Selection Mode by executing the <Symbol>DtImsMode</Symbol>
  37 action located in <literal>Desktop_Tools</literal> in the Application Manager.
  38 </para>
  39 <para>For IMS Selection Mode, you can choose:</para>
  40 <variablelist>
  41 <varlistentry><term><literal>ask-at-login</literal></term>
  42 <listitem>
  43 <para>Instructs <command>dtimsstart</command> to display the selection window
  44 and prompt you for an IMS each time it is invoked.</para>
  45 </listitem>
  46 </varlistentry>
  47 <varlistentry><term><literal>resume-current-input-method</literal></term>
  48 <listitem>
  49 <para>Instructs <command>dtimsstart</command> to automatically start the last
  50 selected IMS by using the saved IMS Selection File and without displaying
  51 the selection window.</para>
  52 </listitem>
  53 </varlistentry>
  54 </variablelist>
  55 <refsect2>
  56 <title>Remote Execution of IMS</title>
  57 <para>If you use the <literal>&minus;host</literal> option to have <command>dtimsstart</command> start an IMS on a remote host, <command>dtimsstart</command>
  58 does the following:</para>
  59 <itemizedlist><listitem><para>Executes the <Symbol>DtImsGetRemoteConf</Symbol>
  60 action to retrieve IMS configuration data from the specified remote system
  61 </para>
  62 </listitem><listitem><para>Lists the IMSs registered on the remote system
  63 in the selection window</para>
  64 </listitem><listitem><para>Executes the <Symbol>DtImsRunRemoteIms</Symbol>
  65 action to start the selected IMS on the remote system.</para>
  66 </listitem></itemizedlist>
  67 <para>For more information on configuring remote execution, refer to
  68 the <emphasis>Common
  69 Desktop Environment: Advanced User's and System Administrator's Guide</emphasis>.
  70 </para>
  71 </refsect2>
  72 </refsect1>
  73 <refsect1>
  74 <title>OPTIONS</title>
  75 <para>The following options are available:</para>
  76 <variablelist>
  77 <varlistentry><term><literal>&minus;env</literal></term>
  78 <listitem>
  79 <para>Outputs the contents of the <Symbol>XMODIFIERS</Symbol> environment
  80 variable to stdout. <command>dtimsstart</command> automatically updates this
  81 variable to reflect the currently selected IMS. Use this option to verify
  82 that the intended IMS is the one that is being started. If you omit this
  83 option, no output occurs.</para>
  84 </listitem>
  85 </varlistentry>
  86 <varlistentry><term><literal>&minus;ims</literal> <emphasis>name</emphasis></term>
  87 <listitem>
  88 <para>The name of the IMS to be started. If you specify this option, <command>dtimsstart</command> starts the IMS without displaying the selection window.
  89 If you omit this option, <command>dtimsstart</command> displays the selection
  90 window.</para>
  91 </listitem>
  92 </varlistentry>
  93 <varlistentry><term><literal>&minus;shell</literal> <emphasis>name</emphasis></term>
  94 <listitem>
  95 <para>The output format to use, of output, if <literal>&minus;env</literal>
  96 is specified. If you omit this option, <command>dtimsstart</command> uses
  97 the value of $SHELL as the default.</para>
  98 </listitem>
  99 </varlistentry>
 100 <varlistentry><term><literal>&minus;host</literal> <emphasis>hostname</emphasis></term>
 101 <listitem>
 102 <para>The name of the host on which the IMS is to run. If you omit this option, <command>dtimsstart</command> uses the local host as the default.</para>
 103 </listitem>
 104 </varlistentry>
 105 <varlistentry><term><literal>&minus;imsopt</literal> <emphasis>options</emphasis></term>
 106 <listitem>
 107 <para>The command line options for the selected IMS.</para>
 108 </listitem>
 109 </varlistentry>
 110 <varlistentry><term><literal>&minus;list</literal></term>
 111 <listitem>
 112 <para>Instructs <command>dtimsstart</command> to output the names of input
 113 methods registered on the system and then exit immediately.</para>
 114 </listitem>
 115 </varlistentry>
 116 </variablelist>
 117 </refsect1>
 118 <refsect1>
 119 <title>EXIT STATUS</title>
 120 <variablelist remap="tight">
 121 <varlistentry><term>0</term>
 122 <listitem>
 123 <para>The IMS was started successfully.</para>
 124 </listitem>
 125 </varlistentry>
 126 <varlistentry><term>1</term>
 127 <listitem>
 128 <para>Execution failed for one of the following reasons:</para>
 129 <itemizedlist><listitem><para>The started IMS did not complete its initialization
 130 within the timeout period.</para>
 131 </listitem><listitem><para>The started IMS process aborted.</para>
 132 </listitem><listitem><para>The IMS specified by the <literal>&minus;ims</literal>
 133 option is not registered.</para>
 134 </listitem></itemizedlist>
 135 </listitem>
 136 </varlistentry>
 137 <varlistentry><term>2</term>
 138 <listitem>
 139 <para>A syntax error was found.</para>
 140 </listitem>
 141 </varlistentry>
 142 </variablelist>
 143 </refsect1>
 144 <refsect1>
 145 <title>ENVIRONMENT VARIABLES</title>
 146 <para><command>dtimsstart</command> references the following environment
 147 variables:</para>
 148 <variablelist>
 149 <varlistentry><term><systemitem class="environvar">HOME</systemitem></term>
 150 <listitem>
 151 <para>The home directory.</para>
 152 </listitem>
 153 </varlistentry>
 154 <varlistentry><term><systemitem class="environvar">LANG</systemitem></term>
 155 <listitem>
 156 <para>The locale.</para>
 157 </listitem>
 158 </varlistentry>
 159 <varlistentry><term><systemitem class="environvar">DISPLAY</systemitem></term>
 160 <listitem>
 161 <para>The type of display on which IMS is to be run.</para>
 162 </listitem>
 163 </varlistentry>
 164 </variablelist>
 165 <para>It sets the <systemitem class="environvar">XMODIFIERS</systemitem> variable
 166 to the name of the selected IMS to support application and client connections.
 167 </para>
 168 </refsect1>
 169 <refsect1>
 170 <title>ACTIONS/MESSAGES</title>
 171 <para>The following actions relevant to <command>dtimsstart</command> are
 172 defined in the <filename>dtims.dt</filename> file.</para>
 173 <variablelist>
 174 <varlistentry><term><systemitem class="environvar">DtImsMode</systemitem></term>
 175 <listitem>
 176 <para>Change the IM Selection Mode. This action is located at <literal>Desktop_Tools</literal> in the Application Manager.</para>
 177 </listitem>
 178 </varlistentry>
 179 <varlistentry><term><systemitem class="environvar">DtImsGetRemoteConf</systemitem></term>
 180 <listitem>
 181 <para>Retrieve IMS configuration data on a remote system (used internally
 182 by <command>dtimsstart</command>).</para>
 183 </listitem>
 184 </varlistentry>
 185 <varlistentry><term><systemitem class="environvar">DtImsRunRemoteIms</systemitem></term>
 186 <listitem>
 187 <para>Run an IMS on a remote system (used internally by <command>dtimsstart</command> ).</para>
 188 </listitem>
 189 </varlistentry>
 190 </variablelist>
 191 </refsect1>
 192 <refsect1>
 193 <title>ERRORS/WARNINGS</title>
 194 <para><command>dtimsstart</command> can output the following error messages
 195 to stderr:</para>
 196 <variablelist>
 197 <varlistentry><term>invalid option `<emphasis>string</emphasis>'</term>
 198 <listitem>
 199 <para>Correct the indicated option string.</para>
 200 </listitem>
 201 </varlistentry>
 202 <varlistentry><term>environment variable `HOME' not defined</term>
 203 <listitem>
 204 <para>Make sure that HOME is set properly.</para>
 205 </listitem>
 206 </varlistentry>
 207 <varlistentry><term>environment variable `LANG' not defined</term>
 208 <listitem>
 209 <para>Make sure that LANG is set properly.</para>
 210 </listitem>
 211 </varlistentry>
 212 <varlistentry><term>environment variable `DISPLAY' not defined</term>
 213 <listitem>
 214 <para>Make sure that DISPLAY is set properly.</para>
 215 </listitem>
 216 </varlistentry>
 217 <varlistentry><term>cannot open display &lsquo;<emphasis>display_name</emphasis>&rsquo;&rdquo;</term>
 218 <listitem>
 219 <para>Make sure that DISPLAY is set to the correct value.</para>
 220 </listitem></varlistentry>
 221 </variablelist>
 222 <para><command>dtimsstart</command> can display the following error messages
 223 in an error dialog box:</para>
 224 <variablelist>
 225 <varlistentry><term>cannot open file [<emphasis>/usr/dt/config/ims/start.conf</emphasis> ]</term>
 226 <listitem>
 227 <para>This is an installation error. Re-install the package.
 228 </para>
 229 </listitem>
 230 </varlistentry>
 231 <varlistentry><term>cannot create file [<emphasis>file_path</emphasis>]</term>
 232 <listitem>
 233 <para>Make sure the file and its parent directory have write permission.</para>
 234 </listitem>
 235 </varlistentry>
 236 <varlistentry><term>cannot create directory [<emphasis>$HOME/.dt/ims</emphasis>]</term>
 237 <listitem>
 238 <para>Make sure the parent directory has write permission.</para>
 239 </listitem>
 240 </varlistentry>
 241 <varlistentry><term>missing `<emphasis>entry_name</emphasis>' entry in configuration
 242 file [file_path]</term>
 243 <listitem>
 244 <para>Correct the indicated entry in the indicated file.</para>
 245 </listitem>
 246 </varlistentry>
 247 <varlistentry><term>another `dtimsstart' is already running</term>
 248 <listitem>
 249 <para>Terminate the already running <command>dtimsstart</command> and then
 250 restart.</para>
 251 </listitem>
 252 </varlistentry>
 253 <varlistentry><term>cannot create selection file [<emphasis>file_path</emphasis>]</term>
 254 <listitem>
 255 <para>Make sure the indicated file has write permission.</para>
 256 </listitem>
 257 </varlistentry>
 258 <varlistentry><term>no ims configuration file for `<emphasis>ims_name</emphasis>'</term>
 259 <listitem>
 260 <para>The indicated IMS is registered in the locale configuration file, but
 261 its IMS configuration file does not exist.</para>
 262 </listitem>
 263 </varlistentry>
 264 <varlistentry><term>ims `<emphasis>ims_name</emphasis>' not registered</term>
 265 <listitem>
 266 <para>The indicated IMS name is not registered in the locale configuration
 267 file.</para>
 268 </listitem>
 269 </varlistentry>
 270 <varlistentry><term>no executable file for `<emphasis>ims_name</emphasis>'
 271 [file_path]</term>
 272 <listitem>
 273 <para>The indicated IMS executable does not exist.</para>
 274 </listitem>
 275 </varlistentry>
 276 <varlistentry><term>ims `<emphasis>ims_name</emphasis>' is already running</term>
 277 <listitem>
 278 <para>The indicated IMS is already running on the display.</para>
 279 </listitem>
 280 </varlistentry>
 281 <varlistentry><term>cannot execute ims `<emphasis>ims_name</emphasis>'</term>
 282 <listitem>
 283 <para>The <function>fork</function> call failed. The errno is shown in the
 284 log file, <filename>$HOME/.dt/ims/imslog</filename>.</para>
 285 </listitem>
 286 </varlistentry>
 287 <varlistentry><term>ims `<emphasis>ims_name</emphasis>' aborted</term>
 288 <listitem>
 289 <para>The IMS process aborted. Refer to the log file, <filename>$HOME/.dt/ims/imslog</filename>, for details.</para>
 290 </listitem>
 291 </varlistentry>
 292 <varlistentry><term>ims `<emphasis>ims_name</emphasis>' is not available yet</term>
 293 <listitem>
 294 <para>The indicated IMS was not available within the 3-minute timeout period.
 295 </para>
 296 </listitem>
 297 </varlistentry>
 298 <varlistentry><term>unknown host `<emphasis>host_name</emphasis>'</term>
 299 <listitem>
 300 <para>The network address of the indicated host cannot be found.</para>
 301 </listitem>
 302 </varlistentry>
 303 <varlistentry><term>no ims registered on `<emphasis>host_name</emphasis>'</term>
 304 <listitem>
 305 <para>No IMS is registered on the indicated host for the current locale.</para>
 306 </listitem>
 307 </varlistentry>
 308 <varlistentry><term>ims `<emphasis>ims_name</emphasis>' not registered on
 309 `<emphasis>host_name</emphasis>'</term>
 310 <listitem>
 311 <para>The indicated IMS is not registered on the indicated host.</para>
 312 </listitem>
 313 </varlistentry>
 314 </variablelist>
 315 <para>Note that other error messages can be generated by <function>DtActionInvoke</function> or various Xt functions. These messages are self-explanatory.
 316 </para>
 317 </refsect1>
 318 <refsect1>
 319 <title>FILES</title>
 320 <variablelist>
 321 <varlistentry><term><filename>/usr/dt/bin/dtimsstart</filename></term>
 322 <listitem>
 323 <para><command>dtimsstart</command> executable</para>
 324 </listitem>
 325 </varlistentry>
 326 <varlistentry><term><filename>/usr/dt/app-defaults/&lt;locale_name>/Dtimsstart</filename></term>
 327 <listitem>
 328 <para><command>dtimsstart</command> resource file</para>
 329 </listitem>
 330 </varlistentry>
 331 <varlistentry><term><filename>/usr/dt/appconfig/types/&lt;locale_name>/dtims.dt</filename></term>
 332 <listitem>
 333 <para>action definition file</para>
 334 </listitem>
 335 </varlistentry>
 336 <varlistentry><term><filename>/usr/dt/appconfig/appmanager/&lt;locale_name>/Desktop_Tools/DtImsMode</filename></term>
 337 <listitem>
 338 <para>action files for <function>DtImsMode<function></function></function></para>
 339 </listitem>
 340 </varlistentry>
 341 <varlistentry><term><filename>/usr/dt/lib/nls/msg/&lt;locale_name>/dtimsstart.cat</filename></term>
 342 <listitem>
 343 <para>message catalog file</para>
 344 </listitem>
 345 </varlistentry>
 346 <varlistentry><term><filename>/usr/dt/config/Xsession.d/:0020.dtims</filename></term>
 347 <listitem>
 348 <para>Xsession.d script file</para>
 349 </listitem>
 350 </varlistentry>
 351 <varlistentry><term><filename>/usr/dt/config/ims/start.conf</filename></term>
 352 <listitem>
 353 <para><command>dtimsstart</command> configuration file</para>
 354 </listitem>
 355 </varlistentry>
 356 <varlistentry><term><filename>/usr/dt/config/ims/&lt;locale_name></filename></term>
 357 <listitem>
 358 <para>locale entry files</para>
 359 </listitem>
 360 </varlistentry>
 361 <varlistentry><term><filename>/usr/dt/config/ims/&lt;ims_name></filename></term>
 362 <listitem>
 363 <para>IMS entry files</para>
 364 </listitem>
 365 </varlistentry>
 366 <varlistentry><term><filename>$HOME/.dt/ims/&lt;locale_name></filename></term>
 367 <listitem>
 368 <para>IMS selection file</para>
 369 </listitem>
 370 </varlistentry>
 371 <varlistentry><term><filename>$HOME/.dt/ims/&lt;display_name>/&lt;locale_name></filename></term>
 372 <listitem>
 373 <para>display-specific IMS selection file</para>
 374 </listitem>
 375 </varlistentry>
 376 <varlistentry><term><filename>$HOME/.dt/ims/imslog</filename></term>
 377 <listitem>
 378 <para><command>dtimsstart</command> log file</para>
 379 </listitem>
 380 </varlistentry>
 381 </variablelist>
 382 <refsect2>
 383 <title>Resource Files</title>
 384 <para><command>dtimsstart</command> searches a proper resource file in the
 385 following order and loads the first file successfully opened.</para>
 386 <orderedlist><listitem><para><filename>$HOME/.dt/&lt;display-name>/current/dt.resources</filename></para>
 387 </listitem><listitem><para><filename>$HOME/.dt/&lt;display-name>/home/dt.resources</filename></para>
 388 </listitem><listitem><para><filename>$HOME/.dt/sessions/current/dt.resources</filename></para>
 389 </listitem><listitem><para><filename>$HOME/.dt/sessions/home/dt.resources</filename></para>
 390 </listitem><listitem><para><filename>/usr/dt/config/&lt;locale-name>/sys.resources</filename></para>
 391 </listitem><listitem><para><filename>/usr/dt/config/C/sys.resources</filename></para>
 392 </listitem></orderedlist>
 393 </refsect2>
 394 <refsect2>
 395 <title>Configuration Files</title>
 396 <para><command>dtimsstart</command> refers to the following configuration
 397 files:</para>
 398 <itemizedlist><listitem><para>Locale Entry file</para>
 399 </listitem><listitem><para>IMS configuration file</para>
 400 </listitem><listitem><para>IMS Selection file</para>
 401 </listitem></itemizedlist>
 402 <para>The location and format for each configuration file is listed below.
 403 </para>
 404 <refsect3>
 405 <title>Locale Entry File</title>
 406 <para>This file lists the IMSs that support the locale. Its location is <filename>/usr/dt/config/ims/&lt;locale_name></filename>. The format
 407 is:</para>
 408 <para>@Default: <emphasis>ims_name</emphasis></para>
 409 <para><emphasis>ims_name</emphasis>: <emphasis>label_string</emphasis></para>
 410 <para>For example:</para>
 411 <programlisting><filename>/usr/dt/config/ims/ja_JP.SJIS</filename>
 412
 413 @Default:  xjim
 414 xjim:      HP XJIM
 415 atok8:     ATOK8
 416 vje:       VJE-gamma
 417 egbridge:  EGBridge
 418 none:      No Input Method</programlisting>
 419 </refsect3>
 420 <refsect3>
 421 <title>IMS Entry File</title>
 422 <para>This file describes the attributes of an IMS. Its location is
 423 <filename>/usr/dt/config/ims/&lt;ims_name></filename>. The format is:
 424 </para>
 425 <para><emphasis>attribute_name</emphasis>: <emphasis>attribute_value</emphasis></para>
 426 <para>The IMS attributes are:</para>
 427 <variablelist>
 428 <varlistentry><term><literal>protocols</literal></term>
 429 <listitem>
 430 <para>A required String that lists the supported protocols. The supported
 431 XIM protocols are XIM, Ximp, and Xsi.</para>
 432 </listitem>
 433 </varlistentry>
 434 <varlistentry><term><literal>server_name</literal></term>
 435 <listitem>
 436 <para>A required String that identifies the IMS name (used to update the <Symbol>XMODIFIERS</Symbol> environment variable).</para>
 437 </listitem>
 438 </varlistentry>
 439 <varlistentry><term><literal>cmd_path</literal></term>
 440 <listitem>
 441 <para>A required Path type that specifies the absolute path of the executable
 442 file for the identified IMS server. A built-in keyword is used for the local
 443 IM built-in Xlib, which does not need a separate process.</para>
 444 </listitem>
 445 </varlistentry>
 446 <varlistentry><term><literal>cmd_param</literal></term>
 447 <listitem>
 448 <para>A String that specifies the command line option(s) for the IMS server.
 449 </para>
 450 </listitem>
 451 </varlistentry>
 452 <varlistentry><term><literal>env_set</literal></term>
 453 <listitem>
 454 <para>A String that identifies the environment variables to be set, excluding <Symbol>XMODIFIERS</Symbol>.</para>
 455 </listitem>
 456 </varlistentry>
 457 <varlistentry><term><literal>env_unset</literal></term>
 458 <listitem>
 459 <para>A String that identifies environment variables to be unset, excluding <Symbol>XMODIFIERS</Symbol>.</para>
 460 </listitem>
 461 </varlistentry>
 462 <varlistentry><term><literal>env_pass</literal></term>
 463 <listitem>
 464 <para>A String that identifies the environment variables to be passed to
 465 a remotely executing IMS, excluding <Symbol>LANG</Symbol>, <Symbol>DISPLAY</Symbol>, and <Symbol>XMODIFIERS</Symbol>.</para>
 466 </listitem>
 467 </varlistentry>
 468 <varlistentry><term><literal>has_window</literal></term>
 469 <listitem>
 470 <para>A Bool indicating whether the IMS has its own main window appearance
 471 or not. The default is False.</para>
 472 </listitem>
 473 </varlistentry>
 474 <varlistentry><term><literal>no_server</literal></term>
 475 <listitem>
 476 <para>A Bool indicating whether <command>dtimsstart</command> should start
 477 the IMS or not. It should be True for the local IM, since it doesn't require
 478 any server process started by <command>dtimsstart</command>. The default
 479 is False.</para>
 480 </listitem>
 481 </varlistentry>
 482 <varlistentry><term><literal>no_remote</literal></term>
 483 <listitem>
 484 <para>A Bool indicating whether the IMS allows remote execution or not. The
 485 default is False.</para>
 486 </listitem>
 487 </varlistentry>
 488 <varlistentry><term><literal>no_option</literal></term>
 489 <listitem>
 490 <para>A Bool indicating whether the IMS allows the command-line option or
 491 not. If True, any options specfied by <literal>&minus;imsopt</literal> are
 492 ignored, though the value of the <literal>cmd_param</literal> entry is always
 493 applied regardless of this value. It should be True for the local IMS. The
 494 default is False.</para>
 495 </listitem>
 496 </varlistentry>
 497 </variablelist>
 498 <note>
 499 <para>For entries that accept multiple values, the values are separated by
 500 white space(s). If multiple entries of the same name appear in the file,
 501 only the last entry is used.</para>
 502 </note>
 503 <para>For example:</para>
 504 <programlisting><filename>/usr/dt/config/ims/xjim</filename>
 505
 506 protocols:    XIM Ximp
 507 server_name:  xjim
 508 cmd_path:     /usr/bin/X11/xjim
 509 cmd_param:    -iconic
 510 env_set:
 511 env_unset:
 512 env_pass:
 513 has_window:   true</programlisting>
 514 </refsect3>
 515 <refsect3>
 516 <title>IMS Selection File</title>
 517 <para>This file saves the most recently selected IMS for each locale. Its
 518 location is <filename>$HOME/.dt/ims/[&lt;display_name>/]&lt;locale_name></filename>. The format is:</para>
 519 <para><emphasis>entry_name</emphasis>: <emphasis>entry_value</emphasis></para>
 520 <para>The selection file entries are:<?Pub Caret></para>
 521 <variablelist>
 522 <varlistentry><term><literal>@SelectMode</literal></term>
 523 <listitem>
 524 <para>The most recently set IMS Selection Mode. Valid values are 0 (zero)
 525 (for <literal>ask-at-login</literal>) and 1 (for <literal>resume-current-input-method</literal> ).</para>
 526 </listitem>
 527 </varlistentry>
 528 <varlistentry><term><literal>@ImsName</literal></term>
 529 <listitem>
 530 <para>The name of the most recently selected IMS.</para>
 531 </listitem>
 532 </varlistentry>
 533 <varlistentry><term><literal>@HostName</literal></term>
 534 <listitem>
 535 <para>The name of the host on which the IMS runs.</para>
 536 </listitem>
 537 </varlistentry>
 538 </variablelist>
 539 <para>For example:</para>
 540 <programlisting><filename>$HOME/.dt/ims/ja_JP.SJIS</filename>
 541
 542 @SelectMode:  1
 543 @ImsName:     atok8
 544 @HostName:    host-A</programlisting>
 545 </refsect3>
 546 </refsect2>
 547 </refsect1>
 548 <refsect1>
 549 <title>EXAMPLE</title>
 550 <para>The command to execute <command>dtimsstart</command> in the
 551 <filename>/usr/dt/config/Xsession.d/0020.dtims</filename> script is as follows:</para>
 552 <programlisting>eval  ` /usr/dt/bin/dtimsstart  -env -shell ksh `</programlisting>
 553 </refsect1>
 554 <refsect1>
 555 <title>SEE ALSO</title>
 556 <para>TO BE SUPPLIED</para>
 557 </refsect1>
 558 </refentry>