HotFix ME112SB001
Filename: ME112SB001 (SPARC)

For: MetaFrame for UNIX(r) Operating Systems, Feature Release
1 for the Solaris Operating Environment.

Languages: all languages supported by MetaFrame for UNIX
Operating Systems, Feature Release 1.

Description
-----------
This hotfix:

1. Fixes a problem where MetaFrame for UNIX cannot
reconnect to a font server from which it has become
disconnected.

2. Adds a new "-notimestamps" command line switch to the
ctxclipboard application that stops XEmacs from beeping
when selecting text. See the section below on
changes required to ctxsession.sh for details about how to
activate this feature.

3. Increases the number of connections that the X server
can accept from 60 to 256. See the section below on file
descriptors for more information about this change.

4. Optimizes the X servers handling of the graphics cursor in
the Cadence CAD package to improve usability.

5. Adds a new "-qandtdelay " command line option to
ctxXtw. This sets the delay in ms for which Thinwire 2
graphics operations are held in the Queue and Toss (Q&T)
buffer. If this option is not present, or is present but a
value of zero is specified, then MetaFrame uses its
internal algorithm. The value is capped to 1000ms.
See the section below on changes required to ctxXtw.sh
for details about how to activate this feature.

6. Fixes a problem that occurs when FrameMaker (5.5 or 6.0)
is launched in 16-bit color depth.

7. Adds support for the extra keys that can be found on the
SPARC keyboard.

Changes Required To ctxsession.sh
---------------------------------
The clipboard process is started for all sessions in the shell
script file /opt/CTXSmf/lib/ctxsession.sh. To stop XEmacs
beeping when text is selected, find the line that begins with
$CTXCLIP & and replace it with:
- $CTXCLIP -notimestamps &

Changes Required To ctxXtw.sh
-----------------------------
After you install this hotfix, you need to edit
/opt/CTXSmf/slib/ctxXtw.sh to set the qandtdelay option.
ctxXtw.sh is a script file that runs when the X server
starts; it includes X server configuration settings. Update
ctxXtw.sh as follows:

- Include the -qandtdelay n switch.
In ctxXtw.sh, find the line that begins with XTW_OPTS
and add -qandtdelay n. For example:
XTW_OPTS=
"-session $CITRIX_SESSION_ID -terminate -qandtdelay 10 -bs"

Number of File Descriptors allowed per process
----------------------------------------------
This hotfix increases the number of connections permitted
to the X server to 256. However each connection consumes
a file descriptor and it may be that the X server runs out
of file descriptors that it is allowed before it reaches
its maximum number of connections.

To determine how many file descriptors are allowed to
be opened by default by the X server process, log in as
the user ctxsrvr, and if that user does not already run
ksh, start one by typing ksh, and then type the command
ulimit -n. If the number which is printed is greater
than or equal to 256 you need do no more. However if
the number is less, you need to type ulimit -Hn to
find the hard limit of file descriptors that are allowed.
If this number is less than 256, you must read the
manual page for ulimit to find how to increase this limit.

If this number is 256 or greater, you have a number of
options, but the simplest one with the least far-reaching
implications for system resources is to log in as root and
edit the ctxXtw.sh file, and add this line:- ulimit -n 255.

Installation Instructions for Hotfix ME112SB001
-----------------------------------------------
Important: This hotfix will only install on servers on which
you have installed MetaFrame for UNIX(r) Operating Systems,
Feature Release 1 for the Solaris Operating Environment.

1. Download the hotfix file to a suitable directory on the server
on which you want to install the hotfix. Ensure there is at
least 2 Mb free in this directory.

2. The hotfix file is archived and compressed. To untar and
uncompress the file, type:
compress -dc ME112SB001.tar.Z | tar xvf -

3. Ensure there are no users logged on and stop the server. Use
ctxshutdown to do this.

4. Log on as root.

5. In the directory containing the ME112SB001
directory, install the hotfix by typing:
patchadd -M . ME112SB001

--------------
--------------
Files Updated:
--------------
--------------

-r-xr-xr-x 1 ctxsrvr ctxadm 256576 Nov 28 2001 ctxclipboard
-rwxr-xr-x 1 ctxsrvr ctxadm 16273 Nov 28 2001 ctxsession.sh
-r-x------ 1 ctxsrvr ctxadm 611736 Nov 28 2001 ctxfm
-r-sr-x--- 1 root ctxadm 2237048 Nov 28 2001 ctxXtw
-rwx------ 1 ctxsrvr ctxadm 7375 Nov 28 2001 ctxXtw.sh