************************************************************************** Rock v1.6 - Fidonet mailer for point systems Copyright (C) 1995 Jean-Marc Xiume' This software is distributed under the terms of the GNU General Public License. Read "license.doc" for more details. Rock is based upon POP, copyright (c) 1994 Denis Turcotte and Robert Williamson. Rock.rexx is based upon JAZ.f copyright (c) 1994 Robert Williamson. LaunchWPL is copyright (C) 1994 Robert Williamson. xferq.library is copyright (c) 1993 David Jones and (c) 1994, 1995 Robert Williamson. wpl.library is copyright (c) 1993 Russell McOrmond. ************************************************************************** Introduction ------------ Welcome to Rock, one of the smallest Point mailers available for the Amiga. It's written using the WPL and Arexx languages. Rock is pretty easy to install and to configure, is not memory and disk space hungry, and allows to call the all the different phone numbers of your boss if the line is busy. For calls to other systems than the boss, it can make use of the nodelist if you already have installed the traplist.library, otherwise it asks for the phone number. (Note that traplist.library is free, but TrapList is a shareware program). To keep things simple, the only available protocols are WAZOO for negociation and ZEDZAP for file transfer. An example configuration file (ROCK.cfg) and the related doc (RockCfg.doc) are given. Installation ------------ Simply copy the ROCK directory where you want, and assign "rock:" to that directory. You should add a line like the following one in your user-startup: Assign rock: DH1:Fidonet/Rock The libraries in the distribution's libs directory (wpl.library, xferq.library, and xprzedzap.library) must be accessible to the system. You can either copy them in the libs: directory, or add the following line to your user-startup: Assign libs: rock:libs add To properly unarchive files and preserve file attributes you should use the -a option of LHA, or manualy set the "s" flag of "rock" and "boss" with the protect command. ( e.g.: protect rock +s ) Before starting to use Rock, you must configure it. Read "RockCfg.doc", then modify the configuration file "rock.cfg" to suit your needs. If you want, you can use the Fidonet Nodelist in traplist format. The traplist software must be installed and the traplist.library must be in the libs: directory. Usage ----- Amigados template: rock ADDRESS,CONFIG To start a session with your boss, just type "Rock" in the shell, or click on the BOSS icon (the "s" flag must be set for those files, see installation). To call another system, give its 4D address as an argument on the command line (ex: ROCK 1:167/151.0), Rock will then ask for the phone number and the password for this system. If you use the nodelist (see the nodelist parameter in the configuration file), rock will try to find these datas there. If it cannot find them, it will ask to enter manually, like above. You can also give the name of the config file to use as an argument, for example if you want to poll more than one BBS. It's a standard amigados template, so if you give a config file name and no address you have to use the "config" keyword. Examples: rock rock 2:320/104 rock 2:320/109 tlcsbbs.cfg rock config tlcsbbs.cfg You can terminate rock by pressing control-c in its window, except during the file transfer phase. Support Scripts --------------- The "KillRock" script is for... trying to kill Rock if things go wrong. The "WaitRock.rexx" script waits for rock to terminate. It can be used, for example, in an amigados script like this: ... rock:rock ;start rock wait 3 ;allow it some time to declare its arexx port rx rock:waitrock.rexx ;wait until the end of the session ... This scripts accepts as an argument the number of seconds to wait between each test, in order to optimize the CPU time used. To start Rock from Spot, use the "StartRock.spot" script from the Arexx menu in Spot. You can also put "rock:rock" in the "Poll" gadget of the "settings->system" window. The "CallNode" script allows you to use a reqtools requester to enter the address of the node you want to call. The "Boss" button calls directly your boss. Note that this script needs the rexxreqtools.library. Notes ----- Rock is MailWare. If you like it, please send me a nice postcard of your country (or if you're too lazy a NetMail will do ;-) ). It not only makes me happy but allows me to register the users for a better support. Enjoy !... :-) Comments, suggestions and of course donations are welcome: smail: Jean-Marc Xiumé Parc du Belvédère 83120 Sainte-Maxime FRANCE fidonet : 2:320/104.22 amiganet: 39:180/1.22 usenet : jmx@ramses.fdn.org jmx@ramses.telesys-innov.fr (for mails >10Kb) Thanks to --------- - All those who created WPL - Denis Turcotte for the original idea and the first wpl script. - Robert Williamson for the original XferQ management script (see extras/jaz.f for the original script) - Patrice Orio, Arnaud Meurgues, Alain Chofardet, Luc Gibert, and Pierre Delisle for beta testing and improvement ideas. - Patrice Orio for the icons and Amigaguide documents. History ------- * Rock 1.6 - 12 nov 1995 - Four parameters have been added to the config file, read RockCfg.doc for more details . cycledelay : delay between calling each boss' different phone line (if any). Calldelay will be effective after cycling through all these numbers. . maxcalls : maximum number of dials. . maxmbfail : maximum number of connects at a speed slower than minbaud. . beeponconnect: beep/flash when connected. - The 2 calling counters (maxcalls et maxmbfail) are displayed at each try. - Various changes in rock.wpl - Updated the config file doc "RockCfg.doc" : be sure to read it ! * Rock 1.5a - 14 aug 1995 - New "deleteflo.rexx" script : check if the files pointed in the .?LO have been correctly uploaded, and delete or modify the .?LO accordingly. Now, if the connection is broken during file upload, the files that have not been sent will be in the next session. - A few fixes in rock.rexx and rock.wpl - Execution priority of Rock increased from 4 to 15. - New material done Patrice Orio : New MagicWB-style icons for rock, scripts and docs, and also an amigaguide version of the docs. * Rock 1.5 - 30 jul 1995 * Rock 1.5beta2 - 15 jul 1995 - Added the CallNode script (launch rock via a reqtools requester). - The 680x0 version of the xprzedzap.library v3.5 crashed the system. It's replaced by the older 1.5 version, that also runs under system 1.3. - Corrected the xprzedzap.library initstring (xprsetup). - Some minor bugfixes. * Rock 1.5beta - 23 may 1995 - Added version 1.4 changes to rock 1.3a - Rock now reconises the "NO ANSWER" string used by some modems. - To improve reading, a blank line is printed in the status window after receiving each file. - Put back the turnaround delay (2 seconds between the sending and the receiving phase). * Rock 1.4 - 19 apr 1995 (released by Robert Williamson, modified from rock version 1.3 / 01 mar 1995) - corrected invalid copyright notices - added missing copyright notices - removed the possibly privatee version of wpl.library v0.99.02 and replaced it with the public version 0.97.04 - replaced obsolete xprzedzap.library 0.56j with the current version 3.5 - corrected xprsetup command for new xprzedzap.library * Rock 1.3a - 29 mar 1995 - Small bug fixed in rock.wpl : ROCKDEF!FIDO was called but this section doesn't exist in the default config. - A "return" was missing in rock.cfg at the end of the MODEM section. - Added support for .FLO files without the full qualified path for fido packets. Now the outbound path is checked and added if necessary. * Rock 1.3 - 01 mar 1995 - "waitrock" support script. Waits until rock exits. * Rock 1.3beta5 - 12 feb 1995 - ** Warning, configuration file modified ! Read the docs !! ** . Parameters grouped in 5 sections (nets,fido,modem,display,files). . Added the addresses of the boss' different nets (fidonet, amiganet...). . Added the initloop and initwait parameters, for modem initialization purpose. . Added the minbaud parameter, to hang up the modem if the connexion speed with the boss is lower than minbaud. . Changed the names of the display variables. . Added the closestatus parameter, to choose if the status window will close itself of not, after rock has exited. . Added the nodelist parameter. It's the path of the directory where are the nodelist files. - It's now possible to use the NodeList ! (traplist format). - The configuration parameters have now a default value, except of course those in the FIDO section. - Suppressed the .FLO part in the "rock" script. This is now done by the new "bossflo.rexx" script. - No need to change the "rock" script any more, neither for the boss main address, nor for the different nets. All is now done in "rock.cfg". - Changed the modem init phase. - Automatic creation of the xferq directory ("assignxferq" script) - Updated the config-file doc, be sure to read it. - The validity of the given address is now checked before calling, by the new "addrcheck.rexx" script. - New "nodelist.rexx" script, to find the node's phone number and password in the nodelist. - Corrected a bug in rock.rexx . The .?LO files with a CR as line-end caracter are now handled correctly. - New "config" argument to the "rock" script, in order to use the config file of your choice. * Rock 1.2c - 30 dec 1994 Unrealeased developpement version. * Rock 1.2b - 14 dec 1994 - Some minor changes. * Rock 1.2a - 01 oct 1994 - Rock is now able to open its windows on a given public screen. * Rock 1.2 - 28 sep 1994 - Amigados launch script "rock" changed in order to concatenate the .FLO files of the different nets in a single file named with the main address of the boss. Previously, rock sent only the fidonet files. - Added the different addresses of the boss in the config file, in order to have the correct address for each called phone number. - Added "bossoutbound.rexx" script to rename the .?LO, .?UT and .REQ files according to the current called boss address. Rock doesn't support AKAs, and send only the files that match the current address. - The logfile reports if the given address doesn't match the one we are connected to. - Rock.wpl updated according to the above changes. * Rock 1.1 - 24 sep 1994 - The Rock.rexx script has been corrected, as the previous didn't sent out the file-attaches (at least in my tests with Trapdoor ;) ). - Use of the ROCK: assign instead of Mail: for Rock's files. - The logfile gives more details on what's going on: . date and time at the beginning of each line. . start and exit point of the program. . address ans phone number of the called system. . reports the reply message from the modem. . tells if an error has occured or if the session has been manually aborted. . after the negociation, gives the name of the called system, the name of the sysop, and the name of his mailer. . session connect time (ROCKtime.rexx). - Various changes in ROCK.wpl. - KillRock script, just in case ;) * Rock 1.0 - Used the rock.rexx script from the JAZ 1.01 mailer, Copyright (c) 1994 Robert Williamson. * POP 0.9 * Original version Copyright (c) Denis Turcotte 1994.