HOW TO INSTALL THE TUW-TCP/IP PACKAGE  8. April 1992,
                                       updated January 12th, 1993 by pm.

---

Please note:

This package was intended to overcome the drawbacks of existing
network packages for the ATARI: high price, low performance and
missing compatibility between the software of different companies.
Therefore we have introduced a packet driver interface similar to that
used on IBM-PCs and developed a TCP/IP software compatible with the
ATARI networking interface routines as well as some
application programs to connect to our SUN workstations.
This was done mainly to utilize our existing STs and TTs in our
network and was never thougt of becoming available to the public.
Hans Wieser who first started the project has left our group.
Meanwhile our group also has switched over to PCs, so no further updates
will be done. (pm Jan 1994)
I apologize for the bad support, nevertheless I hope you
will find it useful.

Updates to the newest versions are put in the tuw-tcp directory separately.

pm.
---

Copy the following programs into the AUTO folder of your bootdisk:

1.) INETCUST.PRG (customization to your environment)
2.) PKTDRV.PRG   (one of lancest.prg, lancett.prg, dlinkdrv.prg or
                  your own packet driver)
3.) TUWTCP.PRG   (TCP/IP)

These programs must be executed in the given order at boot-time.

PKTDRV.PRG and TUWTCP.PRG depend on the custom structure which is loaded
resident by INETCUST.PRG .
INETCUST.PRG reads the file INETCUST.INF, which you should update for
your site-customisation requirements. If you execute INETCUST.PRG and
the custom-structure is already resident, the resident structure is updated.
INETCUST.PRG searches INETCUST.INF in the root directory of the current
drive.( This is the boot drive when executed from the AUTO folder. )

The SUBNETBITS keyword allows for adjusting the actually used number
of bits for your subnet address.

HOSTS:
Provide all internet addresses and hostnames you want to refer to in a
file and enter the full pathname to this file at the HOSTS keyword in 
INETCUST.INF .
The format of this file is:

# This is a comment
# internet addr  firstname of host    second name of host  ....  
ddd.ddd.ddd.ddd  hostname            nickname_of_host

Use only one line per host.

PS: Nameserver support eg. is included in TNFTP.PRG.

Utilities for TUW-TCP:
----------------------

Notes:
If you want to run FTPSERV.PRG or TNFTP.PRG as an accessory, simply rename it
to *.ACC and copy it to the root-directory of your bootdisk. 

See also the separate updates for some utilities.

                                       updated August 25th, 1993 by pm.
TNFTP - TELNET and FTP client
-----------------------------
TNFTP.ACC needs fontfiles and the TNFTP.RSC file in the root 
directory of your bootdrive.

To become familiar with all shortcut-keys provided by TNFTP.PRG (TNFTP.ACC),
run it as the normal .PRG and look at the menu. You also have the possibility
to activate a dialog with the <HELP> key at any time a TNFTP-window is the
active one. If you have a TNFTP.ACC-window open and
you start another program, the TNFTP-window will be closed due to system 
requirements; simply click on the desk-menu entry of the TNFTP accessory and
all TNFTP-windows will reopen, the connection to the host will remain
established. 
Closing a window by clicking the close-box at the upper left corner of 
the window will close the connection too. You can run TNFTP.PRG (TNFTP.ACC) 
and FTPSERV.ACC concurrently to be able to ftp back to your ATARI.
The environment variable FTPWIN specifies the FTP window and FTPTMP a
filename for temporary data.

FTPSERV - simple FTP server
---------------------------
FTPSERV.PRG and FTPSERV.ACC cannot run concurrently since only one server
can listen on the FTP-port. Only one FTP client can be serviced at the same
time. To stop FTPSERV.PRG simply close the info-window.
Access is controlled via the /ETC/PASSWD file which is of the following
structure:

username:password:homedir

where password can be ommitted and homedir can be '*' to allow for
unlimited access.

NETSTAT - status info about active connections
----------------------------------------------
NETSTAT.ACC/PRG gives you info about currently active connections
as well as driver statistics.

SETCLOCK - get time from time server
------------------------------------
SETCLOCK.PRG sets the local clock after retrieving the actual time from
the first timeserver specified in INETCUST.INF. Time SETCLOCK.PRG is
linked with the german version of PURE-C libraries, so the reported 
timezone name may be incorrect. Daylight savings time should be honoured
be changing the TZOFFS entry in INETCUST.INF accordingly.
( The 'TZ' keyword is NOT currently used by this program )

LPR - line printer access
-------------------------
LPR.TTP allows for printing of files on a remote printer.
Options are: -Sprinthost -Pprinter file.
Defaults can be specified in the environment variables for the
printer in PRINTER, the username in USER and the print host
in PRINTHOST.

SPOOLD - routes files with extension .PCO to remote printer
-----------------------------------------------------------
SPOOLD.ACC automatically prints a file with extension .PCO on the
remote printer as soon as it gets closed after it was opened, then
the file is deleted!.
(Intended to be used with TEMPUS WORD or similar programs which are able
to print to disk)
Defaults can be specified in the environment variables for the
printer in PRINTER, the username in USER and the print host
in PRINTHOST.

HPPRND - routes bios/gemdos printer output to remote printer
-----------------------------------------------------------
HPPRND.ACC automatically generates a file with extension .PCO from
printer output via bios or gemdos and prints it on the
remote printer as soon as the stream gets closed after it was opened, then
the file is deleted!.
(Intended to be used with TEMPUS WORD, CALAMUS or similar programs which 
use their own printer driver via bios or gemdos)
A full bios/gemdos printer redirector would need a capture timeout which
could be added to the sources.

Defaults can be specified in the environment variables for the
printer in PRINTER, the username in USER and the print host
in PRINTHOST.

Since this package in part needs the multitasking capabilities of the AES,
any .TOS or .TTP program not using the GEMDOS calls of the package will
suspend the network services. 8-(

Latest news:
---------
It was reported that the package will not work under multitasking environments.
As far as I was able to trace the problem, TUWTCP works under MINT but
TNFTP had to be modified so it can only be run as .PRG not .ACC (TNFTPX.PRG).
The problem seems to stem from the stack checking in PURE-C under
multitasking.

Meanwhile I also did a PCB for the DE600 interface and it works fine on our
ST an TT. See pcb.zoo.

For any suggestions, enhancements and bugreports send a mail to

  Peter Mayer  , pm@fortec.tuwien.ac.at


