<refentry id="xmode">
<refnamediv>
<refname>XMODE</refname>
<refpurpose>Examine or Change Device Initialization Mode</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>xmode</command>
<arg choice="plain"><replaceable>devname</replaceable></arg>
<arg choice="opt"><replaceable>arglist</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para>
This command is used to display or change the initialization
parameters of any SCF-type device such as the video display,
printer, RS232 port, etc. A common use is to change baud rates,
control key definitions, etc.
</para>
<para>
<command>Xmode</command> is very similar to the <command>tmode</command> command.
<command>Tmode</command> only operates on
open paths so its effect is temporary. <command>Xmode</command> actually updates the
device descriptor so the change persists as long as the computer is
running, even if paths to the device are repetitively opened and
closed. If <command>xmode</command> is used to change parameter(s) and the <command>cobbler</command>
program is used to make a new system disk, the changed parameter
will be permanently reflected on the new system disk.
</para>
<para>
<command>Xmode</command> requires a device name to be given. If no arguments are
given, the present values for each parameter are displayed,
otherwise, the parameter(s) given in the argument list are
processed. Any number of parameters can be given, and are separated
by spaces or commas.
</para>

</refsect1>
<refsect1><title>XMODE Parameter Names</title>

<informaltable frame="none">
<tgroup cols="2">
<colspec colwidth="1in"/>
<colspec colwidth="4in"/>
<tbody>
<row>
<entry>upc</entry>
<entry>Upper case only. Lower case characters are automatically
converted to upper case.</entry>
</row>
<row>
<entry>-upc</entry>
<entry>Upper case and lower case characters permitted (default).</entry>
</row>
<row>
<entry>bsb</entry>
<entry>Erase on backspace: backspace characters echoed as a
backspace-space-backspace sequence (default).</entry>
</row>
<row>
<entry>-bsb</entry>
<entry>no erase on backspace: echoes single backspace only</entry>
</row>
<row>
<entry>bsl</entry>
<entry>Backspace over line: lines are &quot;deleted&quot; by sending
backspace-space-backspace sequences to erase the same
line (for video terminals) (default).</entry>
</row>
<row>
<entry>-bsl</entry>
<entry>No backspace over line: lines are &quot;deleted&quot; by printing
a new line  sequence (for hard-copy terminals).
echo Input characters &quot;echoed&quot; back to terminal (default)</entry>
</row>
<row>
<entry>-echo</entry>
<entry>No echo</entry>
</row>
<row>
<entry>lf</entry>
<entry>Auto line feed on: line feeds automatically echoed to
terminal on input and output carriage returns (default).</entry>
</row>
<row>
<entry>-lf</entry>
<entry>Auto line feed off.</entry>
</row>
<row>
<entry>pause</entry>
<entry>Screen pause on: output suspended upon full screen. See
&quot;pag&quot; parameter for definition of screen size. Output
can be resumed by typing any key.</entry>
</row>
<row>
<entry>-pause</entry>
<entry>Screen pause mode off.</entry>
</row>
<row>
<entry>null=n</entry>
<entry>Set null count: number of null ($00) characters
transmitted after carriage returns for return delay.
The number is decimal, default = 0.</entry>
</row>
<row>
<entry>pag=n</entry>
<entry>Set video display page length to n (decimal) lines.
Used for &quot;pause&quot; mode, see above.</entry>
</row>
<row>
<entry>bsp=h</entry>
<entry>Set input backspace character. Numeric value of
character in hexadecimal. Default = 08.</entry>
</row>
<row>
<entry>bse=h</entry>
<entry>Set output backspace character. Numeric value of
character in hexadecimal. Default = 08.</entry>
</row>
<row>
<entry>del=h</entry>
<entry>Set input delete line character. Numeric value of
character in hexadecimal. Default = 18.</entry>
</row>
<row>
<entry>bell=h</entry>
<entry>Set bell (alert) output character. Numeric value of
character in hexadecimal. Default = 07</entry>
</row>
<row>
<entry>eor=h</entry>
<entry>Set end-of-record (carriage return) input character.
Numeric value of character in hexadecimal. Default = 0D</entry>
</row>
<row>
<entry>eof=h</entry>
<entry>Set end-of-file input character. Numeric value of
character in hexadecimal. Default 1B.</entry>
</row>
<row>
<entry>type=h</entry>
<entry>ACIA initialization value: sets parity, word size, etc.
Value in hexadecimal. Default 15</entry>
</row>
<row>
<entry>reprint=h</entry>
<entry>Reprint line character. Numeric value of character
in hexadecimal.</entry>
</row>
<row>
<entry>dup=h</entry>
<entry>Duplicate last input line character. Numeric value of
character in hexadecimal.</entry>
</row>
<row>
<entry>psc=h</entry>
<entry>Pause character. Numeric value of character in
hexadecimal.</entry>
</row>
<row>
<entry>abort=h</entry>
<entry>Abort character (normally <keycombo action="simul"><keycap>Control</keycap>
<keycap>C</keycap></keycombo>). Numeric value
of character in hexadecimal.</entry>
</row>
<row>
<entry>quit=h</entry>
<entry>Quit character (normally <keycombo action="simul"><keycap>Control</keycap>
<keycap>E</keycap></keycombo>). Numeric value
of character in hexadecimal.</entry>
</row>
<row>
<entry>baud=d</entry>
<entry>Set baud rate for software-controllable interface. Numeric
code for baud rate: 0=110 1=300 2=600 3=1200 4=2400 5=4800
6=9600 7=19200</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1><title>Examples</title>
<screen>
xmode /TERM -upc lf null=4 bse=1F pause

xmode /T1 pag=24 pause bsl -echo bsp=8 bsl=C

xmode /P baud=3 -if
</screen>
</refsect1>
</refentry>