Please look at CCF/README and CCF/CCFxmux/README.xmux for important 
information and common problems. Other subsystems also have README's 
containing general information.

Applications known to work well under CCSM/CCFX:
	
	emacs 
	ghostview
	netscape ?
	rasmol
	tgif
	xclock
	xess (spread sheet)
	xeyes
	xfig
	xload
	xlogo
	xmaze
	xterm
	xtetris
	xv

Applications known to have problems under CCSM/CCFX:

	some Motif applications have problems with pop-up menus

Common problems:

Applications cannot be launched until the ccsm user joins or creates a
session. Sessions can only be established if the CCF white pages and 
session name server (cctlwp and ccfsns) are running on a machine
described by the environment variable CCTL_WP_HOST_NAME.

Sometimes a ccfx from a previous session has difficulty terminating 
properly. Since ccfx uses a well-known port, a newly launched ccfx
will fail. If an old ccfx is still running (or perhaps a ccfx launched
by another user on the same machine) application launching will fail.
Use the PERL SCRIPT ccfzap to kill all CCF components before restarting:

	$CCF_BIN/ccfzap
	$CCF_BIN/ccsm

The script ccfzap will only kill CCF components owned by the current user.
If another user is running CCF components on the same machine, you may
not run ccsm or ccfx on the same machine.

If you have difficulty creating or joining a session, you may need to
kill and reset cctlwp and ccfsns or simply start new instances of these
applications on another machine. Be sure to reset CCTL_WP_HOST_NAME if
you run the servers on a new machine.

Various diagnostics and error messages are printed in the shell window used to 
start ccsm. If you see repeated messages like these:

CHANNEL default channel(1):packet: 40 is multicasted (8)
CHANNEL default channel(1):packet: 41 is multicasted (8)
CHANNEL default channel(1):packet: 42 is multicasted (8)
CHANNEL default channel(1):packet: 43 is multicasted (8)
CHANNEL default channel(1):packet: 40 is multicasted (8)
CHANNEL default channel(1):packet: 41 is multicasted (8)
CHANNEL default channel(1):packet: 42 is multicasted (8)
CHANNEL default channel(1):packet: 43 is multicasted (8)

the multicast transport layer (CCTL) is timing out and retransmitting. It
is likely that some CCF component has failed or crashed (like ccsm, ccfx,
ccfaudio, ccfchat, ccfcb, or ccfdssh). Existing participants may be able
to continue working but no new participants may join the session.

It is not currently possible to leave a session and successfully join another
during the same invocation of ccsm. (cctl currently lacks a working failure
detector and can't reliably distinguish participants that fail and leave.)
To initiate or join another session, simply exit and restart ccsm.

ccsm and ccfx manipulate the X stream generated by client X applications.
Occasionally these manipulations involve reordering the original X stream
sequence numbers. Xlib implementations (provided by various vendors) sometimes
detect harmless modifications to the sequence and report warnings such as
these:

Xlib: sequence lost (0x10000 > 0x64) in reply type 0xc!
Xlib: sequence lost (0x104ea > 0x67) in reply type 0xc!
Xlib: sequence lost (0x104ed > 0x6c) in reply type 0x8!
Xlib: sequence lost (0x104ea > 0x6f) in reply type 0xc!
Xlib: sequence lost (0x104ed > 0x75) in reply type 0x8!
Xlib: sequence lost (0x104ea > 0x75) in reply type 0x8!
Xlib: sequence lost (0x104ea > 0x77) in reply type 0xc!
Xlib: sequence lost (0x104e7 > 0x77) in reply type 0xc!

Such warnings can be safely ignored.

Some MOTIF applications fail to run properly (nothing is displayed or the
application crashes or hangs). Others may hang during the use of pulldown 
menus. If an application fails while controlling exclusive access to the 
pointer, keyboard or display, it may be necessary to kill it (or ccsm) 
by logging in from another machine.

ccsm and ccfx currently fail to reclaim used file descriptors. It is
possible exceed the system-imposed per-process file descriptor limit
(usually 64) by opening and closing a large number of applications
in a single session.

Users may experience severe delays across slow or unreliable Internet
links.