home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / anser106.lzh / ARCFILE.3 < prev    next >
Text File  |  1988-08-12  |  10KB  |  234 lines
  1.  
  2.  
  3.                    -*>Starlight Answering Machine v1.06<*-
  4.                           Programmed by:  Bob Uhrick
  5.                          (C)1988, Starlight Telecomm
  6.                 Compiled on 12-Aug-88 with Manx Aztec C v3.6a
  7.  
  8.  
  9.        ---------------------------------------------------------------
  10.  
  11.                                  INTRODUCTION
  12.  
  13.         Attention Sysops:  When you take down your BBS to do maintenance on
  14. it, or to play that brand new game one of your users just uploaded, do you
  15. usually keep your modem off-hook (keep the line busy), or do you allow your
  16. phone to keep ringing, and ringing, and ringing when someone tries to call? I
  17. think it's a good idea to let your users know why your BBS is down, and to
  18. also let them know when they can expect it back in operation.  That's the main
  19. reason I wrote this small program.  You can run it in the background and it
  20. will answer the modem when someone calls.  A text file which you specify is
  21. then displayed to the user, then the user is logged-off, and the program will
  22. wait for another call.  The program is only about 15K, so it doesn't take up
  23. much of your precious memory.  This will leave you with plenty of room to
  24. work.  This is great for Sysops who do a lot of programming and compiling,
  25. since compilers usually eat up plenty of memory.
  26.  
  27.        ---------------------------------------------------------------
  28.  
  29.                                SHAREWARE NOTICE
  30.  
  31. The Starlight Answering Machine is released to the public under the SHAREWARE
  32. concept, which means, "You don't pay for it unless you use it".  If you don't
  33. like this program, and don't intend to use it, just remember:  What did you
  34. pay for it in the first place?  If you think this program is useful to you,
  35. and you use it often, please send a check or money order for $10.00 to:
  36.  
  37.                            Bob Uhrick
  38.                            6736 Horrocks St.
  39.                            Philadelphia, PA. 19149
  40.  
  41. This registration fee will go towards the development of The Starlight BBS
  42. software that I am currently working on.
  43.  
  44.        ---------------------------------------------------------------
  45.  
  46.                                  DISTRIBUTION
  47.  
  48. The ORIGINAL *UNALTERED* archive may be distributed by any of the following
  49. methods:
  50.  
  51. 1> Computer Bulletin Boards (BBS), as long as no charge is made for the
  52.    privilege of downloading this archive.
  53.  
  54. 2> Through any commercial or non-commercial computer network as long as it
  55.    DOES NOT claim ANY SORT of copyright over this program.  If you see this
  56.    program on such a network, please ask the Sysop to remove it IMMEDIATELY!
  57.  
  58. 3> Via disk-based (or other magnetic media) PD libraries such as the Fish
  59.    Disks, AMICUS, etc., as long as distribution costs are limited to media and
  60.    handling costs (including shipping), and NO subscription charge is imposed
  61.    to the user for rights to receive such disks.
  62.  
  63. Any other methods of distribution MUST be discussed with the author!
  64.  
  65.        ---------------------------------------------------------------
  66.  
  67.                             INSTALLATION AND USAGE
  68.  
  69.         The file "AM.Config" should be located in either the current
  70. directory, or the S: directory of your WorkBench disk.  This configuration
  71. file tells the program how to handle the modem commands, and the name of the
  72. file to display to the user.  Here is a break-down of the AM.Config file:
  73.  
  74.    FILENAME: DEV:dir/filename
  75.  
  76. This is the name of the file that is displayed to the user when he/she logs
  77. on.  The best place to keep this file is in RAM: since you can swap disks,
  78. etc. without worrying about the file.  There is one special feature:  If you
  79. specify NONE for the filename, the program will display the following built-in
  80. message to the user:
  81.  
  82.                                    *Sorry*
  83.  
  84.                      The system is down for maintenance.
  85.                            Please try again later.
  86.  
  87.                                    Thanks!
  88.  
  89.                                   - Sysop -
  90.  
  91.    BAUD: number
  92.  
  93. This is the *highest* baud rate that your modem can communicate at.  Valid
  94. rates are:  300, 1200, 2400, 4800, and 9600.
  95.  
  96.    OPEN: string
  97.  
  98. This is the modem initialization string that is sent to the modem when the
  99. program is first run.  Here are some examples that work with
  100.  
  101.       1200 baud modems:
  102.       ATE0F1M0Q0V1X1S0=0S2=255S7=20S12=255
  103.  
  104.       2400 baud modems:
  105.       ATE0F1M0Q0V1X4&C1&D2S0=0S2=255S7=20S12=255
  106.  
  107. NOTICE:  I have register S0=0 which DISABLES the modem's auto-answer ability.
  108. This is important since the software will determine when the modem should
  109. answer.
  110.  
  111.    RESET: string
  112.  
  113. This is the string that is sent to the modem AFTER someone is logged-off.
  114. This *should* be a command to hang-up your modem.  The command to do so on
  115. Hayes compatible modems is ATH0
  116.  
  117.    RING: string
  118.  
  119. This is the string that the program looks for when the modem uncounters a
  120. ring.  On a normal Hayes compatible modem, this should be RING
  121.  
  122.    ANSWER: string
  123.  
  124. This is the string that is sent to the modem after a ring is detected.  On a
  125. normal Hayes compatible modem, this should be ATA
  126.  
  127.    300: string
  128.    1200: string
  129.    2400: string
  130.    4800: string
  131.    9600: string
  132.  
  133. These are the strings that the modem sends to the program after a connection
  134. has been made.  These strings tell the program what baud rate has been
  135. connected.  On a normal Hayes compatible modem, they should be set to the
  136. following:
  137.  
  138.    300: CONNECT
  139.    1200: CONNECT 1200
  140.    2400: CONNECT 2400
  141.    4800: CONNECT 4800
  142.    9600: CONNECT 9600
  143.  
  144. Well, that's about it for the configuration file.  Let's go on to the actual
  145. program itself:
  146.  
  147.         It is best to "run" this program from the CLI (by the way, this
  148. version can ONLY be used from the CLI...  I may include the ability to run
  149. this program from a WorkBench icon in the future, but for now, it can inly
  150. be run from the CLI).  To do so, type "run Starlight-AM" at the CLI prompt.
  151. If the program encounters any errors during the set-up procedure, you will
  152. be notified of what caused the error, and the program will end.  After
  153. correcting the error, just "run Starlight-AM".
  154.  
  155.         After the program is finished loading in the "AM.Config"
  156. configuration parameters, the title screen will appear, and the message
  157. "Awaiting Logon..." will appear.  The current date/time will also be
  158. displayed.  Hold down the right mouse button, and you will see that there
  159. are some pull-down menus:
  160.    _________                     _________
  161.   | Project |________________   | Options |________
  162.   |                          |  |                  |
  163.   | About -*>Starlight AM<*- |  | Titlebar On   A1 |
  164.   | Exit to AmigaDOS      AX |  | Titlebar Off  A2 |
  165.   |__________________________|  |__________________|
  166.  
  167. "About Starlight AM" will display a little bit of information about the
  168. program.
  169. "Exit to AmigaDOS" will do just that:  It will exit the program, and return
  170. you to the CLI.  This command can also be invoked using the right-Amiga-X
  171. hotkey sequence.
  172.  
  173. "Titlebar On" will turn on the titlebar so you can use the front/back
  174. gadgets to toggle between other screens.  This command can also be invoked
  175. using the right-Amiga-1 hotkey sequence.
  176. "Titlebar Off" will turn off the titlebar.  This command can also be invoked
  177. using the right-Amiga-2 hotjey sequence.
  178.  
  179. Well, that's about all for now!  It seems like it took longer to write these
  180. docs than it did to write the actual program! <grin>
  181.  
  182. And...  Don't forget to send in your registration fee! :-)
  183.  
  184.        ---------------------------------------------------------------
  185.  
  186.                               WHERE TO CONTACT ME
  187.  
  188. You can contact me through US Mail (my address is listed above) or on the
  189. following BBSs:
  190.  
  191.      Berk's Amiga BBS   (215)-678-7691     <-  These two are the best since
  192.      Millennium Falcon  (215)-551-0789     <-  they're local to me, although
  193.      AMIC-2000          (707)-579-0523         I *will* receive messages on
  194.      Roundabout BBS     (803)-791-9448         the other systems, since I
  195.      Excalibur's Realm  (201)-256-0691         try to check them at least
  196.      Custom BBS         (213)-839-6867         once a week.
  197.      Bifrost BBS        (301)-948-6286
  198.      Amy Center         (818)-982-8495
  199.      Deep Thought       (919)-471-6436
  200.  
  201. ...and on other BBSs around the country where you see my name in the user
  202. list (thanks to the miracle of PC-Pursuit!).
  203.  
  204. Oh, I can also be reached through USENET e-mail at:
  205.  
  206.       sun!portal!cup.portal.com!Bob_Uhrick
  207.  
  208.                      - or -
  209.  
  210.             Bob_Uhrick@cup.portal.com
  211.  
  212.        ---------------------------------------------------------------
  213.  
  214.                             WHERE TO FIND UPDATES
  215.  
  216. The latest and current up-to-date versions of all of my software can be
  217. found on:
  218.  
  219.           =====> ONIX: Online Network for Information Xchange <=====
  220.           -- Never a Busy Signal! (up to 16 Simultaneous Callers) --
  221.           ----------------------------------------------------------
  222.           Largest Online Software Library in Philadelphia: 465 megs!
  223.            5600+ files & growing: Amiga, C64, Graphics, IBM, & Mac
  224.            FAST Xmodem, Xmodem/CRC, & 1K Xmodem (Ymodem) Downloads
  225.             Multi-User "Chat": 65,535 Public & Private "Channels"
  226.             Public/Private Messaging -- Multi-Player Online Games
  227.            Classified Ads: Seen by users from all over the country
  228.           ----------------------------------------------------------
  229.                     PC-Pursuit'able through the PAPHI node
  230.                 16 Lines, 23 Hours Daily, 300/1200 baud, 8/N/1
  231.                  ==> CALL TODAY: (215)-896-9020 via modem <==
  232.  
  233. Enjoy the program!!  Look for the -*>Starlight-BBS<*- software coming soon!
  234.