WA4DSY OS/2 APRS server docs.

New 1-7-97

This is free software but is Copyright 1996 by Dale Alan Heatherington.

This program gets data from a TNC connected to a serial port
and sends it to all clients who have connected to port 14579
from a tcpip network. Clients can use telnet to watch raw
TNC data or JavAPRS to view the data plotted on a map.

A history of TNC data going back 30 minutes is kept in
memory and delivered to each user when he connects.  This
history data is filtered to remove duplicates and certain
other unwanted information.  The time to live parameters can be
modified on a call sign basis by editing function
"void GetMaxAgeAndCount(char *buf, int *MaxAge, int *MaxCount)"
and recompiling.  This should be in a config file but I haven't
gotten around to doing it yet.

** New feature 1-7-97 **

This server will now accept data from clients logged on to port 14579 and
relay the data unmodified* to all other logged on clients. 

* The client data is unmodified except for the end of line protocol.
The server detects end of line when it sees either a <CR> or <LF>.
It then converts the end of line character to sequence <CR><LF><NULL>
before retransmission.
 


-----------------------

Files:

AprsServ.exe			The APRS server executable
welcome.txt			This file is sent to users when they connect
password.txt			User names and Passwords for Internet TNC access
init.tnc			This file is read into the TNC when the server starts
restore.tnc			This file is read into the TNC when the server closes
history.txt			Created by the server when it closes to save the history buffer
				It's also is read into the servers history list when  server starts.

AprsServ.log			Created by server to log all user connections
AprsServ.cpp			Source code
AprsServ.mak			Makefile for IBM Visual Age C++


Note: These files should all be in the same directory as AprsServ.exe .

----------------------

STARTING THE SERVER

The server has two command line arguments, the COM port and the tcpip socket number.

example:  aprsserv com1 14579

Starts the server with the tnc connected to COM1 and listening to tcpip port 14579

If no arguments are supplied the server will use COM2 and port 14579

** NOTE:  	The TNC COM port is fixed at 9600 baud, 1 stop bit, 8 data bits and no parity.
		Be sure the TNC is configured to these parameters.



3 single letter console commands are available when the server is running.
They must be lower case.

?	prints a description of the other 2 commands
q	Quit
s	Prints statistics

------------------------

REMOTE TNC ACCESS - ctrl-R

You may telnet to the APRS server and connect to the TNC for the purpose
of changing parameters or even sending data out over the radio channel.
Use ctrl-R to enter remote access mode.  You'll be prompted for your user
name and password.  These must match an entry in the password.txt file.
After you have logged on everything you type goes to the TNC.  You will
not see a "CMD:" prompt from the TNC because the server only sends data
after a <CR> . The is no <CR> after the "CMD:" prompt so you won't see it
until after you type a command.  APRS data will continue to flow so you
may want to turn off the TNCs monitor mode while you're logged on.  Remember
to turn it back on before you exit.

Note:  Everything you type will also be sent to all logged on users .

To exit remote TNC access type ctrl-Q.

-------------------------

Java Applet

The JavAPRS applet by Steve Dimse is a completely separate product and
is not supported by me.










