home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TABSRA21.ZIP / TABSRA.DOC < prev   
Encoding:
Text File  |  1995-01-28  |  38.3 KB  |  856 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                   TabsRA v2.01
  11.  
  12.                  Copyright (C) 1994, 1995  All Rights Reserved
  13.  
  14.  
  15.  
  16.  
  17.  
  18.         [  A utility for RemoteAccess Bulletin Boards using the TABS  ]
  19.         [  services provided by True Media, Inc. of Palm Bay, FL      ]
  20.  
  21.  
  22.  
  23.                     TabsRA is compatible with the following:
  24.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  25.                     RemoteAccess v1.1  -  RemoteAccess v2.02
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                RiverBend SoftWare
  44.                      P.O. Box 671 * Osceola, AR 72370-0671
  45.  
  46.  
  47.                                   Fido 1:19/99
  48.  
  49.               InterNet Address: jim.tanner@f99.n19.z1.fidonet.org
  50.                                 jim.tanner@river.cnx.com
  51.                                 riverbend@river.cnx.com
  52.  
  53.                BBS Line 1 (501) 563-6829 2400-16800 HST V32b V42b
  54.                  BBS Line 2 (501) 563-6829 2400-14400 V32b V42b
  55.                                     -Index-
  56.  
  57.  
  58.  
  59.                 Requirements ........................... Page 1
  60.                 About TabsRA ........................... Page 2
  61.                 Installation ........................... Page 4
  62.                 Command Line Options/Switches .......... Page 6
  63.                 Command Line Examples (RA Menu) ........ Page 8
  64.                 Configuration File ..................... Page 9
  65.                 Trouble Shooting ....................... Page 12
  66.                 Registering TabsRA ..................... Page 16
  67.                 Warranty and Misc ...................... Page 17
  68.                 Government and Commercial Use .......... Page 17
  69.                 Order Form ............................. Page 18
  70.  
  71.  
  72.  
  73.      TabsRA is the copyright protected property of Jim Tanner, dba
  74.      RiverBend SoftWare, P.O. Box 671, Osceola, Arkansas 72370-0671
  75.  
  76.      TabsRA is shareware!  It is not "freeware" and as such may be
  77.      used for a period of 15 days as a "test drive" period.  If you
  78.      continue to use TabsRA after the 15 day period then you become
  79.      obligated to register it.  If you do not register TabsRA after
  80.      15 day period, you must remove it from your system.
  81.  
  82.      TabsRA may not be reverse engineered, disassembled, or changed
  83.      in any manner.
  84.  
  85.      When registered, TabsRA will not display any "beg screens" or
  86.      undue delays of any kind.  Each registered copy is personalized
  87.      for each registered owner.  No upgrade fees are ever charged!
  88.  
  89.      See Page 18 for registration and pricing information.
  90.  
  91.      Site licenses are available by contacting RiverBend SoftWare at
  92.      (501) 563-2892 during normal business hours (Central Time).  See
  93.      Page 18 for additional info on Site Licenses.
  94.  
  95.  
  96.      NOTE:  The term SID used in this document stands for:
  97.  
  98.                    Subscription IDentification
  99.                    ~            ~~
  100.             This is the number a Caller receives when he/she calls
  101.             the True Media 900 numbers.
  102.  
  103.      BBS operators are encouraged to make the archive containing the
  104.      latest version of TabsRA available for download by their callers.
  105.      All files in the original archive must be included and must not
  106.      have been changed or altered in any manner.
  107.  
  108.  
  109.  
  110.                                       -1-
  111.  
  112.      Requirements:
  113.  
  114.         BBS software:  While TabsRA was written specifically for
  115.                        RemoteAccess v2.xx and higher, it should work
  116.                        with most any software that uses either the
  117.                        DORINFOx.DEF and/or DOOR.SYS as its dropfile.
  118.  
  119.                        Software known to be supported is:
  120.  
  121.                        RemoteAccess v1.11 - v2.02
  122.                        QuickBBS v2.75 - v2.80
  123.                        ProBoard
  124.                        SuperBBS v1.17
  125.                        Other software that creates a "GAP" style DOOR.SYS
  126.  
  127.                        TabsRA will perform all functions as stated in
  128.                        this document for RemoteAccess software.  It's use
  129.                        with other software offers some but not all the
  130.                        options available.
  131.  
  132.  
  133.         Hardware:      No additional hardware other than that used to
  134.                        run a single or multiline BBS is required to run
  135.                        TabsRA.
  136.  
  137.         TABS:          TabsRA is designed to use/read the 7 digit SID
  138.                        numbers issued by True Media, Inc.  If other
  139.                        firms offer the same 7 digit list then TabsRA
  140.                        should work equally well with any lists these
  141.                        businesses provide to SysOps.  As long as the
  142.                        list of 7 digit SID numbers is a straight ASCII
  143.                        text file with no additional control characters
  144.                        imbedded, TabsRA should have no problems with
  145.                        using these lists of 7 digit numbers.
  146.  
  147.         TRUE MEDIA:    SysOps wanting to add the TABS subscription
  148.                        option to their BBS can call True Media, Inc.
  149.                        at the following numbers:
  150.  
  151.                        BBS Support Board:  (407) 722-3406
  152.                            A call to the BBS can get you enrolled in
  153.                            the TABS program (it's free) and get you
  154.                            your lists of SID numbers on the first call.
  155.  
  156.                        Voice Support:  (407) 722-3150
  157.  
  158.                        FAX: (407) 722-3154
  159.  
  160.                        There is absolutely NO CHARGE to enroll in the
  161.                        TABS program.  You can drop out at any time or
  162.                        continue as long as you like.
  163.  
  164.  
  165.                                       -2-
  166.  
  167.      About TabsRA:
  168.  
  169.         This software was written in Turbo Pascal v7.0 using JPDoor v4.1
  170.         by McSoft, Inc. as the door library.
  171.  
  172.         Specifications:               {+} = Registered Option
  173.  
  174.            1.. Multinode capable (1-999 lines).
  175.  
  176.            2.. Supports baud rates to 115000
  177.  
  178.            3.. Gives up time slices to DESQview, OS/2, Windows,
  179.                Novell NetWare, and most other multitasking software.
  180.  
  181.            4.. After verifying SID number entered by Caller it will:
  182.  
  183.                a.. Update the Callers Security Level.
  184.                b.. Turn selected Flags ON in the Callers record.
  185.                c.. Add selected amount of Credits to Callers record.
  186.                d.. Update Caller's Expiration date.
  187.                e.. Remove SID number entered by Caller from active list.
  188.        {+}     f.. Optionally send private message to SysOp and Caller.
  189.  
  190.            5.. Disallow extended ASCII characters (128-255) to act as
  191.                a guard against entry of extended characters in the
  192.                event of telephone line noise.
  193.  
  194.            6.. Requires only 1 configuration file when run in a single or
  195.                multiline operation.
  196.  
  197.            7.. Continually monitors Comport for carrier activity and
  198.                returns to main board if carrier is dropped.
  199.  
  200.      {+}   8.. Allow SysOp to break in for a "chat" with Callers by pressing
  201.                Alt-C.  Pressing <Escape> exits the chat procedure.
  202.  
  203.            9.. Returns Caller to main board after 4 minutes of inactivity.
  204.  
  205.           10.. Supports file locking when used in a NetWork environment.
  206.  
  207.      {+}  11.. Checks for waiting online messages and send them to Caller.
  208.  
  209.      {+}  12.. Checks for and honor RemoteAccess semaphore flags (RAXIT.n)
  210.  
  211.           13.. Handles from 1 to 999 separate nodes.
  212.  
  213.           14.. Maintains general activity log when a Caller is using
  214.                TabsRA.
  215.  
  216.           15.. Maintains a file of used SID numbers and verify any number
  217.                entered by Caller against both the used file and the
  218.                active file.
  219.  
  220.                                       -3-
  221.  
  222.      About TabsRA: (Con't from Page 2)
  223.  
  224.           16.. Handles both $10.00 and $25.00 TABS subscriptions.
  225.  
  226.           17.. Allows Comport numbers 0 - 254 for use with DigiBoard
  227.                and DGFossil.
  228.  
  229.           18.. Provides a 2 line status bar at the bottom of the screen
  230.                similar to the one provided by RemoteAccess and also
  231.                allow SysOp to change status bars by pressing F1 - F10
  232.                The F10 Key will disable the status bar as it does in
  233.                RemoteAccess.
  234.  
  235.                NOTE:  The F1 Key is kinda daffy but is due to a bug in
  236.                       the door library (JPDoor) and NOT a bug in TabsRA.
  237.                       It will be fixed in the next release of JPDoor and
  238.                       as soon as that happens, TabsRA will be updated to
  239.                       correct this problem.
  240.  
  241.      {+}  19.. The  "U" UpDate Database command used by SysOp to update
  242.                the database with new SID lists.  This only works in the
  243.                registered version.  It is NOT SHOWN in the Menu however
  244.                it is there.  To use this option, The SysOp must logon to
  245.                the BBS and enter the TabsRA door.
  246.                If a NEW list of $10 and/or $25 SID numbers has been
  247.                obtained from True Media, Inc. and TABSRA.CFG has been
  248.                properly completed, this will append the new list to the
  249.                bottom of the ACTIVE10.DAT and/or ACTIVE25.DAT  This is
  250.                much the same as the hidden "I" option in other versions
  251.                (NOT written by RiverBend SoftWare) of software available
  252.                from True Media, Inc.  NOTE that this should ONLY BE USED
  253.                with NEW lists.  If your old list (TABSxx.TXT) is in the
  254.                same directory, it will get appended to the bottom of the
  255.                active list thereby creating an active list containing
  256.                duplicate numbers.  You should either move any old lists
  257.                out of the subdirectory or rename them to TABSxx.OLD
  258.  
  259.      {+}  20.. TabsRA keeps up with the number of active SID numbers
  260.                available in both the $10 and $25 lists (ACTIVE10.DAT
  261.                and ACTIVE25.DAT).  When the number of available numbers
  262.                left gets to less than 15, TabsRA will post a message to
  263.                the SysOp advising that it's time to call True Media and
  264.                get new lists.  This only works if a valid Message Board
  265.                number has been specified in TABSRA.CFG and a valid path
  266.                to the message base has also been specified in TABSRA.CFG
  267.                A note is also placed in the activity log advising the
  268.                list is getting low and new lists should be obtained from
  269.                True Media, Inc.
  270.  
  271.        The latest version of TabsRA can always be found on RiverBend BBS.
  272.        It is "Freqable" by FidoNet Nodes using the MagicName TABS and may
  273.        also be downloaded on the first call.  FidoNet address is 1:19/99
  274.        RiverBend BBS numbers are 501.563.6829 or 501.563.6203
  275.                                       -4-
  276.  
  277.      Installation:
  278.  
  279.         1.. While TabsRA may be placed in your main BBS directory, it's
  280.             best if you create a separate directory (name it anything
  281.             you like) to place TABSRA.EXE and associated files in.  This
  282.             directory MUST be the same one in the environment statement.
  283.  
  284.             TabsRA needs to find the following files all in the same
  285.             directory.
  286.  
  287.                   >>>  ALL OF THE FILES BELOW ARE REQUIRED  <<<
  288.  
  289.             TABSRA.EXE       -   Main executable file.
  290.         **  ACTIVE10.DAT     -   Active (unused) $10.00 SID numbers list
  291.         **  ACTIVE25.DAT     -   Active (unused) $25.00 SID numbers list
  292.             CONFIG.EXE       -   Creates TABSRA.CFG for use by TabsRA
  293.             TABSRA.CFG       -   Configuration file created by CONFIG.EXE
  294.         ++  TABSHELP.ASC     -   TabsRA General help file (ASCII version)
  295.             TAB_HELP.ASC     -   TabsRA General help file (ASCII version)
  296.             TABS_ADD.ASC     -   TabsRA additional help file (ASCII version)
  297.  
  298.         **  You will need to rename your lists received from True Media
  299.             to these filenames.  At present, when downloaded from the
  300.             True Media support board, they are named TABSxx.TXT with the
  301.             "xx" standing for either "10" or "25" depending on the list.
  302.             Use the DOS "copy" command as in "COPY TABS25.TXT ACTIVE25.DAT"
  303.             This will allow you to have an untouched copy of the lists
  304.             you received from True Media as a backup copy.  Both copies
  305.             of TABSxx.TXT should then renamed to TABSxx.SAV (See Page 3,
  306.             Item #19 for more information about these files).
  307.  
  308.         3.. Complete the configuration file (TABSRA.CFG) using CONFIG.EXE
  309.             If you're upgrading from a previous version, CONFIG.EXE will
  310.             rename the current configuration file to TABRACFG.OLD and
  311.             create a new TABSRA.CFG  When using CONFIG.EXE, simply answer
  312.             the question at each prompt and when finished, your new
  313.             TABSRA.CFG will contain all the needed information in its
  314.             proper sequence.
  315.  
  316.             ALWAYS run CONFIG.EXE when upgrading to a new version.
  317.             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  318.  
  319.         4.. TabsRA can no longer be run from a batch file.  It MUST
  320.             be run from the OptData line in a Type 7 Menu.
  321.  
  322.     ++  5.. Edit this file to insert your own BBS name, etc.  You may
  323.             also create ANSI versions of the three help files.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.                                       -5-
  331.  
  332.  
  333.         5.. When calling TabsRA from the "Optional Data" line in your
  334.             RemoteAccess or QuickBBS menu, select a "Type 7" Menu and
  335.             complete the "Optional Data" line as follows:
  336.  
  337.             C:\RA\TABS\TABSRA.EXE *N /M /S *M
  338.                                   ^^ ^^ ^^ ^^
  339.             TabsRA will read the "*N" as the line or node number.
  340.             Next is "/M" which indicates a multiline setup.  Then
  341.             follows "/S" which indicates that TabsRA is to send the
  342.             Caller and the SysOp a private message if the Caller
  343.             is verified.  The last macro, "*M" tells RemoteAccess
  344.             to swap out of memory while TabsRA is running and should
  345.             be the last macro on the line.
  346.  
  347.             See Pages 6 and 7 for a complete list of switches that
  348.             can be used.
  349.  
  350.             See Page 9 for examples of complete command lines used
  351.             when calling TabsRA from the "OptData" line in a Type 7
  352.             Menu.
  353.  
  354.  
  355.             NOTE:  The "*M" macro should always be used and MUST
  356.                    ALWAYS be the last macro on the command line.
  357.  
  358.  
  359.             Switches are ALWAYS preceeded by a forward slash "/"
  360.             ~~~~~~~~
  361.  
  362.             Macros are ALWAYS preceeded by an asterick "*"
  363.             ~~~~~~
  364.  
  365.             The "*N" macro MUST ALWAYS be the 1st macro used
  366.             following the Drive:\Path\TABSRA.EXE statement.
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.                                       -6-
  386.  
  387.      Command Line Switches:
  388.      ~~~~~~~~~~~~~~~~~~~~~
  389.         Listed below are the available command line switches recognized
  390.         by TabsRA and their meaning.  These switches may be in any order
  391.         on the command line but MUST be between the *N and *M macros.
  392.         NOTE that each switch is preceded by a forward slash "/".
  393.  
  394.    {+}  Indicates switch is available only in registered versions.
  395.  
  396.         ---------------------------------------------------------------
  397.  
  398.         /M  -  Indicates a multiline operation.  If running a single
  399.                line operation with no "local node", omit this switch.
  400.  
  401.    {+}  /S  -  Send private message to both Caller and SysOp after
  402.                the Caller has entered a valid SID number and has been
  403.                validated.  The message to the Caller is a "Thanks" note
  404.                and the message to the SysOp serves as notice that the
  405.                Caller has been validated by TabsRA.  Both messages are
  406.                sent to to the message board indicated in TABSRA.CFG
  407.  
  408.         /U  -  Do NOT automatically upgrade the Caller but wait for the
  409.                SysOp to do it manually.  I can't imagine why one would
  410.                want to use this however it's there if needed.
  411.  
  412.    {+}  /X  -  Respond to the RAXIT semaphore flags.
  413.  
  414.         /D  -  Use DOOR.SYS rather than DORINFO1.DEF  RemoteAccess
  415.                and QuickBBS should NOT use this switch.  This should
  416.                only be used by those systems whose software uses the
  417.                DOOR.SYS file as its main dropfile.
  418.  
  419.         /F  -  Use DORINFOx.DEF rather than DORINFO1.DEF  RemoteAccess
  420.                and QuickBBS should NOT use this switch.  This switch
  421.                should only be used by systems whose software generates
  422.                a DORINFO2.DEF or DORINFO3.DEF, etc. as its dropfile.
  423.  
  424.         /B  -  Use output buffers.  This may speed up the operation but
  425.                usually has the effect of slowing "Hot Key" response.  It's
  426.                recommended that you try TabsRA WITHOUT this switch first
  427.                and only use it if TabsRA runs extremely slow on your system.
  428.  
  429.         /Z  -  This switch tells TabsRA to generate a "DeBug" log file.
  430.                Use this only if you're having problems with TabsRA and
  431.                send it to RiverBend BBS at (501) 563-6829 (Fido 1:19/99)
  432.                for evaluation.
  433.  
  434.    {+}  /C  -  This switch tells TabsRA to check for online messages
  435.                that may be waiting for the Caller and if any are found
  436.                to send the message.
  437.                NOTE that for this switch to be active the BBS must be
  438.                running a multiline system and the "/M" switch MUST be on
  439.                the command line.
  440.                                       -7-
  441.  
  442.      Command Line Switches:  (Con't from Page 6)
  443.  
  444.  
  445.    {+}  /A  - This switch allows you two different methods of changing
  446.               a Callers Security Level.
  447.  
  448.           1.. If this switch exists on the command line then the numbers
  449.               on the SECLEV10= and SECLEV25= lines in TABSRA.CFG will be
  450.               ADDED to the callers current Security Level.  An example
  451.               would be if you had SECLEV10=5 in TABSRA.CFG and the
  452.               callers current Security Level was 12 then after entering
  453.               a valid $10 SID the new Security Level would be 17.  If
  454.               you had a caller with a current Security Level of 20 then
  455.               that caller will be upgraded to Security Level 25 after
  456.               entering a valid SID.
  457.  
  458.           2.. If this switch does NOT exist on the command line then the
  459.               numbers on the SECLEV10= and SECLEV25= lines in TABSRA.CFG
  460.               will be the callers NEW Security Level after entering a
  461.               valid SID.  For example if SECLEV10=45 in TABSRA.CFG then
  462.               after entering a valid SID, the callers new Security Level
  463.               will be 45.  No matter what Security Level the caller is
  464.               at when he/she enters the TabsRA door, if he/she enters a
  465.               valid $10 SID then the new Security Level will be 45.
  466.  
  467.           >>  This is the default for unregistered versions.  If TabsRA
  468.           >>  is NOT registered then the number entered on the SECLEV10=
  469.           >>  and SECLEV25= lines will be the callers NEW Security Level.
  470.  
  471.  
  472.           NOTE:  Pay close attention to the above two comparisons!  If
  473.                  the "/A" switch DOES NOT EXIST and you have a caller at
  474.                  Security Level 40 and he/she enters a valid $10 SID then
  475.                  the callers Security Level will be LOWERED to 25.  This
  476.                  is applicable ONLY in registered versions of TabsRA.
  477.  
  478.                  If the "/A" switch DOES EXIST the callers Security Level
  479.                  will be RAISED by 25 to a 65.
  480.  
  481.  
  482.         /R  - This switch is not active at this time.  In a later version
  483.               of TabsRA it will give the SysOp the option of adding RIP
  484.               graphics to the menu and help files in TabsRA.  Later
  485.               versions will have SysOp configurable menus and help screens
  486.               and if the SysOp wants to use RIP, then the option will be
  487.               available.
  488.  
  489.               It is NOT advisable to put this switch on the command line
  490.               at this time as it's just something that TabsRA will have
  491.               to read and retain and not be able to do anything with.
  492.  
  493.  
  494.  
  495.                                       -8-
  496.  
  497.  
  498.      Command Line Examples (OptData Line in Type 7 Menu)
  499.  
  500.  
  501.         NOTE that you must always separate these options with one (1)
  502.              blank space.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  503.  
  504.         ------------------------------------------------------------------
  505.         1.. This is the minimum requirement for a multiline system.
  506.             The "*M" tells RA to swap out when TabsRA is in use.
  507.  
  508.             C:\RA\TABS\TABSRA.EXE *N /M *M
  509.         ------------------------------------------------------------------
  510.  
  511.         2.. Indicates a multiline operation and wants TabsRA to send a
  512.             message to the Caller and SysOp
  513.  
  514.             C:\RA\DOORS\TABS\TABSRA.EXE *N /M /S *M
  515.         ------------------------------------------------------------------
  516.  
  517.         3.. Indicates a single line setup sending a messages to the
  518.             SysOp and Caller with RA swapping itself out of memory when
  519.             TabsRA is running:
  520.  
  521.             C:\RA\TABS\TABSRA.EXE *N /S *M
  522.         ------------------------------------------------------------------
  523.  
  524.         4.. This is the minimum requirement for a single line operation:
  525.                         ~~~~~~~~~~~~~~~~~~~
  526.             C:\RA\TABS\TABSRA.EXE *N *M
  527.         ------------------------------------------------------------------
  528.  
  529.  
  530.         NOTE:  The "*N" Macro MUST ALWAYS be the 1st Macro used and "*M"
  531.                MUST ALWAYS be the last Macro used.  Any Switches are to
  532.                be between the "*N" and the "*M"  All Switches are ALWAYS
  533.                preceeded by a forward slash "/".
  534.  
  535.                See TABSRA.DOC for additional switches that can be used.
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.                                       -9-
  551.  
  552.      The Configuration File:
  553.  
  554.         The name of the configuration file is TABSRA.CFG  This file MUST
  555.         reside in the same directory as TABSRA.EXE and the other files
  556.         associated with TabsRA.  This file MUST NOT be renamed to any
  557.         other filename.
  558.  
  559.         The items listed in TABSRA.CFG are in a certain order of sequence
  560.         and that sequence MUST NOT BE CHANGED.  Each line must be present
  561.         EVEN if it is not used.
  562.  
  563.         A line by line description follows.
  564.  
  565.         ------------------------------------------------------------------
  566.         ; A comment can follow any line with a ";" character as the FIRST
  567.         ; character on the line.
  568.         ------------------------------------------------------------------
  569.         DAYS10=xx     The "xx" represents the number of days the Callers
  570.                       Subscription Expiration date will be extended for
  571.                       a $10.00 subscription.  Days can be any number from
  572.                       1 to 32000  (Do NOT use commas if days exceed 999)
  573.         ------------------------------------------------------------------
  574.         SECLEV10=xxx  The "xxx" represents the Security Level that TabsRA
  575.                       will set the Caller to for a $10.00 subscription.
  576.                       Security Level must follow the guide lines set up
  577.                       by the BBS software being used.  (See switch /A)
  578.         ------------------------------------------------------------------
  579.         DAYS25=xxx    The "xxx" represents the number of days the Callers
  580.                       Subscription Expiration date will be extended for
  581.                       a $25.00 subscription.
  582.         ------------------------------------------------------------------
  583.         SECLEV25=xx   The "xx" represents the Security Level that TabsRA
  584.                       will set the Caller to for a $25.00 subscription.
  585.         ------------------------------------------------------------------
  586.         SERIAL=0      This is the serial number for registered versions.
  587.                       DO NOT change this in an attempt to evade the
  588.                       registration requirement as TabsRA will refuse to
  589.                       load if this is not found in the shareware version.
  590.         ------------------------------------------------------------------
  591.         GROUP10=xx    The "xx" represents the Group number to be included
  592.                       in the Callers record for $10.00 subscriptions.  If
  593.                       you do not use Groups you may leave this as "GROUP10="
  594.                       just as long as the line is present in its proper
  595.                       place in order.
  596.         ------------------------------------------------------------------
  597.         GROUP25=xx    The "xx" represents the Group number to be included
  598.                       in the Callers record for $25.00 subscriptions.  If
  599.                       you do not use Groups you may leave this as "GROUP25="
  600.                       just as long as the line is present in its proper
  601.                       place in order.
  602.  
  603.  
  604.  
  605.                                       -10-
  606.  
  607.      The Configuration File: (Con't from Page 9)
  608.  
  609.         CREDITS10=xx The "xx" represents the number of credits that is to
  610.                      be ADDED to the Callers record for a $10.00 subscript-
  611.                      ion.  If the Caller has credits already then this is
  612.                      the amount of credits to be ADDED to his/her record.
  613.                      If you do not use credits, this may be left blank as
  614.                      in "CREDITS10=" just as long as the line is in the
  615.                      file AND in its proper sequence.
  616.         ------------------------------------------------------------------
  617.         CREDITS25=xx The "xx" represents the number of credits that is to
  618.                      be ADDED to the Callers record for a $25.00 subscript-
  619.                      ion.  If the Caller has credits already then this is
  620.                      the amount of credits to be ADDED to his/her record.
  621.                      If you do not use credits, this may be left blank as
  622.                      in "CREDITS25=" just as long as the line is in the
  623.                      file AND in its proper sequence.
  624.         ------------------------------------------------------------------
  625.         FLAGSA10=0xxxx  Each "x" represents the "A" Flag to be turned ON in
  626.                  ^    the Callers record.  NOTE the leading "0"  This is
  627.                  ^    a zero (not upper case O) and MUST immediately follow
  628.                       the equal sign.  DO NOT separate the Flag numbers
  629.                       with spaces, commas, etc. and put nothing but NUMBERS
  630.                       here.  DO NOT put the Flag letters or any letter
  631.                       character.  The leading "0" MUST be present if any
  632.                       Flag numbers are entered here!
  633.                       ----------------------------------------------------
  634.                       This is CORRECT:  FLAGSA=02478
  635.  
  636.                       Indicates "A" Flags 2,4,7 and 8 are to be turned ON
  637.                       in the Callers record.
  638.                       ----------------------------------------------------
  639.                       This is WRONG:  FLAGSA=A2 A4A7,A8
  640.  
  641.                       Has no leading "0" and has letter "A" and a blank
  642.                       space and a comma.
  643.         ------------------------------------------------------------------
  644.         FLAGSB10=0xx    Each "x" represents the "B" Flag to be turned ON in
  645.                  ^    the Callers record.  NOTE the leading "0"  This is
  646.                  ^    a zero (not upper case O) and MUST immediately follow
  647.                       the equal sign.  DO NOT separate the Flag numbers
  648.                       with spaces, commas, etc.
  649.         ------------------------------------------------------------------
  650.         FLAGSC10=     Indicates that no "C" Flags are to be turned ON in
  651.                       the Callers record.
  652.         ------------------------------------------------------------------
  653.         FLAGSD10=0xx  Each "x" represents the "D" Flag to be turned ON in
  654.                  ^    the Callers record.  NOTE the leading "0"  This is
  655.                  ^    a zero (not upper case O) and MUST IMMEDIATELY FOLLOW
  656.                       THE EQUAL SIGN.  DO NOT separate the Flag numbers
  657.                       with spaces, commas, etc. Flags are numbered 1 - 8.
  658.  
  659.        Follow the examples above for the $25 Flag settings.
  660.                                      -11-
  661.  
  662.      The Configuration File: (Con't from Page 10)
  663.  
  664.         MESGPATH=     This line should contain the path to your Message
  665.                       base as in "C:\RA\USERS\"  Note that the Drive
  666.                       letter MUST be included.  If you do not want private
  667.                       messages sent to the Caller and SysOp then this line
  668.                       may be left blank as in "MESGPATH=" just be sure the
  669.                       line is in its proper place in the config file.  If
  670.                       you have the command line option "/S" included in
  671.                       your command line then this line MUST contain the path
  672.                       to the RemoteAccess message base.
  673.         ------------------------------------------------------------------
  674.         MESGBOARD=    This is the NUMBER of the Message base you want the
  675.                       private messages posted to.  If you have included
  676.                       the command line option "/S" on the command line then
  677.                       a valid Message Board number MUST appear here.  This
  678.                       is for Hudson Massage Base use and also MUST be
  679.                       greater than zero (0).
  680.         ------------------------------------------------------------------
  681.         SEMPATH=      This is the path to the directory where your BBS
  682.                       software places its Semaphore Flags.  If you want
  683.                       TabsRA to honor semaphore flags such as "RAXIT.x"
  684.                       then this path MUST be present along with the "/X"
  685.                       command line option.  If you do not use semaphore
  686.                       flags or your BBS software does not support them,
  687.                       you may leave the path blank BUT the "SEMPATH="
  688.                       statement MUST be in the config file and you must
  689.                       be running a multiline system.
  690.         ------------------------------------------------------------------
  691.         NEW10=        This is the name of the list of NEW $10 Tabs numbers
  692.                       when they are obtained from True Media, Inc.  This
  693.                       is currently TABS10.TXT but has been known to change
  694.                       without notice from True Media, Inc.  NOTE that this
  695.                       MUST be the FILENAME ONLY.  DO NOT INCLUDE THE PATH.
  696.         ------------------------------------------------------------------
  697.         NEW25=        This is the name of the list of NEW $25 Tabs numbers
  698.                       when they are obtained from True Media, Inc.  This
  699.                       is currently TABS25.TXT but has been known to change
  700.                       without notice from True Media, Inc.  NOTE that this
  701.                       MUST be the FILENAME ONLY.  DO NOT INCLUDE THE PATH.
  702.         ------------------------------------------------------------------
  703.         MENUTYPE=     If you use ONLY the $10 option, enter "1" here.  If
  704.                       you use ONLY the $25 option, enter "2" here.  If you
  705.                       use BOTH the $10 and $25 options, enter "3" here.
  706.                       Assuming you will use both the $10 and $25 options,
  707.                       this line should look like  MENUTYPE=3
  708.         ------------------------------------------------------------------
  709.         TABSRA.CFG is a straight ASCII text file and may be edited using
  710.         any text editor that DOES NOT leave any control codes in the file
  711.         (word processors usually do this and therefore should NOT be used
  712.         for editing the TABSRA.CFG file).  Each line in TABSRA.CFG has a
  713.         particular meaning to TabsRA and MUST be in its proper place
  714.  
  715.                                      -12-
  716.  
  717.  
  718.      Trouble Shooting:
  719.  
  720.         1.. TabsRA won't load...
  721.  
  722.             Be sure ALL the files associated with TabsRA exists in the
  723.             directory specified above.  These files are:
  724.  
  725.             TABSRA.EXE          TABSRA.CFG          TABS_ADD.ASC
  726.             TABSHELP.ASC        ACTIVE10.DAT        TAB_HELP.ASC
  727.             ACTIVE25.DAT
  728.  
  729.             Check the command line options and be sure the FIRST option
  730.             is the "*N" macro.
  731.  
  732.             A full command line would look something like:
  733.  
  734.             C:\RA\TABS\TABSRA.EXE *N /M /S *M
  735.                                   ^^ ^^ ^^ ^^
  736.                                    |  |  | |___ RA to swap out
  737.                                    |  |  |_____ Send Private Mesg.
  738.                                    |  |________ Multiline system
  739.                                    |___________ Node number passed by RA
  740.  
  741.  
  742.  
  743.             TabsRA MUST NOT be called using a BATch file.  It MUST
  744.             always be called direct from the OptData line in the
  745.             Type 7 Menu.
  746.  
  747.  
  748.             If you are upgrading from a previous version, you can
  749.             remove the environment variable SET TABS_RA from your
  750.             batch files as it's no longer needed and will just take
  751.             up valuable environment space if left active.
  752.  
  753.             If you are upgrading from a previous version, be sure
  754.             you make the necessary changes to each menu where TabsRA
  755.             is called from and remove the old batch files that may
  756.             have been used to call TabsRA in the past.
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.                                      -13-
  771.  
  772.  
  773.      Trouble Shooting: (Con't from Page 12)
  774.  
  775.         2.. TabsRA doesn't recognize some/none of the lines in the
  776.             configuration file (TABSRA.CFG).
  777.  
  778.             Verify that each line either begins with a semicolon ";"
  779.             for comments OR the configuration option.  If any line
  780.             has a semicolon on it, it MUST BE THE FIRST CHARACTER on
  781.             the line at the EXTREME LEFT SIDE OF THE FILE.
  782.  
  783.             Each line that contains a configuration variable MUST NOT
  784.             CONTAIN ANYTHING OTHER THAN THE INFORMATION EXPECTED BY
  785.             TabsRA.
  786.             --------------------------------------------------------------
  787.             THIS IS WRONG ==>    ;DAYS10=90    Semicolon on same line
  788.                                  ^             causes TabsRA to think
  789.                                  ^             this is a comment line.
  790.             --------------------------------------------------------------
  791.             THIS IS WRONG ==>  DAYS10= 90      Blank space after "=" sign
  792.                                       ^        causes TabsRA to not see 90
  793.             --------------------------------------------------------------
  794.             THIS IS WRONG ==>  FLAGSB25=1257   No leading "0" after "="
  795.                                                causes TabsRA to NOT set
  796.                                                Flag B1 to ON although
  797.                                                Flags B2 B5 and B7 will be
  798.                                                set to ON.
  799.             --------------------------------------------------------------
  800.             THIS IS WRONG ==>  FLAGSB10= 1,2   Blank space after "=", no
  801.                                         ^ ^    leading "0" and comma causes
  802.                                         ^ ^    TabsRA to head South.
  803.             --------------------------------------------------------------
  804.             THIS IS WRONG ==>    DAYS10=9 0    Blank space between 9 and 0
  805.                                          ^     causes TabsRA to only see
  806.                                                9 days rather than 90
  807.             --------------------------------------------------------------
  808.             A proper configuration file for TabsRA should contain a
  809.             total of twenthree (23) options.  No more, No less!
  810.  
  811.         3.. TabsRA won't send a Private message to SysOp and Caller.
  812.  
  813.             Verify that the command line switch "/S" does exist on the
  814.             command line AND a path to the RemoteAccess Message Base is
  815.             specified on the "MESGPATH=" line in the config file AND
  816.             a Message Board Number other than "0" is specified on the
  817.             "MESGBOARD=" line in TABSRA.CFG  (Registered option.)
  818.  
  819.             NOTE that anytime a path is called for, it MUST have a
  820.             trailing BackSlash "\" as the last character
  821.  
  822.  
  823.  
  824.  
  825.                                      -14-
  826.  
  827.  
  828.      Trouble Shooting: (Con't from Page 13)
  829.  
  830.         4.. A message appears saying something like "File not found"
  831.             or "Unable to locate file!"
  832.  
  833.             Verify that ALL paths are correct and that each path
  834.             statement ends with the trailing BackSlash "\".  Also
  835.             add the "/Z" switch to the command line to create a "debug"
  836.             file.
  837.  
  838.         5.. TabsRA drops out and returns to main board without ever
  839.             loading.
  840.  
  841.             Look at the configuration file TABSRA.CFG and verify that
  842.             the line "SERIAL=0" exists and that no number other than
  843.             a zero (0) is present on that line.  Attempts to evade the
  844.             registration process will cause TabsRA to drop back to the
  845.             main board but ONLY after it has informed the Caller that
  846.             the SysOp has attempted to get around the registration
  847.             requirement by entering invalid registration serial numbers.
  848.  
  849.             Other causes may be an incorrect or misspelled path name
  850.             in the configuration file or on the command line.  Remember
  851.             that ALL path names MUST have a trailing BackSlash "\" as
  852.             the last character.
  853.  
  854.         6.. TabsRA reports that it can't find EXITINFO.BBS (See #9 also)
  855.  
  856.             "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t  "*M" t