home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / PAGEV155.ZIP / RA-PAGER.DOC < prev    next >
Encoding:
Text File  |  1996-03-03  |  11.4 KB  |  265 lines
  1.                   
  2.                    ▄▀▀▀▄  ▄▀▀▄     ▄▀▀▄                      
  3.                    █   █  █  █     █▄▄█  ▄▄   ▄▄▄  ▄▄ ▄▄▄▄
  4.                    █▀▀▀▀█ █▀▀█ ▀▀▀ █    █  █ █ ▄▄ █▄  █▄▄█▄
  5.                    █    █ █  █     █    █▀▀█ ▀▄▄▀ ▀▄▄ █   █
  6.                    ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  7.                                  Version 1.55
  8.                                                     
  9.                           (C) 1996 by Jason Raphael
  10.  
  11.    ─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-
  12.    
  13.                       ─═─ Welcome to RA-Pager v1.55! ─═─
  14.                        
  15.  RA-Pager v1.55 was programmed and designed by Jason Raphael, February 1996.
  16.                         Completed at 2:48pm, 03-03-96.
  17.  
  18.                                     - 1 - 
  19.  
  20.  ──═════════════════════──
  21.      Table of Contents
  22.  ──═════════════════════──
  23.  
  24.     Table of Contents........1
  25.     Information..............2
  26.     Legal Information........3
  27.     Archive Contents.........4
  28.     Installation.............5
  29.     RA-Pager Log.............6
  30.     SysOp Keys...............7
  31.     Registration.............8
  32.     Credits..................9
  33.     Support..................10
  34.  
  35.                                     - 2 -
  36.  
  37.  ──═════════════════════──
  38.         Information
  39.  ──═════════════════════──
  40.  
  41.     RA-Pager is a RemoteAccess questionnaire (q-a) script.  This means that
  42.     it will load extremely fast from RA, and you can still see the RA status
  43.     bar and use all RA SysOp keys while in the program.  RA-Pager gives you
  44.     many advantages over RA's standard SysOp pager.  Some of the features 
  45.     are:
  46.  
  47.         - "Do you want to page SysOp?" prompt before paging..
  48.         - Full logging of all activity, page reasons, etc to a separate log
  49.           (One thing I always disliked about RA's internal paging is the
  50.           lack of logging of reasons, and the necessity of scanning through
  51.           your entire RA.LOG to find when someone paged)..
  52.         - Full lightbar support of all prompts..
  53.         - Pressing enter on the chat reason prompt won't simply exit as RA's 
  54.           internal pager does.  Instead, the user is displayed a message
  55.           saying to please enter a reason, or type QUIT to exit..
  56.         - Moving bars while SysOp is being paged so the user knows that
  57.           something is happening..
  58.         - Allows you to continue using RA's chatter (which many people prefer
  59.           over a 3rd-party chatter) with a much improved interface..
  60.         - ...And much more!
  61.  
  62.    - Notice on modifications of questionnaire:
  63.  
  64.      You may modify the text in this questionnaire (such as the paging 
  65.      reason asking string, etc).  I only have one small requirement about
  66.      this: You must leave the blue status bar at the top of every screen (as 
  67.      it is now) with the program name on it, the exact way it is by default.
  68.  
  69.                                     - 3 -
  70.  
  71.  ──═════════════════════──
  72.      Legal Information
  73.  ──═════════════════════──
  74.     
  75.     Neither myself (Jason Raphael) nor Dream Scape BBS can be held 
  76.     responsible for any damage this program may cause on your system.  It
  77.     HAS been thoroughly tested on my system as well as other systems, and to 
  78.     the best of my knowledge works fine.  After all, it is only an RA 
  79.     questionnaire. <grin> :)  If you DO for some reason encounter any 
  80.     problems with it, however, neither of the above mentioned parties take 
  81.     any responsibility for it.
  82.  
  83.     You are encouraged to distribute RA-Pager, as long as it is in its
  84.     original archive with all files included and NOT modified in any way.
  85.     
  86.                                     - 4 -
  87.  
  88.  ──═════════════════════──
  89.      Archive Contents
  90.  ──═════════════════════──
  91.  
  92.     The RA-Pager archive (PAGEV155.ZIP) should contain the following files:
  93.       DONATE.FRM     Donation form
  94.       FILE_ID.DIZ    Program identification
  95.       PAGEV155.Q-A   Main Q-A file
  96.       RA-PAGER.BAT   Batch file used by RA-Pager
  97.       RA-PAGER.DOC   RA-Pager documentation (you're reading it!)
  98.       RAPSAV10.ZIP   RAPSA v1.0, a handy utility I wrote to adjust RA's
  99.                      paging status from the DOS prompt
  100.       README.1ST     Important installation information
  101.       WHATSNEW.155   Information on new features in versions
  102.  
  103.     The following file will be created after RA-Pager is executed:
  104.       PAGE.LOG     RA-Pager logfile
  105.  
  106.                                     - 5 -
  107.  
  108.  ──═════════════════════── 
  109.        Installation
  110.  ──═════════════════════──
  111.  
  112.    You *MUST* rename PAGEV155.Q-A to PAGE.Q-A.  This will also be helpful
  113.    so that you don't have to adjust any menus due to new filenames in any 
  114.    future/previous versions.
  115.      
  116.    Also, you must have an ANSI driver loaded (such as ANSI.SYS).
  117.  
  118.      1) Copy PAGE.Q-A to your RemoteAccess questionnaire directory.
  119.      
  120.      2) Copy RA-PAGER.BAT to a directory that is in your PATH statement
  121.         (ex: C:\DOS).  If you have your RemoteAccess system directory in your
  122.         PATH statement (in your autoexec.bat file), then you can just move
  123.         it to that directory.
  124.  
  125.         IMPORTANT: RA-Pager uses your RemoteAccess environment variable to 
  126.         locate your RA system directory.  You *MUST* have the RA environment
  127.         variable set, and RA-PAGER.BAT *MUST* reside in a directory that is
  128.         in your PATH statement, or RA-Pager will not operate correctly.
  129.  
  130.      3) In RACONFIG -> Options -> Paging, make sure you have "Ask why"
  131.         set to No, and "SysOp msgs" set to 0 (disabled).  RA-Pager 
  132.         incorporates these features, so if you have RemoteAccess using
  133.         them as well, the user will be prompted twice for both items.
  134.      
  135.      4) Add the option in your menus:
  136.  
  137.     ∙ Setting up RA-Pager v1.55 in a RemoteAccess menu
  138.      
  139.      a) Enter RACONFIG -> Menu editor
  140.      b) Go to the menu that you wish to have an option to page the system
  141.         operator on.  If you're running a registered version of RA, you may
  142.         wish to put this on your GLOBALRA.MNU so that it can be executed
  143.         from any menu on your BBS.
  144.      c) Make a new menu entry as follows:
  145.  
  146.  Action   Execute a questionnaire (Type 12) 
  147.  Display  ;         <-- Your display may vary
  148.  OptData  PAGE      <-- Make sure you rename PAGEV155.Q-A to PAGE.Q-A!
  149.  HotKey   P         <-- Your hotkey may vary
  150.  AutoExec No
  151.  Colour   Colour example
  152.  
  153.  MinSec   0                  TimeUsed 0                  FlatCost 0
  154.  MaxSec   0                  TimeLeft 0                  TimeCost 0
  155.  A flags  --------           Age      0                  Terminal ANSI RIP
  156.  B flags  --------           MinSpeed 0                  Nodes
  157.  C flags  --------           MaxSpeed 0                  Groups
  158.  D flags  --------           Credit   0                  DayTimes
  159.  
  160.     At this point in time, RA-Pager does not support ASCII.  If your system 
  161.     supports ASCII callers, you'll have to set up a regular RA page menu 
  162.     option for them to use.  This should be very easy to do - As in the 
  163.     above example, set the "Terminal" setting for RA-Pager to ANSI and RIP
  164.     only.  Then, create another menu option _after_ the option for RA-Pager.
  165.     Make the action on this option a type 11 (page system operator for chat).
  166.     Now, all ANSI/RIP callers will go to RA-Pager, and all ASCII callers will
  167.     just get the internal RA pager.
  168.  
  169.     If there is enough demand, RA-Pager could support ASCII in a future 
  170.     release.
  171.  
  172.                                     - 6 - 
  173.  
  174.  ──═════════════════════──
  175.        RA-Pager Log
  176.  ──═════════════════════──   
  177.     
  178.     RA-Pager will create a logfile of all activity.  Who entered the program
  179.     and when will be logged, as well as their paging reason and if they left
  180.     a message or not (if they chatted with you, that will be logged also -
  181.     see next section for more information).  Here are two examples of how
  182.     the logfile will look after certain actions have taken place:
  183.  
  184.     RA-Pager executed by Jason Raphael [Jammer] on node 2 (02-08-96, 16:37).
  185.     - Reason: Testing RA-Pager v1.55!
  186.     - Left a message: Yes
  187.     RA-Pager executed by Jason Raphael [Jammer] on node 2 (02-08-96, 16:58).
  188.     - Reason: Example of logfile after SysOp has chatted
  189.     - Left a message: [Chatted with SysOp]
  190.  
  191.     The RA-Pager logfile will be created in your RA system directory with 
  192.     the filename PAGE.LOG.
  193.  
  194.                                     - 7 -
  195.  
  196.  ──═════════════════════──
  197.         SysOp Keys
  198.  ──═════════════════════──
  199.     
  200.     There is only one major SysOp key in RA-Pager, and it only works in one
  201.     place.  After you've chatted with a user, you would normally press ESCape
  202.     once to end chat.  One minor change: Press ESCape _twice_ to end chat.
  203.     This will cause the "Leave a message" prompt to abort and clear right
  204.     away, as well as log that you chatted with the user.
  205.  
  206.                                     - 8 -
  207.  
  208.  ──═════════════════════──
  209.         Registration 
  210.  ──═════════════════════──    
  211.     
  212.     You are not required to pay any kind of fee to use this program.  RA-Pager 
  213.     has greatly progressed since the time I began writing it (it was formerly 
  214.     not publicly released).  Over all the versions, I've put a lot of my time 
  215.     into making it look just right, fixing every little detail, etc.  There 
  216.     are no special features or extras you get for sending a donation, but I'm
  217.     definitely more likely to release future versions and other q-a programs
  218.     if I were to receive some donations.  I suggest a small donation of $5.
  219.     Please see DONATE.FRM for donation information.  Even if you choose not
  220.     to donate, if you enjoy the program, I'd really appreciate receiving
  221.     some kind of postcard or letter from you.  My mailing address is at
  222.     the end of this document.
  223.  
  224.                                     - 9 -
  225.  
  226.  ──═════════════════════──    
  227.           Credits       
  228.  ──═════════════════════──    
  229.  
  230.     As mentioned above, the development of RA-Pager has come a very long
  231.     way since the first version written.  There are some people that I'd
  232.     like to thank for their help, without which RA-Pager wouldn't be where
  233.     it is today (in no particular order):
  234.          - Brad Meyer, the RA-Pager "beta tester," for his support, ideas,
  235.            and testing of RA-Pager since version 1.0..
  236.          - Andrew Milner - If it weren't for him, RemoteAccess wouldn't be
  237.            here, and this program would be useless..
  238.          - Eric Staufer, who inspired me to finally release this program
  239.            publicly.
  240.  
  241.  
  242.                                     - 10 -
  243.  
  244.  ──═════════════════════──    
  245.          Support
  246.  ──═════════════════════──    
  247.  
  248.     You can always obtain the latest version of RA-Pager by either:
  249.      ∙ FREQing magicname RA-PAGER from Dream Scape BBS, 1:284/22, any time
  250.        but ZMH up to 28.8 bps..
  251.      ∙ Logging on to Dream Scape BBS, 417-883-4035.
  252.  
  253.     If you're having any problems with RA-Pager v1.55, if you have a 
  254.     suggestion for a future version, or need to contact me for some other
  255.     reason, there are several ways you can do so:
  256.  
  257.     - Send FidoNet netmail: 1:284/22
  258.     - Logon to Dream Scape BBS: (417) 883-4035
  259.     - Send internet e-mail: jason.raphael@c-matrix.springfield.mo.us
  260.     - Post a message to me in the RA_UTIL FidoNet echo
  261.     - Send me mail via U.S. Postal service:
  262.                 Dream Scape BBS
  263.                 1730 East Republic Road A-123
  264.                 Springfield, MO  65804-7502
  265.