home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CL211.ZIP / CALLERS.DOC next >
Encoding:
Text File  |  1994-11-07  |  11.8 KB  |  303 lines
  1.  
  2.  
  3.                            ««« Callers v2.11 »»»
  4.  
  5.      (c)'91-'94 AquiSystems Software Dev NL., AquiSoftworks BBS Hilversum
  6.  
  7.                *** This is a drop in for version 2.10 ! ***
  8.  
  9.  
  10. ┌─
  11. │ What's Callers ?
  12. └──────────────────────────────────────────────────────────────────────────   
  13.  
  14.   ■ Callers read's the FrontDoor 'INBOUD/OUTBOUND.HIS & LASTCALL.FD' files
  15.     and also read's the RemoteAccess 'LASTCALL.BBS' file.
  16.   ■ Callers is capable to scan your NetMail directory on waiting mail packets,
  17.     and a total of files waiting for your downlinks (or points).
  18.   ■ Then it writes a few ansi files with this information.
  19.   ■ You can use these files in your BBS with a type 5 menu. 
  20.   ■ It's compatible with RA 1.1x/2.x and FD 2.02/2.11/2.12/2.20
  21.   ■ It's $TASK$ aware when using FrontDoor 2.20.mL or higher, 2 tasks are
  22.     possible in unregistered mode, 8 when registered.
  23.  
  24.  
  25. ┌─
  26. │ ShareWare concept & Copyright notice.
  27. └──────────────────────────────────────────────────────────────────────────
  28.  
  29.   ■ AquiSystems Software Dev NL. should be named as AquiSystem in the 
  30.     rest of this manual.
  31.   ■ In no event shall AquiSystems or Arnoud Aquina be liable to you
  32.     or anyone alse for any damage directly or indirectly caused by Callers.
  33.   ■ All executables, documents and example files are copyrighted 1991-1994
  34.     by Arnoud Aquina and AquiSystems.
  35.     You may however share unmodified copies of this product, as long as
  36.     no money is charged or accepted.
  37.   ■ Callers is distrubuted under the Shareware concept. That means you
  38.     must register Callers after a trail period of 30 days. Otherwise you
  39.     are violating federal copyright laws. I can (and will) only continue
  40.     developing Callers when enough people will register it.
  41.   ■ For more information about registering, please read the chapter
  42.     about 'Licensing'.
  43.   ■ All brands and product names named in this documentation are trademarks
  44.     or registered trademarks of there respective holders.
  45.   ■ Arnoud Aquina is in no way obligated to provide future versions
  46.     of, or support for this software.
  47.   ■ It's only a fact that Callers take's a place on your harddisk.
  48.     When it's fallen in two pieces, you hold both ends.
  49.  
  50.  
  51. ┌─
  52. │ Installation in RemoteAccess systems.
  53. └───────────────────────────────────────────────────────────────────────────
  54.  
  55.   ■ Create a new directory for example <drive>:\CALLERS or <drive>:\STAT
  56.   ■ Copy all file's to that directory.
  57.   ■ Before you run callers, you have to create a setup file otherwise
  58.     it won't work.
  59.     Just run CSETUP and you get a setup menu on your screen.
  60.   ■ Edit all values for your preferences.
  61.   ■ Press ESC to save all new values.
  62.   ■ This is all to create a setup file.
  63.   ■ If you wanna change the setup simply run CSETUP again.
  64.   ■ The next thing is needed otherwise CALLERS won't work
  65.     Set the following environment variabels :
  66.     SET RA=<drive>:\[rapath]  for your RemoteAccess path.
  67.     SET FD=<drive>:\[fdpath]  for your FrontDoor path.
  68.   ■ It's recommended to add SET FDOPTL=INTL to your environment !
  69.  
  70.  
  71. ┌─
  72. │ How to register? / Licensing.
  73. └───────────────────────────────────────────────────────────────────────────
  74.  
  75.   In the package you will find two files for registering, just edit
  76.   the right one for your country.
  77.   Rename it to your BBS and folow the instructions in that file.
  78.   It costs only ƒ15,- for your copy of Callers.
  79.   You receive a key-file, rename it to CALLERS.KEY, place it in the directory
  80.   where Callers is placed, and your copy is registered.
  81.   Keep alive ShareWare, register your copy of Callers now....
  82.   All registered functions are marked with {+} !
  83.  
  84.  
  85. ┌─
  86. │ Wich file's need Callers?
  87. └────────────────────────────────────────────────────────────────────────────
  88.  
  89.   CALLERS.EXE          -> This is the main executable.
  90.   CSETUP.EXE           -> The configuration utility.
  91.   CALLERS.CFG          -> The control file, edit it for your system;
  92.                           created by CSETUP
  93.   CALLERS.KEY          -> Only when you register it, not in this package.
  94.   CALLERS.IDX          -> Index file, created when scanning for netmail msgs.
  95.   STRUCT.210           -> Structure of setup file, maybe you want to write
  96.                           a setup program yourself, just let me know if so.
  97.  
  98.  
  99. ┌─
  100. │ How to work with Callers.    
  101. └────────────────────────────────────────────────────────────────────────────
  102.  
  103.   You have to create a batch file to use it with FD and RA for example :
  104.  
  105.   START.BAT
  106.  
  107.    C:
  108.    :START
  109.    CD\FD
  110.    FD
  111.    {do something with errorlevels}
  112.    CD\RA
  113.    RA -Bxxxx {Where xxxx is the right baudrate, given by FrontDoor}
  114.    CD\CALLERS
  115.    CALLERS {-S & -N:<xxxxxx> parameters optionally, see below}
  116.    GOTO START
  117.  
  118.   This is a very small example, but this give's you a way how to handle
  119.   the program.
  120.  
  121.   Also Callers returns some errorlevels, wich are the following :
  122.  
  123.   Errorlevel  10  -> INBOUND.HIS, OUTBOUND.HIS not found.
  124.   Errorlevel   9  -> LASTCALL.FD not found.
  125.   Errorlevel   8  -> LASTCALL.BBS not found.
  126.   Errorlevel   6  -> SETUP.FD not found.
  127.   Errorlevel   5  -> CONFIG.RA not found.
  128.   Errorlevel   4  -> Borland Runtime error detected.
  129.   Errorlevel   3  -> RemoteAccess path not found.
  130.   Errorlevel   2  -> Nothing to do.
  131.   Errorlevel   1  -> CALLERS.CFG not found.
  132.   Errorlevel   0  -> Normal program termination.
  133.  
  134.   You may use these errorlevels for your own purposes.
  135.  
  136.   When you have Callers running with FrontDoor 2.20.mL+ and use a second line,
  137.   and sharing OUTBOUND.HIS on multiple nodes, you should run CALLERS with
  138.   his -S parameter, when not, Callers doesn't work properly.
  139.  
  140.   You also may override the BBS name found in CONFIG.RA, just simply start
  141.   CALLERS -N:FileBase_BBS or CALLERS -N:AquiSoftworks_BBS_H'sum remember to use
  142.   underscores in the name instead of spaces, this due using more parameters
  143.   on the commandline.
  144.  
  145.   Use -T:<Task> to override the tasknumber where Callers is running, this is
  146.   usefull when you run a multiline network (FrontDoor 2.20.mL+ only!)
  147.   But remember, you must still use the multiline option in the setup utility
  148.   for using it multiline.
  149.  
  150.   Use -D to dissable any last mail session overwritten in LASTCALL.BBS.
  151.   Use -F to dissable create a total overview for files waiting. {+}
  152.  
  153.   You could use CALLERS -N:Hello_BBS -S or CALLERS -S -N:Hello_BBS -D -F
  154.  
  155.   
  156. ┌─
  157. │ Update's from version 2.04/2.10(a) to 2.11
  158. └────────────────────────────────────────────────────────────────────────────
  159.  
  160.  ■ Deleted 38400 bps in local baudrate and added 21k6, 24k, 26k4 and 28k8 bps.
  161.  ■ Fixed OS/2 bug on version 2.99 (a)
  162.  ■ Now checking first on OUTBOUND.HIS instead on the inbound file, this is
  163.    done for point systems, wich most of the time don't have a inbound 
  164.    history, you usually can't poll them. (a)
  165.    This has fixed in 2.11 when your are using -S for shared outbound history.
  166.  ■ Bug in ANSI packet file, fixed. (a)
  167.  ■ Skipped first non used entry in INBOUND/OUTBOUND.HIS files.
  168.  ■ Fully compatible with FD's $TASK$ variable (when you use FD multiline).
  169.  ■ Callers scans your netmail directory on waiting mail packets and files wich
  170.    are waiting for your downlinks or points.
  171.    The sort routine used can sort a maximum of 400 netmail messages.
  172.    A maximum of 4 files are scanned from the subject line.
  173.  ■ LASTCALL.FD (FD) import to LASTCALL.BBS (can be disabled).
  174.  ■ Redesigned output screen in CALLERS.EXE.
  175.  ■ Added errorlevel 8 when LASTCALL.BBS of RA was not found.
  176.  ■ Now using a runtime library written by myself.
  177.  ■ Added errorlevel 4 when a runtime error was detected, see Bug Report.
  178.  ■ Task number is now showed on outbound screen when using -S parameter.
  179.  
  180.  
  181. ┌─
  182. │ Upgrading from version 2.02/2.03g/2.04 to 2.10(a) or 2.11
  183. └────────────────────────────────────────────────────────────────────────────
  184.  
  185.   Copy CALLERS.EXE over the old version, also copy CSETUP.EXE wich replaces
  186.   the internal setup of Callers in prev. versions.
  187.   When using version 2.02/2.03g or 2.04, just run CSETUP wich upgrades to the 
  188.   new version.
  189.   When youre using an older version (like < 2.02), delete CALLERS.CFG and 
  190.   run from scratch.
  191.  
  192.  
  193. ┌─
  194. │ Distribution Sites
  195. └────────────────────────────────────────────────────────────────────────────
  196.  
  197.   It's possible to find Callers on many Bulletin Boards, but these are
  198.   the only official distribution boards :
  199.  
  200.   Europe           : AquiSoftworks BBS, 50:222/0@AquiNet, 2:283/516@FidoNet,
  201.                      Sysop : Arnoud Aquina,
  202.                      +31-35-859162, 1200-28800 Bps (VFC), 24 hrs a day,
  203.                      Hilversum, The Netherlands.
  204.  
  205.   The Netherlands  : Sunlite BBS, 50:557/0@AquiNet, 2:283/516.2@FidoNet,
  206.                      Sysop : Merijn van de Schoot,
  207.                      +31-4254-2949, 1200-28800 Bps (VFC), 24 hrs a day,
  208.                      Diessen, The Netherlands.
  209.  
  210.   UK               : Imperial BBS, 50:400/0@AquiNet, 2:440/29@FidoNet,
  211.                      Sysop : James Legg,
  212.                      +44-322-556325, 300-14400 Bps (V32B), 24 hrs a day,
  213.                      Crayford, Kent, England.
  214.                        
  215.   You can download here the latest version of Callers if available.
  216.   Also you may find it on the BBS of any of the beta testers.
  217.  
  218.  
  219. ┌─
  220. │ Beta testers.
  221. └────────────────────────────────────────────────────────────────────────────
  222.  
  223.   Our beta-team :
  224.  
  225.   Merijn van de Schoot,
  226.   Sunlite BBS,
  227.   50:557/0@AquiNet, 2:283/516.2@FidoNet,
  228.   +31-4254-2949, 1200-28800 Bps (VFC), 24 Hrs
  229.  
  230.   Martin van der Heide,
  231.   FileBase BBS,
  232.   50:222/112@AquiNet, 2:512/50@Fidonet,
  233.   +31-35-858404/858414, Node 1 & 2 up to 28k8/V.FC/V34, 24 Hrs
  234.  
  235.   Joris de Mooij,
  236.   The Vesuvius BBS,
  237.   50:222/102@AquiNet,
  238.   +31-1644-2098, 1200-28800 Bps (VFC), 24 Hrs
  239.  
  240.   James Legg,
  241.   Imperial BBS,
  242.   50:400/0@AquiNet, 2:440/29@FidoNet,
  243.   +44-322-556325, 300-14400 Bps (V32B), 24 Hrs
  244.  
  245.   Pascal Aquina,
  246.   "Jimmy's Place BBS",
  247.   50:222/101.99@AquiNet, 2:283/516.7@FidoNet,
  248.   +31-35-PRIVATE, 300-14400 Bps (V32B).
  249.  
  250.   I'm looking for beta-tester outside The Netherlands, also for distribution.
  251.   If you want to test it, leave a message to me on Fido 2:283/516.
  252.   I give you a free key-file if you bring 2 sysops to me wich want to 
  253.   register this program !!!
  254.  
  255.    
  256. ┌─
  257. │ Credits.
  258. └─────────────────────────────────────────────────────────────────────────────
  259.  
  260.   The following people for their programs :
  261.  
  262.          FrontDoor              Joaquim H, Homrighause, Absolute Solutions.
  263.          RemoteAccess           Andrew Milner, Wantree Development.
  264.          ARJ                    Robert K. Jung.
  265.          FidoNet                Tom Jennings, Fido Software.
  266.          Runtime library,  
  267.          AquiNet                Arnoud Aquina, AquiSystems Software Dev NL.
  268.          SIGnet                 Glenn Harvey.
  269.          TechNet                Mart van der Engh.
  270.          Turbo Pascal           Borland International.
  271.  
  272.  
  273. ┌─
  274. │ Bug Reports.
  275. └─────────────────────────────────────────────────────────────────────────────
  276.   
  277.   Callers now uses a internal runtime library written by myself.
  278.   When there is a runtime error, Callers print this to your screen.
  279.   The program then exits normaly whit errorlevel 4 and continues your batch,
  280.   so it won't hang up your system.
  281.   Also a file called CALLERS.ERR is created so you can see what happened.
  282.   You may send this file to me, so I can find out whats going wrong.
  283.  
  284.   Send your bugreports to Arnoud Aquina by following netmail :
  285.  
  286.    50:222/0   or 50:51/0 AquiNet (HQ)
  287.    27:2331/40 or 27:2331/401 SIGnet (HUB)
  288.    111:318/0 TechNet (HOST)
  289.    2:283/516 FidoNet (DCN node)
  290.  
  291.  
  292.   Snail mail :
  293.  
  294.    AquiSystems Software Dev NL.,
  295.    Arnoud Aquina,
  296.    Galvanistraat 8,
  297.    NL-1221 ES  Hilversum, The Netherlands.
  298.  
  299.    AquiSoftworks BBS, The home of AquiNet,
  300.    +31-35-859162 / 24 Hrs / Max. 28800 baud (V.FC).
  301.  
  302.  
  303. ■ End of DOC-file Callers 2.11