home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / tcp / Networking / TCP / Dial / AmiTCP_session-1.0 / README
Text File  |  1994-08-06  |  5KB  |  161 lines
  1. AmiTCP_session, written by David Jameson (dave@freeside.thegap.com)
  2. Version 1.0, released 6 August 1994.
  3. Based on AmiTCP_dialup by K. Raquel Sanborn (which was based on a
  4. script by P. Josh Rovero, which was based on a script by Dave Bolen).
  5.  
  6.  
  7. REQUIREMENTS
  8.     Workbench 3.0 or above,
  9.     A modem,
  10.     A dial-up SLIP connection.
  11.  
  12.  
  13. INTRODUCTION
  14.  
  15.     This program is an Arexx script which starts up AmiTCP, dials up
  16.     a terminal server, sends outgoing mail and news, logs the time
  17.     online, and then hangs up the modem.
  18.  
  19.     Unlike AmiTCP_dialup, this program only works with a terminal server
  20.     which uses static IP allocation (i.e. one where you don't get 
  21.     allocated a new IP address each time you log in).
  22.  
  23.     Also included in this archive is a script called "purge.rexx" which
  24.     deletes old news articles.
  25.  
  26.  
  27. INSTALLATION
  28.  
  29.     [1]    You must have the following programs installed before running
  30.         this script:
  31.     
  32.     *    AmiTCP version 2.3 (comm/net/AmiTCP-bin-22.lha and 
  33.              AmiTCP-22to23.lha)
  34.  
  35.     *    inetutils version 1.3 (comm/net/INetUtils-1.3tcp.lha)
  36.  
  37.         *    breakname version 37.2 (util/cli/BreakName372.lha)
  38.  
  39.     It may work with newer versions of Inetutils and AmiTCP, but
  40.     you'll probably have to change some things in the script.
  41.  
  42.     [2] protect c/#? +s
  43.         copy c/#? to amitcp:bin/
  44.  
  45.     [3]    copy libs/#? to libs:
  46.       (unless you have newer versions of these libraries)
  47.  
  48.     [4]    makedir uunews:NNTPSpoolDir
  49.       (this is where outgoing netnews articles will be stored)
  50.  
  51.     [5]    Tell your news reader to use the nntpcopy program to send
  52.       outgoing news articles.  Nntpcopy simply copies the news
  53.     article into the directory uunews:NNTPSpoolDir, creating a
  54.     unique name for the file.  Any articles in this directory are
  55.     then sent to the NNTP server when AmiTCP_session is run.
  56.  
  57.     If you are using the Tin newsreader, set the environment
  58.     variable TIN_POST to "nntpcopy.rexx %s".  This can be done by
  59.     putting the following line in your user-startup file:
  60.  
  61.     setenv TIN_POST "nntpcopy.rexx %s"
  62.  
  63.     [6] Change the constants at the beginning of 
  64.         amitcp:bin/AmiTCP_session.rexx.
  65.       You need to fill in the phone number, username, password,
  66.     name of logfile, name of NNTP server, serial port speed,
  67.     the name of the active file and the name of the SLIP device.
  68.  
  69.     The active file should be set to "uulib:active" if you use
  70.     the Tin newsreader, or "uunews:active" if you use GRn.
  71.  
  72.     The script logs the time online in the same format as Ncomm, 
  73.     and by default it stores the log information in ncomm:ncomm.log 
  74.     (change this to something else if you don't have Ncomm installed, 
  75.     or to something like ram:logfile if you don't want a permanent log).
  76.  
  77.     [7]    Make sure your modem has "DTR override" enabled.  This is so
  78.         that the modem doesn't hang up when the Amiga drops DTR
  79.     (which happens when the serial.device is closed).  This
  80.     usually involves setting a DIP switch on the back of the
  81.     modem.
  82.  
  83.     
  84.     If you're having trouble, check to make sure your configuration
  85.     files are set up properly.  My s:uuconfig file looks like this:
  86.  
  87.     SMTPMailDir    uumail:
  88.     NodeName    freeside
  89.     LogFile    uulib:logfile
  90.     DomainName    .thegap.com
  91.     SMTPRoute    SMARTERHOST
  92.  
  93.     My environment looks like this:
  94.  
  95.     DomainName    .thegap.com
  96.     HOME    uunews:
  97.     HOST    freeside.thegap.com
  98.     HOSTNAME    freeside.thegap.com
  99.     NNTPSERVER    news.gpl.net
  100.     SMTPMailDir    uumail:
  101.     SMTPSmarterHost    mailhost.thegap.com
  102.     TIN_POST    nntpcopy.rexx %s
  103.     USER    dave
  104.     USERNAME    dave
  105.     NodeName    freeside
  106.     SendMail    smtppost
  107.     SMTPHOST    mailhost.thegap.com
  108.     SMTPRMAIL    SMTPpost -t
  109.     SMTPSpoolDir    uumail:SMTPSpoolDir/
  110.  
  111.     The following assigns are in my s:user-startup:
  112.  
  113.     assign inet:    amitcp:
  114.     assign uulib:   amitcp:UUCP
  115.     assign uumail:  uulib:Mail
  116.     assign uunews:  uulib:News
  117.     assign uuspool: uulib:Spool
  118.  
  119.  
  120. USAGE
  121.  
  122.     To run the program, simply type "AmiTCP_session.rexx".  If successful,
  123.     the program should connect to the terminal server and begin
  124.     transferring mail and news.  It will then bring up a requester,
  125.     which, when clicked on, will end the AmiTCP session and hang up the
  126.     modem.  
  127.  
  128.     To use the news purger, type "purge.rexx <active_file> <days>" where 
  129.     <active_file> is the name of the active file and <days> is the
  130.     number of days to keep news articles for, e.g. "purge uulib:active 3"
  131.     will delete articles more than 2 days old (articles will be kept if
  132.     their creation date is today, yesterday, or the day before -- 3 days
  133.     in total).  This script has a few limitations: it doesn't update the
  134.     low article numbers in the active file, and it doesn't check the
  135.     articles for "Expires:" lines.
  136.  
  137.  
  138. DISTRIBUTION
  139.     This set of programs is public domain.  Do whatever you want with them!
  140.  
  141.  
  142. DISCLAIMER
  143.     The author is not responsible for any disasters which occur while
  144.     using these programs.
  145.  
  146.  
  147. ACKNOWLEDGEMENTS
  148.  
  149.     K. Raquel Sanborn for AmiTCP_dialup
  150.  
  151.     Michael B. Smith for INetUtils
  152.  
  153.     Mark Tomlinson and Geoff McCaughan for the Amiga version of Tin
  154.  
  155.     Kai Iske for breakname
  156.  
  157.     Joseph Stivaletta for rexxserdev.library
  158.  
  159.     And most of all, thanks to the authors of AmiTCP!
  160.  
  161.