home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RATB100.ZIP / RATB_100.ZIP / RATB.ENG < prev    next >
Text File  |  1993-04-01  |  40KB  |  1,253 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.         ┌──────────────────────────────────────────────────────────────┐
  14.         │                                                              │
  15.         │   ▀▀▀▀▀▀▀▀▀▀▀       ▀▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀       │
  16.         │   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀   ▀▀▀▀▀ ▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀▀     │
  17.         │    ▀▀▀▀    ▀▀▀▀▀   ▀▀▀▀   ▀▀▀▀  ▀▀  ▀▀▀▀  ▀▀   ▀▀▀▀   ▀▀▀▀   │
  18.         │    ▀▀▀▀    ▀▀▀▀▀   ▀▀▀▀   ▀▀▀▀      ▀▀▀▀       ▀▀▀▀   ▀▀▀▀   │
  19.         │    ▀▀▀▀▀▀▀▀▀▀      ▀▀▀▀▀▀▀▀▀▀▀      ▀▀▀▀       ▀▀▀▀▀▀▀▀      │
  20.         │    ▀▀▀▀ ▀▀▀▀       ▀▀▀▀   ▀▀▀▀      ▀▀▀▀       ▀▀▀▀   ▀▀▀▀   │
  21.         │    ▀▀▀▀   ▀▀▀▀     ▀▀▀▀   ▀▀▀▀      ▀▀▀▀       ▀▀▀▀   ▀▀▀▀   │
  22.         │   ▀▀▀▀▀    ▀▀▀▀▀  ▀▀▀▀▀   ▀▀▀▀▀    ▀▀▀▀▀▀     ▀▀▀▀▀▀▀▀▀▀     │
  23.         │   ▀▀▀▀▀    ▀▀▀▀▀  ▀▀▀▀▀   ▀▀▀▀▀    ▀▀▀▀▀▀     ▀▀▀▀▀▀▀▀       │
  24.         │                                                              │
  25.         │              Remote Access Time Bank  -  v1.00               │
  26.         │           Copyright (c) 1991-93 by Ivan F. Martinez          │
  27.         │                                                              │
  28.         └──────────────────────────────────────────────────────────────┘
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.      TABLE OF CONTENTS
  68.      ──────────────────────────────────────────────────────────────────────
  69.  
  70.      Beta Team And Credits . . . . . . . . . . . . . . . . . . . . . .   3
  71.  
  72.      Copyrights . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  73.  
  74.      Overview and Features . . . . . . . . . . . . . . . . . . . . . .   4
  75.  
  76.      Description of the files that compose the System  . . . . . . . .   7
  77.                RATB.EXE  . . . . . . . . . . . . . . . . . . . . . . .   7
  78.                RATBCFG.EXE . . . . . . . . . . . . . . . . . . . . . .   8
  79.                RATB.RAL  . . . . . . . . . . . . . . . . . . . . . . .  10
  80.                RATBEDIT.EXE  . . . . . . . . . . . . . . . . . . . . .  10
  81.                RATBCFG.COR . . . . . . . . . . . . . . . . . . . . . .  12
  82.                RATB.BLK  . . . . . . . . . . . . . . . . . . . . . . .  12
  83.  
  84.      External Support Text Files . . . . . . . . . . . . . . . . . . .  13
  85.  
  86.      Installation  . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  87.                Installing RATB for the first time with RA  . . . . . .  14
  88.                Installing RATB for the first time with PC-Board  . . .  15
  89.                Upgrading from versions previous to 0.80  . . . . . . .  16
  90.  
  91.      Personalizing your Menu . . . . . . . . . . . . . . . . . . . . .  17
  92.  
  93.      Language Files . . . . . . . . . . . . . . . . . . . . . . . . .   19
  94.  
  95.      Final Considerations   . . . . . . . . . . . . . . . . . . . . .   20
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.      BETA TEAM AND CREDITS
  132.      ──────────────────────────────────────────────────────────────────────
  133.  
  134.      Documentation: Flávio Lucarelli and Roberto Narciso
  135.  
  136.  
  137.      The RATB 1.00 Beta Team is:
  138.      Araken Salamene                    4:801/31
  139.      Eldon Alencar                      4:809/3
  140.      Flávio Lucarelli                   4:801/30
  141.      Luciano Zoppe                      4:801/7
  142.      Martin Gut                         4:801/4
  143.      Roberto Narciso                    4:801/11
  144.      Ruben Pinto                        4:801/9
  145.      Stenio Pita                        4:809/1
  146.  
  147.      Thanks to :
  148.      Luciano Zoppe    - The first to register RATB
  149.      Flavio Lucarelli - The first to register RATB outside of Säo Paulo
  150.      Andrew Milner    - For Remote Access, well worth the US$50
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.      COPYRIGHTS
  158.      ──────────────────────────────────────────────────────────────────────
  159.  
  160.               Remote Access        Andrew Milner and Continental Software
  161.               PC-Board             Clark Development Co.
  162.               ARJ                  Robert Jung
  163.               X00                  Raymond L. Gwinn
  164.               BNU                  David Nugent & Unique Comp. Pty Ltd.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.                                        3
  192.  
  193.  
  194.  
  195.      OVERVIEW AND FEATURES
  196.      ──────────────────────────────────────────────────────────────────────
  197.  
  198.      RATB is an external program (door) for RA and PC-BOARD,  which  allows
  199.      each user to bank online time, kbytes and netmail credit (RA only) for
  200.      use or exchange at a later time, just as in a bank account.
  201.  
  202.      RATB will only work with PC-Board 14.5, or Remote Access 2.0. Previous
  203.      versions of these software will not work with this version of RATB.
  204.  
  205.      FEATURES:
  206.      (Items marked with a {+} are only available to  registered  users,  to
  207.      register see information contained in the file REGISTER.FRM)
  208.  
  209.      - Checks for user inactivity (Time-Out):
  210.        The program checks for the user's inactivity time-out,  disconecting
  211.        him if his inactivity time has reached the limit determined  by  the
  212.        SysOp.
  213.  
  214.      - Checks if the user has used the BBS for the minimum time  configured
  215.        to be able to execute RATB:
  216.        The program  counts  the  time  used  since  the  beginning  of  the
  217.        connection up to the moment when RATB is loaded, not  permiting  the
  218.        user to use RATB and showing the file  BBSFIRST.A??  or  .RALs  68th
  219.        prompt if the time used is less than determined by the SysOp.
  220.  
  221.      - Checks for remaining time before executing RATB:
  222.        The program checks if the  users  remaining  time  is  equal  to  or
  223.        inferior to the time determined in the configuration file, if it  is
  224.        it will return to the BBS and display the file  TBINSUF.A??  or  the
  225.        11th prompt in the .RAL file.
  226.  
  227.      - Checks for Minimum remaining time:
  228.        The program does not let  users  deposit  all  of  their  time,  not
  229.        leaving enough time for the disconection procedure, for example. The
  230.        same value configured as minimum time required to use the BBS before
  231.        accessing RATB is also used as minimum remaining time.
  232.  
  233.  
  234.      - Works with Ansi/Avatar Active or Not.
  235.  
  236.      - Acccepts Color Configuration:
  237.        In the configuration module there is an option to configure  all  of
  238.        the colors that the user's see while using RATB. The colors  of  the
  239.        program may be configured in the file RATBCFG.COR.
  240.  
  241.      - Accepts the use of Hotkeys:
  242.        RATB works with hotkeys, that is, the user does not  need  to  press
  243.        [Enter] after every  command.  The  keys  may  be  defined  in  each
  244.        language file.
  245.  
  246.      - The SysOp can alter any account:
  247.        When entering  RATB,  the  user's  security  level  is  automaticaly
  248.        checked. If it is equivalent or higher than a SYSOP SECURITY  LEVEL,
  249.        he will have the option of cancelling and changing transactions made
  250.        in any account.
  251.  
  252.  
  253.  
  254.  
  255.                                        4
  256.  
  257.  
  258.  
  259.      OVERVIEW AND FEATURES
  260.      ──────────────────────────────────────────────────────────────────────
  261.      - The SysOp can do transactions with his accounts on a no-limit basis:
  262.        If the option 'Sysop Free Limits' is selected in the  configuration,
  263.        the SysOp will be able to do any transaction in his account  without
  264.        any daily limits being verified. However the maximum  limit  of  the
  265.        account is still obeyed.
  266.  
  267.      - It is possible to hide a certain user's account  from  the  list  of
  268.        accounts:
  269.        User's with access level of a SysOp or higher may alter  an  account
  270.        and make it secret or not, in other  words,  only  SysOps  will  see
  271.        secret user's on the list of accounts.
  272.  
  273.      - Sorts the accounts:
  274.        The accounts can  be  sorted  in  increasing  or  decreasing  order,
  275.        alphabeticaly, by Time, Kbytes or Credits.
  276.  
  277.      - It is possible for users to transfer Credits, Time and Kbytes  among
  278.        themselves:
  279.        The maximum value permited for each  transference  is  configurable,
  280.        being able to deactive transferences using value '0'.
  281.  
  282.      - It is possible to Exchange Kbytes for Time and vice-versa:
  283.        The value of each Kbyte in Minutes and of each Minute in  Kbytes  is
  284.        configurable,  if  this  value  is  '0'  this   function   will   be
  285.        deactivated.
  286.  
  287.      - Support Multi-Node systems:
  288.        Locks the system files, making it possible for RATB  to  work  in  a
  289.        multi-node system without any problem at all. However RATB does  not
  290.        permit two users who are accessing the board at the same time to  do
  291.        any kind of transfer between themselves.
  292.  
  293.      - Option for Personalizing the Menu:
  294.        RATB has a default menu, but this one  can  be  substituted  with  a
  295.        screen (ASC, ANSI, AVATAR) mande  by  the  SysOp.  For  this  to  be
  296.        possible, RATB has various control codes which  are  substituted  by
  297.        the respective text when displayed to the user (the  codes  will  be
  298.        described ahead).
  299.  
  300.      - Two Types of Menus, the Normal and Expert:
  301.        If the user  selects  the  EXPERT  menu,  a  reduced  menu  will  be
  302.        displayed. This avoids wasting time trasmitting a bigger menu.
  303.  
  304.      - It is possible to configure a personalized title in the place of 'RA
  305.        TIME-BANK'. {+}
  306.  
  307.      - Support for Various Languages:
  308.        RATB has language files (which may be edited  by  the  SysOp),  wich
  309.        contain all of the text displayed to  the  users  and  have  a  .RAL
  310.        extention.
  311.  
  312.      - Birthday Present Configurable by Access Level:
  313.        (For up to 10 different access levels)
  314.        On the date of a user's birthday he  may  receive  Time,  Kbytes  or
  315.        Credits. The quantity is configurable by the SysOp.
  316.  
  317.  
  318.  
  319.                                        5
  320.  
  321.  
  322.  
  323.      OVERVIEW AND FEATURES
  324.      ──────────────────────────────────────────────────────────────────────
  325.  
  326.      - Support for a configuration for each line and/or Access Level:
  327.        Different limits may be configured  for  each  of  the  BBS's  lines
  328.        and/or for each access level. For  each  configuration  a  different
  329.        file will be created.
  330.  
  331.      - Utility to Edit the Accounts without Acessing RATB:
  332.        With the utility RATBEDIT it is possible to alter, consult and  sort
  333.        the accounts without having to  access  RATB.  (See  Description  of
  334.        Files that Compose the System).
  335.  
  336.      - Option to Define a Minimum Security Level to Access RATB:
  337.        If  the  user  does  not  have  the  minimum  security  level,   the
  338.        TBLEVEL.A?? or the 36th .RAL prompt will be displayed to him when he
  339.        attempts to access RATB.
  340.  
  341.      - Listing of the Last Transactions made in the Accounts in Recent Days.
  342.  
  343.      - Supports a Black List:
  344.        If the user's name is in the RATB.BLK file, he will not be  able  to
  345.        access RATB and will see the  TBBLACK.A??  file  or  the  39th  .RAL
  346.        prompt.
  347.  
  348.      - Disconection from RATB:
  349.        The GOODBYE.A?? file is displayed.
  350.  
  351.      - Option for the User to Deposit everything that he has left.
  352.  
  353.      - Internal Chat
  354.  
  355.      - Checks for the time of the Next Event:
  356.        RATB checks for the time of the next event,  not  letting  the  user
  357.        withdraw or buy time, if it passes over the event's time.
  358.  
  359.      - Supports the Use of Control Codes:
  360.        (RA only)
  361.        In the menus and in every text file displayed by RATB, RA's  control
  362.        codes ^F and ^K may be used.
  363.  
  364.      - Option to Create LOG files in one Directory Only:
  365.        The directory must be specified in the variable 'LOGPATH' defined in
  366.        the Environment. (Ex: SET LOGPATH=C:\RA\)
  367.  
  368.      - Supports PCBoards Environment Variables:
  369.        PCBNODE - indicates node used.
  370.        PCBDIR  - indicates current configuration directory.
  371.        PCBDAT  - indicates the name of the configuration file.
  372.  
  373.      - Supports the Use of the @COMMAND@ Variable and @Xnn Attributes:
  374.        (PCBoard only)
  375.        In the menus and text files displayed by RATB, it is possible to use
  376.        PC-Board's variables @COMMAND@ and the attributes @Xnn.
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.                                        6
  384.  
  385.  
  386.  
  387.      DESCRIPTION OF THE FILES THAT COMPOSE THE SYSTEM
  388.      ──────────────────────────────────────────────────────────────────────
  389.  
  390.      RATB.EXE
  391.  
  392.      This is RATB's main program, which should be executed by the BBS.
  393.  
  394.      Command  line  paramaters  that  can  be  used   with   RATB.EXE,   to
  395.      automaticaly execute some options: {+}
  396.  
  397.      DEP_TIME                 - Deposit Time
  398.      DEP_KB                   - Deposit Kbytes
  399.      DEP_CRED                 - Deposit Credits
  400.      DEP_ALL_TIME             - Deposita All possible Time
  401.      DEP_ALL_KB               - Deposita All possible Kbytes
  402.      DEP_ALL_CRED             - Deposita All existing Credits
  403.      WITHD_TIME               - Withdraw Time
  404.      WITHD_KB                 - Withdraw Kbytes
  405.      WITHD_CRED               - Withdraw Credits
  406.      WITHD_ALL_TIME           - Withdraw All possible Time
  407.      WITHD_ALL_KB             - Withdraw All possible Kbytes
  408.      WITHD_ALL_CRED           - Withdraw All existing Credits
  409.      QUIT                     - Skips the menu and returns to the BBS
  410.      BYE                      - Disconects after executing commands
  411.      ';'                      - Interpreted as an [Enter] (Carriage Return).
  412.  
  413.      If RATB receives any other parameters that are not  listed  above,  it
  414.      will assume the command as if it were given by the user.
  415.  
  416.      For Example:
  417.        RATB   1;100
  418.  
  419.      RATB will think that the user typed:
  420.        '1' [Enter] '100'
  421.  
  422.      In RATB, you will find Sysop Keys very similar to  Remote  Access.  By
  423.      typing F9 you will see a list of  all  functions  available.  Some  of
  424.      these are:
  425.  
  426.      ALT-C          Enables a Chat mode with the user, not available when in
  427.                     local mode.
  428.  
  429.      ALT-J          Will Shell to DOS, type 'Exit' to return.
  430.  
  431.      The menu option are regarding to the possible operatins on  depositing
  432.      and withdrawing time, kbytes and netmail  credit.  These  options  are
  433.      very simple and need no more explanations.  The  option  to  list  the
  434.      acoounts will list all user accounts that  are  not  hidden  (it  will
  435.      however show the SysOp the hidden accounts also). If any of the user's
  436.      listed is using RATB on the other line, he will have his last movement
  437.      date  as  "NOW".  The  option  to  List  Movements  shows   the   last
  438.      transactions made by a user in his account.
  439.  
  440.      There are still three more options on  the  menu,  only  available  to
  441.      registered users, which are for the SysOp's use only, Change  Accounts
  442.      which lets you alter any account, as long as the user is not connected
  443.      at the same moment, the option to delete an account, and the option to
  444.      sort the accounts. {+}.
  445.  
  446.  
  447.                                        7
  448.  
  449.  
  450.  
  451.      DESCRIPTION OF THE FILES THAT COMPOSE THE SYSTEM
  452.      ──────────────────────────────────────────────────────────────────────
  453.  
  454.      RATBCFG.EXE
  455.  
  456.  
  457.      Configuration fields are listed bellow:
  458.  
  459.      Maximum time             - Time deposit limit of an account.
  460.  
  461.      Maximum Kb               - Kbytes deposit limit of an account.
  462.  
  463.      Maximum Credit           - Credits deposit limit of an account.
  464.  
  465.      Max. Daily Time Deposit  - Daily Time deposit limit.
  466.  
  467.      Max. Daily Kb Deposit    - Daily Kbytes deposit limit.
  468.  
  469.      Max. Daily Cred. Deposit - Daily Credits  deposit  limit  (0  disables
  470.                                 this option).
  471.  
  472.      Max. Daily Time WithDraw - Time withdraw limit.
  473.  
  474.      Max. Daily Kb WithDraw   - Kbytes withdraw limit.
  475.  
  476.      Max. Daily Cred.Withdraw - Credits withdraw limit.
  477.  
  478.      Max. Daily Time Transfer - Daily Time transfer limit (0 disables  this
  479.                                 option)
  480.  
  481.      Max. Daily Cred. Transf. - Daily Credit  transfer  limit  (0  disables
  482.                                 this option)
  483.  
  484.      Max. Daily Kb Purchase   - Daily Kbytes purchase limit.
  485.  
  486.      Purchase Value of Kb     - Defines how many Kbytes  can  be  purchased
  487.                                 with 1 minute of time.   (0  disables  this
  488.                                 option)
  489.  
  490.      Max. Daily time Purchase - Daily time purchase limit.
  491.  
  492.      Purchase Cost of minute  - Defines how many minutes can  be  purchased
  493.                                 with 1 Kbyte. (0 disables this option)
  494.  
  495.      BirthDay Time            - Defines   how  many  minutes   users   will
  496.                                 receive in their accounts if they enter  in
  497.                                 RATB on their birthday date.
  498.  
  499.      BirthDay Kb              - Defines how many Kbytes users will  receive
  500.                                 in their accounts if they enter in RATB  on
  501.                                 their birthday date.
  502.  
  503.      Time Out Limit           - Defines the time (in seconds) in wich  RATB
  504.                                 will disconnect RATB if no key is pressed.
  505.  
  506.      SysOp Security Level     - Defines SysOp's Security  Level.  Any  user
  507.                                 with this level or greate will be  able  to
  508.                                 access the SysOp Maintenance Functions.
  509.  
  510.  
  511.                                        8
  512.  
  513.  
  514.  
  515.      DESCRIPTION OF SYSTEM FILES
  516.      ──────────────────────────────────────────────────────────────────────
  517.  
  518.      SysOp Free               - Defines if SysOp will not have his  account
  519.                                 movementations checked  for  daily  limits.
  520.                                 Account's Limits are always checked.
  521.  
  522.      Minimum time remaining   - Minimum user's remaining  time   wich  user
  523.                                 must have to enter in RATB.
  524.  
  525.      Minimum used to enter    - Minimum BBS use time to enter in RATB.
  526.  
  527.      Path to Time Bank file   - Pathname to RATB data  file  (don't  forget
  528.                                 name and extension)
  529.  
  530.      Title Color              - RATB Title Color.
  531.  
  532.      Values Color             - Color of All RATB Values.
  533.  
  534.      Normal Color             - Remaining Screen Itens Color.
  535.  
  536.      Select Color             - Color of Selection Prompts.
  537.  
  538.      - Color codes must be in (foreground)/(background) format:
  539.  
  540.      0 - Black                        8 - DarkGray
  541.      1 - Blue                         9 - LightBlue
  542.      2 - Green                       10 - LightGreen
  543.      3 - Cyan                        11 - LightCyan
  544.      4 - Red                         12 - LightRed
  545.      5 - Magenta                     13 - LightMagenta
  546.      6 - Brown                       14 - Yellow
  547.      7 - LightGray                   15 - White
  548.  
  549.      - Adding 16 to background color code, blinking mode will be enabled.
  550.  
  551.      - To create configurations for diferent node or security  level,  type
  552.        F1 and enter  the  node/security  level  number.  If  you  create  a
  553.        configuration for security level for a node wich does not  have  its
  554.        own configuration, any  other  level  wich  access  this  node  will
  555.        continue to use the Default configuration.
  556.  
  557.      - Security Level configuration are valid only for the defined security
  558.        level and not to the levels above it, i.e. if exists a configuration
  559.        for level 200 the level 300 will not be afected by it.
  560.  
  561.      - Security Level configuration is prioritary over node  configuration,
  562.        i.e. Users with level 50 are able to withdraw 100Kb per day  if  one
  563.        of then is connected in node 2 where it is possible to withdraw only
  564.        20Kb per day, he will still be able to withdraw 100Kb.
  565.  
  566.      - The user's birthday gift (Kbytes, Time and Credits) will be credited
  567.        to all users with levels equal or  higher  than  any  birthday  gift
  568.        configuration lines.
  569.  
  570.      RATB.RAL
  571.  
  572.      It is the RATB default language file, it cannot be edited and must  be
  573.      in the same directory of RATB. (See Language)
  574.  
  575.                                        9
  576.  
  577.  
  578.  
  579.      DESCRIPTION OF SYSTEM FILES
  580.      ──────────────────────────────────────────────────────────────────────
  581.  
  582.      RATBEDIT.EXE
  583.  
  584.      It is the Accounts Editor, wich also makes data files maintenance.
  585.  
  586.      Typing any invalid parameter, RATBEDIT will display the list of  valid
  587.      parameters.
  588.  
  589.      Command line parameters (maintenance mode):
  590.  
  591.      -AL        Checks account limits. Verifies if  any  user  has  account
  592.                 values  higher  than  configuration  defined  values,   and
  593.                 correct it.
  594.  
  595.      -CU        Converts users name case to Uppercase.
  596.  
  597.      -CL        Converts users name case to Lowercase.
  598.  
  599.      -DM[dias]  Deletes accounts of users wich have not entered in RATB for
  600.                 the last 60 days or for the specified number of days.
  601.  
  602.      -DI        Deletes accounts of users wich are not  in  the  BBS  users
  603.                 file.
  604.  
  605.      -KL[dias]  Deletes tranfers  files  data  (Data  about  Movements  and
  606.                 transfers) when they are older than 7 days  or  older  than
  607.                 the specified number of days.
  608.  
  609.      -P         Pack users file, Eliminating deleted records.
  610.  
  611.      -PE        Pack users file and also eliminate accounts with all values
  612.                 (Time, Kbytes and credits) equals to zero.
  613.  
  614.      -PT        Deletes transfers files data when they have   already  been
  615.                 displayed.
  616.  
  617.      -R         Creates ACCOUNTS.LST file, wich contains the  list  of  all
  618.                 RATB users accounts.
  619.  
  620.      -S[+|-]<n> Sorts the Data file:  + = direct order (Default) {+}
  621.                                       - = reverse order
  622.                 Sort Creterium        n =  1 - Name
  623.                                            2 - Time
  624.                                            3 - Kbytes
  625.                                            4 - Credits
  626.                                            5 - Surname
  627.  
  628.      In sort every hidden marked user will be place in the file begin. This
  629.      option is only available in registered version.
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.                                        10
  640.  
  641.  
  642.  
  643.      DESCRIPTION OF SYSTEM FILES
  644.      ──────────────────────────────────────────────────────────────────────
  645.  
  646.      If none parameter is passed to RATBEDIT it will enter  in  interactive
  647.      mode where you can view/change/delete/etc. The functions available  in
  648.      interactive mode are:
  649.  
  650.      ALT-C      Converts users name case to lowercase,   this   option   is
  651.                 usefull only when you have just converted   a   file   from
  652.                 earlier versions or from RATS wich store  users   name   in
  653.                 uppercase.
  654.      ALT-D      Deletes a record.
  655.      ALT-I      Includes a new account.
  656.      ALT-P      Purges deleted records.
  657.      ALT-S      Sorts the file.
  658.      ALT-T      Resets user's daily movements.
  659.      ALT-U      Undeletes a deleted record.
  660.      Direita e
  661.      Esquerda   Moves the cursor between fields.
  662.      Cima e
  663.      Baixo      Moves the cursor between records.
  664.      [Enter]    Edits the field under the cursor.
  665.      ESC        Returns to DOS.
  666.      F          Troggles user's flag  'Free',  wich   means   this   user's
  667.                 daily limits will not be checked.  (Except  the   account's
  668.                 limits)
  669.      L          Troggles user's flag 'Locked', wich means  this  user  does
  670.                 not have access to RATB, it makes the same  effect  if  you
  671.                 put this user's name in RATB.BLK (Descripted forward)
  672.      H          Troggles user's flag 'Hidden', wich means  this  user  will
  673.                 not appear in the accounts list. (Except for SysOp)
  674.  
  675.      WARNING:   It is not possible to change an account of an user  if   he
  676.                 is using RATB.
  677.  
  678.  
  679.  
  680.      RATBCFG.COR
  681.  
  682.      This file has the color configuration of RATBCFG.
  683.      If you want to edit it here is a description of contents of each  line
  684.      of the file:
  685.  
  686.      1st Line - >  Window's Color
  687.      2nd Line - >  Window's Border Color
  688.      3rd Line - >  Title's Color
  689.      4th Line - >  Data Entry Field's Color
  690.  
  691.      On fault of any value will be used 07 (LightGray).
  692.  
  693.  
  694.  
  695.      RATB.BLK
  696.  
  697.      It is a text file, wich can be edit with  any  ASCII  editor.  If  any
  698.      user's name is here then this user will not have access  to  RATB  and
  699.      the TBBLACK.A?? file or the prompt 39 of the  language  file  will  be
  700.      displayed to him if he tries to enter in RATB.
  701.  
  702.  
  703.                                        11
  704.  
  705.  
  706.  
  707.      DESCRIPTION OF SYSTEM FILES
  708.      ──────────────────────────────────────────────────────────────────────
  709.  
  710.  
  711.      Example on RATB.BLK:
  712.  
  713.      BATMAN
  714.  
  715.      If BATMAN tries to enter in RATB and will receive the warns.
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.                                        12
  768.  
  769.  
  770.  
  771.      TEXT FILES
  772.      ──────────────────────────────────────────────────────────────────────
  773.  
  774.      All bellow described files may be created in three versions:
  775.      ASCII (.ASC), ANSI (.ANS) and AVATAR (.AVT), in  this  last  case  you
  776.      must to disable any compression type (If you uses AVTCONV run it  with
  777.      the /r- parameter)
  778.  
  779.      In all cases the   PCBoard's  @COMMAND@ variables and @Xnn attributes;
  780.      and the RA control codes ^Kx and ^Fx can be used.
  781.  
  782.      In all cases you can  use  the  ^K]nnn  code  to  display  the  select
  783.      language prompt, where nnn is the prompt number.
  784.  
  785.      BBSFIRST.A?? : If an user tries to enter in RATB  and  does  not  have
  786.                     used the BBS for the minimum time  this  file  will  be
  787.                     displayed or if it is not present the  prompt  68  from
  788.                     the .RAL
  789.  
  790.      BYE_RATB.A?? : Is displayed every time a user disconnets in the  RATB.
  791.                     If  it  not  exists  the  GOODBYE.A??  file    will  be
  792.                     displayed.
  793.  
  794.      RATBHLP.A??  : This file shuld contain the HELP file for RATB,  if  it
  795.                     is not present the RATB.HLP file will be displayed.
  796.  
  797.      RATBMNU.A??  : This file should contain the customized menu in  normal
  798.                     mode. (See Personalizing Menu)
  799.  
  800.      RATBMNUX.A?? : This file should contain the customized menu in  expert
  801.                     mode. (Therefore it should be a short menu)
  802.  
  803.      TBINSUF.A??  : If user does not have enough tune to use RATB this file
  804.                     will be displayed or if it is not present the prompt 11
  805.                     from .RAL
  806.  
  807.      TBLEVEL.A??  : Will be displayed if user does  not  have  the  minimum
  808.                     security level to  access  RATB,  if  not  present  the
  809.                     prompt 36 from .RAL will be displayed.
  810.  
  811.      TBBLACK.A??  : If user has his name in the  RATB.BLK (black list) file
  812.                     he will not have access to RATB and this file  will  be
  813.                     displayed or if not present the prompt 39 from .RAL
  814.  
  815.  
  816.      - Note about RATB's Presentation Screen:
  817.        The presentation screen will appear every time a user enter in  RATB
  818.        if it is not registered or only in the first time he enters if  RATB
  819.        is registered.
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.                                        13
  832.  
  833.  
  834.  
  835.      INSTALLATION
  836.      ──────────────────────────────────────────────────────────────────────
  837.  
  838.      There  are  three  basic  types  of instalations,  ahead is a descrip-
  839.      tion for each one of these.
  840.  
  841.      RATB instalation for the first time in RA:
  842.  
  843.      - Create a directory for RATB
  844.        In this example RATB will be in a directory of its one, but you  may
  845.        put it in any directory.
  846.        Enter the RA  directory  (CD\RA)  and  make  a  directory  for  RATB
  847.        (MD RATB).
  848.  
  849.      - Unpack the archive RATB_100.ARJ
  850.        Use the ARJ archiver: ARJ E RATB_100 C:\RA\RATB
  851.  
  852.      - Run RATB's configuration program: RATBCFG
  853.        To configure read the  description  of  RATBCFG,  all   fields   are
  854.        listed there.
  855.  
  856.      - Put the option 'Time Bank' in one of your menus
  857.        In RA's directory (CD\RA) run the Menu Editor (RACONFIG -M).
  858.  
  859.      * Choose the Menu where you will put the option, generally  we  choose
  860.        the Menu where the other doors area.
  861.  
  862.      * Choose the line where you will put the option,  type  <INS>  and  an
  863.        empty line will appear.
  864.  
  865.      * Type  [Enter] to edit it. (See the Screen with details in  the  next
  866.        page)
  867.  
  868.      - Create in RA's directory (C:\RA) the file RATB.BAT (You may use  any
  869.        ASCII editor or the command COPY CON RATB.BAT)
  870.        RATB.BAT should have the following commands:
  871.        CD\RA\RATB
  872.        RATB
  873.        (In case you used the COPY command, press Ctrl-Z)
  874.  
  875.      - Edit and configure your  EAGLE.CFG  file  (Instructions  on  how  to
  876.        configure it are in the file itselft, to  edit  them  use  a  simple
  877.        ASCII editor).
  878.  
  879.      - Define the variable EAGLE with the name of the directory and of  the
  880.        file where the configurations are:
  881.        Put the following line in your AUTOEXEC.BAT or BBS.BAT file:
  882.        SET EAGLE=C:\RA\EAGLE.CFG
  883.        If your EAGLE.CFG is not in RA's directory  (C:\RA),  simply  change
  884.        the line above to the directory where it is. If you wish  to  change
  885.        the name of the file, change it in your AUTOEXEC.BAT file also.
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.                                        14
  896.  
  897.  
  898.  
  899.      INSTALLATION
  900.      ──────────────────────────────────────────────────────────────────────
  901.  
  902.      ╒════════════════════════════════════════════════════ Edit Menu Item ╕
  903.      │                                                                    │
  904.      │          1         2         3         4         5         6       │
  905.      │ 123456789012345678901234567890123456789012345678901234567890123456 │
  906.      │ ^[T]^ Time Bank                                                    │
  907.      │                                                                    │
  908.      │ *C /C \RA\RATB.BAT*M                                               │
  909.      │                                                                    │
  910.      │ Action   Execute sub-program (Type 7) (a)                          │
  911.      │ Display                               (b)                          │
  912.      │ OptData                               (c)                          │
  913.      │ HotKey   T                                                         │
  914.      │ AutoExec No                                                        │
  915.      │ Colour   Colour example                                            │
  916.      │                                                                    │
  917.      │ MinSec   20                 TimeUsed 0                FlatCost 0   │
  918.      │ MaxSec   0                  TimeLeft 0                TimeCost 0   │
  919.      │ A flags  --------           Age      0                Terminal Any │
  920.      │ B flags  --------           MinSpeed 0                Nodes        │
  921.      │ C flags  --------           MaxSpeed 0                Groups       │
  922.      │ D flags  --------           Credit   0                DayTimes     │
  923.      │                                                                    │
  924.      │                                                                    │
  925.      ╘════════════════════════════════════════════════════════════════════╛
  926.  
  927.      (a) Indicates what RA should do: Execute a Sub-Program
  928.      (b) Indicates what should be written in the menu
  929.      (c) Should contain the name of the sup-program to be loaded. *C is the
  930.          path of the COMMAND.COM file which should be accessed  every  time
  931.          that a BATCH file is executed. The *M is to SWAP from  the  memory
  932.          to the disk. The RATB.BAT file is explained below.
  933.  
  934.      For information on the rest  of  the  items  above,  consult  your  RA
  935.      documentation. If you're not going to Shell to DOS from RATB, *M  will
  936.      probably not be necessary.
  937.  
  938.  
  939.  
  940.      Installing RATB for the first time running PC-Board:
  941.  
  942.      - You need to load a FOSSIL driver for RATB to work  (Future  versions
  943.        will have their  own  internal  routines  for  serial  communication
  944.        control):
  945.        The well know FOSSIL drivers are BNU and X00. RATB was  tested  with
  946.        X00, but BNU should present no problems.
  947.  
  948.        Example:
  949.        (X00.SYS / X00.EXE are the fossil files)
  950.  
  951.      - Put this in your CONFIG.SYS file:
  952.        DEVICE=X00.SYS E
  953.        or
  954.        In your AUTOEXEC.BAT file:
  955.        X00.EXE E
  956.        (Please, don't load it twice ! :))
  957.  
  958.  
  959.                                        15
  960.  
  961.  
  962.  
  963.      INSTALLATION
  964.      ──────────────────────────────────────────────────────────────────────
  965.  
  966.      UPGRADE from previous versions:
  967.  
  968.      ATTENTION:
  969.      The files from versions previous to 0.80 are not compatible,  to  make
  970.      them compatible you must have  the  file  RATBUPG.ARJ,  available  for
  971.      download at the Eagle BBS. This will allow you  to  install  this  new
  972.      version without loosing your old configuration and accounts file.
  973.  
  974.      - Execute CONVCFG.BAT to convert the  configuration  file,  since  the
  975.        account files are the same format everything should work  perfectly.
  976.        After that you may dele the program 0__to100.exe and CONVCFG.BAT.
  977.  
  978.  
  979.      NOTE ABOUT THE LOGs:
  980.        If the environment variable 'ra'  is  defined,  RAT's  log  will  be
  981.        created in RA's log (in RA's format). If not, a  separate  Log  file
  982.        will be created in  the  directory  appointed  by  the  variable  of
  983.        environment LOGPATH.
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.                                        16
  1024.  
  1025.  
  1026.  
  1027.      PERSONALIZING YOUR MENU
  1028.      ──────────────────────────────────────────────────────────────────────
  1029.  
  1030.      RATB will search in it's directory for the files RATBMNU.A?? and if it
  1031.      finds them it will show them, instead of show the standard  menu.  The
  1032.      RATBMNU.A?? files are text files, which are processed  and  displayed,
  1033.      the program accepts the formats ANS/ANS/AVT.
  1034.  
  1035.      In the file it is possible to use macros (control  codes),  where  the
  1036.      program will substitute these for the prevailing value, when it  finds
  1037.      it. The marcos have a special format, so it is  possble  to  create  a
  1038.      menu with windows and so on.
  1039.  
  1040.      Below are the list of macros:
  1041.  
  1042.      Macro      Substitute
  1043.      ─────      ─────────────────────────────────────
  1044.      %A         User's Name  (40 characters)
  1045.      %z         User's Name  (Variable length)
  1046.  
  1047.      (All of the next fields are 5 characters long and are justified to the
  1048.      right.)
  1049.  
  1050.      %B         Remaining Time
  1051.      %C         Download Limit
  1052.      %D         Credits Available
  1053.      %E         Time deposited in the account
  1054.      %F         Kbytes depositded in the account
  1055.      %G         Credits deposited in the account
  1056.      %H         Time deposited (today)
  1057.      %I         Maximum Time Deposit per day
  1058.      %J         Kbytes deposited (today)
  1059.      %K         Maximum Kbytes Deposit per day
  1060.      %L         Credits deposited (today)
  1061.      %M         Maximum Credits Deposit per day
  1062.      %N         Time Withdrawn from the account (today)
  1063.      %O         Maximum Time Withdraw per day
  1064.      %P         Kbytes Withdrawn from the account (today)
  1065.      %Q         Maximum Kbytes Withdraw per day
  1066.      %R         Credits withdrawn from the accont (today)
  1067.      %S         Maximum Credits Withdraw per day
  1068.      %T         Time Transfering (today)
  1069.      %U         Limit for Time Transfering per day
  1070.      %V         Credit Transfering (today)
  1071.      %W         Limit for Credit Transfering per day
  1072.      %X         Time bought (today)
  1073.      %Y         Limit for buying time per day
  1074.      %Z         Price to buy time
  1075.      %1         Kbytes bought (today)
  1076.      %2         Limit of Kbytes purchase per day
  1077.      %3         Price to buy Kbytes
  1078.      %4         Credits bought (today)
  1079.      %5         Limit to buy Credits per day
  1080.      %6         Price to buy Credits
  1081.      %8         Price of the Bkytes transfered on that day
  1082.      %9         Daily time limit for Kbyte transfering
  1083.  
  1084.  
  1085.  
  1086.  
  1087.                                        17
  1088.  
  1089.  
  1090.  
  1091.      PERSONALIZING YOUR MENU
  1092.      ──────────────────────────────────────────────────────────────────────
  1093.  
  1094.      %!         Maximum Limit of Time in the Account
  1095.      %@         Maximum Limit of Kbytes in the Account
  1096.      %#         Maximum Limit of Credits in the Account
  1097.  
  1098.      All of the next fields have 20 characters and  are  justified  to  the
  1099.      left:
  1100.  
  1101.      %a - %o     Options availabe for account transactions.
  1102.      %p - %v     Options for the SysOps, Listing of accounts and exiting RATB.
  1103.  
  1104.      These options are loaded as a chart, so that the SysOp options may  be
  1105.      inserted along with other options that will be substituted by them  if
  1106.      the user does not have SysOp access level.
  1107.  
  1108.      So that they stay in a determined position and appear for all  of  the
  1109.      users (although they are not available for use) you may use the  macro
  1110.      ^K]nnn where nnn is the nuumber of the language text.
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.                                        18
  1152.  
  1153.  
  1154.  
  1155.      LANGUAGE FILES
  1156.      ──────────────────────────────────────────────────────────────────────
  1157.  
  1158.      RATB will seach at  first  for  the  file  referent  to  the  language
  1159.      selected by the user in the BBS, and in case of  not  finding  it,  it
  1160.      will search for the RATB.RAL file. For example:
  1161.  
  1162.      The user Jon Doe has selected the language number 2 which in the BBS's
  1163.      RA corresponds to Portuguese, so when  he  accesses  RATB,  RATB  will
  1164.      search for a  file  entitled  RATB2.RAL,  where  the  text  should  be
  1165.      configured in Portuguese.
  1166.  
  1167.      If this file is not found, RATB.RAL will be displayed, since it's  the
  1168.      DEFAULT file in English. RATB.RAL cannot be modified.
  1169.  
  1170.      For information  on  how  to  create  new  language  for  RATB,  check
  1171.      EAGLANG's manual, where the whole process is explained.
  1172.  
  1173.      If you're using a non-registered copy of RATB,  besides  the  official
  1174.      language it will only accept the number 1 language.
  1175.  
  1176.      The registed copy  is  limited  only  to  the  ammount  of  language's
  1177.      available by RA or Pc-Board. {+}
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.                                        19
  1216.  
  1217.  
  1218.  
  1219.      FINAL COMMENTS
  1220.      ──────────────────────────────────────────────────────────────────────
  1221.  
  1222.      This program complies with the laws of SHAREWARE, in other words,  you
  1223.      may use this program for a period of 30 days to test it and if  you're
  1224.      satisfied, send in your registration.
  1225.  
  1226.      Information on how to register are available in the REGISTER.FRM file.
  1227.  
  1228.      This program does not have any type of guarantess, except that it will
  1229.      work according to what is written  in  this  documentation  file,  not
  1230.      being responsible for any loss of data or damage that  it  may  cause.
  1231.      You use it at your own risk.
  1232.  
  1233.      Every  time  that  modifications  are  made  in  RA's  or   Pc-Board's
  1234.      structures and influence in the program's operation, a new version  of
  1235.      RATB will be available for File Request at the Eagle BBS, in the  same
  1236.      week that RA is made available.
  1237.  
  1238.      If you find any helpful comments, suggestions or bug  reports,  please
  1239.      feel free to contact use by sending a netmail to:
  1240.  
  1241.               Eagle BBS - Ivan F. Martinez
  1242.               55-11-753-6682
  1243.               Access Speeds:1200/2400
  1244.               FidoNet 4:801/6
  1245.               24 Hours
  1246.  
  1247.               Address:
  1248.               Av. Três, 655 - Parque Los Angeles
  1249.               ZIP 09750
  1250.               Säo Bernardo do Campo - SP
  1251.               Brazil
  1252.  
  1253.