                                           Ch. d'Heureuse


Wiesemann&Theis COM-Server
==========================

The W&T COM-Server is a TCP/IP terminal server with two serial
ports (A and B).


Protocols
---------

The server can be accessed with raw TCP or with the W&T control
protocol. If raw TCP is used, the serial ports of the server must
be configured manually (baudrate, parity, handshaking, ...). If
the W&T control protocol is used, the ports are configured
automatically when a serial port is opened.


Port Names
----------

If the W&T control protocol is used, a port name has the format
"wtcom:<host>:<ser_port>". <host> specifies the TCP/IP host name of
the COM server or the IP address. <ser_port> specifies the serial
port name ("A" or "B"). If <ser_port> is omitted, "A" is assumed.

Examples for port names with the W&T control protocol:
   wtcom:comserv1:A
   wtcom:192.168.123.5:B
   wtcom:comserv9

If raw TCP is used, a port name has the format "tcp:<host>:<port>".
<host> specifies the TCP/IP host name of the COM server or the
IP address. <port> specifies the TCP port number. Port 8000 must
be used for serial port A, and 8100 for serial port B.

Examples for port names with raw TCP:
   tcp:comserv1:8000
   tcp:192.168.123.5:8100


Logging
-------

The communication between the PC and the COM server can be logged
into a disk file. The logging function can activated by setting
an OS environment variable. The program DUMPCLOG.EXE must be used
to list the log files.

Examples:
  ("temp.log" is the log file name, "comserv1" is the host name)

  Log port A data channel:
    SET tcplog_comserv1:8000=temp.log

  Log port B data channel with "milli-seconds" timestamps:
    SET tcplog_comserv1:8100=temp.log timestamp(msecs)

  Log port A control channel with date/time timestamps:
    SET tcplog_comserv1:9094=temp.log timestamp(datetime)
