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

[Exclude]
and
[Include]

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

By default EpicServer sends all Pigeon Hole values and QProc events,
but none of the Enque16 events.

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

The [Exclude] section is processed first, and is used to remove any or
all of the events  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.



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

[Config]

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

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

Note that you can only have one copy of EpicServer in each machine,
as part of its job is to interface to the EPIC driver (VxD) and possibly
grab the Enque16 events for transmission to clients. for the same reason
you can't have a Server and lient on the same machine.

------------------------------------------------------------------------
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 EpicServer.


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

[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
========================================================================
