home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / OLMSAM10.ZIP / ANSWER.DOC < prev    next >
Encoding:
Text File  |  1994-11-14  |  12.7 KB  |  278 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                          OLMS ANSWERING MACHINE
  8.  
  9.           An add-on utility for Pete Rocca's OLMS version 2.0
  10.  
  11.  
  12.                    By Michael Nelson and Pab Sungenis
  13.                        Copr. 1994 EMPIRE Doorware
  14.  
  15.                        Another Shareware Offering
  16.  
  17.  
  18.                               ------------
  19.                               INTRODUCTION
  20.                               ------------
  21.  
  22.         When OLMS was first released, it quickly found its way onto our
  23. BBS.  The only problem was that it didn't have one of our favorite
  24. features: the 'vacation mail' capability offered by another door, which
  25. would scan a mail packet for a user, save it in a special directory, and
  26. allow the user to download the packets later.  When work would take me
  27. out of town for days on end, I faced the prospect of either losing mail,
  28. resetting my message bases so they grow to fill all available disk
  29. space, or switching back to my other mail door.
  30.         While OLMS version 2.0 offers the ability to scan and pack from
  31. the command line, it unfortunately does not offer an interface to allow
  32. any user who wants to use this feature.  That's where Answering Machine
  33. comes in.
  34.         OLMS Answering Machine is a door program which allows a user to
  35. turn on their own personal answering machine and/or download any packets
  36. that may be waiting, and a utility that will scan and pack mail for any
  37. and all users whose 'answering machines' are turned on in your nightly
  38. event.  For about twenty minutes' installation time, Answering Machine
  39. provides a feature that will save you and your users so much time and
  40. inconvenience, you'll wonder how you ever got along without it.
  41.  
  42.  
  43.                               ------------
  44.                               REQUIREMENTS
  45.                               ------------
  46.  
  47.         Answering Machine requires that you be using the following:
  48.  
  49.         * OLMS version 2.0 or greater.  If you haven't upgraded yet,
  50.           you really should!
  51.  
  52.         * DSZ.EXE, GSZ.EXE, or a similar transfer protocol program with
  53.           batch capability.  NOTE: The XFER.EXE program provided with
  54.           OLMS 2.0 WILL NOT WORK with Answering Machine.  Most sysops
  55.           will have a copy of DSZ laying around, especially if you used
  56.           OLMS version 1.x!
  57.  
  58.  
  59.                               ------------
  60.                               INSTALLATION
  61.                               ------------
  62.  
  63.         The OLMS Answering Machine is composed of five files:
  64.  
  65.         * AMACHINE.EXE  This is the actual Answering Machine door.
  66.         * ANSWER.HLP    Online help for the user.
  67.         * ANSWER1.EXE   This program creates a batch file to run in your
  68.                         daily event.
  69.         * ANSWER.CFG    A sample configuration file.
  70.         * SAMPLE.BAT    An example of using Answering Machine in your
  71.                         daily event.
  72.  
  73.         Extract/copy these five files to your OLMS directory.  MAKE SURE
  74. THEY ARE ALL IN THE SAME DIRECTORY AS THE OLMS DOOR AND DATA FILES; do
  75. not make a separate directory for this program.
  76.  
  77.         ************************** NOTE **************************
  78.         *                                                        *
  79.         * If you have used an earlier version of OLMS than 2.0   *
  80.         * (in other words, you converted your data files and     *
  81.         * upgraded to the current version), please run the       *
  82.         * AM-INIT.EXE file immediately before using the program. *
  83.         * This makes sure that all users have their answering    *
  84.         * machine toggle turned OFF.  Any users entering a new   *
  85.         * account in the door under version 2.0 will have it     *
  86.         * turned off automatically.                              *
  87.         *                                                        *
  88.         **********************************************************
  89.  
  90.         Next, edit the ANSWER.CFG file to correctly represent your
  91. system setup.  The lines of the file are, in order:
  92.  
  93.         OLMS LOCAL DIRECTORY:  This is the directory specified in
  94.         the OLMS configuration program, where packets 'downloaded'
  95.         locally are moved to.  If this directory is your mail reader
  96.         directory or a download directory, you should change it in
  97.         OLMS' configuration editor to point somewhere else.  Your
  98.         current temporary or work directory should suffice.  Be sure
  99.         that this line matches the 'local' directory for OLMS, or
  100.         Answering Machine will not work.
  101.  
  102.         BBS ID:  This is the BBS ID as specified in the OLMS
  103.         configuration, the string that is used in packet names
  104.         (ex.: CONNECT.QWK, CONNECT.Q23, CONNECT.SU1).
  105.  
  106.         DOWNLOAD COMMAND LINES:  These are the command lines used
  107.         to send packets to users when downloading through the door.
  108.         The correct command lines for DSZ are used in the sample
  109.         configuration file included in the archive.  The command
  110.         lines are (in order) for XModem, YModem and ZModem.  As in
  111.         OLMS, you may use *P for the current COM port, and *B for the
  112.         current baud rate.
  113.                 The file ANSWER.BEW is created by the Answering
  114.         Machine door, and contains the filenames (one per line) of the
  115.         files to be sent.  This is the format DSZ and GSZ use; if you
  116.         use another transfer program (ex.: XFER), you will need to
  117.         create a custom program/batch file to send each file listed
  118.         in ANSWER.BEW individually.  We seriously recommend using
  119.         DSZ or GSZ, since they were the programs used in the development
  120.         of this door, and are the de facto industry standards for
  121.         transfer protocols.
  122.  
  123.         ******************** A NOTE ABOUT PROTOCOLS *******************
  124.         *                                                             *
  125.         * Support for XModem is included here.  Naturally, since      *
  126.         * the concept of "vacation mail" involves batch transfers,    *
  127.         * which are impossible under XModem, Answering Machine really *
  128.         * only supports YModem and ZModem.  Yet, during the writing   *
  129.         * of this program, we were asked to add XModem.  Don't ask    *
  130.         * us why; we don't know and don't want to know.  The XModem   *
  131.         * command line for DSZ is given, but use it 'at your own      *
  132.         * risk.'                                                      *
  133.         *                                                             *
  134.         ***************************************************************
  135.  
  136.         ACTUAL LOCAL DOWNLOAD DIRECTORY:  This is the directory that
  137.         mail packets 'downloaded' locally through the door will be
  138.         moved to.  Odds are, this will be the directory you originally
  139.         specified as the 'local' directory when you installed OLMS,
  140.         and will be the same path you download other BBS's packets to.
  141.         Once again, change the local path used by OLMS to another
  142.         directory (the same one specified on line one of your config
  143.         file for Answering Machine), and specify the directory you want
  144.         to read your packets in on this line.
  145.  
  146.         Next, you will need to add Answering Machine to your BBS.
  147. The command line for the Answering Machine door is:
  148.  
  149.         AMACHINE <drop path>
  150.  
  151. where <drop path> is where Answering Machine can find the BBS's drop
  152. files (DORINFO1.DEF and EXITINFO.BBS).  Be sure to swap memory out when
  153. running the Answering Machine door.  A sample command line for RA 2.x,
  154. using a Type 7 command would be:
  155.  
  156.                 *c /c amachine.exe c:\bbs *m
  157.  
  158. If OLMS is in a different directory than RA, you will need to run the
  159. door through a batch file.  Answering Machine needs to start up in the
  160. same directory as the OLMS data files.  For example:
  161.  
  162.                 @echo off
  163.                 d:
  164.                 cd \doors\olms
  165.                 amachine.exe c:\ra
  166.                 c:
  167.  
  168. And this batch file would be called similar to this:
  169.  
  170.                 *c /c amachine.bat *m
  171.  
  172.         Last, but far from least, you'll need to create an event to scan
  173. and pack messages for users who have their answering machines 'turned
  174. on.'  This can be a BBS event, a Front End event, or even run from
  175. another window under OS/2 or Desqview.  We recommend either adding it to
  176. your daily maintenance event, right before you purge and pack your
  177. message bases, or add it immediately after your last network mail run.
  178. The steps that need to be performed are, in order:
  179.  
  180.         * Change to your OLMS directory.
  181.         * Run ANSWER1.EXE.  This scans through the OLMS user database,
  182.           and creates a batch file to scan and pack for users who have
  183.           their vacation mail activated.
  184.         * Call this batch file, called ANSWER.BAT.  This will run
  185.           OLMS for each user to scan and pack new mail and then
  186.           move the packets created to each user's special holding
  187.           directory, to be downloaded later.
  188.  
  189.         The SAMPLE.BAT file included in the archive shows one way of
  190. doing this.  Make sure these three things are performed, in an event,
  191. once each day.
  192.  
  193.         That's it!  You're fully installed, operative, and ready to go!
  194. OLMS Answering Machine is prepared to make sure you don't miss a single
  195. message!
  196.  
  197.  
  198.                         -----------------------
  199.                         USING ANSWERING MACHINE
  200.                         -----------------------
  201.  
  202.         Except for interaction with the users though the door, Answering
  203. Machine basically runs itself.  After loading, the user is presented
  204. with four options:
  205.  
  206.         [1] Turn ON Vacation Mail
  207.  
  208.             This activates your answering machine, creating a directory to
  209.             hold your packets (the directories are created off of your
  210.             OLMS directory and named ANSW0001 - ANSWFFFF, based on a
  211.             user's location in the OLMS user file), and turning on a
  212.             flag telling ANSWER1.EXE to scan and pack your mail in the
  213.             event.
  214.  
  215.              ************** WARNING!  WARNING!  WARNING! **************
  216.              *                                                        *
  217.              *  Answering Machine uses the user's position in the     *
  218.              *  USERS.DAT file when creating or accessing their       *
  219.              *  personal holding directory.  IF YOU HAVE ANY USERS    *
  220.              *  WITH THEIR VACATION MAIL TURNED ON, DO NOT USE        *
  221.              *  OLMS'S MAINTAIN PROGRAM TO REMOVE DELETED USERS,      *
  222.              *  SINCE THIS WILL THROW OFF THE NUMBERING SYSTEM, AND   *
  223.              *  MAY KEEP ANSWERING MACHINE FROM FUNCTIONING PROPERLY. *
  224.              *                                                        *
  225.              *  If you want to run MAINTAIN, make sure no users have  *
  226.              *  their vacation mail turned on.                        *
  227.              *                                                        *
  228.              **********************************************************
  229.  
  230.         [2] Turn OFF Vacation Mail
  231.  
  232.             This turns off the scan/pack flag, and deletes the holding
  233.             directory.  You cannot turn off vacation mail while you
  234.             have mail waiting.
  235.  
  236.         [3] Download Vacation Mail
  237.  
  238.             This option lists all packets waiting for you, and allows
  239.             you to download all or some of them.  When 'downloading'
  240.             locally, the files will be moved to your reader directory.
  241.             When downloading on-line, Answering Machine will use the
  242.             protocol the user specified in his/her OLMS setup.  If the
  243.             protocol is not X, Y, or Z, the program will prompt for one
  244.             of these three protocols.  Users will also be given the
  245.             option of logging off when the download is done.
  246.  
  247.         [4] Quit
  248.  
  249.             This exits the door, returning to the BBS.
  250.  
  251.         Users can also get a brief description of the program and
  252. on-line help by pressing '?'.
  253.  
  254.  
  255.                               -----------
  256.                               FINAL NOTES
  257.                               -----------
  258.  
  259.         OLMS Answering Machine is shareware.  If you use it, we ask that
  260. you register your copy.  No registration fee is required (register OLMS
  261. first and make Pete happy), but donations will not be refused.  Send any
  262. donations and other snail-mail correspondence to:
  263.  
  264.         Pab Sungenis
  265.         1349 Roosevelt Blvd.
  266.         Vineland, NJ  08360-6590
  267.  
  268.         Questions, comments, advice, hate mail, letter bombs, ransom
  269. payments, gold buillion, beef bouillion, etc. may also be sent via E-Mail:
  270.  
  271.         pab@cnx.com     mnelson@cnx.com     Fido 1:266/73
  272.         72632,52        74217,567
  273.  
  274.         Thank you, and enjoy the program.
  275.  
  276.                                         Pab & Mike.
  277.  
  278.