EPICCLIENT Version 1.05: Explanation of INI file options
========================================================================

[Exclude]
and
[Include]

------------------------------------------------------------------------
Controlling which events are to be sent to the Server
------------------------------------------------------------------------

By default EpicClient sends only the inter-Epic Pigeon Hole values and
QProc events, plus most of the more useful Enque16 events. Here is a list
of the items sent by default:

	PH 96 - 99 inclusive, the 4 reserved inter-Epic Pigeon Holes
			written to in EPL by the SendPH0-3 Enque16s.

	QP 190 - 199 inclusive, the 10 reserved QProc events triggered in
			EPL by the SendQP0-9 Enque16s.

	Enque16s:

		0x001 - 0x01f	Most of the Button functions
		0x100 - 0x1ef and
		0x200 - 0x2ef	the soft axis functions
		0x300 - 0x35f	the POV functions

The resetting and mouse functions are deliberately excluded by default,
although there are some applications for sending Mouse operations to
the server (see example later).

If these defaults don't suit your application, you need to add [Exclude]
and/or [Include] sections to the EpicClient.ini file.

The [Exclude] section is processed first, and is used to remove any or
all of the events listed above, to *stop* them being sent to the server.
Specify the items to be excluded by listing them in this section, in one
or more of the following formats

	PH=ALL		to exclude ALL PHs
	QP=ALL		to exclude ALL QPs
	NQ=ALL		to exclude all Enque16s

Obviously if you use one of these, then there's no point in having other
lines for the same type of event. However, if you want to explicitly list
the events to be excluded, do this by listing them, thus:

	PH=n,n,n-n,n ...

and QP=, NQ= similarly. These list the event numbers, in decimal. If they
won't fit on one normal length line, split them and number each line, thus:

	PH1=n,n,n,n-n, ....
	PH2=n,n,n,n,n,n-n, ...

and so on.

If you'd rather specify the values in hexadecimal than decimal (hex is much
more appropriate for Enque16s, where the functions are defined in hex ranges),
just precede the list with 'X', thus:
	
	NQ=Xx,x,x-x,x,x....

Only insert one X, right at the beginning. This tells the program that all
the numbers in the line will be in hexadecimal.

The [Include] section is processed after the [Exclude] section, but otherwise
it is identical in format.

As an example of a useful entry:

	[Include]
	; Add MouseButtoning facility
	NQ=X0FA

which allows EPL in the Client to operate Epicinfo.cfg-defined mouse clicking
in the Server. This could be useful in FS98 with some panel gauges, and
switches sited on hardware connected to the Client EPIC.
	


========================================================================

[Config]

------------------------------------------------------------------------
Port=8102
------------------------------------------------------------------------

This controls the IPX/SPX port number to be addressed. Only the
EpicServer running with the same Port number will be addressed by
this EpicClient. You can have several EpicServers running on a
network, each using a different Port number.

Note that you can only have one copy of EpicClient in each machine,
as part of its job is to interface to the EPIC driver (VxD) and grab
all the Enque16 events for transmission to its server.

------------------------------------------------------------------------
Window=12,4,788,592
------------------------------------------------------------------------

This is not relevant, as the Window isn't used for anything. Ignore it.

------------------------------------------------------------------------
Visible=Tray
------------------------------------------------------------------------

Normally leave this to default, so you just get an Icon in the Windows
'tray' in the task bar. Other values are:
	
     Visible=No	   means the same as 'tray' in this case
     Visible=Min   to start up minimized
     Visible=Max   to start up maximized
     Visible=Yes   to start up with a sized window (see Window= above)

Note that there is no point in any setting other than the default at
present, as the Window is not used for anything visible in the
issued version of EpicClient.


========================================================================

[User]

------------------------------------------------------------------------
Log=Errors
Log=Errors+
Log=Yes
Log=No
Log=AllRx
Log=AllTx
Log=All
------------------------------------------------------------------------

Set to "Yes", this simply logs the EPIC driver (VxD) version found.

The "Errors" setting (defaulted) shows only Errors, whilst "Errors+"
also shows retries and re-connections, which will occur naturally as
machines are booted, restarted and so on.

The "Errors+" setting (defaulted) shows only Errors and connection
attempts - both successes and failures. With "Errors" the log file
contains only the Error reports.

The options "AllRx", "AllTx" and "All" log details of all data being
received, transmitted, or both, respectively. This is for serious
problem investigation only, as the log can get quite large. Note that
much of the data logged will not be decoded for you, so in general it
is really only for support purposes.

To avoid logging at all, set "No".

========================================================================
Pete Dowson, 5th July 2000
========================================================================
