home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CALLRT14.ZIP / CALLROUT.DOC next >
Text File  |  1993-05-05  |  10KB  |  277 lines
  1. Call Router v1.4
  2. Copyright (c) 1992-93 by RBK Software
  3. All rights reserved.
  4.  
  5. User supported software.
  6.  
  7.  
  8. Support Notice
  9. --------------
  10.  
  11. Call Router is user supported software. If you use this program beyond
  12. a two-week trial period, we ask you to register your copy.
  13.  
  14. Benefits of registering Call Router:
  15.  
  16. 1) You help fund the future development of this software.
  17.  
  18. 2) You receive full program support.
  19.  
  20. 3) You receive the next version through U.S. mail with several useful
  21.    utilities to use with Call Router.
  22.  
  23.  
  24. Disclaimer
  25. ----------
  26.  
  27. RBK Software specifically disclaims any and all warranties, expressed or
  28. implied, including fitness for a particular purpose. Use this product at
  29. your own risk.
  30.  
  31.  
  32. Distribution
  33. ------------
  34.  
  35. This program may be copied and distributed to others to use on a trial
  36. basis so long as all files in the original archive are intact and
  37. unaltered. The two files RMDEMO.BAT and CRDEMO.BAT may be copied and
  38. then edited for personal use only.
  39.  
  40.  
  41. New features for version 1.4
  42. ----------------------------
  43.  
  44. + Call Router now has a built-in screen saver. After a minute of no
  45.   activity, your screen will clear preventing image "burn-in".
  46.   When a keyboard press or a ring is detected, the screen is restored
  47.   back to normal. The feature is only active when Call Router is
  48.   running and is not a memory resident screen-saver.
  49.  
  50. + The ability to control the DTR line is now possible with the 'dtron'
  51.   command line argument. Call Router turns DTR off to prevent your modem
  52.   from answering when in auto-answer. Use of 'dtron' will turn DTR on to
  53.   restore your modem's ability to auto-answer.
  54.  
  55. + Now you can register via Compuserve.
  56.   While on-line type "GO SWREG" and follow the instructions which follow.
  57.  
  58.  
  59. System requirements
  60. --------------------
  61.  
  62. - IBM PC or compatible.
  63.  
  64. - Hayes compatible modem.
  65.  
  66. - Voice grade telephone connection.
  67.  
  68. - RS-232 Cable with pin 22 connected. (Ring Indicator)
  69.  
  70. - MS-DOS version 2.1 or higher. (Has not been tested below 3.1)
  71.  
  72.  
  73. Description / Overview
  74. ----------------------
  75.  
  76. Call Router is a communications utility designed to help you make the
  77. most out of a single phone line. Call Router waits for an incoming call
  78. and will determine if the call is a ringmate or standard call by measuring
  79. and counting the incoming ring pattern and duration. Call Router does
  80. NOT take the line off-hook and establish a connection but exits setting
  81. the appropriate DOS errorlevel so that your 'answering' program can be
  82. called to take over.
  83.  
  84. Call Router should be started from a batch file so the errorlevel can be
  85. tested on exit. The effectiveness of this program is largely based on
  86. the setup of this batch file and your selection of software.
  87.  
  88. Here are two examples how Call Router may be used:
  89.  
  90.  1. Using Call Router with ringmate.
  91.  
  92. RingMate is an add-on service offered through your local telephone
  93. company. The service adds an additional phone number to an existing
  94. line. When called, the new number sounds a distinctly different ring
  95. pattern. The original number retains its standard length ring. One can
  96. tell by the distinct ring that the ringmate number was dialed.
  97.  
  98. Using Call Router with this service, you can use the additional number
  99. as a separate data number because Call Router can measure the difference
  100. between ringmate and standard rings. Call Router will direct which
  101. 'answering' program to start through the batch routine you create.
  102.  
  103.  2. Using Call Router on a standard line (without ringmate).
  104.  
  105. Call Router also has the ability to count incoming rings. This feature
  106. allows you to create a ringback function. If Call Router finds that the
  107. phone only rang once and the call was terminated, it would exit and set
  108. errorlevel to 2. The batch file that you created could then start an
  109. answering program. The caller could call back and get the data
  110. connection they requested. If the phone had continued to ring, you or
  111. your answering machine could have answered.
  112.  
  113.  
  114. Starting Call Router
  115. --------------------
  116.  
  117. Usage: CALLROUT comport [speed s] [rings r] [rm] [ssoff] [dtron]
  118.  
  119.  comport - Specify COM port to be used: 1, 2, 3, or 4.
  120.            This must be entered as the first argument whenever Call
  121.            Router is started.
  122.  
  123. Optional arguments:
  124.  
  125. speed s  - Baud rate specification. (up to 115200 baud)
  126.            Initial setting of baud rate, similiar to mode command.
  127.            Really not neccessary to change in most cases, for future use.
  128.            Call Router's default is 2400 baud.
  129.  
  130. rings r  - Number of rings to count before program exit.
  131.            Default setting is 2.
  132.  
  133.      rm  - Indicates that RingMate service is active on the line.
  134.            The minimum rings setting is 2 while RingMate is active.
  135.            This argument is also optional.
  136.            Call Router's default is RingMate inactive.
  137.  
  138.    ssoff - Screen saver OFF.
  139.            This disables the screen saver which is active by default.
  140.  
  141.    dtron - Turns DTR ON at exit.
  142.            DTR is turned off to prevent modem auto-answer while Call
  143.            Router is active. This parameter will force DTR at exit.
  144.  
  145. If you start Call Router without arguments, a help screen is displayed
  146. and an option to print a registration form is provided.
  147.  
  148.  
  149.  
  150. Creating your batch file
  151. ------------------------
  152.  
  153. This version of Call Router requires the use of and a good working
  154. knowledge of MS-DOS batch commands. Consult your DOS manual or an MS-DOS
  155. batch command tutorial for additional information.
  156.  
  157. There are two sample batch files distributed with Call Router. You may
  158. use these as a rough guide or edit them to suit your purposes freely.
  159. Depending on how you are using Call Router, you may also consider
  160. putting Call Router in your AUTOEXEC.BAT file and have your 'answering'
  161. program reboot after each call.
  162.  
  163. (continued next page...)
  164.  
  165.  
  166. Call Router sets DOS errorlevel as follows:
  167.  
  168.  errorlevel 4 - Short ring detected (Ringmate rings)
  169.  errorlevel 3 - Standard ring detected.
  170.  errorlevel 2 - Timeout condition.
  171.  errorlevel 1 - Program error upon startup or initialization.
  172.  errorlevel 0 - Program ended normally.
  173.  
  174.  Short ring detected (errorlevel 4)
  175.    This indicates 'ringmate rings' where detected and there were 'r'
  176.    rings counted (or the default minimum of 2 rings).
  177.    * Call Router can only exit with errorlevel 4 if the 'rm' argument
  178.      was passed.
  179.  
  180.  Standard ring detected (errorlevel 3)
  181.    This indicates standard rings where detected and there were 'r' rings
  182.    counted. If the ringmate detect option was not used and you have
  183.    ringmate service, those rings will be handled as standard rings.
  184.  
  185.  Timeout condition (errorlevel 2)
  186.    This occurs when a caller hangs up before 'r' rings have been
  187.    counted.
  188.  
  189.  Program error upon startup or initialization. (errorlevel 1)
  190.    This indicates that the program did run normally.
  191.    Possible causes are:
  192.     [ Incorrect usage... help screen will be displayed.]
  193.     [ Error opening a COM port. ]
  194.     [ Error installing INT's.   ]
  195.     Call router has built-in error traps and will display a resulting
  196.     error message if they occur.
  197.  
  198.  Program ended normally (errorlevel 0)
  199.    This simply indicates that the ESC key was pressed and Call Router
  200.    ended normally.
  201.  
  202. Use the 'IF ERRORLEVEL' condition to test the success level of a
  203. previous command. In this case the Call Router program is the previous
  204. command in your batch file.
  205.  
  206.  
  207. Useful tips / troubleshooting
  208. ------------------------------
  209.  
  210. * If you have ringmate, use that number as your data number.
  211.   Call Router is much faster with ringmate and allows you more time to
  212.   load your 'answering' program. For every one ring the caller hears you
  213.   hear two. This means that Call Router will have determined a ringmate
  214.   call on one standard ring since it takes two to determine the ring type.
  215.  
  216. * Because the quiet time between rings is measured as well, the program
  217.   exits at the starting edge of the next ring. So, if you set the
  218.   'rings' argument to 2, the program will exit at the very start of
  219.   ring 3. This checks for a hangup.
  220.  
  221. * If Call Router is running and NOT notifying you of incoming rings
  222.   check the following:
  223.    - Pin 22 on your 25 pin RS-232 cable must be connected.
  224.    - Make sure your phone is properly connected to your modem.
  225.  
  226. * Test your setup before before taking calls. Have someone call you from
  227.   a remote site while you watch what happens. Call from a remote site
  228.   yourself and see how your computer responds.
  229.  
  230. * When choosing your 'answering program' avoid software that takes a
  231.   long time to load and initialize or use a front-end program that can
  232.   answer sooner.
  233.  
  234. * Combining features built into many bulletin board systems with a few
  235.   batch utilities can greatly enhance the performance of Call Router.
  236.  
  237.  
  238. Support
  239. -------
  240.  
  241. Any questions, suggestions, or comments may be addressed to:
  242.  
  243. RBK support BBS - 24hrs.
  244. An official RBK software support and distribution site.
  245. (516) 859-1078 (300/1200/2400 BPS)
  246.  
  247. Compuserve [70714,3020]
  248.  
  249. RBK Software
  250. 280-13 Belmore Avenue
  251. East Islip, NY  11730
  252.  
  253. Sorry, no voice support for unregistered users.
  254.  
  255.  
  256. Registering
  257. -----------
  258.  
  259. Support further development of this software...
  260. please register your copy of Call Router today!
  261.  
  262. Send a completed registration form with a $15 check or money order
  263. payable to: "Robert Mulligan"
  264.  
  265.  RBK Software
  266.  280-13 Belmore Avenue
  267.  East Islip, NY  11730
  268.  
  269.    -or-
  270.  
  271. Via Compuserve - "GO SWREG"
  272.  
  273. You will receive the next version of Call Router with printed
  274. documentation and several useful utility programs for use with
  275. Call Router through the U.S mail.
  276.  
  277.