<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>Adding Variables to CONFIG.SYS </TITLE>
</HEAD>
<BODY BGCOLOR="#efefef" TEXT="black" LINK="blue" VLINK="#551A8B" ALINK="red">

<A HREF="OS2.html"><EM>README for XFree86 on OS/2</EM></A>
 <b>:</b> <EM>Adding Variables to CONFIG.SYS </EM><BR>
<b>Previous:</b> <A HREF="OS28.html"><EM>Installing the packages</EM></A><BR>
<b>Next:</b> <A HREF="OS210.html"><EM>Remarks on the Network Configuration</EM></A>


<HR NOSHADE>
  <H2><A NAME="11"></A>9. Adding Variables to CONFIG.SYS <A NAME="envvar"></A></H2>
<p>XFree86/OS2 requires a number of settings in the CONFIG.SYS file to work
correctly. Please add the following settings, and in particular take
care to set forward versus backward slashes correctly:</p>
<p>
<dl>
<dt><b>TERM</b><dd><p>Set the preferred terminal type for the xterm or editor to be used.
Some programs need this setting. I have my type set to
<blockquote><code>
<pre>
SET TERM=ansi
</pre>
</code></blockquote>

<code>\XFree86\lib\X11\etc\termcap.x11</code>
contains a suitable termcap which
can be used in place of termcap files that come with EMX, EMACS, or
other ported software.</p>
<dt><b>TERMCAP</b><dd><p>This variable must be set to the location where the termcap file
used for the above <code>TERM</code> variable is searched. My setting, for
instance, is:
<blockquote><code>
<pre>
SET TERMCAP=D:/EMX/ETC/TERMCAP.X11
</pre>
</code></blockquote>

Note that forward ``/'' is used as a directory separator.</p>
<dt><b>ETC</b><dd><p>Set to an ETC directory. Normally, this is already set to the ETC
directory of the TCP/IP code, such as
<blockquote><code>
<pre>
SET ETC=C:\TCPIP\ETC
</pre>
</code></blockquote>
</p>
<dt><b>TMP</b><dd><p>Set to an TMP directory. Normally, this is already set to the TMP
directory of the TCP/IP code, such as
<blockquote><code>
<pre>
SET TMP=C:\TCPIP\TMP
</pre>
</code></blockquote>
</p>
<dt><b>HOSTNAME</b><dd><p>Set to the internet hostname. Normally, this is already set by the
TCP/IP installation program, such as
<blockquote><code>
<pre>
SET HOSTNAME=myhost
</pre>
</code></blockquote>

With IAK, you would normally run a loopback configuration 
<A HREF="OS210.html#loopback">Network configuration</A> and would then
set this to
<blockquote><code>
<pre>
SET HOSTNAME=localhost
</pre>
</code></blockquote>
</p>
<dt><b>USER</b><dd>
<dt><b>LOGNAME</b><dd><p>Set both to a username. Currently, they are there just to make some
programs happy; in the future, this variable might be set by a
login shell of a multiuser configuration. My variable, for instance,
is set to
<blockquote><code>
<pre>
        SET USER=holger
        SET LOGNAME=holger
</pre>
</code></blockquote>
</p>
<dt><b>HOME</b><dd><p>Set this to an existing directory that is supposed to be a home directory
of a user. Some utilities place temporary and init files here. This
is also future investment for a multiuser configuration, but must still
be there. For instance, this variable might be set to
<blockquote><code>
<pre>
SET HOME=H:\user\holger
</pre>
</code></blockquote>
</p>
<dt><b>X11ROOT</b><dd><p>This is one of the most important settings, it determines the root
of the XFree86 directory tree. Normally, you will set this to the
drive letter of the partition where the \XFree86 tree resides,
such as in
<blockquote><code>
<pre>
SET X11ROOT=Y:
</pre>
</code></blockquote>

You may try to move the tree to another subdirectory, e.g. to
<code>K:\OS2\X11\XFree86...</code> and would then have
to change this to
<blockquote><code>
<pre>
SET X11ROOT=K:/OS2/X11
</pre>
</code></blockquote>
,
but this is discouraged, since some utilities might not accept this.
Note the forward ``/'' as a directory separator here.</p>
<dt><b>DISPLAY</b><dd><p>This variable may be set to the display to be used for displaying
clients. Normally you will set this variable to the same value as
the <code>HOSTNAME</code> variable and simply add a <code>:0.0</code> after it, such as
<blockquote><code>
<pre>
SET DISPLAY=myhost:0.0
</pre>
</code></blockquote>

Read the X11 man page on the exact meaning of these postfixes and
other options.</p>
<dt><b>XSERVER</b><dd><p>Set this to the executable name of the X server to be used. This
must be a complete path. My setting is as follows:
<blockquote><code>
<pre>
SET XSERVER=D:/XFree86/bin/XF86_Mach64.exe
</pre>
</code></blockquote>
</p>
<dt><b>PATH</b><dd><p>Add the binary directory for the X11 utilities to your search PATH.
This is normally the directory (adjust the letter)
<blockquote><code>
<pre>
Y:\XFree86\bin
</pre>
</code></blockquote>

It is possible to move the binaries to another directory in the
search path; for maintenance reasons and clarity of the structure, this
is not recommended, though.</p>
<dt><b>LIBPATH</b><dd><p>Add the DLL directory for the X11 utilities to the LIBPATH.
This is normally the directory (adjust the letter)
<blockquote><code>
<pre>
Y:\XFree86\lib
</pre>
</code></blockquote>

It is possible to move the DLLs to another directory in the
library path; for maintenance reasons and clarity of the structure, 
this is not recommended, though. Note that
<code>Y:\XFree86\lib</code>
has several other subdirectories; these may not be moved elsewhere,
rather they must stay there, because most utilities form a path to
these directories by using <code>%X11ROOT%\XFree86\lib</code>
as a base.</p>
</dl>
</p>
<p>The recent version of XFree86/OS2 has a REXX script named <code>checkinstall.cmd</code>
which you can (and should) use to check whether you have entered most things
correctly. This is not bullet-proof, but prevents the most obvious 
setup problems. Also, the X server itself will do some checking and will
refuse to start if something is wrong.</p>

 <HR NOSHADE>
<A HREF="OS2.html"><EM>README for XFree86 on OS/2</EM></A>
 <b>:</b> <EM>Adding Variables to CONFIG.SYS </EM><BR>
<b>Previous:</b> <A HREF="OS28.html"><EM>Installing the packages</EM></A><BR>
<b>Next:</b> <A HREF="OS210.html"><EM>Remarks on the Network Configuration</EM></A>



</BODY>
</HTML>
