home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / BBS / RA_111.ZIP / RA.DOC < prev    next >
Text File  |  1992-01-25  |  306KB  |  8,176 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.       │  └───┘  └┤   ┌───┘ │  │ │  │ │  └┤  │   │   └┐   │  └┐  │   ┌───┘
  26.       │  ┌────┐  │   └─────┤  │ │  │ │   │  └───┘    │   │   │  │   └─────┐
  27.       │  │    │  │         │  │ │  │ │   │           │   │   │  │         │
  28.       └──┘    └──┴─────────┴──┘ └──┘ └───┴───────────┘   └───┘  └─────────┘
  29.         
  30.                                                                                
  31.            ┌──────────┬──────┐ ┌──────┐ ┌───────┐ ┌───────┐ ┌───────┐
  32.            │  ┌───┐   │   ┌──┘ │   ┌──┘ │   ┌───┘ │   ┌───┘ │   ┌───┘
  33.            │  │   │   │   │    │   │    │   └───┐ │   └─────┤   └─────┐
  34.            │  └───┘   │   │    │   │    │   ┌───┘ └─────┐   ├─────┐   │
  35.            │  ┌────┐  │   └────┤   └────┤   └─────┬─────┘   ├─────┘   │
  36.            │  │    │  │        │        │         │         │         │
  37.            └──┘    └──┴────────┴────────┴─────────┴─────────┴─────────┘
  38.             
  39.                                                          
  40.                                                                                
  41.   
  42.                                   RemoteAccess 1.11
  43.  
  44.                   
  45.                                      (C) 1989-92
  46.              
  47.             Andrew Milner and Continental Software, All Rights Reserved
  48.              
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.        TABLE OF CONTENTS
  64.        ────────────────────────────────────────────────────────────
  65.  
  66.        PREAMBLE AND CREDITS  . . . . . . . . . . . . . . . . .    2
  67.  
  68.        OVERVIEW AND FEATURES . . . . . . . . . . . . . . . . .    3
  69.  
  70.        LICENSING INFORMATION . . . . . . . . . . . . . . . . .    5
  71.  
  72.        HOW TO REGISTER . . . . . . . . . . . . . . . . . . . .    6
  73.             SHAREWARE version  . . . . . . . . . . . . . . . .    6
  74.             PROFESSIONAL version . . . . . . . . . . . . . . .    7
  75.             REGISTRATION FORM  . . . . . . . . . . . . . . . .    8
  76.             The key system . . . . . . . . . . . . . . . . . .    9
  77.  
  78.        PRODUCT SUPPORT . . . . . . . . . . . . . . . . . . . .   10
  79.             Australia  . . . . . . . . . . . . . . . . . . . .   10
  80.             USA and Canada . . . . . . . . . . . . . . . . . .   10
  81.             Europe and others  . . . . . . . . . . . . . . . .   11
  82.             Support conferences  . . . . . . . . . . . . . . .   13
  83.  
  84.        INSTALLATION  . . . . . . . . . . . . . . . . . . . . .   14
  85.  
  86.        CONFIGURATION . . . . . . . . . . . . . . . . . . . . .   16
  87.             RACONFIG . . . . . . . . . . . . . . . . . . . . .   16
  88.                  System  . . . . . . . . . . . . . . . . . . .   16
  89.                       PATHS  . . . . . . . . . . . . . . . . .   16
  90.                       SITE INFO  . . . . . . . . . . . . . . .   16
  91.                       ADDRESS  . . . . . . . . . . . . . . . .   16
  92.                       SECURITY . . . . . . . . . . . . . . . .   16
  93.                  Options . . . . . . . . . . . . . . . . . . .   17
  94.                       MESSAGES . . . . . . . . . . . . . . . .   17
  95.                       FILES  . . . . . . . . . . . . . . . . .   20
  96.                       RESTRICTIONS . . . . . . . . . . . . . .   21
  97.                       ERRORLEVELS  . . . . . . . . . . . . . .   21
  98.                       DISPLAY  . . . . . . . . . . . . . . . .   22
  99.                       COLOURS  . . . . . . . . . . . . . . . .   22
  100.                       PAGING . . . . . . . . . . . . . . . . .   23
  101.                       NEW USERS  . . . . . . . . . . . . . . .   24
  102.                       SYSTEM . . . . . . . . . . . . . . . . .   26
  103.                       PROMPTS  . . . . . . . . . . . . . . . .   29
  104.                       PRINTER  . . . . . . . . . . . . . . . .   29
  105.                  Modem . . . . . . . . . . . . . . . . . . . .   30
  106.                       OPTIONS  . . . . . . . . . . . . . . . .   30
  107.                       COMMANDS . . . . . . . . . . . . . . . .   31
  108.                       RESPONSES  . . . . . . . . . . . . . . .   32
  109.                  Manager . . . . . . . . . . . . . . . . . . .   33
  110.                       MESSAGES . . . . . . . . . . . . . . . .   33
  111.                       FILES  . . . . . . . . . . . . . . . . .   36
  112.                       INTERNAL PROTOCOLS . . . . . . . . . . .   38
  113.                       EXTERNAL PROTOCOLS . . . . . . . . . . .   38
  114.                       LANGUAGES  . . . . . . . . . . . . . . .   43
  115.                       ALT-Fn KEYS  . . . . . . . . . . . . . .   45
  116.                       EVENTS . . . . . . . . . . . . . . . . .   45
  117.                       MENUS  . . . . . . . . . . . . . . . . .   46
  118.                       USERS  . . . . . . . . . . . . . . . . .   46
  119.                       CTL FILES  . . . . . . . . . . . . . . .   46
  120.                       COMBINED . . . . . . . . . . . . . . . .   46
  121.  
  122.        SECURITY  . . . . . . . . . . . . . . . . . . . . . . .   47
  123.  
  124.        MENUS . . . . . . . . . . . . . . . . . . . . . . . . .   48
  125.             Menu functions . . . . . . . . . . . . . . . . . .   49
  126.             Automatic command execution  . . . . . . . . . . .   76
  127.             Special optional data switches . . . . . . . . . .   76
  128.             Menu templates . . . . . . . . . . . . . . . . . .   77
  129.             The global menu  . . . . . . . . . . . . . . . . .   78
  130.             Setting up your menus  . . . . . . . . . . . . . .   79
  131.             Creating your menus  . . . . . . . . . . . . . . .   80
  132.  
  133.        EXTERNAL SUPPORT FILES  . . . . . . . . . . . . . . . .   83
  134.  
  135.        THE USER DATABASE . . . . . . . . . . . . . . . . . . .   91
  136.             Information stored in the user database  . . . . .   92
  137.             Packing and sorting the user file  . . . . . . . .   93
  138.  
  139.        THE MESSAGE DATABASE  . . . . . . . . . . . . . . . . .   94
  140.             Message database size limitations  . . . . . . . .   94
  141.             Packing and renumbering the message base . . . . .   95
  142.  
  143.        MAIL NETWORKING . . . . . . . . . . . . . . . . . . . .   99
  144.             Installing the nodelist files  . . . . . . . . .    102
  145.  
  146.        MULTI - NODE OPERATION  . . . . . . . . . . . . . . .    104
  147.  
  148.        REFERENCE SECTION . . . . . . . . . . . . . . . . . .    107
  149.             Sysop keys . . . . . . . . . . . . . . . . . . .    107
  150.             Command-line parameters  . . . . . . . . . . . .    109
  151.                  RA.EXE  . . . . . . . . . . . . . . . . . .    109
  152.                  RACONFIG.EXE  . . . . . . . . . . . . . . .    110
  153.             Errorlevels  . . . . . . . . . . . . . . . . . .    111
  154.             Text file control codes  . . . . . . . . . . . .    112
  155.                  User parameter codes  . . . . . . . . . . .    114
  156.                  System parameter codes  . . . . . . . . . .    115
  157.                  Colour control numbers  . . . . . . . . . .    116
  158.             Modem string translation . . . . . . . . . . . .    117
  159.             Questionnaire script language  . . . . . . . . .    118
  160.             Terminal emulations  . . . . . . . . . . . . . .    125
  161.             Text file naming conventions . . . . . . . . . .    126
  162.             Interactive EMSI . . . . . . . . . . . . . . . .    127
  163.             BATCH FILES  . . . . . . . . . . . . . . . . . .    128
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.        This  document makes  reference to  a number  of third-party
  186.        products.  All copyrights,  trademarks  and reserved  rights
  187.        held in these products are acknowledged.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                                      1
  246.        PREAMBLE AND CREDITS
  247.        ────────────────────────────────────────────────────────────
  248.  
  249.        RemoteAccess started as one  of those spare-time projects in
  250.        early 1989. After about  eight months of initial development
  251.        I released version 0.01 on the 25th of January, 1990. Almost
  252.        two  years  later  as  this  is  written,  after  four major
  253.        releases, a  couple of maintenance releases,  a few thousand
  254.        registered  users (thanks!)  and  an  uncountable number  of
  255.        other changes in  my life, RemoteAccess  has become a  full-
  256.        time occupation.
  257.  
  258.  
  259.        I'd like to thank Mark Anderson for his patience in updating
  260.        this documentation,  Bruce Bodger, Barry  Phillips and their
  261.        support groups NARAS, UKRAS and EURAS, the guys who  operate
  262.        the registration sites and of course the beta test team. 
  263.  
  264.  
  265.        I'd also like to thank the following for their contributions
  266.        (in no  particular  order whatsoever)  -  all of  them  have
  267.        played a part in the development of RemoteAccess:
  268.  
  269.        Adam Blake, Joaquim  Homrighausen, Ray Gwinn,  David Nugent,
  270.        Rob  van  Hoeven,  Tomas  Bremin, Peter  Janssens,  Advanced
  271.        Engineering, Phil  Mackay, Bob  Fletcher, Adam Hudson,  Gary
  272.        Smith, Scott's Pub and  Restaurant, Mum, Dad, Vanessa, Matt,
  273.        Sugar, Letham  Burns, James Smith and  Online Communications
  274.        Inc.,  Guns n' Roses, Matilda  Bay Brewing, Al  Hays and the
  275.        Church  Street Station  gang, Kevin  Johnson, Terry  Harvey,
  276.        john  barton,  Andrew  Russell,  Mike  Janke,  Fred  "Levis"
  277.        Horner, and  the Luxembourg PTT for  connecting my telephone
  278.        in just seven weeks.
  279.  
  280.  
  281.                                                    Andrew Milner,
  282.                                                    Luxembourg City.
  283.                                                    ────────────────
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.                                      2
  307.        OVERVIEW AND FEATURES
  308.        ────────────────────────────────────────────────────────────
  309.  
  310.        RemoteAccess   is  a  "fully-blown"  remote  bulletin  board
  311.        package.  It  may be used as a stand-alone system or with  a
  312.        front-end  mailer  if  you wish to interface it  to  a  mail
  313.        network  such as FidoNet.  It offers fully  definable  menus
  314.        with  a  unique  template system which provides not  only  a
  315.        massive  degree  of  flexibility in  making  your  BBS  look
  316.        different  from  any  other,  but also the  lowest  possible
  317.        maintenance.  AVATAR  screen  control  is built  in,  making
  318.        possible extremely efficient and  complex colour and  cursor
  319.        control at the user's  end if an AVATAR terminal  program is
  320.        used.
  321.  
  322.        Access  to the 200 available message areas is controlled  by
  323.        your  menu structure,  along with a  sophisticated  security
  324.        system which incorporates over 64,000 security levels with a
  325.        set of user-definable flags. For each security level you can
  326.        specify maximum download limits for different log-on speeds,
  327.        daily time limits, and optionally activate the built-in file
  328.        ratio  system,  limiting  downloads by ratio to  uploads  by
  329.        either  number  of  files  or kilobytes.  In  addition  it's
  330.        possible to assign a user to one of 255 separate groups, and
  331.        in so doing segregate groups of users from each other.
  332.  
  333.        Other security features include the disallowing of downloads
  334.        during peak hours,  disallowing low speed callers at certain
  335.        times,  and disallowing ANSI graphics at low speeds. You can
  336.        disallow  one-word "pseudonyms",  and  optionally  configure
  337.        the system to force a user to change passwords every x  log-
  338.        ons. Undesirable user names and passwords are also definable
  339.        for  maximum  security.  If you're unlikely to want to  call
  340.        your own system, remote sysop access can be disabled, making
  341.        it virtually impossible for your account to be "hacked".
  342.  
  343.        Direct  support  for high-speed modems up to 38,400 baud  is
  344.        available, and RemoteAccess will optionally answer the phone
  345.        automatically  to ensure that the modem will answer if  your
  346.        BBS is "alive and well".
  347.  
  348.        RemoteAccess  supports as many as 250 lines  simultaneously.
  349.        Full  system  access  to  all  file  and  message  areas  is
  350.        available  to  each line (at your discretion),  as  are  all
  351.        doors.  Several  "multi-node specific" features are provided
  352.        to  augment  multi-line operation.  You  can  configure  the
  353.        system  to  disallow one person logging on to more than  one
  354.        line  at  a  time.  A "who else is  on-line?"  and  "today's
  355.        callers" function is available to you,  along with  separate
  356.        system  logs  for each line.  Logging is selectable  between
  357.        either Opus (expanded) or  FrontDoor (compact) styles to aid
  358.        integrated  log readability. Some basic user-to-user on-line
  359.        messaging, to be expanded at a later date is also available.
  360.  
  361.        RemoteAccess offers a  fully configurable user  environment.
  362.        Its multi-lingual support and configurable date formats mean
  363.        that your users will  feel at home no matter  where they are
  364.        calling from - every one of  the 500+ text prompts is  fully
  365.        sysop-configurable.
  366.  
  367.                                      3
  368.        RemoteAccess does NOT do its own internal multi-tasking.  To
  369.        this  end,  we have attempted to make it as well-behaved  as
  370.        possible.  It  has built-in time-slicing and screen-handling
  371.        support    for   Windows,  DESQview,   TopView,   MultiLink,
  372.        DoubleDOS  and    PC-MOS/386.  It is    fully  overlaid  and
  373.        occupies approximately  220k of  memory when fired up.  What
  374.        do  you do if you have say   a 300k DESQview window and want
  375.        to  run TradeWars  in  a  shell?   No  problem!   Simply  by
  376.        specifying  a control character on  the  command  line,  you
  377.        can instruct RemoteAccess to swap  itself  lock,  stock  and
  378.        barrel to EMS and/or disk leaving only 3k  resident. 
  379.  
  380.        A  comprehensive  file transfer system is also part  of  the
  381.        package.  Six  of  the  most  popular  protocols,  including
  382.        Zmodem,  Ymodem batch and Xmodem are built-in,  and  fifteen
  383.        slots  for  external protocols are available for you to  add
  384.        any   others.  All  protocols may  be made  available on  an
  385.        "error  free"  connect basis  at  the  your discretion.  The
  386.        protocol interface   system   is  extremely  flexible,   and
  387.        has   been tested  with DSZ,   Kermit  (an  Opus  compatible
  388.        protocol),   and BiModem. There are of course many others we
  389.        haven't tested, but most should work. Support for CD-ROM and
  390.        other mass  read-only media  is another  invaluable feature.
  391.        The  file   transfer   system   is   further   enhanced   by
  392.        comprehensive file search  and locate  functions along  with
  393.        the ability to tag any file  or group of files as "free" and
  394.        or password protected. A large selection of transfer options
  395.        include global downloads and  the ability for specific files
  396.        to be attached to a file transfer menu option.
  397.  
  398.        Interactive EMSI  session support  is an exciting  new first
  399.        for RemoteAccess! Read the section on IEMSI in the reference
  400.        section  at the  end of  this document  for details  on this
  401.        revolutionary new set of features.
  402.  
  403.        Extensive on-line facilities are available to the sysop.  An
  404.        optional set of status bars provide a wealth of  information
  405.        about  both  the  person currently on-line and  the  system.
  406.        Several  "hot-keys"  are also available to  perform  a  wide
  407.        range  of functions,  amongst which  is a  full  screen user
  408.        attribute  editor, a "sysop on next" key, shell to DOS, hang
  409.        up, lock out, and local snoop.
  410.  
  411.        As an added bonus, we have decided to use the QuickBBS-style
  412.        user  and message database formats.  This means that you can
  413.        continue  to use your favourite QuickBBS utilities  with  no
  414.        need to convert to another format.  Any incompatibilities in
  415.        the  configuration  files  is taken care of  by  an  upgrade
  416.        utility.  We  make  no  apology for the  similarity  between
  417.        RemoteAccess and QuickBBS.  QuickBBS had many features  that
  418.        we  wanted,  and  compatibility  gives the  added  bonus  of
  419.        offering  the  sysop  ease  of  installation  and a familiar
  420.        environment.
  421.  
  422.        To  cater for both Opus and QuickBBS users alike,  each user
  423.        has  (at  the discretion of the sysop) the option  of  using
  424.        hot-keyed   menus   or   command   stacking.   Comprehensive
  425.        messaging, file search  options and support for a wide range
  426.        of "doors" ensure that your BBS will be a hit!
  427.  
  428.                                      4
  429.        LICENSING INFORMATION (Shareware version)
  430.        ────────────────────────────────────────────────────────────
  431.  
  432.        "RA"  refers  to the executable programs  and  documentation
  433.        contained    in   RemoteAccess   Bulletin   Board   Software
  434.        distribution  archives  released  by  Continental  Software.
  435.        (Shareware version).
  436.  
  437.        1.  RA  is the copyrighted material of Continental Software.
  438.        It  may only be used  in accordance with  the conditions set
  439.        out in this license agreement.
  440.  
  441.        2.  You  may  use RA for a period of three weeks on a  trial
  442.        basis  in  order  to determine  it's  suitability  for  your
  443.        particular application.  After this period you MUST register
  444.        each  copy  of RA that you  run  simultaneously.  Multi-line
  445.        installations  that share  a common  file base AND  have the
  446.        same name need only register one copy.
  447.  
  448.        3. Registration  entitles  you  to  use RA  and  any  future
  449.        versions of  RA  for  as long as you wish,  subject  to  any
  450.        special  licensing conditions  attached to  future versions.
  451.        For  details on  the  registration procedure,  refer to  the
  452.        section in this document "HOW TO REGISTER".
  453.                     
  454.        4. Continental   Software   is  in   no   way  obligated  to
  455.        provide future versions of, or support for, RA.   
  456.  
  457.        5. Site and Group registrations are available, and are dealt
  458.        with on a case by case basis.
  459.  
  460.        6.  You  may  not  modify or otherwise  reverse-engineer RA.
  461.  
  462.        7.  You are encouraged to distribute RA provided that no fee
  463.        is charged  for its distribution, and  that the distribution
  464.        archive  is not  modified  in any  way.  Pay Bulletin  Board
  465.        Systems  may however charge  their  normal fee provided that
  466.        no additional charge for RA is levied.  
  467.  
  468.        8. RA may not  be included as  part of any software  library
  469.        which  is distributed  on a  commercial basis  (commercial =
  470.        "for  money")   without   prior  written   permission   from
  471.        Continental Software.
  472.  
  473.        9. RA may not be used in any unlawful or illegal manner.
  474.  
  475.        10.   Continental Software's  liability resulting from  your
  476.        use or   inability   to use  RemoteAccess is limited  to the
  477.        amount that the  affected party has paid  for it, or in  the
  478.        event  that RA was registered with a third party for payment
  479.        to Continental Software, liability  is limited to the amount
  480.        that was  received by  Continental Software from  that third
  481.        party.
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.                                      5
  490.        HOW TO REGISTER
  491.        ────────────────────────────────────────────────────────────
  492.  
  493.        SHAREWARE version:
  494.  
  495.             Systems that qualify for this category must be         
  496.             physically run from a noncommercial site. A site is    
  497.             considered to be noncommercial only if it is a private 
  498.             residence at which no commercial activities are        
  499.             conducted.
  500.  
  501.        Print  or reproduce the registration form at the end of this
  502.        section and send it with your registration payment to one of
  503.        the following sites:
  504.  
  505.  
  506.        AUSTRALIA: AUD60              CANADA: CDN60
  507.  
  508.             "Registration/RA"             "Registration/RA"
  509.             C/- Terry Harvey              C/- Royce Jones
  510.             PO Box 593                    624 Dolph Street N Apt #B
  511.             Burwood NSW 2134              Cambridge ON
  512.             AUSTRALIA                     CANADA N3H-2B4
  513.             Accepts VISACARD,
  514.             MasterCard, BankCard
  515.  
  516.  
  517.        EUROPE: DFL120                USA: $50
  518.  
  519.             "Registration/RA"             "Registration/RA"
  520.             C/- R.A. de Bruin             C/- Ed Meloan       
  521.             Columbusrede 17               1110 Terrace Circle Drive
  522.             2725 KL Zoetermeer            North Augusta SC 29841
  523.             HOLLAND                       USA
  524.  
  525.  
  526.        GERMANY: DM90
  527.  
  528.             "Registration/RA"
  529.             C/- Frank Altenburg
  530.             Wickopweg 9
  531.             6100 Darmstadt
  532.             GERMANY
  533.  
  534.        ASIA: AUD60 or equivalent     UNITED KINGDOM: GBP33
  535.  
  536.             "Registration/RA"             "Registration/RA"
  537.             C/- Andrew Russell            C/- Barry Phillips
  538.             D1-1-6 R.S.G.C. View          PO Box 21
  539.             Desa Pandan                   Ormskirk
  540.             Jalan Kampong Pandan          Lancs L39 3QW
  541.             55100 Kuala Lumpur            UNITED KINGDOM
  542.             Malaysia
  543.  
  544.  
  545.        * You MUST fill out the registration form correctly in order
  546.          for your details to be processed. Not doing so will result
  547.          in delays in your key arriving.
  548.  
  549.  
  550.                                      6
  551.        * Cheques and money orders should be made payable to the    
  552.          person at your registration site.
  553.  
  554.        * Please include either a FidoNet address or a stamped,     
  555.          self-addressed envelope so that receipt of your payment   
  556.          can be acknowledged.
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.        PROFESSIONAL version:
  564.  
  565.             If the system is physically run from a commercial site 
  566.             (ie. the site is not a private residence, or commercial
  567.             activities are conducted at the site).
  568.  
  569.        This is  professionally packaged with an expanded ring-bound
  570.        manual  and  includes three  modules  not  available in  the
  571.        shareware version:
  572.  
  573.        1.  Real-Time  Conferencing -  supporting  up  to 250  users
  574.        concurrently,   featuring  public/private/password-protected
  575.        conferences, conference moderators and sub-conferences.
  576.  
  577.        2. RANETMGR -   The RemoteAccess Network  Manager, a utility
  578.        designed to give you complete control over a busy multi-node
  579.        system. Dynamically  view the status  of each node  as users
  580.        log  on and off, what each user is doing, broadcast messages
  581.        to  any  combination of  nodes  and  automatically take  any
  582.        combination of nodes down for maintenance.
  583.  
  584.        3. TopEd/Pro - A  fully functional, specially customised and
  585.        registered version  of TopEd, a premium  full-screen message
  586.        editor.
  587.  
  588.        The professional version supports up to 100 languages, while
  589.        the shareware version supports a maximum of eight.
  590.  
  591.        The  professional  version  of  RemoteAccess is  sold  on  a
  592.        commercial basis only. It is NOT shareware.
  593.  
  594.  
  595.        Enquiries  for the  professional version should  be directed
  596.        to:
  597.  
  598.        USA:                            Europe:
  599.  
  600.        Online Communications Inc.      Advanced Engineering sarl 
  601.        22 State Street                 8, Am For
  602.        Bangor, Maine 04401             L-5351 Oetrange
  603.        USA                             Luxembourg
  604.  
  605.        Tel: (207) 941 1110             Tel: +352 358725
  606.                                        Fax: +352 355938
  607.        BBS: (207) 990 3511             BBS: +352 355936
  608.  
  609.  
  610.  
  611.                                      7
  612.                   *** RemoteAccess REGISTRATION FORM ***
  613.  
  614.  
  615.        Sysop Name _________________________________________________
  616.  
  617.        System Name ________________________________________________
  618.  
  619.        [The above two items are used to generate your registration 
  620.         key and must appear EXACTLY as they do in RACONFIG.]
  621.  
  622.  
  623.        Network Address (number and network name) __________________
  624.  
  625.  
  626.        Any other networks you are a member of _____________________
  627.  
  628.  
  629.        Primary BBS telephone number and baud ______________________
  630.  
  631.  
  632.        Voice telephone number _____________________________________
  633.  
  634.  
  635.        Hours of BBS operation _____________________________________
  636.  
  637.  
  638.        Postal Address :
  639.  
  640.        ____________________________________________________________
  641.  
  642.        ____________________________________________________________
  643.  
  644.        ____________________________________________________________
  645.  
  646.  
  647.  
  648.        Version of RemoteAccess registering ______.
  649.  
  650.  
  651.        Registration amount enclosed _______, for ____ copies.
  652.  
  653.  
  654.        What do you like about RemoteAccess?
  655.  
  656.        ____________________________________________________________
  657.  
  658.        ____________________________________________________________
  659.  
  660.        ____________________________________________________________
  661.  
  662.  
  663.  
  664.        What enhancements/changes  would you like to see in our next
  665.        release?
  666.  
  667.        ____________________________________________________________
  668.  
  669.        ____________________________________________________________
  670.  
  671.  
  672.                                      8
  673.        The key system
  674.        ────────────────────────────────────────────────────────────
  675.  
  676.        Upon registering you  will receive  your uniquely  generated
  677.        key. Each key is a small file approximately 2k in size which
  678.        contains information about your registration. To install the
  679.        key, simply rename it  (if necessary) to RA.KEY and  copy it
  680.        to your RemoteAccess system directory.
  681.  
  682.        When  RemoteAccess  detects a  valid  key  it switches  into
  683.        registered mode, identifying itself by placing a "+"  at the
  684.        end of the version number as well as displaying the  name of
  685.        the system and  sysop it  is registered to  in the  "version
  686.        information" menu function.
  687.  
  688.        For  example, logging  on to a  registered system  you would
  689.        see:
  690.  
  691.        RemoteAccess 1.11+
  692.        Please enter your full name:
  693.  
  694.        Features marked in this manual with a {+} are only available
  695.        when RemoteAccess is running in registered mode. These bonus
  696.        features  show our appreciation  of your taking  the time to
  697.        register with us.
  698.  
  699.        It  should be  made  absolutely clear  that RemoteAccess  is
  700.        still fully  functional before  it is registered;  the bonus
  701.        features are  "nice" but their  absence makes the  system no
  702.        less  usable.   RemoteAccess  is  not  and   never  will  be
  703.        "DemoWare" or "ExpireWare".
  704.  
  705.        WARNING!  Your key  is  unique, and  under NO  circumstances
  706.        should it be  made available to  anyone else. Doing so  is a
  707.        direct violation of the  agreement you entered into with  us
  708.        by registering.
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                                      9
  734.        PRODUCT SUPPORT                    
  735.        ────────────────────────────────────────────────────────────
  736.  
  737.        You    can  always  get  the  latest  shareware  version  of
  738.        RemoteAccess  and  technical   support  from  the  following
  739.        systems:
  740.  
  741.  
  742.        Australia:
  743.  
  744.             Terry Harvey
  745.             The Eagles
  746.             Sydney NSW
  747.             (02) 745 3190 V32 V42 PEP
  748.             FidoNet@3:712/704
  749.                     3:712/707
  750.                 
  751.  
  752.        USA and Canada: (North American RemoteAccess Support group)
  753.  
  754.             Bruce Bodger                       Fred Horner
  755.             The TruckStop BBS                  The Private EaR
  756.             Tulsa OK                           Waco TX
  757.             918 254 6618 HST                   817 776 9877 HST
  758.             FidoNet@1:170/400                  FidoNet@1:388/10
  759.  
  760.             Mike Janke                         Ed Meloan
  761.             Kendall BBS                        Augusta Forum
  762.             Miami FL                           N. Augusta SC
  763.             305 271 2146 HST                   803 279 4124 HST
  764.             FidoNet@1:135/4                    FidoNet@1:360/1
  765.  
  766.             Al Bruner                          Royce Jones
  767.             The SW/SE Connection               DAKIN BBS
  768.             San Diego CA                       Cambridge Ontario
  769.             619 467 0335 HST                   519 653 7677 HST
  770.             FidoNet@1:202/707                  FidoNet@1:221/204
  771.  
  772.             Mark Howard                        Geoffrey Booher
  773.             Rivendell                          The Gateway Net BBS
  774.             Buffalo NY                         Freeport IL
  775.             716 646 0227 HST                   815 233 5008 HST
  776.             FidoNet@1:260/1                    FidoNet@1:2270/233
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                                     10
  795.        Europe and others: (European RemoteAccess Support Group)
  796.  
  797.  
  798.        Ruud de Bruin                      Orlando Castillo
  799.        HOLLAND                            SPAIN
  800.        +31 49 424553 V32                  +34 6 543 7026 V32
  801.        FidoNet@2:281/603                  FidoNet@2:346/4
  802.  
  803.        Joerg Dassler                      Tony Van den Bogaert
  804.        GERMANY                            BELGIUM
  805.        +49 911 752799 HST                 +33 3 2720210
  806.        FidoNet@2:244/8501                 FidoNet@2:295/43
  807.  
  808.        Robert Soubie                      Reinier De.Groot
  809.        FRANCE                             HOLLAND, HELP 2
  810.        +33 56 89 51 12                    +31 1749 48422
  811.        FidoNet@2:324/5                    FidoNet@2:512/100
  812.  
  813.        Malte Erikson                      Frank Altenburg
  814.        SWEDEN                             GERMANY, HELP 2
  815.        +46 300 29436                      +49 6151 710809
  816.        FidoNet@2:203/302                  FidoNet@2:249/7
  817.  
  818.        Peter Hermann                      Wim Abels
  819.        GERMANY, HELP 3                    GERMANY, HELP 4
  820.        +49 531 13216                      +49 211 5961291
  821.        FidoNet@2:240/550                  FidoNet@2:242/20
  822.  
  823.        Roland Gautschi                    Bjarne Maschoreck
  824.        SWITZERLAND                        DENMARK
  825.        +64 230319                         +45 31 42 72 64
  826.        FidoNet@2:30/6                     FidoNet@2:231/50
  827.  
  828.        Andrew Milner                      Clive Jones
  829.        LUXEMBOURG                         REPUBLIC of SOUTH AFRICA
  830.        +352 490 486                       +27 11 868 4790
  831.        FidoNet@2:270/18                   FidoNet@5:7101/14
  832.  
  833.        Lars Eriksson                      Hilmar Thors
  834.        FINLAND                            ICELAND
  835.        +358 28 23452                      +354 1 627648
  836.        FidoNet@2:222/150                  FidoNet@2:257/60
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                     11
  856.        U.K. (United Kingdom RemoteAccess Support Group):
  857.  
  858.  
  859.        Barry Phillips                     Mark Kerr
  860.        MIDLANDS                           IRELAND and WALES
  861.        +44 695 571117 HST DS              +44 232 768163 HST DS
  862.        FidoNet@2:440/66                   FidoNet@2:263/301
  863.  
  864.                                           James Berry
  865.                                           S.E. ENGLAND
  866.                                           +44 303 862415 HST DS
  867.                                           FidoNet@2:440/16
  868.  
  869.        Peter Burnett                      Mark Anderson
  870.        S.W. ENGLAND                       SCOTLAND
  871.        +44 424 853361                     +44 236 747393 HST DS
  872.        FidoNet@2:440/80                   FidoNet@2:259/11
  873.  
  874.  
  875.  
  876.  
  877.        Sweden (SWRAS):
  878.  
  879.  
  880.        Malte Erikson                      Johan Nilsson
  881.        SWRAS HQ                           SWRAS Coordinator
  882.        +46 300 29436                      +46 42 112714
  883.        FidoNet@2:203/302                  FidoNet@2:200/212
  884.  
  885.        Mats Wallin                        Patrik Sjoberg
  886.        +46 8 6453882                      +46 26 628057
  887.        FidoNet@2:201/329                  FidoNet@2:205/208
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.                                     12
  917.        Support conferences:
  918.  
  919.  
  920.        Conference                   Support
  921.        Name            Language     Area            Moderators     
  922.        -------------   ---------    --------------  --------------
  923.        RA_SUPPORT      English      World Wide      Bruce Bodger   
  924.                                                     Mike Janke     
  925.                                                     Andrew Milner
  926.  
  927.        RA_UK           English      United Kingdom  Mark Anderson  
  928.                                                     Barry Phillips
  929.  
  930.        RA.GER          German       Germany /       Joerg Dassler  
  931.                                     Switzerland     Roland Gautschi
  932.  
  933.        RA_SWE          Swedish      Sweden          Hasse Widghal
  934.  
  935.        SF.RA/FD_SP     Finnish      Finland         Lars Eriksson
  936.  
  937.        RA_SUP.028      Dutch        Netherlands     Ruud de Bruin  
  938.                                                    Reinier de Groot
  939.  
  940.        RA_SUP.B        Belgian      Belgium         
  941.  
  942.        RA_UTIL         English      World Wide      Andrew Leary   
  943.        (For RA Utilities)                           John Bierrie
  944.  
  945.        RA_UTIL.GER     German       Germany         Frank Altenburg
  946.                                                     Joerg Dassler
  947.  
  948.  
  949.        New releases  and the  RA_SUPPORT conference should  also be
  950.        available from any of the beta test sites, listed in the    
  951.        accompanying document.
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.                                     13
  978.        INSTALLATION
  979.        ────────────────────────────────────────────────────────────
  980.  
  981.        RemoteAccess   should  run  on  any  IBM  80x86   compatible
  982.        computer. The only two programs you will need in addition to
  983.        the  release  package are DOS 3.x and a FOSSIL  driver.  The
  984.        FOSSIL is a memory-resident program that many communications
  985.        packages use to communicate with the modem. Two FOSSILs that
  986.        have  been  successfully tested with  RemoteAccess  are  Ray
  987.        Gwinn's X00,  and David Nugent's BNU. Either of these should
  988.        be readily available from any local bulletin board.
  989.  
  990.        You  will  also  need a modem that is capable  of  accepting
  991.        Hayes-type  commands.  The  minimum  memory  requirement  is
  992.        approximately 350K, but 512K is recommended.
  993.  
  994.        1.  Ensure  that  your CONFIG.SYS file  contains  these     
  995.            statements:
  996.  
  997.                  FILES=20
  998.                  BUFFERS=25
  999.                             
  1000.            If you intend  to run a multi-node  system you  may     
  1001.            need  to  increase  the  number  of   file  handles     
  1002.            that DOS  can  open at  one time,  by  raising  the     
  1003.            "FILES" value.   Note: Each additional  file handle     
  1004.            will reduce available memory by 50 to 60 bytes.
  1005.  
  1006.            The  more  "BUFFERS"  you  allocate,  the   faster      
  1007.            RemoteAccess  will run.  However,  each additional      
  1008.            buffer  allocated  will reduce memory available by      
  1009.            500 to 600 bytes.
  1010.            
  1011.        2.  Create  a directory to put the main program  files      
  1012.            in.  The  configuration example that follows  later     
  1013.            assumes that this directory (the SYSTEM  directory)     
  1014.            is C:\RA.
  1015.  
  1016.        3.  Ensure  that  your  AUTOEXEC.BAT  file  contains  a     
  1017.            command to set the environment variable RA to  your     
  1018.            SYSTEM  directory,  so  RemoteAccess can  find  its     
  1019.            configuration files:
  1020.  
  1021.                  SET RA=C:\RA
  1022.  
  1023.            It is possible  to increase the overall performance     
  1024.            of  RemoteAccess by placing  the file "RA.OVR" onto     
  1025.            a ramdrive.   If you elect to do this you must also     
  1026.            set the following environment variable:
  1027.  
  1028.                  SET RAOVR=F:\
  1029.  
  1030.         4. Copy all of the executable files from the RemoteAccess  
  1031.            distribution package into the SYSTEM directory. 
  1032.                            
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.                                     14
  1039.        5.  Create four more sub-directories:
  1040.  
  1041.            C:\RA\MSGBASE          This will hold  the  message     
  1042.                                   files the system creates.
  1043.  
  1044.            C:\RA\MENUS            To put your menus in,
  1045.  
  1046.            C:\RA\TXTFILES         To put files such as welcome     
  1047.                                   and disconnect screens in.
  1048.  
  1049.            C:\RA\ATTACH           To hold message file attaches. 
  1050.  
  1051.  
  1052.        This completes  the installation, and  you are now  ready to
  1053.        move on to the CONFIGURATION section.
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.                                     15
  1100.        CONFIGURATION                              
  1101.        ────────────────────────────────────────────────────────────
  1102.  
  1103.  
  1104.        RACONFIG
  1105.        ────────────────────────────────────────────────────────────
  1106.  
  1107.        Return to the RemoteAccess system directory again,  and fire
  1108.        up  the configuration utility,  RACONFIG.EXE.  You will  use
  1109.        this to select the configuration options and  maintain  your
  1110.        particular system.  You will  see that  there are  four main
  1111.        configuration menus.
  1112.  
  1113.  
  1114.  
  1115.        RACONFIG  -  System
  1116.        ────────────────────────────────────────────────────────────
  1117.  
  1118.        PATHS  -  Here is where you  tell RemoteAccess where all its
  1119.        associated files  are stored.   Paths can be defined for the
  1120.        following:
  1121.  
  1122.                  System      : Full path to the RA system files.
  1123.                  Menus       : Default menu path (*.MNU).
  1124.                  Textfiles   : Default textfile path (*.A??).
  1125.                  Msg base    : Message-base and user files.
  1126.                  File attach : Local msg file attaches.
  1127.                  Nodelist    : Network nodelist files.
  1128.                  File list   : Alternative FILES.BBS path.
  1129.                  Semaphore   : Alternative semaphore directory.    
  1130.                  System log  : Filename of the system log. 
  1131.  
  1132.        Enter the  full directory paths  to your chosen directories.
  1133.        The trailing backslash is optional.
  1134.            
  1135.        See the section on MAIL NETWORKING for details on how to set
  1136.        up the NODELIST path,  the section  on message configuration
  1137.        for details on the FILE  ATTACH  PATH,  and  the section  on
  1138.        files configuration for details on the FILE LIST path.
  1139.  
  1140.  
  1141.        SITE  INFO   -   Use  this window  to  enter the  sysop name
  1142.        (probably  your own),  the name  of the  BBS, and  the BBS's
  1143.        location.  The first two must be entered exactly the same as
  1144.        those specified on your registration form.
  1145.  
  1146.  
  1147.        ADDRESS  -  In  this  section  you can  enter  your  network
  1148.        address (if any).  If you have  any alias  addresses (AKAs),
  1149.        you may enter  these in  one  or  more  of  the  nine  slots
  1150.        provided.   For   extra  information  on  network  operation
  1151.        and  an  explanation  of addresses,  see the section on MAIL
  1152.        NETWORKING.
  1153.               
  1154.  
  1155.        SECURITY  -  Here you  may define  a configuration  password
  1156.        that must be entered every time you wish to run RACONFIG and
  1157.        every time you use one of the ALT keys at the local console.
  1158.        {+} Registered only.
  1159.  
  1160.                                     16
  1161.        RACONFIG  -  Options
  1162.        ────────────────────────────────────────────────────────────
  1163.  
  1164.        MESSAGES  -  This  section  deals  with  many of  the global
  1165.        settings in relation to mail and messages. 
  1166.  
  1167.  
  1168.        Logon.     : When  enabled,  will force  the   system  to   
  1169.        Newmail      scan   the  message-base   for   new    mail   
  1170.                     addressed  to the  user  (regardless of what   
  1171.                     area it is  in, provided the user has access   
  1172.                     to that area) at log-on.
  1173.  
  1174.        Full       : This  option  determines  the  type of  mail   
  1175.        mailcheck    check   that  is  performed.  A  full  check   
  1176.                     scans from  the  start  to  the  end of  the   
  1177.                     message-base  for  all   mail  addressed  to   
  1178.                     the user  that  does not have the "Received"   
  1179.                     flag  set.  If you set  the option to "Off",   
  1180.                     the msgbase is  only checked  from the  last   
  1181.                     message that  the user  read.  While this is   
  1182.                     much faster,  there  is the possibility that   
  1183.                     some  mail  may  be  skipped  if  the   user   
  1184.                     elected not to read his/her mail during the    
  1185.                     last logon.
  1186.  
  1187.        Quote      : This string is  a highlight  character  that   
  1188.        string       RemoteAccess  will  place  in  front  of any   
  1189.                     message that is replied to. For  example,  a   
  1190.                     message quoted using  " > "  as  the  quoter   
  1191.                     would look like:
  1192.  
  1193.                           > I have been using RemoteAccess for     
  1194.                           > 2 months now and love it!
  1195.  
  1196.                          I have to agree with you there, Tom.      
  1197.                          Flexibility-wise it can't be beaten.
  1198.  
  1199.                     A  "@" character in  the  quote string  will   
  1200.                     be translated  into the  uppercase  initials   
  1201.                     of the person whose message is being quoted.   
  1202.         
  1203.                     A "#" character will do the same but use the   
  1204.                     lowercase.
  1205.  
  1206.        External   : This is the DOS command line  that  will  be   
  1207.        editor       used  to  activate  a  full  screen  message   
  1208.                     editor,  if  one is installed.   This option   
  1209.                     is  available only to users of ANSI graphics.  
  1210.                     The  full screen  editor  is  a  third-party   
  1211.                     package that enables messages to  be entered   
  1212.                     in a "word-processing"   environment,   with   
  1213.                     cursor movement and text formatting ability.   
  1214.                     TopEd and QuickEd are two such packages that   
  1215.                     interface directly with RA. The command-line   
  1216.                     may contain any of the  metacommands  listed   
  1217.                     in  the  description  of  the  type  7  menu 
  1218.                     command, including "*M" to swap RemoteAccess   
  1219.                     out  of memory before the editor is loaded.
  1220.  
  1221.                                     17
  1222.        Default    : This option  sets the  default  origin  line   
  1223.        origin       which is appended to all  outgoing  EchoMail   
  1224.                     messages. This will take effect in all areas   
  1225.                     except where you  have  entered  a  specific   
  1226.                     origin line for a particular area.
  1227.  
  1228.        Reply      : The REPLY HEADER is  displayed at the top of   
  1229.        header       a message when a  user replies to  a message   
  1230.                     that  was   not   originally   addressed  to   
  1231.                     him/her.   The  following  macro  characters   
  1232.                     may be used:
  1233.  
  1234.                        @ - Person  the original message was        
  1235.                            addressed to,
  1236.  
  1237.                        # - Person who posted  the  original        
  1238.                            message,
  1239.                
  1240.                        ` - Date of the original message,           
  1241.               
  1242.                        ~ - Time of the original message.
  1243.  
  1244.        Msg        : When this option is set to "Yes", when users   
  1245.        uploads      enter  a message  they   are  asked if  they   
  1246.                     wish to "upload  a prepared message?"   This   
  1247.                     allows  the user to prepare his/her messages   
  1248.                     offline  and  send  them   using  any of the   
  1249.                     available  file   transfer  protocols.  Note   
  1250.                     that ONLY  internal protocols may be used as   
  1251.                     RemoteAccess   does  not have enough control   
  1252.                     over the external ones.  The maximum size of   
  1253.                     a  message that may  be uploaded  is pre-set   
  1254.                     at 20k.
  1255.  
  1256.        Echo       : If this  option is  enabled,  when  replying   
  1257.        netreplies   to an EchoMail message,  users will be asked   
  1258.                     if they  would  like  to  reply directly  to   
  1259.                     the originator  of the  message via netmail,   
  1260.                     rather  than replying in the same  area with   
  1261.                     a msg that  might not be  of interest to the   
  1262.                     other  participants.   Note:  that  this {+}   
  1263.                     registered  only option  is only  enabled if   
  1264.                     RemoteAccess    can   determine   where  the   
  1265.                     original message came from.
  1266.  
  1267.        Net.       : This option applies to  NetMail sent through   
  1268.        killsent     a mail network.  When the msg is entered, if   
  1269.                     set to "Ask", the user will be asked whether   
  1270.                     to delete his/her message after it has  been   
  1271.                     exported from  the  message  database.
  1272.  
  1273.        Confirm    : When enabled, RemoteAccess  will  prompt the   
  1274.        delete       user for confirmation before deleting msgs.
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.                                     18
  1283.        Net.crash  : This  defines  the  minimum  security  level   
  1284.        opt          at  which   users   have   the   choice   of   
  1285.                     sending  NetMail  with the "crash" flag set.   
  1286.                     The "crash" means the mail will be sent  out   
  1287.                     of your system immediately. This can be very   
  1288.                     costly, so care should be taken when setting   
  1289.                     this option. 
  1290.  
  1291.        Net.crash  : This option  defines the  security level  at   
  1292.        force        which  NetMail  always  has the "crash" flag   
  1293.                     set.   Again  this  can  be  costly  so care   
  1294.                     should  be taken when  setting this option.  
  1295.  
  1296.        Net.       : This  option  defines  the minimum  security   
  1297.        attach       level  a user must  have in order to  attach   
  1298.                     files  to a  NetMail message.   Once  again,   
  1299.                     take care when setting this   option  as  it   
  1300.                     can be costly.  NOTE:  In many mail networks   
  1301.                     sending Netmail messages with files attached   
  1302.                     to  them   through  other   systems  is  not 
  1303.                     permitted. If in  doubt you  should set  the   
  1304.                     "net.crash force"  security  level  so  that   
  1305.                     all file attaches are sent direct.
  1306.  
  1307.        Group      : This  option determines the minimum security   
  1308.        Mail         a user  must  have in order  to post mail to   
  1309.                     a group of users.   See MENU COMMANDS,  menu   
  1310.                     type 27  for detailed  information  on Group   
  1311.                     Mail.
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.                                     19
  1344.        FILES   -  This section allows  you to define global options
  1345.        which affect the behaviour of the file transfer facilities:
  1346.  
  1347.  
  1348.        Upload     : The   UPLOAD  CREDIT   provides  a  way   of   
  1349.        credit       rewarding your users  for uploading files to   
  1350.                     you.  If this  value is  set to  a  non-zero   
  1351.                     value,  after each upload session,  the user   
  1352.                     is granted that many  seconds  per minute of   
  1353.                     upload time.  So,  if  you  set  the  credit   
  1354.                     factor to 30 (seconds),  and a  user  spends   
  1355.                     10 minutes   uploading,   he/she  would   be   
  1356.                     granted an extra 5 minutes for that session.   
  1357.                     Note  that   during  uploads  the  timer  is   
  1358.                     "frozen" in addition to this bonus.
  1359.  
  1360.        Touch      : When  a  file  is   uploaded  using  a batch   
  1361.        dates        protocol  such  as  Zmodem  or  Ymodem,  the   
  1362.                     original   date  of  the  file  is  normally   
  1363.                     preserved when  the  file  is  saved  in the   
  1364.                     upload  area.  This is of little use  if the   
  1365.                     file  was  originally  created  in 1987,  so   
  1366.                     RemoteAccess will, if the TOUCH DATES option   
  1367.                     is  enabled,  reset  the  date stamp  of the   
  1368.                     file to the date  on  which it was uploaded.
  1369.  
  1370.        Show       : When a  user displays a list  of files,  the   
  1371.        missing      default action is to  show missing files  as   
  1372.                     "<MISSING>".  By  disabling this option  you   
  1373.                     can make RemoteAccess remove  missing  files   
  1374.                     from the users display.
  1375.  
  1376.        Upload     : It is possible to  disable uploads  when the   
  1377.        space        the amount  of  free  space  on  your upload   
  1378.                     drive  falls  below  a  preset  level.   For   
  1379.                     example, to disable uploads if there is less   
  1380.                     than 1 megabyte free, set  UPLOAD  SPACE  to   
  1381.                     1024 (kilobytes).
  1382.  
  1383.        Logon.     : If the LOGON.NEWFILES option is enabled, the   
  1384.        Newfiles     user  will  be given the opportunity  to run   
  1385.                     a  check  for  files  which  are  new  since   
  1386.                     his/her last call at logon. 
  1387.  
  1388.        Download   : This defines the starting  time during which   
  1389.        start        users can download files.
  1390.  
  1391.        Download   : This defines  the ending  time  during which   
  1392.        end          users  can  download  files. By setting this   
  1393.                     option and  the  DOWNLOAD  START  option  to   
  1394.                     00:00, users will be able to download at any   
  1395.                     time. 
  1396.                                     
  1397.        Download   : This option  allows you  to set  a  minimum    
  1398.        speed        speed at which users can download files.
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.                                     20
  1405.        List       : You may configure the  format in  which file   
  1406.        format       description lines  are displayed when a user   
  1407.                     asks for  a  list  of  available files.   To   
  1408.        {+}          achieve  this  you  must  build  a  template   
  1409.        Registered   string in this field.   The following  macro   
  1410.        Only         characters can be used:
  1411.  
  1412.                           % - Full filename, uppercase
  1413.                           ^ - Full filename, lowercase
  1414.                           & - Filename (no extension), uppercase   
  1415.                           ! - Filename (no extension), lowercase   
  1416.                           @ - Date (in user's selected format)     
  1417.                           # - File size (bytes)
  1418.                           $ - File size (k)
  1419.                           | - New line
  1420.                           ` - '*' if new, space if not
  1421.                           ~ - Description
  1422.  
  1423.                     You may  also enter  colour  sequences  into   
  1424.                     the templates.  If a non-ANSI caller   calls   
  1425.                     these sequences will be ignored and the user   
  1426.                     will see   white text  on  black.  To  enter   
  1427.                     the colour  sequences, press CTRL-P and then   
  1428.                     CTRL-K[<colour code>   (See  the section  on   
  1429.                     COLOUR CODES for more information).
  1430.                     
  1431.                     To emulate the old hardcoded display use:  
  1432.                      
  1433.                      [0E%  [0D#  [0A@' [03~
  1434.         
  1435.  
  1436.        RESTRICTIONS  -  This  section  allows you to set  following
  1437.        restrictions on your system:
  1438.  
  1439.        Logon      : Minimum  speed at which  callers  can  logon   
  1440.        speed        to your system. 
  1441.  
  1442.        ANSI       : Minimum speed at which callers may  select ANSI
  1443.        speed        graphics.
  1444.  
  1445.        No300      : Start   time   for   disallowing  300   baud   
  1446.        start        callers.
  1447.  
  1448.        No300      : End time for disallowing  300 baud callers.    
  1449.        end          If you wish  to  allow  300 baud callers to    
  1450.                     logon  at  any  time, you  can  disable the    
  1451.                     NO300  restrictions  by  setting  both  the    
  1452.                     START and END times to 00:00.
  1453.  
  1454.  
  1455.        ERRORLEVELS  -  These values are used if you have  activated
  1456.        the  "Shell to Mailer"  feature.   For  full information  on
  1457.        this option,  read  the reference  section  on  COMMAND LINE
  1458.        PARAMETERS.
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.                                     21
  1466.        DISPLAY  -   This section  allows you to  set the  following
  1467.        video display attributes:
  1468.  
  1469.  
  1470.        Monochrome : Forces  monochrome  operation  on  the local   
  1471.                     display. 
  1472.  
  1473.        Direct     : If  you  are  not using  RemoteAccess  in  a   
  1474.        write        Multi-tasking  environment,  then  set  this   
  1475.                     option to "Yes".  This will cause all screen   
  1476.                     output  to be written to Video RAM  directly   
  1477.                     instead  of  using  BIOS  calls,   and  will   
  1478.                     result in a significant speed increase.
  1479.  
  1480.        Snow       : If  you use one of the  older CGA cards that
  1481.        check        is prone to "snowing", enable this option. 
  1482.  
  1483.        Display    : This detects  the  screen  mode you  are in.   
  1484.        lines        "AUTO" sets RA  to automatically  detect the   
  1485.                     screen mode,  25 and 43/50  options force 25   
  1486.                     and 43/50 line modes respectively.
  1487.  
  1488.  
  1489.        COLOURS  -  The  COLOURS submenu  allows  you  to  customise
  1490.        some  of the more-often  used colours  that  the  user sees.
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.                                     22
  1527.        PAGING  -  The  PAGING  menu  allows   you  to  control  the
  1528.        following:
  1529.  
  1530.  
  1531.        Duration   : Duration, in  seconds, that the paging  tune   
  1532.                     will sound at the local console.
  1533.  
  1534.        Max number : Maximum number  of times a user can page the   
  1535.                     sysop  unsuccessfully  during one session.   
  1536.  
  1537.        Ask why    : If enabled this  option  will  cause Remote-   
  1538.                     Access to ask  the  user  why  he/she wishes   
  1539.                     to chat.  The response is  then displayed on   
  1540.                     the status  bar,   and  may  be  redisplayed   
  1541.                     later by  pressing F6.  {+} Registered only.
  1542.  
  1543.        Sysop msgs : If  the  page  was  unsuccessful,  the  user   
  1544.                     can  be   prompted  whether  to leave  a msg   
  1545.                     addressed  to  the  sysop.   To  enable this   
  1546.                     option   enter   the  desired  message  area   
  1547.                     number  that you  would like  these msgs  to   
  1548.                     be posted  in.  Setting  this  field to zero   
  1549.                     disables the feature.  {+} Registered only.
  1550.  
  1551.        External   : If  you  wish  to use  a  external  chatting   
  1552.                     utility,  you  can specify the  command line   
  1553.                     to shell to run  the program in this  field.   
  1554.                     {+} Registered only.
  1555.  
  1556.        Suspend    : If enabled, this option prevents  time  from   
  1557.                     being  deducted  from the  users  daily time
  1558.                     limit during a chat with the sysop.
  1559.  
  1560.        Auto Log   : When enabled,  this  option  will  cause  RA   
  1561.                     to automatically  open  a  capture file when   
  1562.                     chat mode is initiated.
  1563.              
  1564.        Sunday     : In these seven fields,  you  can  define the   
  1565.        Monday       starting  and  ending times  at  which users   
  1566.        Tuesday      are  permitted to page  the sysop,  on a day   
  1567.        Wednesday    by day basis.    The first field of each day   
  1568.        Thursday     determines the starting  time and the second   
  1569.        Friday       field determines the  ending  time  at which   
  1570.        Saturday     users can page the sysop.   To  disable  the   
  1571.                     starting and  ending  page  times  set  both   
  1572.                     fields to 00:00.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.                                     23
  1588.        NEW USERS  -  The NEW USERS section controls how your system
  1589.        will treat new users.   You can configure the  following for
  1590.        new users:
  1591.  
  1592.  
  1593.        Security   : This is the security level (0 to 64000) that   
  1594.                     will be granted to a new user  who  logs  on   
  1595.                     for the first time.   If  you  run a private   
  1596.                     system,  and do not want to allow  new users   
  1597.                     to  log  on,  set  this field to  zero.   In   
  1598.                     this case,  the user  is notified  that  the   
  1599.                     system is private and is disconnected.
  1600.  
  1601.        Flags      : The  4  flag  entries   determine  the  flag   
  1602.                     configuration that will be  granted  to  new   
  1603.                     users.  See the section on  SECURITY  for  a   
  1604.                     full description of the security system.
  1605.  
  1606.        Credit     : This sets  the  new  user's  initial  credit   
  1607.                     against   sending  netmail   messages.   The   
  1608.                     NETWORKING  section provides full  detail on   
  1609.                     setting up netmail costings.
  1610.  
  1611.        Group      : This is an arbitrary  number  between 0  and   
  1612.                     255 you  may  assign new users.   It  allows   
  1613.                     you to segregate users into separate groups,   
  1614.                     which then can  be  used  in  various   menu   
  1615.                     types.  (see  the  menu  command  list   for   
  1616.                     further details)
  1617.  
  1618.        ANSI       : Determines  whether a new user may use  ANSI   
  1619.                     codes (Yes/No/Ask).
  1620.  
  1621.        AVATAR     : Determines whether a new user may use AVATAR   
  1622.                     codes (Yes/No/Ask).
  1623.  
  1624.        Clrscr     : Determines whether a  new  user  would  like   
  1625.                     screen clearing codes enabled  (Yes/No/Ask).
  1626.  
  1627.        More       : Determines whether the new user  would  like   
  1628.                     to be prompted with "More Y/N" at the end of   
  1629.                     each screen page (Yes/No/Ask).
  1630.  
  1631.        Sub days   : Number  of  days subscription new users  are   
  1632.                     allocated.
  1633.  
  1634.        Data       : If enabled,  new  users  are asked for their   
  1635.        phone        Data Phone number.
  1636.  
  1637.        Voice      : If enabled,  new  users  are asked for their   
  1638.        phone        Voice Phone number.
  1639.  
  1640.        One word   : If disabled, new users will be  required  to   
  1641.        names        enter their name as at least 2 words with  a   
  1642.                     total length of  at least three  characters.   
  1643.                     Note that this restriction only  applies  to   
  1644.                     new users;  a  user  already  in  the   user   
  1645.                     database  may  log  on   using  his  or  her 
  1646.                     "handle".
  1647.  
  1648.                                     24
  1649.        Handle     : If this  option is  enabled,  new users will   
  1650.                     be asked to choose an optional unique handle   
  1651.                     or alias.   This  is  saved  as part of  the   
  1652.                     user's  record and may be used  to  log onto   
  1653.                     the system  later, and to  send and  receive   
  1654.                     mail. 
  1655.  
  1656.        Birthdate  : If enabled, new users will  be  prompted  to   
  1657.                     enter  their  full  birthdate.  RemoteAccess   
  1658.                     will  attempt  to intelligently  identify if   
  1659.                     the date supplied is legitimate.
  1660.  
  1661.        Hotkeys    : RemoteAccess   may  be  configured to behave   
  1662.                     either like QuickBBS  with hot-keyed  menus,   
  1663.                     or   like   Opus  with   command    stacking   
  1664.                     facilities (Yes/No/Ask).
  1665.  
  1666.        FS msg     : FS  MSG  VIEW,   when enabled,  will display   
  1667.        view         messages to the user using a "fixed  header"   
  1668.                     format, designed  for  enhanced readability.
  1669.  
  1670.        FS msg     : The FS MSG EDIT setting will determine if RA   
  1671.        edit         asks the new users if they would like to use   
  1672.                     the external message editor (Yes/No/Ask).
  1673.  
  1674.        IEMSI      : When  a  new  user  connects to your  system   
  1675.                     using  IEMSI   (  explained  fully  in   the   
  1676.                     reference section of this manual),   RA will   
  1677.                     skip the regular  new user questionnaire  as   
  1678.                     it   can   determine   the   user's   screen   
  1679.                     parameters,  location,  password  etc. auto-   
  1680.                     matically.   If   this  option  is  disabled   
  1681.                     however,  all new users  will be  forced  to   
  1682.                     answer the regular questionnaire manually.
  1683.  
  1684.        Language   : This option sets the  default  language  for   
  1685.                     new users before they select their preferred   
  1686.                     language.  If  this option  is set  to zero,   
  1687.                     the new  users  will  not  be  asked   which   
  1688.                     language they wish to use as their default.  
  1689.  
  1690.        Date       : If set to "ASK" new users are able to select   
  1691.        format       which date  format they  would like  to  use   
  1692.                     when  entering  dates  and  when  dates  are   
  1693.                     displayed. The available formats are:
  1694.  
  1695.                                      DD-MM-YY
  1696.                                      MM-DD-YY
  1697.                                      YY-MM-DD
  1698.                                      DD-Mmm-YY
  1699.  
  1700.                     The sysop  may  choose to force a particular   
  1701.                     date format by selecting the format  in this   
  1702.                     field.
  1703.         
  1704.        Cap        : If enabled  this will force RA to capitalise   
  1705.        location     the  users  location,  when  entered.
  1706.  
  1707.  
  1708.  
  1709.                                     25
  1710.        SYSTEM  -  The SYSTEM submenu contains  options that pertain
  1711.        to  the  hardware/software  environment   plus  some   other
  1712.        global options listed below:
  1713.  
  1714.  
  1715.        Fast       : Whenever RA is activated in local  mode  and 
  1716.        logons       this option is set, it is assumed that it is   
  1717.                     the sysop who is logging on, and you will be   
  1718.                     prompted for a password only.  If  you press   
  1719.                     [CR]  at the password prompt RA will ask for   
  1720.                     a full user name.
  1721.  
  1722.        Check      : When running more than one line,  you should   
  1723.        multi        set CHECK MULTI to "Yes".  This will prevent   
  1724.                     a user from logging on to more than one line   
  1725.                     at the same time,  and effectively using his   
  1726.                     /her entire daily time limit  on  EACH LINE.
  1727.  
  1728.        Remote     : If you never (or rarely) call  your own  BBS   
  1729.        sysop        remotely,  you should disallow sysop  remote   
  1730.                     access by setting REMOTE SYSOP to "No". This   
  1731.                     makes it  almost impossible  for  an unknown   
  1732.                     "hacker" to gain  access to your system  via   
  1733.                     your own  account.
  1734.  
  1735.        Exclude    : If enabled,   this  option  will  cause  the   
  1736.        sysop        sysops name  to be omitted from a User List,   
  1737.                     List of Today's Callers, Who Else Is Online,   
  1738.                     and the Last Caller functions.
  1739.  
  1740.        Text       : By  inserting a special control  code  in  a   
  1741.        shells       textfile  it is  possible  to  automatically   
  1742.                     activate a program in a shell when the  text   
  1743.                     file is displayed.  As explained in the TEXT   
  1744.                     FILE  CONTROL  CODES   section,   there  are   
  1745.                     important security considerations  that must   
  1746.                     be looked  into if  you intend  to use  this   
  1747.                     feature. If you aren't going to use it,  set   
  1748.                     TEXT SHELLS to "No".
  1749.  
  1750.        Log        : The logging  format  is  determined  by this   
  1751.        style        option.  The "Expanded" format mode contains   
  1752.                     more information, including  the line number   
  1753.                     in  a  multi-line  system.   The   "Compact"   
  1754.                     format is less detailed.
  1755.  
  1756.        Multi      : If  you  are  installing  RemoteAccess  on a   
  1757.        node         multi-node site (ie.  you  are going  to  be   
  1758.                     running more  than one  node),  you MUST set   
  1759.                     this option  to "Yes".  This  enables  extra   
  1760.                     file/message  checking  routines  to  ensure   
  1761.                     that a conflict between two lines  accessing   
  1762.                     the same data  never  arises.   If  you  are   
  1763.                     running only one line,  setting  this option   
  1764.                     to "Off"   will  disable  this  checking and   
  1765.                     significantly    increases    the   system's   
  1766.                     operating speed.
  1767.  
  1768.  
  1769.  
  1770.                                     26
  1771.        Enviro-    : The ENVIRONMENT option  refers  to  the type   
  1772.        nment        of multi-tasking  system that  you  will  be   
  1773.                     running RemoteAccess under. If set to "Auto-   
  1774.                     detect",   RemoteAccess  will   attempt   to   
  1775.                     determine the multitasker  in  use  when  it   
  1776.                     fires  up.   On    some  hardware / software   
  1777.                     configurations  it  may   not   be  able  to   
  1778.                     correctly  detect   it's   environment.   To   
  1779.                     overcome this, you can force RemoteAccess to   
  1780.                     "assume" that it is running under a specific   
  1781.                     multitasker.   Those   currently   supported   
  1782.                     are  DoubleDOS, Windows  3.x   (enhanced mode),
  1783.                     DESQview,  TopView,  MultiLink, PC-MOS/386  and
  1784.                     the "standard" AT BIOS. RA will  time-slice,
  1785.                     or give up CPU time, to other tasks when  it
  1786.                     is waiting  for a call or  at  a   prompt.  The
  1787.                     result    is   a  significant   overall  system
  1788.                     performance improvement.
  1789.  
  1790.        Screen     : To avoid screen  "burn in"  on  the "waiting   
  1791.        blank        for call"  display,   set  the  SCREEN BLANK   
  1792.                     to the number of  seconds you would like the   
  1793.                     display to remain  visible  after  the  last   
  1794.                     activity.   This  is  a {+} registered  only   
  1795.                     option.
  1796.  
  1797.        After      : After RA  displays  a  system  message,  the   
  1798.        msgs         default action is  to wait  for  one  second   
  1799.                     before returning to the  current  menu.  You   
  1800.                     may alter  this  wait  period by setting the   
  1801.                     AFTER MSGS option to the  desired number  of   
  1802.                     seconds.  If  you  set  this  field to zero,   
  1803.                     instead  of waiting for  a few  seconds,  RA   
  1804.                     will prompt  the user to press the Enter key   
  1805.                     to continue.
  1806.  
  1807.        ALT-J      : If enabled,  this option will  cause Remote-   
  1808.        swap         Access to swap itself out of memory   before   
  1809.                     a  sysop shell  to DOS.   This  will  enable   
  1810.                     programs   that  require  a large  amount of   
  1811.                     memory  to  be  run.    NOTE:  the  swapping   
  1812.                     process will take a few seconds.
  1813.          
  1814.        IEMSI      : The IEMSI option simply allows you to enable   
  1815.                     or disable RemoteAccess' IEMSI capabilities.   
  1816.                     IEMSI is  fully explained in  the  reference   
  1817.                     section at the end of  this  manual. Setting   
  1818.                     this  option  to  "Only"  will  force  RA to 
  1819.                     permit IEMSI logons only.
  1820.  
  1821.        Pwd echo   : The  PWD ECHO allows  you  to  define  which   
  1822.                     character is echoed  back to  the  user when   
  1823.                     any password  is  entered. If  this  if left   
  1824.                     blank,  no  character is  echoed back to the   
  1825.                     user.
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.                                     27
  1832.        Auto ANSI  : When the  user  logs  on,  if AUTO  ANSI  is   
  1833.                     enabled RA will attempt to determine if  the   
  1834.                     calling terminal has ANSI  capabilities.  If   
  1835.                     it has, the file LOGO.ANS will be  displayed   
  1836.                     instead of LOGO.ASC.
  1837.  
  1838.        Pwd        : PWD TRIES sets the maximum number of invalid   
  1839.        tries        password  attempts at logon. After  this  is   
  1840.                     exceeded the user will be disconnected.
  1841.  
  1842.        Pwd        : PWD CHANGE is another security  feature.  If   
  1843.        change       this is set to any  non-zero value, then all   
  1844.                     users  (excluding the sysop)  will be forced   
  1845.                     to change their  password  every  number  of   
  1846.                     logons as determined by its value.
  1847.  
  1848.        Pwd        : PWD STRICT is an invaluable security feature   
  1849.        strict       which  if enabled, will check passwords that   
  1850.                     users  enter.   You  can   specify   certain   
  1851.                     undesirable passwords in a control file (see   
  1852.                     the  section  on  EXTERNAL FILES),  such  as   
  1853.                     "Secret" or "Test".  It  will also  disallow   
  1854.                     the user's  first or last name as a password   
  1855.                     and  checks the  old and  new  passwords for   
  1856.                     phonetic similarity. 
  1857.  
  1858.        Pwd        : You  may specify the minimum password length   
  1859.        length       that  users  may  select.  Longer  passwords   
  1860.                     mean  better   security,   a  value  of 4 is   
  1861.                     recommended  as  an  absolute minimum.
  1862.  
  1863.        Logon      : This option  specifies   how  much  time  to   
  1864.        time         grant to a user  before the system knows how   
  1865.                     much time he/she  is entitled to. You should   
  1866.                     make this long  enough to  enable a new user   
  1867.                     to  complete the   new  user  procedure  and   
  1868.                     questionnaire, if you  have one.
  1869.  
  1870.        User       : USER TIMEOUT determines  how  long  to  wait   
  1871.        timeout      during   periods   of   inactivity    before   
  1872.                     disconnecting.   The inactive time period is   
  1873.                     measured from the last character sent to the   
  1874.                     modem, and users are  given a  warning  that   
  1875.                     they  are  about to be disconnected  fifteen   
  1876.                     seconds  before   the  timer  expires.  This   
  1877.                     feature is automatically disabled  in  local   
  1878.                     mode, or by a setting of zero.
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.                                     28
  1893.        Watchdog   : If a  user  logs  on   and  is  disconnected   
  1894.        area         because   he/she   enters  his/her  password   
  1895.                     incorrectly,  RemoteAccess  can notify  that   
  1896.                     user of a possible attempt  at guessing  the   
  1897.                     password,  by  way of a private message.  In   
  1898.                     the WATCHDOG AREA field, specify the message   
  1899.                     area  number   (as   per   your   msg   area   
  1900.                     configuration)  that  the   warning  message   
  1901.                     should be  placed   in.  A  value   of  zero   
  1902.                     disables  this  feature.  In  addition,  you   
  1903.                     will need  to  create  an  ASCII  text  file   
  1904.                     called   " WATCHDOG.MSG "  in   the   system   
  1905.                     directory that contains the text of the  msg   
  1906.                     that is sent to the user.
  1907.  
  1908.  
  1909.  
  1910.        Sysop      : Before  a   user  is   disconnected,   after   
  1911.        area         incorrectly  entering  their  password, they   
  1912.                     are given the opportunity  to  enter  a  msg   
  1913.                     to the  sysop.  The SYSOP AREA defines which   
  1914.                     area the  msg is placed in. 
  1915.  
  1916.  
  1917.  
  1918.  
  1919.        PROMPTS  -  This menu allows you to define the global system
  1920.        prompts.  The  prompts in  this  section are  common  to all
  1921.        languages.
  1922.  
  1923.  
  1924.        Logon      : This is the  prompt that the  user will  see   
  1925.        prompt       when  prompted for his/her name at logon.
  1926.  
  1927.        Left &     : These define which characters RemoteAccess     
  1928.        Right        places around Yes/No and similar prompts.      
  1929.        brackets
  1930.                     For example - if the characters are "{" and    
  1931.                     "}", a Yes/No prompt would appear as:
  1932.  
  1933.                        {Y/n}?
  1934.  
  1935.        Language   : This prompt is displayed when RemoteAccess     
  1936.        prompt       asks the user to select a language.
  1937.  
  1938.        Language   : This prompt is displayed above the list of     
  1939.        header       available languages.
  1940.  
  1941.  
  1942.  
  1943.        PRINTER  -  In this  section  you  may define which  printer
  1944.        port you wish RemoteAccess to direct  output to  when  using
  1945.        the "-P" command-line parameter  or the  ALT-P key to enable
  1946.        log printing.   (See COMMAND-LINE PARAMETERS  and SYSOP KEYS
  1947.        for more  information  on printer  logging). {+}  Registered
  1948.        only.
  1949.  
  1950.  
  1951.  
  1952.  
  1953.                                     29
  1954.        RACONFIG  -  Modem
  1955.        ────────────────────────────────────────────────────────────
  1956.  
  1957.         
  1958.        OPTIONS    -   This  window  contains general  configuration
  1959.        information for your modem.
  1960.  
  1961.  
  1962.        Comport    : Set this to the communications port you have   
  1963.                     your modem hooked up  to.  Valid  ports  are
  1964.                     1-4. A setting  of 0  forces  RA  into local   
  1965.                     mode regardless of command-line parameters.
  1966.  
  1967.        Speed      : SPEED refers  to the highest  modem-computer   
  1968.                     speed your modem supports.  If you are using   
  1969.                     a high-speed modem you should lock the speed   
  1970.                     at the modem's maximum speed  to  ensure the   
  1971.                     highest possible  throughput.  Refer to your   
  1972.                     FOSSIL documentation on how to do this.
  1973.  
  1974.        Lock       : If  you  have  a  high-speed  modem which is   
  1975.                     capable  of  being  locked at a fixed speed,   
  1976.                     set this option to "Yes".
  1977.  
  1978.        Answer     : Setting this to "Yes" tells  RemoteAccess to   
  1979.                     make the modem answer the  phone whenever it   
  1980.                     receives  the ring  string  by   sending the   
  1981.                     answer command  to the modem (see COMMANDS).   
  1982.                     If it is set to "No" then it is assumed that   
  1983.                     the  modem  will  answer  the  phone itself.   
  1984.                     "Yes"  is   the  preferred  setting,  as  it   
  1985.                     ensures that your  BBS will  only answer the   
  1986.                     phone if it is "alive  and well". Otherwise,   
  1987.                     you  are likely to  upset  your  users  when   
  1988.                     they  waste  their  money  on   a  BBS  that   
  1989.                     answers the phone and then does nothing.
  1990.  
  1991.        Delay      : This refers  to a  delay,   in  tenths  of a   
  1992.                     second  that  RemoteAccess   waits   between   
  1993.                     sending  characters  to  the  modem   during   
  1994.                     initialisation.   Usually   you   will  only   
  1995.                     need to  raise this above  zero  if  you are   
  1996.                     using a high-speed modem that cannot  handle   
  1997.                     commands  at high speeds.  A typical example   
  1998.                     of  this is  the Courier HST, which requires   
  1999.                     a delay of about 3.
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.                                     30
  2015.        Buffer     : This field  sets the  size of  RemoteAccess'   
  2016.                     internal communications send buffer for baud   
  2017.                     rates  up to  2400.  You  can  change it  to   
  2018.                     fine-tune    your   system    for    maximum   
  2019.                     throughput.  If you are using a slow machine   
  2020.                     (ie.  a 4.77 MHz XT),  set it to zero.  This   
  2021.                     disables  the internal buffering  system and   
  2022.                     its  associated overhead.  For most systems,   
  2023.                     the  default setting  of  5  will  not  need   
  2024.                     to   be   changed.     In   a  multi-tasking   
  2025.                     environment  though, you  will  achieve much   
  2026.                     better performance by increasing  the buffer   
  2027.                     size.  Experimentation   has   shown  values   
  2028.                     around 80-150 to be most effective.
  2029.  
  2030.        Break      : Some modems (such as the Courier HST) can be   
  2031.                     configured to  clear their internal transmit   
  2032.                     buffer when they receive a break signal from   
  2033.                     the  local console.  If the  BREAK option is   
  2034.                     enabled,  RemoteAccess  will  send  a  break   
  2035.                     whenever   it  purges  it's   own   internal   
  2036.                     transmit  buffer.   The  result  will  be  a   
  2037.                     faster  hotkey response. Since  most  modems   
  2038.                     CANNOT  handle this, the recommended setting
  2039.                     is OFF.
  2040.  
  2041.        Tries      : This is  the number  of  times  RemoteAccess   
  2042.                     will attempt to initialise  the modem before   
  2043.                     aborting and returning an  error  condition.
  2044.  
  2045.        Offhook    : If enabled,  this will force RemoteAccess to   
  2046.                     take  the modem  off-hook  when  a  call  is   
  2047.                     terminated.
  2048.  
  2049.  
  2050.        COMMANDS  -  This submenu is where the commands that are    
  2051.        sent to the modem are defined.
  2052.  
  2053.        Init1 &    : These fields define in the  strings sent  to   
  2054.        Init2        the  modem,  whenever  RemoteAccess is fired   
  2055.                     up,  in order  to prepare  the modem to take   
  2056.                     calls.  See  the  reference   section  MODEM   
  2057.                     STRING  TRANSLATION  at   the  end  of  this   
  2058.                     document  for  more information.
  2059.  
  2060.        Busy       : The   BUSY  string  is   sent  to  the modem   
  2061.                     whenever you either log-on locally,  drop to   
  2062.                     DOS  or if you  ESCape from  the  "wait  for   
  2063.                     call" sequence.  You could either  tell  the   
  2064.                     modem  to  go "off hook" with an "ATH1|", or   
  2065.                     simply not to answer the phone  by  dropping   
  2066.                     DTR.   Note :  in  some  countries   it   is   
  2067.                     prohibited to  place a telephone  line  "off   
  2068.                     hook",  please check with your phone company   
  2069.                     if you are unsure.
  2070.         
  2071.  
  2072.  
  2073.  
  2074.  
  2075.                                     31
  2076.        Answer     : The ANSWER string is  sent  to the  modem if   
  2077.                     you have set  automatic  answer  on,  and  a   
  2078.                     call comes in.   Most  modems will answer  a   
  2079.                     call  upon  receiving  an  "ATA|"  from  the   
  2080.                     computer.
  2081.  
  2082.  
  2083.        RESPONSES  -  The responses section is  where you  can  tell
  2084.        RemoteAccess what  responses it  can expect to  receive from
  2085.        your modem. 
  2086.  
  2087.        Init       : The INIT  response is  the  string that  the   
  2088.                     modem  returns  after  RemoteAccess sends it   
  2089.                     the init  string.   Most modems return "OK".   
  2090.  
  2091.        Busy       : The BUSY  response  is  the  string that the   
  2092.                     modem returns after  the  busy  command  has   
  2093.                     been sent to  place  the  modem  "Off hook",   
  2094.                     most modems return  "OK".  Check  your modem   
  2095.                     operating manual for more information.
  2096.  
  2097.        Ring       : The  RING response  is the  string the modem   
  2098.                     displays  when  someone  calls  your system,   
  2099.                     to   indicate   that  the  call   should  be   
  2100.                     answered.   Most  modems return "RING", some   
  2101.                     use  "RINGING".   Check  your  modem  manual   
  2102.                     and set this accordingly.
  2103.  
  2104.        Secure     : The SECURE  response  is  the response  your   
  2105.                     modem   returns   when   it   gets  an   MNP   
  2106.                     connection.   Ignore   this  entry  if  your   
  2107.                     modem doesn't support MNP.  Check your modem   
  2108.                     manual to determine  what string  your modem   
  2109.                     returns.
  2110.  
  2111.        300 -      : 300 - 38400  are  the  response  strings the   
  2112.        38400        modem returns when a connection is made with   
  2113.                     another  modem.    Most   modems   return  a   
  2114.                     "CONNECT  <Baudrate> "  string,  or   simply   
  2115.                     "CONNECT"  for 300 baud.  Note that  if this   
  2116.                     is the case  you should specify the vertical   
  2117.                     bar  after the string to indicate the end of   
  2118.                     the string.  (See  MODEM STRING  TRANSLATION   
  2119.                     in the reference guide  at the  end of  this   
  2120.                     document).
  2121.  
  2122.         
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.                                     32
  2137.        RACONFIG  -  Manager
  2138.        ────────────────────────────────────────────────────────────
  2139.  
  2140.        This is   perhaps  the most important part  of  RACONFIG. It
  2141.        is where all  the message and file  areas, protocols, menus,
  2142.        users and events are defined.   
  2143.               
  2144.              
  2145.        MESSAGES  -  From the  messages menu  you may  define  up to
  2146.        200 different  areas,  each  with it's  own  attributes  and
  2147.        security requirements.
  2148.  
  2149.        Name       : In this field you can give each message area   
  2150.                     a name.  This   should   be   a   meaningful   
  2151.                     description of  its  content,   for  example   
  2152.                     "IBM  Users", "Cooking",  or "Games".  Avoid   
  2153.                     using  names  like "Message Area 1".  If you   
  2154.                     wish to "delete" a message area,  simply set   
  2155.                     the area name to nothing.
  2156.  
  2157.        Type       : Each area can be one of three TYPES.  LOCAL,   
  2158.                     if the message area is available on your BBS   
  2159.                     only,  or if you are in a mail  network such   
  2160.                     as  FidoNet,  ECHOMAIL  or  NETMAIL.   These   
  2161.                     latter  two  types  are explained more fully   
  2162.                     in the MAIL  NETWORKING  section. If you are   
  2163.                     not  part of  a  mail  network, set the type   
  2164.                     to LOCAL. 
  2165.                                 
  2166.                     When a user  posts a  message in  a  message   
  2167.                     area which has  the type LOCAL assigned, the   
  2168.                     recipient  must be  an  existing user of the   
  2169.                     system.  If RemoteAccess  can  not  find the   
  2170.                     recipient's  name in  the  user database the   
  2171.                     user will  be asked if he/she would  like to   
  2172.                     search/list  the user database.   The   only   
  2173.                     exception  to  this  is a message  posted to
  2174.                     "All".
  2175.  
  2176.        Status     : This controls  the types  of  messages  that   
  2177.                     users are  allowed to post in the area.  You   
  2178.                     have the  choice   of  PRIVATE ONLY,  PUBLIC   
  2179.                     ONLY,  PRIVATE/PUBLIC and READ ONLY.  It may   
  2180.                     be  desirable to allow only public  messages   
  2181.                     in  general  discussion  areas,  or likewise   
  2182.                     private only in user-to-user  message  areas   
  2183.                     to ensure that all messages in that area may   
  2184.                     be read only by  the sender or the recipient   
  2185.                     of the message.    Message  areas  marked as   
  2186.                     READ ONLY may only  have messages posted  in   
  2187.                     them by the sysop.  This is useful for,  say   
  2188.                     a general announcement area.
  2189.         
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.                                     33
  2198.        Users      : Each message area  may be configured via the   
  2199.                     USERS  option,  to  allow   users  to   post   
  2200.                     messages with real names only,  handles only   
  2201.                     (this is the user's  permanent  "registered"   
  2202.                     handle),  or with an  alias  which the  user   
  2203.                     may  select  at  the time   the  message  is   
  2204.                     posted. RemoteAccess will  not allow the use   
  2205.                     of the alias "Sysop" or any other users name   
  2206.                     or handle.
  2207.  
  2208.        Days old   : This defines  how long  RemoteAccess  should   
  2209.                     keep  old messages. The  removal of messages   
  2210.                     which  are older than the number of days set
  2211.                     is  performed  by  RAMSG,  the  message-base   
  2212.                     maintenance utility  (see  MESSAGE  DATABASE   
  2213.                     FILES for more information).
  2214.  
  2215.        Days rcvd  : This defines how  long  RemoteAccess  should   
  2216.                     keep messages  that  have been  read by  the   
  2217.                     addressee.   As with the previous field, the   
  2218.                     removal of these  messages  is  performed by   
  2219.                     RAMSG (see MESSAGE DATABASE FILES).         
  2220.  
  2221.        Max msgs   : This defines how many  messages RemoteAccess   
  2222.                     will allow to  be kept  in each area,  after   
  2223.                     this  limit  has  been  reached  RAMSG  will   
  2224.                     remove the  oldest messages  and maintain  a   
  2225.                     constant  number of  messages  equal  to the   
  2226.                     number  specified.   (see  MESSAGE  DATABASE   
  2227.                     FILES)
  2228.  
  2229.        Echoinfo   : The  default action  for an EchoMail message   
  2230.                     area is to append  an  origin  line (see the   
  2231.                     section on MAIL NETWORKING for more on this)   
  2232.                     to  each  outgoing  message.   This  may  be   
  2233.                     disabled by  setting  the  ECHOINFO  flag to   
  2234.                     "No".
  2235.  
  2236.        Combined   : The  COMBINED  flag determines whether users   
  2237.                     may select the current message area  as part   
  2238.                     of their combined message area settings.
  2239.  
  2240.        Attaches   : RemoteAccess provides an extremely  powerful   
  2241.                     facility which  allows users  to  attach one   
  2242.                     or more files to a message.  This means that   
  2243.                     users can send  each other files  privately.   
  2244.                     To  enable  this  option,  set  ATTACHES  to   
  2245.                     "Yes". Also ensure that the FILE ATTACH path   
  2246.                     in the  SYSTEM/PATHS  submenu  points  to  a   
  2247.                     directory which exists.  When a user uploads   
  2248.                     files with a message,  RemoteAccess  creates   
  2249.                     a   uniquely  named  subdirectory  in   this   
  2250.                     directory, and places all the attached files   
  2251.                     in it.  After the recipient has received the   
  2252.                     message and  confirmed that he/she  received   
  2253.                     all   the  files,  all  the  files  and  the   
  2254.                     directory are  deleted. This option is valid   
  2255.                     only in areas defined as LOCAL.
  2256.  
  2257.  
  2258.                                     34
  2259.                     If the  user  elects to attach  a file  to a   
  2260.                     message  when  logged  onto  a  local  node,   
  2261.                     RemoteAccess will prompt him/her for the DOS   
  2262.                     path and filename of the file  they  wish to   
  2263.                     send.   {+} Registered only.
  2264.  
  2265.        SoftCRs    : This option,  if on,  will tell RA to  treat   
  2266.                     SoftCR  characters ($8D),  in  this  message   
  2267.                     area, as  normal printable characters.
  2268.  
  2269.        Deletes    : This, if enabled, will allow users to delete   
  2270.                     messages in this message  area provided  the   
  2271.                     message is either to or from the user.
  2272.  
  2273.        AKA        : This  option  allows  you to  specify  which   
  2274.                     network  address  you wish  to use for  this   
  2275.                     message area.   If  you only  have one or no   
  2276.                     network address  then you  need not  concern   
  2277.                     yourself with  this option.   You may select   
  2278.                     any  of the  AKAs you  have  defined  in the   
  2279.                     SYSTEM/ADDRESS   menu (see  MAIL  NETWORKING   
  2280.                     for more information).
  2281.  
  2282.        Origin     : This option  allows you to define a separate   
  2283.                     origin line to the message area. This origin   
  2284.                     is appended to  the bottom  of all  outgoing   
  2285.                     EchoMail messages.  If  this  is left  blank   
  2286.                     RemoteAccess will append the default  origin   
  2287.                     line specified in OPTIONS/MESSAGES submenu.
  2288.  
  2289.  
  2290.        Access to the message area is controlled by READ,  WRITE and
  2291.        SYSOP security  levels  and access  flags.  Full information
  2292.        on  security  levels and flags  can be found in the SECURITY
  2293.        section.
  2294.  
  2295.  
  2296.        Read       : This is the minimum  security level and flag   
  2297.        Security     combination the user  needs to be allowed to   
  2298.                     read messages in each message area.
  2299.  
  2300.        Write      : This is the minimum  security level and flag   
  2301.        Security     combination the  user needs to be allowed to   
  2302.                     post a message.  When replying to a  message   
  2303.                     addressed   to  the  user,  he/she  is  only   
  2304.                     permitted if the user's  security  level  is   
  2305.                     equal  to or higher  than the Write Security   
  2306.                     setting.
  2307.  
  2308.        Sysop      : This  security  access  combination  permits   
  2309.        security     reading  of all messages in the area,   even   
  2310.                     if   they  are  private  and  addressed   to   
  2311.                     another  user.  This is useful  for  message   
  2312.                     areas  which  are  run by  assistant  sysops   
  2313.                     and the like, so they can check messages for   
  2314.                     suitable content and  delete off-topic ones.
  2315.  
  2316.  
  2317.  
  2318.  
  2319.                                     35
  2320.        FILES  -  The FILE submenu is  where  you define  your  file
  2321.        areas.  Full information on  security  levels and flags  can
  2322.        be found in the SECURITY section.
  2323.  
  2324.  
  2325.        Name       : NAME is the  name of  the file  area as  the   
  2326.                     user will  see it. 
  2327.  
  2328.        Path       : The PATH is a fully qualified directory path   
  2329.                     that points to where the files in  this area   
  2330.                     are stored, for example C:\FILES\IBM\GAMES\.   
  2331.                     Note   that   the   trailing  backslash   is   
  2332.                     optional.
  2333.  
  2334.        New files  : This  option  determines  whether to include 
  2335.                     this file  area in a new files scan, and may 
  2336.                     be  overridden   by  the  use  of   optional 
  2337.                     parameters when  using  the "new files" menu   
  2338.                     command.   (see   MENU  COMMANDS   for  more   
  2339.                     information.) 
  2340.  
  2341.        Upload     : When a user uploads a file, RemoteAccess has   
  2342.        dupes        the  capability   to  search  for  the  file   
  2343.                     before  allowing  the user  to upload it. If   
  2344.                     this  option is  disabled, RemoteAccess will 
  2345.                     not scan this area for dupes.
  2346.  
  2347.        Long       : If you would like  to have long descriptions   
  2348.        desc         for  your  files,  ie.  more than one screen
  2349.                     line, then  you  should enable the LONG DESC   
  2350.                     option. This enables RemoteAccess to  handle   
  2351.                     the  descriptions  correctly.  When  editing
  2352.                     your FILES.BBS  file it is not  necessary to   
  2353.                     put a [CR] in  the  description  as the text   
  2354.                     will be wrapped when displayed. 
  2355.  
  2356.                     NOTE:   To  enable  long   descriptions  for   
  2357.                     uploads  in which  the full  upload  path is   
  2358.                     specified in the optional data field  rather   
  2359.                     than  a template  area  number, append  a /L   
  2360.                     after the upload path.
  2361.  
  2362.        Access  to the file areas is controlled in a similar fashion
  2363.        to that  of  the message  areas,  by  the DL,  LIST  and  UL
  2364.        security levels and access flags.
  2365.  
  2366.  
  2367.        DL         : This  determines the minimum security  level   
  2368.        security     and  flag  combination at  which a user  can   
  2369.                     download files from this area.
  2370.                
  2371.        List       : This determines the  minimum security  level   
  2372.        security     and flag  combination  at which  a  user can   
  2373.                     list the files in this area. 
  2374.  
  2375.        UL         : This determines  the minimum  security level   
  2376.        security     and  flag  combination  at which  a user can 
  2377.                     upload files into the area. 
  2378.  
  2379.  
  2380.                                     36
  2381.        The list  of files that your users see for a particular area
  2382.        is  generated from a textfile that you can edit yourself. By
  2383.        default, this file is called FILES.BBS and is located in the
  2384.        same directory as  the files  it describes. When  a file  is
  2385.        uploaded  to  a  file   area,  RemoteAccess  creates  a  new
  2386.        FILES.BBS  if it doesn't  already exist, and  then appends a
  2387.        single line entry for  the file. The format of  FILES.BBS is
  2388.        simple:
  2389.  
  2390.               <FILENAME.EXT> <Description>
  2391.  
  2392.        Filenames that  contain wildcard / pattern  match characters
  2393.        are expanded  to full  filename specs.  A separate entry  is
  2394.        displayed for each matching file found.
  2395.  
  2396.        The <Description> field  may be up  to 255 characters  long.
  2397.        When displayed to the  user the description is automatically
  2398.        word wrapped to the width of the user's screen.
  2399.  
  2400.        If  you have  some  kind of  read-only  mass storage  device
  2401.        online such as a  CD-ROM, then it usually isn't  possible to
  2402.        have  a FILES.BBS in each file directory. To get around this
  2403.        problem simply  create a separate  directory to hold  all of
  2404.        the FILES.BBS  files. The  individual files should  be named
  2405.        FILES.n, where n is the file area number. For example -
  2406.  
  2407.        C:\RA\CDROMLST\FILES.33
  2408.  
  2409.        Is the  file that  would be read  in place of  FILES.BBS for
  2410.        area number 33. In this example,  the FILE LIST path (in the
  2411.        PATHS section of RACONFIG) has been set to C:\RA\CDROMLST.  
  2412.  
  2413.        The   EXTERNAL SUPPORT FILES   section  contains information
  2414.        on  marking files as  free and/or  password  protected under
  2415.        the subheading FILES.CTL.
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.                                     37
  2442.        PROTOCOLS  -  The   protocols   section   deals   with   the
  2443.        different  transfer  methods  used  by RemoteAccess  to send
  2444.        and receive files.  This section  also allows  you to define
  2445.        any new transfer protocols that you wish to add.
  2446.  
  2447.        The INTERNAL PROTOCOLS   submenu  allows  you  to   disable,
  2448.        enable, or  make available only  on an error-free  (ie. MNP)
  2449.        connect, any of the six internal protocols.    MNP (Microcom
  2450.        Networking Protocol),  also known  as ARQ (Automatic  Repeat
  2451.        Request),   is  a  method  by   which  modems   can   detect
  2452.        transmission errors  and  resend  the incorrect  data.  Only
  2453.        modems which both  have MNP  facilities can use this type of
  2454.        error correction.   Since, when using MNP,  error correction
  2455.        is carried out by the modem hardware,  the software does not
  2456.        need to watch the incoming  data for errors  or wait for the
  2457.        receiving modem to confirm that it has received all the data
  2458.        correctly.   Some protocols are  written especially  for MNP
  2459.        modems and  therefore get  very fast  throughput. If you use
  2460.        such a protocol  you should  set it for "error free" connect
  2461.        only.    An  example  of such  a  protocol  in  the internal
  2462.        protocol list is "Ymodem-G".     
  2463.  
  2464.        When  using  an "error  free"  protocol,  RemoteAccess  will
  2465.        establish whether the user is using an MNP modem by  looking
  2466.        at  the  modem  connection string  to see if  it contains an
  2467.        errorfree response code. This code is definable in RACONFIG.
  2468.        {+} Available in the registered version only.
  2469.  
  2470.  
  2471.        The EXTERNAL PROTOCOLS submenu.   This option allows you  to
  2472.        interface  up  to  fifteen  external   protocols  for   your
  2473.        users to  use,  in addition   to the six that are  built-in.
  2474.             
  2475.        Name       : The  NAME  field  is  the  protocol name  as   
  2476.                     it  will be  displayed to the user when they   
  2477.                     download or  upload.   Note if  you  use the   
  2478.                     textfile XFERPROT.A??  to override the  hard   
  2479.                     coded protocol selection menu then this name   
  2480.                     will not be displayed to the user.
  2481.  
  2482.        Key        : The KEY is the keypress that should activate   
  2483.                     the  protocol.  Note  that  the  KEY must be   
  2484.                     unique. In other words, since [Z]modem is an   
  2485.                     internal  protocol,  you  can't  use [Z]  to   
  2486.                     activate an external protocol.
  2487.  
  2488.        Ext ctl    : Before RemoteAccess  activates the  external   
  2489.        file         protocol,  it   creates  a control file that   
  2490.                     tells the protocol which  files to  send  or   
  2491.                     receive.  This file consists of some general   
  2492.                     information  and a  list of  files,  one per   
  2493.                     line.  You  may  define  exactly  what  each   
  2494.                     line  looks  like.  If  you  select  EXT CTL   
  2495.                     FILE,  then   RemoteAccess  will  write  the   
  2496.                     information   needed   by    Opus-compatible   
  2497.                     external protocols at  the  beginning of the   
  2498.                     file before  the file list.   Check the docs   
  2499.                     for each protocol you  install to  determine   
  2500.                     whether it is "Opus compatible".             
  2501.  
  2502.                                     38
  2503.        Batch      : If  the protocol has  the capability to send   
  2504.                     or receive more than one file at a time, set   
  2505.                     BATCH to "Yes".
  2506.  
  2507.        Status     : You may  temporarily  disable  the   current   
  2508.                     protocol   by   setting   its   status    to   
  2509.                     NOT-AVAILABLE,   re-enabling   it  later  by   
  2510.                     setting it  to  ALWAYS  AVAILABLE.   If  you   
  2511.                     wish to restrict  a protocol's  use to users   
  2512.                     who have connected using an error correcting   
  2513.                     modem then change the status to  ERROR FREE.   
  2514.                     This option  is particularly  useful  if you   
  2515.                     use protocols  such as "YModem-G" which  are   
  2516.                     specifically designed  for error  correcting   
  2517.                     modems.    (See  the  section  on   internal   
  2518.                     protocols  for a full explanation  of "Error   
  2519.                     Free" connections and MNP).
  2520.  
  2521.        Log file   : The LOG FILE is the  full path  and  name of   
  2522.                     the log  file  that  the  external  protocol   
  2523.                     writes. This file contains information about   
  2524.                     what files were  actually sent  or received.   
  2525.                     Without this information,  RemoteAccess will   
  2526.                     not  be able  to  update the  user's record.   
  2527.                     Most protocols  have the facility to  create   
  2528.                     a log of the files  that were actually  sent   
  2529.                     or  received;  if  the   protocol  you   are   
  2530.                     installing doesn't, it  is  advisable not to   
  2531.                     use it.
  2532.  
  2533.        Control    : The  CONTROL FILE is the full path and  name   
  2534.        file         of   the  control  file  that   RemoteAccess   
  2535.                     creates before activating the  protocol.  In   
  2536.                     order to allow the use of as  many different   
  2537.                     protocols as possible, you have full control   
  2538.                     over the format of  this file.
  2539.                 
  2540.        DL/UL      : DL/UL COMMAND LINE  tells RemoteAccess  what   
  2541.        command      program  name  to   execute   in  order   to   
  2542.        lines        activate   the   external  protocol.  It  is   
  2543.                     possible  to   insert  variables   into  the   
  2544.                     command   line    using    special   control   
  2545.                     characters.  For example, the string:
  2546.  
  2547.                            PROTNAME.EXE Send *B
  2548.  
  2549.                     would be expanded to:
  2550.  
  2551.                            PROTNAME.EXE Send 2400
  2552.  
  2553.                     For  a  full  list of special control codes,   
  2554.                     refer  to  the description  of a Type 7 menu   
  2555.                     command in the  MENU  COMMANDS  section.  In   
  2556.                     addition to these codes, the # symbol can be   
  2557.                     used  if the  filename  to  send or  receive   
  2558.                     needs to be specified on the command line.
  2559.  
  2560.  
  2561.  
  2562.  
  2563.                                     39
  2564.        DL ctl     : The DL CTL  STRING  determines  the   format   
  2565.        string       of  each file entry.  Inserting a "@" in the   
  2566.                     string  substitutes that  position  with the   
  2567.                     file name.  For  example, if you  wanted  to   
  2568.                     download  the  file  C:\FILES\FUN\CASINO.ZIP   
  2569.                     using an  Opus type  external  protocol, you   
  2570.                     would set the control file string to:
  2571.  
  2572.                           Send @
  2573.  
  2574.                     When the control file is created, this would   
  2575.                     be expanded to:
  2576.  
  2577.                           Send C:\FILES\IBM\FUN\CASINO.ZIP
  2578.  
  2579.                     If the user were to select a batch download,   
  2580.                     say  RA*.ARJ, the  wildcard/pattern match is   
  2581.                     expanded to a full list  of fully  qualified   
  2582.                     path and file names.
  2583.  
  2584.        UL ctl     : The  UL CTL STRING works in exactly the same   
  2585.        string       way as the DL CTL STRING, except  that   for   
  2586.                     batch uploads,  instead of  specifying   the   
  2587.                     full  file name,  it  substitutes  just  the   
  2588.                     path   to  the  upload  directory,   as  the   
  2589.                     filenames are not known prior to the upload.
  2590.  
  2591.        DL/UL      : When  the external protocol has finished and   
  2592.        log          control  is  returned  to RemoteAccess,  the   
  2593.        keyword      log file  that  was  created  is  scanned to   
  2594.                     extract  information about  what  files were   
  2595.                     sent or received.  RemoteAccess  scans   the   
  2596.                     file for the  UP or DL LOG KEYWORD.  As soon   
  2597.                     as it finds that word, it will scan  forward   
  2598.                     x number of  words to  get the  name  of the   
  2599.                     file  transferred   and  a  description,  if   
  2600.                     available.  To  illustrate  how this  works,   
  2601.                     look at this extract from a BiModem log:
  2602.  
  2603.                       = 10 Sep 14:10:10 BMOD DL-B \GRAPH\VGA.ZIP   
  2604.                       = 10 Sep 14:12:22 BMOD DL-B \GRAPH\MAP.ZIP
  2605.  
  2606.                     The DL/UL LOG KEYWORD can be any word in the   
  2607.                     log  file  that  indicates the transfer of a   
  2608.                     single file.  The  keyword  in  the  example   
  2609.                     above should be set to "DL-B".
  2610.  
  2611.        Log name   : This  option determines  how  many  words RA   
  2612.        word 1       scans after it finds  the UL/DL LOG KEYWORD,   
  2613.                     to find the file name that  was uploaded  or   
  2614.                     downloaded.  In the previous example the LOG   
  2615.                     NAME WORD 1 should be  set to "1", as RA has   
  2616.                     to scan ahead 1 word  after  finding  "DL-B"   
  2617.                     to obtain the downloaded file name.
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.                                     40
  2625.        Log desc   : When a user uploads,  RA can  also  obtain a   
  2626.        word 2       description   from  the  log  file   if  the   
  2627.                     protocol used supports description  logging,   
  2628.                     and write it directly to  the  FILES.BBS. To   
  2629.                     achieve this you can set the LOG DESC WORD 2   
  2630.                     to the number of words RA has to scan  after 
  2631.                     it finds the  UL/DL  LOG  KEYWORD.  If   the   
  2632.                     protocol doesn't support description logging   
  2633.                     or RA cannot find a description, the user is   
  2634.                     prompted for the description.
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.                                     41
  2686.        Example : Installing Lynx as an external protocol
  2687.        -------------------------------------------------
  2688.  
  2689.        Select  an  empty  protocol slot,  and enter  the  following
  2690.        information:
  2691.  
  2692.         Name                  : Lynx
  2693.         Key                   : L
  2694.         Extended control file : No
  2695.         Batch available       : Yes
  2696.         Status                : Enabled
  2697.         Log file name         : C:\Ra\Dszlog.Txt
  2698.         Control file name     : C:\Ra\Lynx.Ctl
  2699.         Download command line : Lynx.Exe S /*P /*B /S /H @Lynx.Ctl 
  2700.         Upload command line   : Lynx.Exe R /*P /*B /S /D /H #      
  2701.         Download ctl string   : @
  2702.         Upload ctl string     :
  2703.         Download log keyword  : x
  2704.         Upload log keyword    : X
  2705.         Log : Name word #     : 10
  2706.         Log : Desc word #     : 0
  2707.  
  2708.        (Note  the  case  of  the upload and  download  log  keyword
  2709.         entries).
  2710.  
  2711.        The  above  example assumes that your  system  directory  is
  2712.        C:\RA.  To complete the installation, you'll need to set the
  2713.        DSZLOG environment variable to the full path and name of the
  2714.        log file that Lynx writes:
  2715.  
  2716.                    SET DSZLOG=C:\Ra\Dszlog.Txt
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.                                     42
  2747.        LANGUAGES  -  RemoteAccess   contains   full   support   for
  2748.        multiple languages.  This means that you can have  different
  2749.        prompts,  textfiles and menus for any language. This version
  2750.        of RemoteAccess supports up  to eight  languages, while  the
  2751.        professional version supports a maximum of one hundred.
  2752.  
  2753.  
  2754.        Selecting the LANGUAGES option  displays a list of all   the
  2755.        installed   languages.   To  edit  one  of   the   currently
  2756.        installed  languages   position the cursor bar   over it and
  2757.        press ENTER.  If   you  wish to  generate   a  new  language
  2758.        file, position the  cursor over   a blank  entry and   press
  2759.        ENTER.         
  2760.  
  2761.        Name       : This field holds the name for the  language,   
  2762.                     this is  the name which will be displayed to   
  2763.                     users  when  they  are  asked  to  select  a   
  2764.                     language.  It is important  that you use the   
  2765.                     spelling of the language which would be used 
  2766.                     by people who speak the language.
  2767.  
  2768.        Available  : If you do  not  wish  to  make  the language   
  2769.                     available  set  the  AVAILABLE option to NO.   
  2770.         
  2771.        Language   : This is where you can edit all the  prompts.   
  2772.                     There   are   approximately  500   different   
  2773.                     prompts, all of which can be changed to suit   
  2774.                     your  needs.  To  use the  editor  place the   
  2775.                     highlight  bar over  the  text you  wish  to   
  2776.                     change,  press  ENTER and then enter the new   
  2777.                     text. At the top  of  the  editor screen the   
  2778.                     default   English   text  appears  for   the   
  2779.                     currently  selected prompt. You may  include   
  2780.                     any  textfile  control  characters in any of   
  2781.                     the prompts (see the section on TEXT CONTROL   
  2782.                     CHARACTERS for further information).
  2783.  
  2784.                     When editing the  prompts the following keys
  2785.                     can be used to assist:
  2786.  
  2787.                     [ALT-C] - To  change  the  prompt's  default   
  2788.                               colour. If set to  black on black,   
  2789.                               RA  will display the prompt in the   
  2790.                               internally hard-coded colour.
  2791.  
  2792.                     [ALT-D] - To  copy   the  default  into  the   
  2793.                               current prompt.
  2794.  
  2795.                     [ALT-I] - Display / edit  the  "info"  field. 
  2796.                               This  usually  contains information  
  2797.                               about the revision level and author  
  2798.                               of the language file being edited.
  2799.  
  2800.                     [ALT-S] - To search for an entry.
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.                                     43
  2808.        You  can  run the  language  editor directly without  having
  2809.        to  go  through  the  RACONFIG  menus  by   using  the  "-L"
  2810.        parameter  on  the   RACONFIG  command  line,   for  example
  2811.        "RACONFIG -L"  (See the section on  COMMAND-LINE  PARAMETERS
  2812.        for further information).
  2813.  
  2814.  
  2815.                     Editing the languages  is a   simple process   
  2816.                     however there  are  a number  of pitfalls to   
  2817.                     watch out for :
  2818.  
  2819.                     * You will  notice that some prompts (marked   
  2820.                       with an asterisk before the prompt number)   
  2821.                       require  you  to  enter  the keys that are   
  2822.                       used to activate the options to which that   
  2823.                       prompt refers. Make sure you maintain  the   
  2824.                       correct  order  of the keys, and that they   
  2825.                       match your new text.                
  2826.  
  2827.                     * Some  prompts are the headers  for listing   
  2828.                       functions,  like  today's  callers,  who's   
  2829.                       online  etc; you'll  see  that  these have   
  2830.                       obvious spacing  built in,  which  must be   
  2831.                       maintained if you change  any part  of the   
  2832.                       text.
  2833.  
  2834.                     * If   you're  translating  the  text   into   
  2835.                       another  language, there  are two rules of   
  2836.                       thumb:
  2837.                     
  2838.                         1. Translate all  text as  literally  as   
  2839.                            possible,
  2840.  
  2841.                         2. Try to use "generic" words and 
  2842.                            phrases.
  2843.          
  2844.                       For example,  RA uses the same  prompt for   
  2845.                       the "Access denied!"  message if the  user   
  2846.                       gets his  password  wrong at  logon  as it   
  2847.                       does  when  a  user  tries  to  access   a   
  2848.                       passworded  menu and fails - therefore you   
  2849.                       wouldn't want   to change  the  string  to   
  2850.                       "Access denied, logging you off".  Anyway,   
  2851.                       you  get the idea.    
  2852.  
  2853.  
  2854.        Menu path  : Each  language can  have  it's  own  set  of   
  2855.                     menus. With this option you  can  define the   
  2856.                     paths   to  the   menus  for   each specific   
  2857.                     language.
  2858.  
  2859.        Text path  : Each  language can also have it's own set of   
  2860.                     textfiles. With this option you  can  define   
  2861.                     the paths to the textfiles for each specific   
  2862.                     language.
  2863.         
  2864.        Ques path  : In this field you may enter the  path to the   
  2865.                     directory where the questionnaire  files are   
  2866.                     stored for each individual language.
  2867.  
  2868.                                     44
  2869.        Filename   : This option allows you to give your language   
  2870.                     a  filename to  be stored in. Enter the path 
  2871.                     and  filename  in  this  field.  It  is  not   
  2872.                     necessary  to  enter  an  extension  for the   
  2873.                     filename as the extension .RAL will be added 
  2874.                     automatically.
  2875.  
  2876.  
  2877.        ALT-Fn KEYS  -  When one of the  ten function  keys  on your
  2878.        keyboard  is  pressed  in  conjunction   with  the  ALT key,
  2879.        RemoteAccess will do one  of three things : If  the  command
  2880.        string that  you  have assigned to the  function key that is
  2881.        pressed is a standard DOS  command  line,   then  that  line
  2882.        will be executed in a  shell  while RemoteAccess  remains in
  2883.        memory.   If,  on  the  other hand, the first   character of
  2884.        the command  string for  the  function   key  is  the  query
  2885.        symbol (?) followed by  a number,  RemoteAccess will exit to
  2886.        DOS with an errorlevel  equal to the number.  Alternatively,
  2887.        if  the first character of the  command string is  the  hash
  2888.        (#),  RemoteAccess will display the named text file from the
  2889.        textfile  directory.  For example,  suppose  three   entries
  2890.        looked like this:
  2891.  
  2892.                    5 : ?110
  2893.                    6 : C:\COMMAND.COM
  2894.                    7 : #WELCOME
  2895.  
  2896.        Pressing ALT-F5 would cause RemoteAccess to exit to DOS with
  2897.        an   errorlevel  of  110, ALT-F6  would execute a  copy   of
  2898.        COMMAND.COM  in  a  shell,  and  ALT-F7  would  display  the
  2899.        appropriate  (ASC/ANS/AVT)  version  of   your   WELCOME.A??
  2900.        file to the user.
  2901.  
  2902.  
  2903.  
  2904.        EVENTS  -  The  RemoteAccess  Event Editor allows you to set
  2905.        pre-determined times  during the week when RemoteAccess will
  2906.        automatically  exit to your batch file and  perform  certain
  2907.        functions,  usually some kind of system maintenance. You may
  2908.        define up to 20 events to run  at  any  time during the day.
  2909.        In addition to this,  it is  also  possible  to specify that
  2910.        an event only run on a  particular  day or days of the week.
  2911.  
  2912.        To  modify  an event,  simply move the highlight bar to  the
  2913.        event you wish to alter, and press [CR]. Use the cursor keys
  2914.        to move between entries in the event edit window,  and enter
  2915.        the time you want the event to start at,  in 24 hour format.
  2916.  
  2917.        Next,  enter  the errorlevel;  when the event is  activated,
  2918.        RemoteAccess  will exit to the batch file from which it  was
  2919.        called at this errorlevel.  Your batch file should trap this
  2920.        errorlevel and act accordingly. In this window, you can also
  2921.        specify  what days you would like the event to run  on,  and
  2922.        whether  the  event is  enabled or  disabled.   If  a user's
  2923.        upload or download  overruns an event  which is FORCED  then
  2924.        the transfer  will be aborted  and the user  disconnected to
  2925.        ensure  that  the  event  runs  at  the  proper  time.  More
  2926.        information  on trapping  events is  contained in  the BATCH
  2927.        FILES section.
  2928.  
  2929.                                     45
  2930.        MENUS   -   This   option   activates the  RemoteAccess menu
  2931.        manager. For   full details  on setting   up menus and  menu
  2932.        types please refer to the MENU section of  this manual.
  2933.  
  2934.  
  2935.        USERS   -    This  is where  you  add,  delete,  modify  and
  2936.        otherwise maintain your user database. Full details  can  be
  2937.        found   on the user editor  further on in the   manual under
  2938.        the  section  THE USER DATABASE.  
  2939.  
  2940.  
  2941.        CTL FILES  -  This option allows you to edit all the  *.CTL 
  2942.        files in addition to any other ASCII textfile, for example a
  2943.        FILES.BBS list.
  2944.  
  2945.            VIP        :  Very Important Persons list.
  2946.            TRASHCAN   :  Disallowed users list.
  2947.            NODECOST   :  Nodelist costing file.
  2948.            FILES      :  Passworded and free file list.            
  2949.            BADFILES   :  Disallowed files for upload.
  2950.            HANDLES    :  Disallowed handles.
  2951.            PHONENUM   :  Disallowed phone number masks.
  2952.            LIMITS     :  Time and file transfer restrictions.      
  2953.            PWDTRASH   :  Disallowed passwords.
  2954.            NAMES      :  User name macros.
  2955.            Other      :  Any other textfile.  (User selectable)
  2956.  
  2957.  
  2958.  
  2959.        COMBINED    -    This option  allows  you to  specify  which
  2960.        message  areas  will  by  default be  enabled  for  combined
  2961.        message area reading to new users.
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.                                     46
  2991.        SECURITY            
  2992.        ────────────────────────────────────────────────────────────
  2993.  
  2994.        All user-security is controlled by a security level and  set
  2995.        of access flags.  The security level is any number from 1 to
  2996.        64,000.  Setting  a user's security level to zero will  lock
  2997.        him or her out of the BBS. There are thirty-two access flags
  2998.        arranged  in  four sets of eight individual flags,  each  of
  2999.        which can be either ON or OFF.  An ON flag is represented by
  3000.        an "X", and an OFF flag by a "-".
  3001.  
  3002.        Firstly let's look at menu security. Each menu is made up of
  3003.        a number  of  lines,  each  of  which  may  have  a  command
  3004.        associated with it.  (The  structure  of menus  is explained
  3005.        fully  in the next section).  In order for a menu line to be
  3006.        visible  (and  selectable) to a user,  the  user's  security
  3007.        level  must be equal to or greater than the  security  level
  3008.        assigned to that line.  In addition to this, every flag that
  3009.        is set ON in the menu line must also be set ON in the user's
  3010.        flag setting. 
  3011.  
  3012.        Read/Write  and Sysop access to message areas is  controlled
  3013.        in the same way. To be able to read messages in an area, the
  3014.        user  must  have not only a sufficient security  level,  but
  3015.        also  at  least the flags that are defined in  RACONFIG  for
  3016.        that  area.  Similarly,  the file area access  security/flag
  3017.        system works in the same way,  BUT the settings only  affect
  3018.        the   three   file  search  menu  functions.   To   restrict
  3019.        up/download  access to certain areas,  you will have to  use
  3020.        menu security.
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.                                     47
  3052.        MENUS
  3053.        ────────────────────────────────────────────────────────────
  3054.  
  3055.        This  is  possibly the most important stage  in  configuring
  3056.        your  BBS.  The  menus that you create will give the  system
  3057.        it's own "feel",  and will make your system look  completely
  3058.        different from the one next door.  The menu system gives you
  3059.        one hundred percent flexibility not  only  cosmetically, but
  3060.        in allowing and disallowing access to certain functions  and
  3061.        parts of your BBS to groups of users.
  3062.  
  3063.        The menus are line-oriented. Using the menu editor supplied,
  3064.        you  enter the lines one at a time.  Each line has a line of
  3065.        text that is displayed to the user, a menu "type", a minimum
  3066.        security  level  and flag setting required  to  access  that
  3067.        line,  and  some  optional  data that is used by  some  menu
  3068.        types. 
  3069.  
  3070.        There are approximately seventy menu functions that  may  be
  3071.        activated  by the user pressing the key you have  linked  to
  3072.        that  function.  These functions are explained fully in  the
  3073.        following pages.
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.                                     48
  3113.        Menu functions
  3114.  
  3115.  
  3116.        Type          : 1
  3117.        Name          : Goto another menu
  3118.        Optional Data : <Menu Name> [Password] [/F=<File Area>|+|-] 
  3119.                        [/M=<Message Area>|+|-] 
  3120.  
  3121.        This function causes a jump to another menu,  which has been
  3122.        created  with  the  editor  and saved  as  <Menu  Name>.  If
  3123.        [Password]  is  specified  then the user will  be  asked  to
  3124.        supply  a  non-case-sensitive  password  before  proceeding.
  3125.        <File  Area> and <Message Area> set the  currently  selected
  3126.        file and message areas respectively for the template system.
  3127.        See the section on MENU TEMPLATES for a full explanation  on
  3128.        this.
  3129.  
  3130.  
  3131.        Examples:
  3132.  
  3133.           FILES        : Jump to the menu 'FILES'.
  3134.  
  3135.           FILES FBES   : Prompt the user for a password,  then jump
  3136.                          to the  menu 'FILES'  provided   the  user
  3137.                          entered the correct password of 'FBES'.
  3138.  
  3139.           FILES /M=10  : Jump to  the  menu  'FILES'  and  set  the
  3140.                          selected message area template to  message
  3141.                          area '10'.
  3142.  
  3143.           FILES /F=10  : Jump  to  the  menu  'FILES'  and set  the
  3144.                          selected file area  template  to file area
  3145.                          '10'.
  3146.  
  3147.           FILES /M=+   : Jump to  the  menu  'FILES'  and  set  the
  3148.                          selected  message  area  template  to  the
  3149.                          current message area plus 1.
  3150.  
  3151.           FILES /F=+   : Jump  to  the  menu  'FILES'  and set  the
  3152.                          selected file area template to the current
  3153.                          file area plus 1.
  3154.  
  3155.  
  3156.  
  3157.  
  3158.        Type          : 2
  3159.        Name          : Gosub another menu
  3160.        Optional Data : <Menu Name> [Password] [/F=<File Area>|+|-] 
  3161.                        [/M=<Message Area>|+|-] 
  3162.  
  3163.        As for Function 1,  but saves the path to the last menu on a
  3164.        "stack",  making  it possible to return to the calling  menu
  3165.        with  a type 3 function.  Note that menus called in this way
  3166.        may be nested to a maximum of 50 levels.
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.                                     49
  3174.        Type          : 3
  3175.        Name          : Return from gosub 
  3176.        Optional Data : None
  3177.  
  3178.        Use  this  function to return from a Gosub (type 2)  to  the
  3179.        previous menu in the  menu stack.
  3180.  
  3181.  
  3182.  
  3183.        Type          : 4
  3184.        Name          : Goto menu after clearing menu stack         
  3185.        Optional Data : <Menu Name> [Password] [/F=<File Area>|+|-] 
  3186.                        [/M=<Message Area>|+|-] 
  3187.  
  3188.        As for function 1,  but  before jumping to the new menu, the
  3189.        gosub menu stack is cleared.  Obviously you can't use a type
  3190.        3 return straight after this!
  3191.  
  3192.  
  3193.  
  3194.        Type          : 5
  3195.        Name          : Display a *.ASC/*.ANS/*.AVT text file       
  3196.        Optional Data : <1-8 character name>
  3197.  
  3198.        This  menu  type  will  display  a  file  in  your  textfile
  3199.        directory  (as  defined  in  RACONFIG).   RemoteAccess  will
  3200.        display the file specified in the  Optional Data  field with
  3201.        one of three extensions.   If  the  user  has  AVATAR  codes
  3202.        active in their setup,  RemoteAccess would  display the file
  3203.        <Filename.AVT>  to   the  user.    If   however   the   file
  3204.        <Filename.AVT> was missing or the  user did  not have AVATAR
  3205.        enabled,  but only ANSI,  the file  <Filename.ANS>  would be
  3206.        displayed.   Finally if the user has only 'ASCII' enabled or
  3207.        both the files <Filename.AVT> and <Filename.ANS> are missing
  3208.        the file <Filename.ASC> would be displayed.
  3209.  
  3210.        These files  may contain any text  or graphical  information
  3211.        up to the limitations of  the text  format.  For example you
  3212.        cannot  display  ANSI colour  in a  *.ASC file.   Along with
  3213.        text and graphics it  is possible  to  display comprehensive
  3214.        system and  user details by inserting  special control codes
  3215.        in  the  files.  These  codes  are  listed  in the TEXT FILE
  3216.        CONTROL CODES section. 
  3217.  
  3218.            
  3219.        Examples:
  3220.  
  3221.        STATS      : This  Optional Data line   would display the   
  3222.                     file  'STATS.AVT'  if  the  user  has AVATAR   
  3223.                     enabled,  'STATS.ANS' if  the  user has ANSI   
  3224.                     enabled or the  file  'STATS.AVT' is missing   
  3225.                     and 'STATS.ASC' if the  user  has only ASCII   
  3226.                     enabled or both  the AVT  and ANS  files are   
  3227.                     missing.
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.                                     50
  3235.        Type          : 6
  3236.        Name          : Bulletin menu
  3237.        Optional Data : <1-8 character name>
  3238.  
  3239.        This function  will display  the file <filename.ASC/ANS/AVT>
  3240.        from the  textfile  directory.   The user  is then  prompted
  3241.        for a file suffix  of length  '8-<length of filename>'.  The
  3242.        suffix  is then  appended  to  the  original  filename,   as
  3243.        specified on  the Optional  Data line,  and that textfile is
  3244.        displayed  to the users  as it would be in a Type 5 command.
  3245.  
  3246.        Examples :
  3247.  
  3248.           BULLET     : If this  optional  data  field was specified
  3249.                        the   file  'BULLET.ASC/ANS/AVT'  would   be
  3250.                        displayed.  Then the  user is prompted for a
  3251.                        2 character input.  If  the user typed "1B",
  3252.                        then the file  "BULLET1B.ASC/ANS/AVT"  would
  3253.                        be displayed. The original text file defined
  3254.                        in  the  optional   data  should   therefore
  3255.                        contain a list of available bulletins.
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.                                     51
  3296.        Type          : 7
  3297.        Name          : Run an external program in a shell
  3298.        Optional Data : <Command Line> [Control Codes]
  3299.  
  3300.        This  command  will run an external program (a "door") in  a
  3301.        shell while the user is on-line. Examples are on-line games,
  3302.        mail-checking facilities and so on. (Refer also to type 15 -
  3303.        Exit  to  DOS  for an alternative way  of  running  external
  3304.        programs). The FULL name of the program must be specified if
  3305.        it is an .EXE or .COM file.  To run one of these two  simply
  3306.        put  the name of the program in the optional data field.  If
  3307.        you  wish  to  call a batch file,  this  must  be  done  via
  3308.        COMMAND.COM,  the memory-resident command-line processor. So
  3309.        to  run  your TradeWars batch file,  the command line  could
  3310.        read:
  3311.  
  3312.                    C:\COMMAND.COM /C \BBS\DOORS\TW2.BAT
  3313.  
  3314.        Many programs require extra information to be passed on  the
  3315.        command line, so the following control codes may be used. In
  3316.        each case, the code is replaced by it's value:
  3317.  
  3318.             *A : Write the user's handle (if any) in DORINFO.DEF   
  3319.                  instead of the user's real name.
  3320.  
  3321.             *B : User's baud rate, or 0 if local.
  3322.  
  3323.             *C : Full path and name to COMMAND.COM.
  3324.  
  3325.             *D : Automatically generate the Doorway DOOR.SYS       
  3326.                  parameter file.
  3327.  
  3328.             *F : User's first name.
  3329.  
  3330.             *G : ANSI graphics, 0=Off/1=On.
  3331.  
  3332.             *H : Normally  the  FOSSIL  is  de-initialised   before
  3333.                  running an external program to avoid any possible 
  3334.                  conflicts  between  the  FOSSIL and  the  program.
  3335.                  Specifying this parameter leaves the FOSSIL  "hot"
  3336.                  or active. 
  3337.  
  3338.             *L : User's last name.
  3339.  
  3340.             *M : Activate MemorySwap feature. RemoteAccess attempts
  3341.                  to  swap itself and all the memory it occupies  to
  3342.                  EMS  (if  installed) and  disk,  leaving  only  2k
  3343.                  resident.    Great   for   running   memory-hungry
  3344.                  programs,  but  it  takes a few seconds to do  the
  3345.                  swap.  If  it  can't do the swap,  it will  try  a
  3346.                  normal shell.  NOTE :  Some programs are notorious
  3347.                  for  "fragmenting" memory,  and will not work with
  3348.                  MemorySwap.  Programs compiled in QuickBASIC, such
  3349.                  as TradeWars 1000 exhibit this problem.
  3350.  
  3351.             *N : Line number,  as specified  by the -N command line
  3352.                  parameter.
  3353.  
  3354.  
  3355.  
  3356.                                     52
  3357.          *Oxxx : Override the baudrate value passed on to the      
  3358.                  called program with xxx.
  3359.  
  3360.             *P : Communications port being used (1-4).
  3361.  
  3362.             *R : User's record number in the user file.
  3363.  
  3364.        *S<filename.ext> :
  3365.               Generates a  custom exitfile using a template file   
  3366.               with the extension .RAT in the system directory      
  3367.               which contains any valid textfile macros. See the    
  3368.               "Textfile  Control Codes"  section  of  the          
  3369.               reference chapter for a full  list of available      
  3370.               text macros.
  3371.  
  3372.               The 'filename'  is the  base  filename  of  the  .RAT
  3373.               template file.  RA will process the file  and  create
  3374.               filename.ext where  the EXITINFO.BBS file is stored.
  3375.  
  3376.             *T : Time remaining for current call.
  3377.  
  3378.             *! : Freeze  the  system timer  for the duration of the
  3379.                  shell.  Useful for running external utilities like
  3380.                  full-screen chat programs etc.
  3381.  
  3382.             *# : Turn off the "Wants Chat" indicator on return from
  3383.                  the   shell.  This  is  to  facilitate  the proper
  3384.                  installation of external chat utilities.
  3385.  
  3386.             *0 : The full path to the currently selected file      
  3387.                  template area.
  3388.  
  3389.             *1 : The number of the currently selected template     
  3390.                  message area.
  3391.  
  3392.  
  3393.        In  addition  to this command line information that  can  be
  3394.        passed,  RemoteAccess also creates two data files before the
  3395.        shell.  DORINFO1.DEF,  which is a RBBS-compatible file,  and
  3396.        EXITINFO.BBS,  which  contains  an  extremely  comprehensive
  3397.        amount of system and user information. The structure of this
  3398.        file  can be found in the RemoteAccess structures  document,
  3399.        RASTRUCT.  It should also be noted that ALL system files are
  3400.        written  to  and closed off before the shell  is  activated,
  3401.        then  reopened  and scanned upon  return.  This  means  that
  3402.        programs  that  modify system files (eg.  USERS.BBS) can  be
  3403.        safely run in a type 7 shell.
  3404.  
  3405.        RemoteAccess also supports Doorway's DOOR.SYS parameter file
  3406.        directly; including  a *D on  the command  line enables  the
  3407.        generation of this file.
  3408.  
  3409.        Note  that the external program must do it's own time  limit
  3410.        and  carrier watchdogging,  in the event that the user  does
  3411.        not exit from the program correctly.
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.                                     53
  3418.        Type          : 8
  3419.        Name          : Product information
  3420.        Optional Data : None
  3421.  
  3422.        Displays  product information including the version  number,
  3423.        licensing  details  and  copyright  information.  If  a user
  3424.        is on-line  remotely,  the name and version of the FOSSIL in
  3425.        use is also displayed.
  3426.  
  3427.  
  3428.  
  3429.        Type          : 9
  3430.        Name          : Terminate the session
  3431.        Optional Data : None
  3432.  
  3433.        Displays  the GOODBYE.ASC/ANS/AVT text file and hangs up  on
  3434.        the user  by dropping  the DTR signal to the modem.  To this
  3435.        end, make  sure your modem's DTR line  is not "forced  high"
  3436.        continuously.
  3437.  
  3438.  
  3439.  
  3440.        Type          : 10
  3441.        Name          : System usage
  3442.        Optional Data : None
  3443.  
  3444.        This displays  a nicely  formatted  full-screen  autoscaling
  3445.        graph that depicts system usage  in terms of  percentage use
  3446.        per hour.   Each node (line)  keeps a separate system  usage
  3447.        graph and therefore  you can see  how  busy each  individual
  3448.        node is. If  you  wish to reset the graph,  delete the  file
  3449.        "TIMELOG.BBS"  from  your system  directory  or,  if you are
  3450.        running multi-node, the node directory.
  3451.  
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.                                     54
  3479.        Type          : 11
  3480.        Name          : Page sysop to chat
  3481.        Optional Data : <Paging string>
  3482.  
  3483.        This function will display  the <paging string>  to the user
  3484.        and page  the  sysop  for a chat  by  playing  a paging tune
  3485.        sounded at the local console.  If the REASON FOR PAGE option
  3486.        has been enabled in RACONFIG,  RemoteAccess will  display  a
  3487.        user-defined  prompt   and  wait  for  the  user to  enter a
  3488.        reason  for  requesting the chat.    When  the  paging  tune
  3489.        sounds the sysop may select "C"  to chat with the  user,  or
  3490.        "A" to abort the page.
  3491.  
  3492.        You may break in for a  chat at any time by pressing  ALT-C.
  3493.        If the  remote is  using an IEMSI-compatible  terminal which
  3494.        supports the IEMSI full-screen  chat flag, RemoteAccess will
  3495.        initiate  a split-screen  chat session.  To force  the "old"
  3496.        style line-oriented chat, hold down  the left SHIFT key when
  3497.        you press ALT-C.
  3498.  
  3499.        All sysop  keys are  listed in the reference section of this
  3500.        manual.  During a chat, the system timer  is  "frozen",  and
  3501.        is re-started  when  the  chat  is   terminated.  The  sysop
  3502.        terminates chat  mode  with the  ESCape  key.  During  chat,
  3503.        you may open a capture file  to record  what is  said during
  3504.        the  chat  session  by pressing CTRL-A,  and  again to close
  3505.        the capture.  If you have set  the "Auto log"  option in the
  3506.        Paging options of RACONFIG  to on, RemoteAccess  will open a
  3507.        chat log automatically upon entering chat.
  3508.  
  3509.        The times at which a user is allowed to page the sysop for a
  3510.        chat and  the number of times a user is allowed to request a
  3511.        chat in one  session  is controlled in  RACONFIG.   You  can
  3512.        override  the times at which  users can page you by pressing
  3513.        ALT-O  when  a  user is  on-line  and selecting  between the
  3514.        options.
  3515.  
  3516.        The default paging sound is a  constant "beep-beep" tone for
  3517.        the duration of the page. You may define your own page sound
  3518.        by creating  a  text  file  called  PAGE.RA  in  the  system
  3519.        directory. The following keywords are valid:
  3520.  
  3521.           TONE [hz] [1/100's sec]   (sounds hz)
  3522.           WAIT [1/100's sec]        (sounds nothing)
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.                                     55
  3540.        The following  table lists  several musical octaves  and the
  3541.        correct frequency value associated with each note:
  3542.  
  3543.           Note  Oct - 1    2    3    4    5    6
  3544.           ----        
  3545.           C       F   45  134 268  536 1071 2145
  3546.           C#      r   71  142 284  568 1136 2273
  3547.           D       e   75  150 301  602 1204 2408
  3548.           D#      q   80  159 319  638 1275 2551
  3549.           E       u   84  169 338  676 1351 2703
  3550.           F       e   90  179 358  716 1432 2864
  3551.           F#      n   95  190 379  758 1517 3034
  3552.           G       c   100 201 402  804 1607 3215
  3553.           G#      y   106 213 426  851 1703 3406
  3554.           A       #   113 225 451  902 1804 3608
  3555.           A#          119 239 478  956 1991 3823
  3556.           B           127 253 506 1012 2025 4050
  3557.  
  3558.        The  RemoteAccess distribution  archive  contains  a  sample
  3559.        PAGE.RA file to get you started.
  3560.  
  3561.  
  3562.  
  3563.        Type          : 12
  3564.        Name          : Questionnaire
  3565.        Optional Data : <1-8 character file name> [/N]
  3566.  
  3567.        Initiates a questionnaire. The <file name> is the first part
  3568.        of  the  name of the questionnaire file.  All  questionnaire
  3569.        files  are   stored  in  the  questionnaire   directory,  as
  3570.        specified in  the  RemoteAccess  Language  Editor,  and have
  3571.        a name extension of .Q-A.  User's responses are stored in an
  3572.        output file named <filename>.ASW.  There is a full  tutorial
  3573.        on  questionnaires,  including the script  language  in  the
  3574.        reference section of this manual.
  3575.  
  3576.        RemoteAccess has two hard-coded questionnaires.  If present,
  3577.        it will   initiate the  questionnaire NEWUSER.Q-A for  a new
  3578.        user after   the hard-coded text  file  NEWUSER2.ASC/ANS/AVT
  3579.        is displayed.  
  3580.  
  3581.        The  SUBDATE.Q-A  questionnaire  is automatically  initiated
  3582.        when  a  user  logs on  and  his/her  subscription date  has
  3583.        expired.  You  could  use  this  questionnaire  to  possibly
  3584.        downgrade  the  user's  security and/or  flag  settings  and
  3585.        display   a  message   informing   the  user   that  his/her
  3586.        subscription has expired.
  3587.  
  3588.        For  information on  hard-coded  (external  support)  files,
  3589.        refer to the EXTERNAL SUPPORT FILES section.
  3590.  
  3591.        Normally the initiation of  a questionnaire is noted  in the
  3592.        system log. Placing the /N parameter after the questionnaire
  3593.        name on the optional data line will suppress this log entry.
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.                                     56
  3601.        Type          : 13
  3602.        Name          : User listing
  3603.        Optional Data : [/G] [/H]
  3604.  
  3605.        Displays a list of users in the user file. Lists users name,
  3606.        location,  file ratio,  and the last time he/she called  the
  3607.        system.  This  function  has  some  basic  pattern  matching
  3608.        capabilities  on the  name field.  By default all  users are
  3609.        listed. However, if a  /G is specified in the  optional data
  3610.        field then the user will only see users who are  in the same
  3611.        group.  Note that  this  restriction does  not apply  to the
  3612.        sysop.  If a /H is specified in the optional data field then
  3613.        the users handles  will be  displayed  in place of  the user
  3614.        names.  If the users  handle field  is blank  then  the user
  3615.        name will be  used.   The  /G and  /H options may be used at
  3616.        the same time to produce a group user listing by handle. 
  3617.  
  3618.  
  3619.        Type          : 14
  3620.        Name          : Time
  3621.        Optional Data : None
  3622.  
  3623.        Shows the current date and time, time of connection and  the
  3624.        user's  daily  time  limit,  time  used  and  time remaining
  3625.        for the day.
  3626.  
  3627.  
  3628.        Type          : 15
  3629.        Name          : Exit to DOS
  3630.        Optional Data : <Errorlevel>
  3631.  
  3632.        This  function  causes RemoteAccess exit to the  batch  file
  3633.        that  executed  it,  with  a specific  errorlevel.  Set  the
  3634.        optional  data  to the errorlevel you wish to  pass  to  the
  3635.        batch  file.  The batch file should trap the errorlevel  and
  3636.        act  accordingly.  If  you exit while the user is still  on-
  3637.        line, to log the user back on invoke RemoteAccess with the -
  3638.        R  command line parameter.  This will force it to  read  the
  3639.        EXITINFO  file that was written at the time of the  previous
  3640.        exit  and take the user directly to the top menu.  Note that
  3641.        errorlevels  0 to 5 are reserved by RemoteAccess for  system
  3642.        use (see the reference section on ERRORLEVELS for a complete
  3643.        list  and  description of these and how to  use  them),  and
  3644.        should not be used.
  3645.  
  3646.        There are two control  codes that are valid on  the optional
  3647.        data field:
  3648.  
  3649.             *A : Pass the user's handle/alias in DORINFO.DEF
  3650.             *D : Generate the DOOR.SYS file 
  3651.  
  3652.        See  the  description  of  the  menu  command  type  7   for
  3653.        additional information on both of these options.
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661.                                     57
  3662.        Type          : 16
  3663.        Name          : Alter location
  3664.        Optional Data : None
  3665.  
  3666.        Allows  the user to change the "location" field  in  his/her
  3667.        user  record.  RemoteAccess  will  automatically  capitalise
  3668.        users  locations  if the  CAP LOCATION  option is enabled in
  3669.        RACONFIG/OPTIONS/NEW USERS. 
  3670.  
  3671.  
  3672.  
  3673.        Type          : 17
  3674.        Name          : Alter password
  3675.        Optional Data : None
  3676.  
  3677.        Allows the  user to  change his/her  password.   Before  the
  3678.        user can change their password they will be asked to re-type
  3679.        their current password.   Frequent password  changes  should
  3680.        be encouraged to  ensure system security,  and in fact there
  3681.        is an option to force a change of  password   every  certain
  3682.        number of logons (refer to "RACONFIG").
  3683.  
  3684.  
  3685.  
  3686.        Type          : 18
  3687.        Name          : Alter screen length
  3688.        Optional Data : None
  3689.  
  3690.        Allows  the  user  to alter the vertical length  of  his/her
  3691.        screen display.   This affects the "Continue?" prompt.
  3692.  
  3693.  
  3694.  
  3695.        Type          : 19
  3696.        Name          : Toggle screen clearing
  3697.        Optional Data : None
  3698.  
  3699.        Allows  the user to specify whether he/she would like screen
  3700.        clearing codes  sent.  If enabled  RemoteAccess  will  clear
  3701.        the users screen every time the user changes menus.
  3702.  
  3703.  
  3704.  
  3705.        Type          : 20
  3706.        Name          : Toggle page pausing
  3707.        Optional Data : None
  3708.  
  3709.        Allows the user to enable or disable the "Continue?"  prompt
  3710.        at the end of each screen page.
  3711.  
  3712.  
  3713.        Type          : 21
  3714.        Name          : Toggle ANSI graphics
  3715.        Optional Data : None
  3716.  
  3717.        Allows the user to select, or deselect ANSI graphics. If the
  3718.        user  disables ANSI, he/she will be asked whether the use of
  3719.        the full-screen editor should be disabled.
  3720.  
  3721.  
  3722.                                     58
  3723.        Type          : 22
  3724.        Name          : Check the mailbox
  3725.        Optional Data : None
  3726.  
  3727.        Checks  to  see if there is any mail addressed to  the  user
  3728.        that he/she hasn't yet read.  This can be done automatically
  3729.        at log-on by setting the appropriate option in RACONFIG. See
  3730.        the section on configuration for details of the two types of
  3731.        mail-check available.  All new messages are marked for later
  3732.        retrieval with the "Read Marked" option.  Note that the user
  3733.        will  only be notified of mail in areas that he/she has read
  3734.        access to,  as defined in RACONFIG. Although the system only
  3735.        prompts  the  user with a "Read mail now  [Yes/no]"  prompt,
  3736.        several options can be activated.  Valid choices are [R]ead,
  3737.        [S]can, [Q]uickscan, [K]ill, or [M]ark as received.
  3738.  
  3739.  
  3740.  
  3741.  
  3742.  
  3743.  
  3744.  
  3745.  
  3746.  
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.  
  3781.  
  3782.  
  3783.                                     59
  3784.        Type          : 23
  3785.        Name          : Read messages
  3786.        Optional Data : <Message area #> or /M
  3787.  
  3788.        This command initiates the message reading routines.  Before
  3789.        a user  can read  any message  RemoteAccess checks that  the
  3790.        user  has  read  access  to the  message area  first.    The
  3791.        <Message area #>  as defined in RACONFIG,   should be placed
  3792.        in  the  Optional Data field or if a  value  of 0 is entered
  3793.        RemoteAccess will  allow  the  user to  read  in  "combined"
  3794.        mode  (see function type 28  for more  information  on  this
  3795.        feature).   If you put a "/M" in the optional data field  in
  3796.        place  of the area number,  RemoteAccess will  automatically
  3797.        substitute the currently selected template message area into
  3798.        the  data field.  See MENU TEMPLATES for more on  this.  The
  3799.        message area number refers to number assigned to the desired
  3800.        area in RACONFIG.
  3801.  
  3802.        After selecting this function the  user  may   select one of
  3803.        eight different reading modes,  which are:
  3804.  
  3805.  
  3806.           (F)orward     : Read forward  from  the selected  message
  3807.                           number to the last message. 
  3808.  
  3809.           (R)everse     : Read reverse  from  the selected  message
  3810.                           number to the first message.
  3811.  
  3812.           (I)ndividual  : Read an individual  message,  selected by
  3813.                           message number.
  3814.  
  3815.           (H)elp        : Displays the file  "MAILHELP.A??"  to the
  3816.                           user,  if it exists (see EXTERNAL SUPPORT
  3817.                           FILES).
  3818.  
  3819.           (M)arked      : Read   messages   marked   by   the  user
  3820.                           previously  when  doing  a  message scan,
  3821.                           (See Menu Type 24).
  3822.  
  3823.           (N)ew msgs    : New messages since the users last call.
  3824.  
  3825.           (S)elected    : Read messages,  by  a search  criteria on
  3826.                           the "To:", "From:" or "Subject" fields.
  3827.  
  3828.           (Q)uit.       : Abort the message reading. 
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.  
  3839.  
  3840.  
  3841.  
  3842.  
  3843.  
  3844.                                     60
  3845.        A menu bar is  displayed at the  end of each  message,  this
  3846.        provides the user with the following functions:
  3847.  
  3848.           [-]  : Read previous reply
  3849.           [+]  : Read next reply
  3850.           [A]  : Redisplay message again
  3851.           [N]  : Go to the next message
  3852.           [L]  : Go back to the previous message
  3853.           [R]  : Post a reply to the current message
  3854.           [E]  : Enter a new message in the current area
  3855.           [F]  : Download files that are attached to the message   
  3856.           [D]  : Delete the displayed  message  (check the  "delete
  3857.                  msg"  menu function for more information)
  3858.           [S]  : Stop reading messages
  3859.  
  3860.  
  3861.        The following options  are available only to  users who have
  3862.        sysop access to the message area:
  3863.  
  3864.           [!]  : Display ^A  kludge  lines normally  hidden.  These
  3865.                  lines normally contain  information  pertaining to
  3866.                  the product that  created the  message,   echomail
  3867.                  information and information about  replies to  the
  3868.                  message.
  3869.  
  3870.           [*]  : Edit   the  current  message's  attributes.   This
  3871.                  allows  you  to   edit   the   following   message
  3872.                  characteristics:
  3873.                    
  3874.                     Area no.     : Message area number.
  3875.                     From         : The sender of the message.
  3876.                     To           : The recipient of the message.   
  3877.                     Subject      : The subject of the message.     
  3878.                     Attributes   : Message   attributes    toggles;
  3879.                                    Deleted,    Netmail,    Private,
  3880.                                    Received, and Local flags.
  3881.                     Exported     : If the msg is  an Echomail  msg,
  3882.                                    this  determines if the  msg has
  3883.                                    been exported.
  3884.  
  3885.           [X]  : Export message to a file or the printer
  3886.  
  3887.           [/]  : Forward message to another user in any msg area.
  3888.  
  3889.           [=]  : Mark message as  unreceived  and  go to  the  next
  3890.                  message.   The  message  will then  be redisplayed
  3891.                  next time you do a mail check.
  3892.  
  3893.           [U]  : Modify the security level  of the user  who posted
  3894.                  the currently displayed message, provided the user
  3895.                  is listed in the userfile.  Great for "on the fly"
  3896.                  user  verification!  NOTE  -  only  users  with  a
  3897.                  security  level  less  than  the person making the
  3898.                  change may be modified, and their level may not be
  3899.                  upgraded higher than the person making the change.
  3900.                  {+}  Registered only.
  3901.  
  3902.  
  3903.  
  3904.  
  3905.                                     61
  3906.        Type          : 24
  3907.        Name          : Scan messages
  3908.        Optional Data : <Message area #> or /M
  3909.  
  3910.        Same  as  the  READ  message function  (type  23)  but  only
  3911.        displays  the message header of each message.  The user also
  3912.        has the  option  of marking  messages for  later  retrieval.
  3913.        Messages marked with this  method  can  be read later by the
  3914.        user by selecting the read  "Marked" option from a menu type
  3915.        23 command.    
  3916.  
  3917.  
  3918.  
  3919.        Type          : 25
  3920.        Name          : QuickScan messages
  3921.        Optional Data : <Message area #> or /M
  3922.  
  3923.        Same as the READ message function (type 23) but each message
  3924.        is listed as a single-line entry containing message  number,
  3925.        the author of the message,  who it is addressed to,  and the
  3926.        subject line.  
  3927.  
  3928.  
  3929.  
  3930.        Type          : 26
  3931.        Name          : Delete message
  3932.        Optional Data : None
  3933.  
  3934.        Allows a user to delete a message provided that:
  3935.  
  3936.        * The user has sysop access to the  area the message is  in,
  3937.          OR
  3938.  
  3939.        * The message is in a LOCAL or NETMAIL area, the user is the
  3940.          sender or recipient of  the message  and the  message area
  3941.          allows  users to  delete  messages (See RACONFIG Manager),
  3942.          OR
  3943.  
  3944.        * The message  is in  an echomail area  and the user is  the
  3945.          sender of the message,  provided the message  has not been
  3946.          exported from the message-base and the message area allows
  3947.          users to  delete  messages (See RACONFIG Manager).
  3948.          
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.                                     62
  3967.        Type          : 27
  3968.        Name          : Post message
  3969.        Optional Data : <Message Area #> or /M [/L] [/U] [/T=<Name>]
  3970.  
  3971.        Post  a  message  in the specified area  (or  the  currently
  3972.        selected  template area if the "/M" is used).  The user must
  3973.        have  either write or sysop access to the message  area,  as
  3974.        defined  in RACONFIG.  The /L option will log the  user  off
  3975.        immediately  after the message is saved (useful for a "Leave
  3976.        message  to  sysop before disconnecting"  option).  The  /T=
  3977.        option will force the message to be addressed to a  specific
  3978.        user.  Simply  place  the user's name in the  optional  data
  3979.        field  after  the /T= parameter to select this  option.  For
  3980.        example, on my "log-off" menu, I have the following entry:
  3981.  
  3982.        Menu Type 27
  3983.        Optional Data: 60 /L /T=Andrew_Milner
  3984.  
  3985.        (Any messages to "Sysop" are redirected to the sysop's  name
  3986.        as defined in RACONFIG).  If you do use a full name, be sure
  3987.        to use underscores in place of spaces.
  3988.  
  3989.        Specifying a message area number of zero forces RemoteAccess
  3990.        to  display all message areas that the user has write access
  3991.        to and prompt for the message area to post the message in.
  3992.  
  3993.  
  3994.        When  posting a message,  the  user will be prompted for the
  3995.        following information:
  3996.  
  3997.           
  3998.           Alias?     : If the  message  area allows  users to  post
  3999.                        messages  using   an  Alias,  the user  will
  4000.                        be asked if they wish  to do so,  if they do
  4001.                        they  will  then  be prompted for  the alias
  4002.                        they wish to use.
  4003.  
  4004.           To         : In this  field the user  must enter the name
  4005.                        of the  recipient of  the message.  In Echo-
  4006.                        Mail areas any  name will  be  accepted.  If
  4007.                        however the user  is posting a  message in a
  4008.                        local message area, RemoteAccess will search
  4009.                        the user  database   to  confirm   that  the
  4010.                        recipient is a valid  user of the system. If
  4011.                        no  record of the recipient is found and the
  4012.                        /U  parameter  is on  the optional data line
  4013.                        the user  is  notified and  asked if  he/she
  4014.                        would like to view/search the user database.
  4015.                        If  the  user elects not to search  the user
  4016.                        database  the  message  will  be  posted  as
  4017.                        normal.
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.                                     63
  4028.                        In   addition   to   posting   messages   to
  4029.                        individual users,   it is  possible  to post
  4030.                        mail  to a  group of  users.   The following
  4031.                        macros  are valid  for a user to  use in the
  4032.                        "to" field  of a  message provided they have
  4033.                        the minimum security level  required to post
  4034.                        a group mail message.
  4035.  
  4036.                        Send msg to :
  4037.  
  4038.                           @[g] - all users in group [g]
  4039.                           @ALL - all users
  4040.                           =[s] - all users with security = [s]     
  4041.                           >[s] - all users with security > [s]     
  4042.                           <[s] - all users with security < [s]
  4043.  
  4044.                        A separately addressed message is generated 
  4045.                        for  each  qualifying user,  so large group 
  4046.                        mailings can take a little while to process 
  4047.                        and occupy a large amount of disk space.
  4048.  
  4049.           Address    : If the message is being posted in a Netmail 
  4050.                        area, the user will be prompted to enter the
  4051.                        network address of the system they  wish to 
  4052.                        sent the mail  to.    If the user is unsure 
  4053.                        of the network  address,  they  may  browse 
  4054.                        the nodelist  obtain the  correct  address. 
  4055.                        NOTE :   Browse  the   nodelist  is  a  {+} 
  4056.                        registered feature only. 
  4057.  
  4058.           Subject    : In this field,  the  user may  place a short
  4059.                        description  of the  subject  matter of  the
  4060.                        message.
  4061.  
  4062.           Private?   : If private  messages  are  permitted  in the
  4063.                        message area,  the  user  will be  given the
  4064.                        option to   address  the mail  privately for
  4065.                        reading by the recipient only.
  4066.  
  4067.           Crash?     : This option  determines if a Netmail message
  4068.                        is sent immediately from your system  to the
  4069.                        destination  system.   The  option  is  only
  4070.                        available  to  users  who have  the  minimum
  4071.                        security level to use Crash mail.          
  4072.  
  4073.  
  4074.           
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.                                     64
  4089.        Type          : 28
  4090.        Name          : Select combined areas
  4091.        Optional Data : None
  4092.  
  4093.        Allows  the user to select any combination of message  areas
  4094.        for  "combined" mode message reading/scanning/quickscanning.
  4095.  
  4096.        The  user is shown a list of available areas and may  toggle
  4097.        any  of  them "ON" or "OFF".  This combination of  areas  is
  4098.        saved  as part of the user's permanent user record,  and  is
  4099.        restored at next log on.  To read messages in the "combined"
  4100.        area, use a normal read/scan/quickscan menu function but set
  4101.        the message area number in the optional data field to  zero.
  4102.  
  4103.        Area  zero is hard-coded as this combined area and cannot be
  4104.        defined by the sysop. Note that it is possible to define via
  4105.        RACONFIG a  default selection of combined  message areas for
  4106.        new users.
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.                                     65
  4150.        Type          : 29
  4151.        Name          : Move a file
  4152.        Optional Data : <Full source path>
  4153.  
  4154.        Primarily intended as a sysop/assistant sysop function, this
  4155.        allows  the  user  to move files  from  a  pre-defined  area
  4156.        <source-path>  to  any valid DOS directory without the  need
  4157.        for remote access  to DOS.  After the file  has been  copied
  4158.        successfully,  RemoteAccess will optionally  move the file's
  4159.        description (if there is one) to the destination directory.
  4160.  
  4161.  
  4162.  
  4163.        Type          : 30
  4164.        Name          : Directory
  4165.        Optional Data : <Full path> or /F
  4166.  
  4167.        Displays   an  MS-DOS  style  directory  of  the   directory
  4168.        specified in the optional data field,  showing name,  length
  4169.        and date of each  file. The user is prompted for an optional
  4170.        wildcard pattern match  filespec.   For  example "*.*" would
  4171.        display all files.
  4172.  
  4173.        The use  of  the "/F"  parameter will  enable you to use the
  4174.        current file template in place of the <Full path>.
  4175.  
  4176.  
  4177.  
  4178.        Type          : 31
  4179.        Name          : List files
  4180.        Optional Data : <Full path> or /F
  4181.  
  4182.        This option displays a list of files available for  download
  4183.        from  the  directory  specified  by the  path  name  in  the
  4184.        optional  data  field.  The file names and descriptions  are
  4185.        contained  in  a  file  called  FILES.BBS.   This  file   is
  4186.        automatically  maintained  by  RemoteAccess when  files  are
  4187.        uploaded,  but it may also be edited by the sysop.  The file
  4188.        consists  of  a  single  word  file-name  per  line  with  a
  4189.        description,  up to 255 characters in  length.  Descriptions
  4190.        that  exceed  the  width  of the  screen  are  automatically
  4191.        wrapped to the next line.  It is possible  to define how you
  4192.        want  the file  listing to  be  displayed  to  the  user  by
  4193.        editing  the file "list format"  template in RACONFIG.   The
  4194.        default list format will display the file name, upload date,
  4195.        size of  each file  and the  file  description.  An asterisk
  4196.        before  the  description   signifies  that the  file  is new
  4197.        since  the user's  last  call.  (See  RACONFIG/OPTIONS/FILES
  4198.        AREA for further information on "List Format").
  4199.  
  4200.        If,  instead  of the full path to the file area,  you put  a
  4201.        "/F",  RemoteAccess  will  substitute  the  path  name  that
  4202.        corresponds to the currently selected template file area, as
  4203.        defined  in  RACONFIG.  See the MENU  TEMPLATE  section  for
  4204.        further information on this.
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.                                     66
  4211.        Type          : 32
  4212.        Name          : Download a file from area
  4213.        Optional Data : <Full path> or /F [Password]
  4214.  
  4215.        Enables  the user to download any file that is contained  in
  4216.        the  specified  directory.  Note that the file need  not  be
  4217.        listed in that directory's FILES.BBS for the user to be able
  4218.        to download it.  If a password  is specified for the file in
  4219.        the "FILES.CTL"  file  or  a password  is  specified  in the
  4220.        optional data field,   the user  will  be  asked for  a  non
  4221.        case-sensitive password before being allowed to proceed with
  4222.        the transfer.  The /F option  works in  the  same way  as in
  4223.        function 31.   (See the section  EXTERNAL SUPPORT  FILES for
  4224.        further information on the "FILES.CTL" file).
  4225.  
  4226.        If  a user  is logged onto a local node,   RemoteAccess will
  4227.        prompt the  user for a directory to move  the selected files
  4228.        to.                        
  4229.  
  4230.  
  4231.        Type          : 33
  4232.        Name          : Upload a file
  4233.        Optional Data : <Full path> or /F [/L]
  4234.  
  4235.        Enables the user to upload (send) a file to your system. The
  4236.        file  will  be  placed in the  directory  specified  in  the
  4237.        optional data path.  FILES.BBS will be automatically updated
  4238.        to reflect the upload.  The /F option works in the same  way
  4239.        as in functions 31 and 32.
  4240.  
  4241.        After uploading a file,  the  user is  prompted  to  enter a
  4242.        one line  file  description.   If  however  the  "Long desc"
  4243.        option is enabled in RACONFIG   for  the file  area to which
  4244.        the file has  been uploaded, the user may  give  the  file a
  4245.        description  longer than  one line.   The file description a
  4246.        user enters is appended to the end of the FILES.BBS file for
  4247.        the  area in  which the  file has been  uploaded.  The  only
  4248.        exception  to this is when the  user asks for the file to be
  4249.        marked  private  for the  sysop only  by  starting  the file
  4250.        description with a '/'.   In  this  case   the  file details
  4251.        are recorded in "PVTFILES.LOG" in the system directory.
  4252.  
  4253.        If a user  selects to upload a file   while they are  logged
  4254.        onto a local node,  RemoteAccess  will  prompt them  for the
  4255.        full DOS path and filename of  the file they wish to upload.
  4256.        The user will then be prompted for  the file descriptions as
  4257.        normal and  finally the files will be  copied to the correct
  4258.        upload directory.  When uploading a  file locally it is also
  4259.        possible  for the  user  to  specify  a  Wildcard,  such  as
  4260.        "D:\FILES\BBS\RA*.ARJ".  This  would  enable  the   user  to
  4261.        upload multiple files matching the wildcard criteria.   
  4262.  
  4263.        Use the /L parameter  to enable long file descriptions  (see
  4264.        the section on FILES for more information on this feature).
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.                                     67
  4272.        Type          : 34
  4273.        Name          : View archive
  4274.        Optional Data : <Full path> or /F
  4275.  
  4276.        Allows  the user to view the contents of an archived file in
  4277.        the specified  directory. The following  archive formats are
  4278.        supported:
  4279.              
  4280.                   .ARC/PAK/PKA
  4281.                   .ZIP
  4282.                   .ZOO
  4283.                   .LZH/LZS
  4284.                   .DWC
  4285.                   .MD
  4286.                   .LBR
  4287.                   .ARJ
  4288.                   .HYP
  4289.  
  4290.        Menu templating   is supported with the /F option.   This is
  4291.        explained more fully in MENU TEMPLATES.
  4292.  
  4293.  
  4294.  
  4295.        Type          : 35
  4296.        Name          : File scan by keyword
  4297.        Optional Data : [area1 area2 area3 ...] or /F
  4298.  
  4299.        This function uses the data specified in RACONFIG to  search
  4300.        all  file  areas that the user has access to for a  key-word
  4301.        that  is supplied by the user.  Any FILES.BBS  entries  that
  4302.        match  are displayed with the name of the area the match was
  4303.        found in.  The default  is to  scan all  areas, but  you may
  4304.        specify  that only certain areas  be searched by putting the
  4305.        area numbers to include on the optional data line. 
  4306.  
  4307.        If you use the "/F" parameter you  can force RA to scan only
  4308.        the currently selected template file area.
  4309.  
  4310.  
  4311.  
  4312.        Type          : 36
  4313.        Name          : File scan by file name
  4314.        Optional Data : [area1 area2 area3 ...] or /F
  4315.  
  4316.        Same as function 35, but scans for an exact file name match.
  4317.        Wildcard and  pattern  matching characters  are  valid.  The
  4318.        default is to scan all areas, but you may specify that  only
  4319.        certain  areas be  searched by  putting the area  numbers to
  4320.        include on the optional data line.   The /F option works  in
  4321.        the same way as function 35.
  4322.  
  4323.  
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.  
  4332.                                     68
  4333.        Type          : 37
  4334.        Name          : Show new files
  4335.        Optional Data : [area1 area2 area3 ...] or /F
  4336.  
  4337.        Scans  all file  areas  which have  the  "New Files"  option
  4338.        enabled in RACONFIG  that  the user has access to, for files
  4339.        that   have  a date  more recent than the  date specified by
  4340.        the user. The default is  to search for files new  since the
  4341.        users last log-on. The default is to scan all areas, but you
  4342.        may specify that  only certain areas be searched  by putting
  4343.        the area numbers to include on the optional data line.   The
  4344.        /F option  works in  the same  way  as function 36 and 37.
  4345.  
  4346.  
  4347.  
  4348.        Type          : 38
  4349.        Name          : Type (view) a text file
  4350.        Optional Data : <Full path> or /F
  4351.  
  4352.        Allows  the  user to type to the terminal the contents of  a
  4353.        plain  ASCII/ANSI/AVATAR   text   file  in   the   specified
  4354.        directory.   This  is useful  for  on-line  file  lists   or
  4355.        magazines.  The /F option overrides  the path  name with the
  4356.        currently selected template file area path.   
  4357.  
  4358.  
  4359.  
  4360.        Type          : 39
  4361.        Name          : Display a fully named text file
  4362.        Optional Data : <Full path and name>
  4363.  
  4364.        Similar  to the type 5 function,  but allows you to  specify
  4365.        the  full  path and name (including extension) of  the  file
  4366.        that will be displayed.  Like the type 5 function, this also
  4367.        interprets the special control characters.
  4368.  
  4369.  
  4370.  
  4371.        Type          : 40
  4372.        Name          : Display a ASC/ANS/AVT text file with hotkeys
  4373.        Optional Data : <1-8 character name>
  4374.  
  4375.        Displays  an  ASC/ANS/AVT  text file the same way as  a type
  4376.        5 would,  but leaves  the current menu hot keys active while
  4377.        the  file is displayed.   This allows  the use  of elaborate
  4378.        graphics in  your menus  that would  be impossible to create
  4379.        with the line editor.   See also AUTOMATIC COMMAND EXECUTION
  4380.        for details on how to integrate these files into your menus.
  4381.  
  4382.  
  4383.  
  4384.        Type          : 41
  4385.        Name          : Toggle full screen editor
  4386.        Optional Data : None
  4387.  
  4388.        Allows  the  user to select or deselect the use of the  full
  4389.        screen message editor.  Use of the editor is only  permitted
  4390.        if the user has ANSI graphics enabled.
  4391.  
  4392.  
  4393.                                     69
  4394.        Type          : 42
  4395.        Name          : Toggle hot-keys
  4396.        Optional Data : None
  4397.  
  4398.        Allows  the  user  to choose  between  hot-keys  or  command
  4399.        stacking.  In  command stacking mode,  several commands,  or
  4400.        key-presses, can be specified on one command line by putting
  4401.        a semi-colon in between each command.
  4402.  
  4403.  
  4404.  
  4405.        Type          : 43
  4406.        Name          : NewMail {+}
  4407.        Optional Data : None
  4408.  
  4409.        Display a  full list of all  the message areas the  user has
  4410.        read  access  to,  highlighting  those  that contain  unread
  4411.        messages. This menu command  is only available in registered
  4412.        mode.
  4413.  
  4414.  
  4415.  
  4416.        Type          : 44
  4417.        Name          : Reset combined areas setting
  4418.        Optional Data : None
  4419.  
  4420.        Allows  the  user  to  turn  ON or OFF all available message
  4421.        areas for his/her combined message area setting.
  4422.  
  4423.  
  4424.  
  4425.        Type          : 45
  4426.        Name          : Display text file and wait
  4427.        Optional Data : <1-8 character name>
  4428.  
  4429.        This is the same as a type 5 function,  but prompts the user
  4430.        to  press  [Enter]  before continuing.  This is  useful  for
  4431.        displaying  text  files that are generated automatically  by
  4432.        utilities that don't append a Control-A (wait character)  at
  4433.        the end of the file.
  4434.  
  4435.  
  4436.  
  4437.        Type           : 46
  4438.        Name           : Display direct textfile with CR
  4439.        Optional Data  : <Full path and name>
  4440.  
  4441.        Displays  a text file with  a fully qualified  path and name
  4442.        and waits for the user to press [Return] before continuing.
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.                                     70
  4455.        Type          : 47
  4456.        Name          : Make a log entry
  4457.        Optional Data : <Log entry>
  4458.  
  4459.        When this command is executed,  it simply takes the contents
  4460.        of  the Optional Data field and writes it to the system  log
  4461.        as if it were a normal hard-coded log entry. The only  macro
  4462.        characters that are valid are:
  4463.  
  4464.             @ : Insert the name of the current template file area  
  4465.             ` : Insert the name of the current template msg area
  4466.  
  4467.  
  4468.  
  4469.        Type          : 48
  4470.        Name          : Download a specific file
  4471.        Optional Data : <Full path and name>
  4472.  
  4473.        Enables the user to download a file or set of files that you
  4474.        have  pre-defined,  using  a protocol of the user's  choice.
  4475.        Note  that  you  may specify wild-cards  and  pattern  match
  4476.        characters in the file name, but if you do, the user will be
  4477.        forced to use a batch transfer protocol. For example, a type
  4478.        48 command with the following optional data field:
  4479.  
  4480.             C:\FILES\RA\RELEASE\RA*.ARJ
  4481.  
  4482.        Would  send all files in the  C:\FILES\RA\RELEASE  directory
  4483.        that matched RA*.ARJ.
  4484.  
  4485.  
  4486.  
  4487.        Type          : 49
  4488.        Name          : Select message area
  4489.        Optional Data : None
  4490.  
  4491.        Displays  a  list of  all message  areas  the user  has read
  4492.        access to, and  asks the user to  select one by number.  The
  4493.        current message  template area  number is set  to the  users
  4494.        choice.  This allows the sysop to run a very low maintenance
  4495.        system,  since all  that  is required  to  add or  delete  a
  4496.        message  area  is  to  modify  the  configuration  file  via
  4497.        RACONFIG.
  4498.  
  4499.  
  4500.  
  4501.        Type          : 50
  4502.        Name          : Select file area
  4503.        Optional Data : None
  4504.  
  4505.        This operates in the  same way as the "select  message area"
  4506.        (type 49)  menu function,  but  uses file  areas instead  of
  4507.        message areas.
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.  
  4514.  
  4515.                                     71
  4516.        Type          : 51
  4517.        Name          : List today's callers
  4518.        Optional Data : [/H]
  4519.  
  4520.        Lists  every  caller  that  has  called  your  system  since
  4521.        midnight  along with log on/off times,  baud rate  and  what
  4522.        line the call was taken on. The /H switch will show  handles
  4523.        instead of read names.
  4524.  
  4525.  
  4526.  
  4527.        Type          : 52
  4528.        Name          : Show all users on-line
  4529.        Optional Data : [/H]
  4530.  
  4531.        Lists all users currently on-line. This would only be useful
  4532.        in a multi-node installation.  It shows where each caller is
  4533.        calling   from,  their   baud   rate, the   line  they   are
  4534.        connected to and what they are doing.
  4535.  
  4536.  
  4537.  
  4538.        Type          : 53
  4539.        Name          : Toggle "Do not disturb"
  4540.        Optional Data : None
  4541.  
  4542.        This is another multi-line feature only. It allows the  user
  4543.        to turn on or off the ability of other users to send him/her
  4544.        messages  with  the  type 54 function,  like - "Hey  Joe,  I
  4545.        noticed  that you're on line 3.  Wanna chat?" Note that  the
  4546.        sysop  has the ability to override this.
  4547.  
  4548.  
  4549.  
  4550.        Type          : 54
  4551.        Name          : Send an on-line message
  4552.        Optional Data : None
  4553.  
  4554.        Allows  the  user to send a message to another user  who  is
  4555.        logged on to  another line at the same time.  Provided  that
  4556.        the  other  user has not set his/her "do not disturb"  flag,
  4557.        the  sender  will be prompted for a one-liner  to  transmit.
  4558.  
  4559.        Depending on what the recipient is doing at the time, he/she
  4560.        will get the message ten to fifteen seconds later.
  4561.  
  4562.  
  4563.  
  4564.        Type          : 55
  4565.        Name          : Download any file
  4566.        Optional Data : None
  4567.  
  4568.        This  is an extremely powerful function that should be  only
  4569.        accessible  to the sysop.  It allows the user to download  a
  4570.        file  from  any  valid drive or directory using any  of  the
  4571.        available file transfer protocols. This is the ONLY download
  4572.        function that  takes no  account of  download  limits,  file
  4573.        ratios  or  transfer time, and does  not  update  the  users
  4574.        record to reflect the download.
  4575.  
  4576.                                     72
  4577.        Type           : 56
  4578.        Name           : Browse the nodelist {+}
  4579.        Optional Data  : None
  4580.  
  4581.        Allows the  user to browse the  nodelist. Includes functions
  4582.        to list  all zones, list all nets and regions in a zone, and
  4583.        list all nodes in a net or region.
  4584.  
  4585.  
  4586.  
  4587.        Type           : 57
  4588.        Name           : Change home/voice number
  4589.        Optional Data  : None
  4590.  
  4591.        Allows the  user to  modify his/her home/voice  phone number
  4592.        permanently.
  4593.  
  4594.  
  4595.  
  4596.        Type           : 58
  4597.        Name           : Change business/data number
  4598.        Optional Data  : None
  4599.  
  4600.        Allows the user to modify his/her business/data phone number
  4601.        permanently.
  4602.  
  4603.  
  4604.  
  4605.        Type           : 59
  4606.        Name           : Global download {+}
  4607.        Optional Data  : None
  4608.  
  4609.        Allows  the  user  to download  files  as  per  the type  32
  4610.        download command, but searches ALL areas the user has access
  4611.        to for  the requested  file(s). All  normal  time and  other
  4612.        security restrictions apply.
  4613.  
  4614.  
  4615.  
  4616.        Type           : 60
  4617.        Name           : Change handle
  4618.        Optional Data  : None
  4619.  
  4620.        Allows  the  user  to   select  a  new  handle.    Note that
  4621.        RemoteAccess will  not  allow the  user to choose a  name or
  4622.        handle which is in use by another user or a handle  which is
  4623.        listed in the "HANDLES.CTL" file.    RemoteAccess  will also
  4624.        not allow the use of "SYSOP" as a  handle.
  4625.  
  4626.  
  4627.  
  4628.        Type           : 61
  4629.        Name           : Toggle AVATAR
  4630.        Optional Data  : None
  4631.  
  4632.        Toggles the use of AVATAR codes (see the section on TERMINAL
  4633.        EMULATIONS for more information).
  4634.  
  4635.  
  4636.  
  4637.                                     73
  4638.        Type           : 62
  4639.        Name           : Toggle full screen message viewer
  4640.        Optional Data  : None
  4641.  
  4642.        Allows the user to select or deselect use of the full screen
  4643.        message  presentation  manager.  When  active,  this  option
  4644.        displays  all messages with a fixed header and uses ANSI and
  4645.        AVATAR codes for special screen manipulation.
  4646.  
  4647.  
  4648.  
  4649.        Type           : 63
  4650.        Name           : Select a new language
  4651.        Optional Data  : None
  4652.  
  4653.        Allows the user to  change their current  language  setting.
  4654.        (See LANGUAGE FILES for more details)
  4655.  
  4656.  
  4657.  
  4658.        Type           : 64
  4659.        Name           : Select a new date format
  4660.        Optional Data  : None
  4661.  
  4662.        Allows the user to change  his/her currently  selected  date
  4663.        format.   The  user   has  a choice  of  the following  date
  4664.        formats:
  4665.  
  4666.  
  4667.                    DD-MM-YY
  4668.                    MM-DD-YY
  4669.                    YY-MM-DD
  4670.                    DD-Mmm-YY
  4671.  
  4672.  
  4673.  
  4674.  
  4675.        Type           : 65 {+} Registered only.
  4676.        Name           : Change current users flags
  4677.        Optional Data  : <flagset><flagnum><action>
  4678.  
  4679.        This allows  you to  set on,  set off or toggle  any of  the
  4680.        users security flag  settings.  The "action"  determines how
  4681.        the flag  is to  be set.   The actions available are:
  4682.  
  4683.  
  4684.                           - : Turn flag OFF
  4685.                           + : Turn flag ON
  4686.                           * : Toggle flag
  4687.  
  4688.  
  4689.        For example,  if the  optional data was  "A1+ A2- D8*",  the
  4690.        flag A1  would  be turned  on,  A2 would  be turned  off and
  4691.        flag D8 would be toggled.
  4692.  
  4693.  
  4694.  
  4695.  
  4696.  
  4697.  
  4698.                                     74
  4699.        Type           : 66
  4700.        Name           : Toggle Text file shells
  4701.        Optional Data  : <ON|OFF>
  4702.  
  4703.        Enables/Disables textfile  file  shells.  This overrides the
  4704.        default  setting in RACONFIG for the one session.  (see TEXT
  4705.        FILE CONTROL CODES for more information)
  4706.  
  4707.  
  4708.  
  4709.        Type           : 67
  4710.        Name           : Toggle auto message-forwarding
  4711.        Optional Data  : None
  4712.  
  4713.        If a user  is going  to be  away for an  extended period  of
  4714.        time,  he/she  may  specify  the  name of  another  user  to
  4715.        whom all his/her mail is  redirected.    When this option is
  4716.        toggled on  the user  will be asked for the name of a person
  4717.        he/she wishes to forward his/her mail to. This name  must be
  4718.        a valid user listed in the system user database. If the name
  4719.        entered can not be located in  the user  database,  the user
  4720.        will  be given  the option  to view/search the user database
  4721.        and then reselect the user to forward mail to.
  4722.  
  4723.  
  4724.  
  4725.  
  4726.  
  4727.  
  4728.  
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.                                     75
  4760.        Automatic command execution
  4761.        ────────────────────────────────────────────────────────────
  4762.  
  4763.        Normally  a  menu  function would be activated when  a  user
  4764.        presses  the  key  that you have linked  to  that  function.
  4765.        However,  it is possible to cause a function to be  executed
  4766.        automatically  as soon as a menu is displayed by setting the
  4767.        entry to "auto execute". As  soon as  that  particular  menu
  4768.        line    is     displayed  the     function    is    executed
  4769.        automatically,  without the need for the user to select  the
  4770.        option.  This  is a very powerful feature when used with the
  4771.        type 40 menu function,  which displays an  ASCII/ANSI/AVATAR
  4772.        text file  while  checking for menu hot-keys.  By setting up
  4773.        the  first line  of  a menu  as  a  type 40  with  automatic
  4774.        execution, as  soon  as the menu is called your text file is
  4775.        displayed instead of the normal menu lines.  This allows you
  4776.        to  design very  elaborate  graphical  menu  displays   that
  4777.        contain  extra information  about  the user by inserting the
  4778.        special  text   file  control codes.  What happens if a user
  4779.        "passes through"    a  menu by using a stacked menu command?
  4780.        In some cases you may want the automatic command to execute,
  4781.        for  example  to  redirect  the user  to  another  menu   by
  4782.        automatic execution of  a type 1 or 2. On the other hand, if
  4783.        the command is only for cosmetic purposes (maybe a text file
  4784.        to display some user statistics)  it would be better to skip
  4785.        the  command  and continue   straight to the next  menu. The
  4786.        rule is that the menu command will only be executed if it is
  4787.        the first entry in  the  menu  AND  it  is  not  a  'display
  4788.        textfile'  type function. 
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.        Special optional data switches
  4795.        ────────────────────────────────────────────────────────────
  4796.  
  4797.        There  are two special "switches" which may be placed at the
  4798.        end of the optional data field for any menu command:
  4799.  
  4800.        /NS    : This switch suppresses the usual clear screen  code
  4801.                 that   RemoteAccess   sends  when  a  new  menu  is
  4802.                 displayed, and is only useful when used with a menu
  4803.                 navigation (GOTO, GOSUB etc) command.
  4804.  
  4805.        /K=xxx : {+}  Registered  only.    This  switch  places  the
  4806.                 specified text <xxx> into  the user's  input buffer
  4807.                 to be processed  exactly as  if it had been entered
  4808.                 as a stacked command. This is an extremely powerful
  4809.                 facility which can be used to link a number of menu
  4810.                 commands together,  and customise a large number of
  4811.                 hard-coded selection menus.
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.                                     76
  4821.        Menu templates                      
  4822.        ────────────────────────────────────────────────────────────
  4823.  
  4824.        The  biggest  drawback of other BBS packages that allow  the
  4825.        sysop  the flexibility of designing his or her own menus  is
  4826.        the amount of maintenance that is necessary in updating  the
  4827.        menus.  Until  now it was necessary to have a separate  menu
  4828.        for  each  file  and message  area.  The  RemoteAccess  menu
  4829.        templating system alleviates this problem by allowing you to
  4830.        set  up one menu that will act as a "skeleton" for all  your
  4831.        message  and  file areas.  Two "variables" are available  to
  4832.        you; "M" for the currently selected message area and "F" for
  4833.        the currently selected file area.  In your template menu(s),
  4834.        where you would normally put the message area number in  the
  4835.        optional  data field for say a "Read" command,  put in "/M".
  4836.  
  4837.        When  the read is selected by the  user,  RemoteAccess  will
  4838.        substitute this for a message area number.  Likewise,  where
  4839.        you would specify a full path for a file function, put a "/F
  4840.        in  the optional data field.  RemoteAccess will replace this
  4841.        variable with the path to the currently selected file area.
  4842.  
  4843.        To put a value into one of these two variables, simply put a
  4844.        "/M=<Area  Number>"  or "/F=<Area Number>" in  the  optional
  4845.        data field of a type 1,  2 or 4 menu command.  For  example,
  4846.        say   you  set  up  a  message  area  template  menu  called
  4847.        "MSGMENU", using the /M in the optional data fields. Another
  4848.        menu,  which  you have set up to list the available  message
  4849.        areas,  simply consists of type 1 or 2 menu commands to jump
  4850.        to MSGMENU. One menu line looks like this:
  4851.  
  4852.             <H>ard Disk Conference
  4853.  
  4854.        This is a type 2 command,  which will "gosub" to the MSGMENU
  4855.        menu:
  4856.  
  4857.             Type : 2
  4858.  
  4859.        On the optional data line,  put the name of the menu to jump
  4860.        to, and also set the template variable.
  4861.  
  4862.             Optional Data : MSGMENU /M=45
  4863.  
  4864.        45 corresponds to the hard disk conference area,  as defined
  4865.        in RACONFIG.
  4866.  
  4867.        There  are two other constructs that work with the  template
  4868.        commands. /M=+ or /F=+ will increment the currently selected
  4869.        template area  by one, and /M=- or /F=- will  decrement  the
  4870.        currently  selected template area by one.  RemoteAccess will
  4871.        automatically  scan  all  file (or  message)  areas  in  the
  4872.        specified direction to determine the next area that the user
  4873.        has been given access to.
  4874.  
  4875.        The current message and file  template  areas are  stored at
  4876.        logoff,  and when the user logs  back on they will be set to
  4877.        these message and file template areas.      
  4878.  
  4879.  
  4880.  
  4881.                                     77
  4882.        When user  logs on  for the  first time,   RemoteAccess will
  4883.        scan the file and message areas  and set  the user  selected
  4884.        template areas to  the first  area found to  which the  user
  4885.        security rights.
  4886.  
  4887.        There are a number of special characters that you can put in
  4888.        the display line of a menu which will display certain system
  4889.        information:
  4890.  
  4891.  
  4892.             ~  :  Displays time remaining today.
  4893.  
  4894.             ^  :  Switches between the normal line colours and  the
  4895.                   overall menu highlight colours. 
  4896.  
  4897.             ;  :  Don't display a carriage return / linefeed at the
  4898.                   end of the line.
  4899.  
  4900.             @  :  Displays the name (as defined in RACONFIG) of the
  4901.                   currently selected file template area.
  4902.  
  4903.             `  :  Displays the name (as defined in RACONFIG) of the
  4904.                   currently selected message template area.
  4905.  
  4906.            ^A  :  This will force RemoteAccess  to  wait until  the
  4907.                   user  presses   the  enter key.    To  enter this
  4908.                   character in the menu,  press CTRL-P  followed by
  4909.                   CTRL-A.
  4910.         
  4911.        You may also include  any valid  textfile control  code,  as
  4912.        listed in the TEXTFILE CONTROL CODES section of this manual.
  4913.  
  4914.  
  4915.  
  4916.  
  4917.  
  4918.        The global menu
  4919.        ────────────────────────────────────────────────────────────
  4920.  
  4921.        It is likely that there are some commands that you will want
  4922.        to  be available from every menu that the user sees. Instead
  4923.        of  duplicating these  for every  single menu,  simply place
  4924.        them by  themselves in a menu  called GLOBALRA. RemoteAccess
  4925.        searches   for  this   special  menu   and  if   it  exists,
  4926.        automatically appends it to the end of every menu.
  4927.  
  4928.        RemoteAccess  appends the  whole menu;  in other  words, not
  4929.        just  the commands but any  visible text as  well. Note that
  4930.        the global menu will always inherit the highlight colours of
  4931.        the current menu  it is  appended to. This  feature is  only
  4932.        available in the registered version {+}.
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.                                     78
  4943.        Setting up your menus                      
  4944.        ────────────────────────────────────────────────────────────
  4945.  
  4946.        Spend  some  time thinking about how your menus will be  set
  4947.        up.  Your BBS can be made to look as unique or as  "uniform"
  4948.        as  you like - you can choose a subjective  topology,  where
  4949.        the  menus are organised according to area of interest, or a
  4950.        functional topology,  where menus are organised according to
  4951.        their  function.  For example,  a functional topology  would
  4952.        group  all  message  areas  together  and  all  file   areas
  4953.        together,  whereas a subjective topology would perhaps group
  4954.        together  several message and file areas that were  related.
  4955.  
  4956.        The  diagram  below illustrates this by depicting  the  same
  4957.        systems using the two different topologies:
  4958.  
  4959.        FUNCTIONAL
  4960.                                          +----------Amiga messages 
  4961.                  +---------Messages menu |
  4962.                  |                          +----------IBM messages
  4963.        Main menu |
  4964.                  |                       +----------Amiga files    
  4965.                  +------------Files menu |
  4966.                                          +----------IBM files
  4967.  
  4968.  
  4969.        SUBJECTIVE
  4970.                                          +----------IBM files
  4971.                  +--------------IBM menu | 
  4972.                  |                       +----------IBM messages
  4973.        Main menu |
  4974.                  |                       +----------Amiga files    
  4975.                  +------------Amiga menu |
  4976.                                          +----------Amiga messages
  4977.  
  4978.  
  4979.        Alternatively,  you  could even use a combination of the two
  4980.        topology types.
  4981.  
  4982.        The  layout of your BBS is determined by how the  menus  are
  4983.        set up. In many cases a user will not realise that he or she
  4984.        is looking at a menu.  The best technique for creating menus
  4985.        is to create all the "low-level" menus first,  then the main
  4986.        menu, and then fill in between with the intermediate menus.
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.                                     79
  5004.        Creating your menus                               
  5005.        ────────────────────────────────────────────────────────────
  5006.  
  5007.        Change to the system directory and fire up RACONFIG.EXE then
  5008.        select MANAGERS/MENUS;  this  then  takes  you into the menu
  5009.        editing  utility  which allows you to create and  edit  your
  5010.        menus.   When  run  it  will  present  you  with  a  list of
  5011.        languages,  after  selecting  the language  of the files you
  5012.        wish  to edit  you will then  be shown a  directory of menus
  5013.        that have already  been  created for that  language - select
  5014.        one,  with  the  cursor  keys and  press RETURN to edit,  or
  5015.        press INSERT to create a new menu.
  5016.  
  5017.        A  large  window  is opened that displays  a  line  by  line
  5018.        summary  of the menu.  You may select a menu item to work on
  5019.        by moving the highlight bar to the item with the cursor. You
  5020.        can then edit the following fields :
  5021.  
  5022.  
  5023.           User       : This field allows  you to  define what  will
  5024.           display      be displayed  to the  user on  the  menu for
  5025.                        this  menu  entry.   You may  use  any  text
  5026.                        control code in this field (See TEXT CONTROL
  5027.                        CODES section for  more information).  After
  5028.                        displaying  this  field  RemoteAccess  moves
  5029.                        the cursor down  one  line  to  prepare  for
  5030.                        the next menu command.   If you place  a ";"
  5031.                        as  the last  character on  the user display
  5032.                        line  RemoteAccess  will  not  move  down  a
  5033.                        and the  user  display  from the  next  menu
  5034.                        command will be added to the same line.
  5035.  
  5036.           Action     : Determines  what this  menu command will do.
  5037.                        (See MENU TYPES for more information).
  5038.  
  5039.           Optional   : This line is associated with the ACTION line
  5040.           data         and  contains  the option  parameter,  which
  5041.                        defines  how  the  various   menu   commands
  5042.                        function.   (See  MENU  TYPES   for  further
  5043.                        information) 
  5044.  
  5045.           Hot-Key    : In this field you specify the  key you  want
  5046.                        to activate this menu command.
  5047.  
  5048.           Automatic  : If enabled  this will make this menu command
  5049.                        execute immediately, without the user typing
  5050.                        any key.
  5051.  
  5052.           Colour     : This defines the colour of the USER DISPLAY.
  5053.  
  5054.           Security   : This defines the  minimum security level  at
  5055.                        which  a  user can select this menu command.
  5056.                        (See   the  SECURITY  section  for   further
  5057.                        details)
  5058.  
  5059.           Flags      : This sets  the flag  combinations  the  user
  5060.                        must have to select the  menu command.  (See
  5061.                        the SECURITY section for more details)
  5062.  
  5063.  
  5064.                                     80
  5065.        When editing the menus the following  keys are  available to
  5066.        assist you:
  5067.  
  5068.  
  5069.           [RETURN] - Edit the currently selected menu item.
  5070.  
  5071.           [INSERT] - Insert  a new menu item immediately before the
  5072.                      current item.
  5073.  
  5074.           [DELETE] - Delete the currently selected menu item.
  5075.  
  5076.           [ALT-D]  - Simulate what  the menu would look like  to  a
  5077.                      user.
  5078.  
  5079.           [ALT-L]  - Discard the  present  menu  and  load  another
  5080.                      from disk.
  5081.  
  5082.           [ALT-N]  - Re-select language.
  5083.  
  5084.           [ALT-P]  - View or modify the menu prompt, its colour and
  5085.                      the menu highlight colours.
  5086.  
  5087.           [ALT-S]  - Save the current menu to disk.
  5088.  
  5089.  
  5090.  
  5091.        You can run the menu editor directly,  without  having to go
  5092.        through the RACONFIG menus by  using the "-M"  parameter  on
  5093.        the RACONFIG command line,  For  example "RACONFIG -M"  (See
  5094.        the   section   on  COMMAND-LINE  PARAMETERS   for   further
  5095.        information).
  5096.  
  5097.  
  5098.        Let's create the LOGOFF menu.  Hit RETURN on the first blank
  5099.        menu  item to bring up the EDIT MENU ITEM window.  The first
  5100.        line  of this menu will just display a message to the  user,
  5101.        so  in  the  USER DISPLAY field,  put "You  have  chosen  to
  5102.        disconnect.  You may -". Move to the ACTION field and set it
  5103.        to  DISPLAY  ONLY.  Next select a suitable  colour  for  the
  5104.        display  line  in  the COLOUR field.  Since this is  only  a
  5105.        display line,  leave SECURITY and FLAGS as they  are.  Press
  5106.        ESCAPE  to return to the menu list,  and note the entry  you
  5107.        have just created.
  5108.  
  5109.        Now enter the user options for the menu.  Move to the second
  5110.        menu  entry  (add one with the INSERT key if necessary)  and
  5111.        press  RETURN  to edit.  We'll give the user the  option  of
  5112.        leaving a message to the sysop, so in the USER DISPLAY field
  5113.        enter  "<L>eave a message to the sysop".  Set the ACTION  to
  5114.        POST  A NEW  MESSAGE (this is under the heading of  MESSAGE-
  5115.        BASE COMMANDS). This command requires a couple of parameters
  5116.        in the optional data field - the number of the message  area
  5117.        to  post the message in and the /T= parameter,  to force the
  5118.        message  to be addressed to the sysop.  It might  look  like
  5119.        this:
  5120.  
  5121.  
  5122.        80 /T=Andrew_Milner
  5123.  
  5124.  
  5125.                                     81
  5126.        (Message area 80 is set up as a "Messages to the sysop" area
  5127.        that  contains local private messages).  Set the HOT-KEY  to
  5128.        "L"  - this is the key that will activate the  function.  We
  5129.        want  all  users to be able to leave a message,  so set  the
  5130.        security level to 1.
  5131.  
  5132.        The  third  line of the menu gives the user  the  option  of
  5133.        returning  to  the previous menu,  so set this to a type  3,
  5134.        with a suitable display line.
  5135.  
  5136.        The  actual log-off command is last.  This will be a type  9
  5137.        (Terminate  Call).  Set the hot-key to "G" and  the  display
  5138.        line to something like "<G>oodbye (Logoff)".
  5139.  
  5140.        The  final step is to set the highlight and prompt  options.
  5141.        Press  ALT-P  from the menu list to bring up the  EDIT  MENU
  5142.        SETTINGS  window.  Here you can tailor the menu by selecting
  5143.        the  menu  prompt  and  its  colour,  along  with  the  menu
  5144.        highlight colour.  Each menu line,  in addition to it's  own
  5145.        colour,  may  contain an overall menu highlight  colour.  To
  5146.        switch between the two colours on a menu line, simply insert
  5147.        the  ^  character;  Note that this character isn't  actually
  5148.        displayed  to  the  user,   it  just  toggles  the  colours.
  5149.  
  5150.        Experiment with this feature by inserting a few ^ characters
  5151.        on display lines and viewing the menu with the ALT-D key.
  5152.  
  5153.        Finally,  save  the menu by going back to the menu list  and
  5154.        pressing  ALT-S.  Save the menu with the name  LOGOFF.  Now,
  5155.        whenever  you need a "Goodbye" option in another menu,  just
  5156.        use a gosub (type 2) function to the menu LOGOFF.
  5157.  
  5158.        There  is  one  hard-coded  menu  called  TOP.  RemoteAccess
  5159.        searches  for this menu when a user logs on and displays  it
  5160.        first,  so it MUST be present. The layout of the top menu is
  5161.        up to you of course;  it is recommended that you look at the
  5162.        menus of other Bulletin Boards so you can incorporate  their
  5163.        best features into your own.
  5164.  
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.  
  5173.  
  5174.  
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.                                     82
  5187.        EXTERNAL SUPPORT FILES
  5188.        ────────────────────────────────────────────────────────────
  5189.                     
  5190.        There  is  very little that is  actually  "hard-coded"  into
  5191.        RemoteAccess. Below is a listing of text files you can place
  5192.        in  the  text  file directory to give your system  just  the
  5193.        right "feel". See the section on TEXT FILE CONTROL CODES for
  5194.        a  list  of special characters that can be used  to  display
  5195.        system  and user information from any of these files.  Files
  5196.        marked  with  an asterisk (*) have a default prompt  if  the
  5197.        file is missing. All the files are plain ASCII which you can
  5198.        create  with your favourite  text  editor/wordprocessor such
  5199.        as the one in  RACONFIG,  or optionally ANSI  which you will
  5200.        need a special ANSI editor to create. RemoteAccess also  has
  5201.        the ability to display AVATAR files, which display faster if
  5202.        the user has an AVATAR terminal, and  can be  generated from
  5203.        your ANSI files by using the AVTCONV utility  supplied.  See
  5204.        the section on TERMINAL  EMULATIONS for further information.
  5205.  
  5206.  
  5207.  
  5208.        1ATATIME.A?? :  This file is displayed  if  a user tries  to
  5209.         *              log  on  to more  than one  line at once  if
  5210.                        multi-line  check  has   been   enabled   in
  5211.                        RACONFIG.
  5212.  
  5213.        ALTNEWS.A??  :  This file is displayed ONLY if  the NEWS.A??
  5214.                        file was not displayed to the  user  because
  5215.                        he/she requested to  skip it during an IEMSI
  5216.                        session.  If you want  all users to see your
  5217.                        news file regardless,  simply  copy NEWS.A??
  5218.                        to ALTNEWS.A??.
  5219.  
  5220.        BADFILES.A?? :  This file is displayed if the  user attempts
  5221.         *              to upload a  file  that  is  listed  in  the
  5222.                        BADFILES.CTL control file.
  5223.  
  5224.        BADPWD.ASC   :  This file is  displayed  when a user  enters
  5225.                        an incorrect  password and elects to leave a
  5226.                        message to the sysop.
  5227.  
  5228.        BIRTHDAY.A?? :  This file is displayed if  the current  date
  5229.                        is the same as the user's birthdate.
  5230.  
  5231.        DATEFMT.A??  :  This file is  displayed  just before  a user
  5232.         *              selects a new date format.   
  5233.  
  5234.        DNLDHRS.A??  :  This file is  displayed  if a  user attempts
  5235.         *              a  download  outside  the  allowed  hours as
  5236.                        defined in RACONFIG.
  5237.  
  5238.        EDITHELP.A?? :  This  file is displayed if the user asks for
  5239.                        help   while  using  the  built-in   message
  5240.                        editor.  
  5241.         
  5242.        ENDCHT.A??   :  This  file  is  displayed  when   the  sysop
  5243.         *              terminates chat  mode.
  5244.  
  5245.  
  5246.  
  5247.                                     83
  5248.        EXPIRED.A??  :  This   file   is  displayed  if  the  user's
  5249.         *              password has just expired,  just before  the
  5250.                        user is asked for a new password.
  5251.  
  5252.        FILEAREA.A?? :  If present, this file will be displayed when
  5253.                        the user is asked to select a  new file area
  5254.                        in place of the normal hard-coded list.
  5255.  
  5256.        GOODBYE.A??  :  This file is displayed when the  user elects
  5257.                        to   log  off,   just  before  the  user  is
  5258.                        disconnected.
  5259.  
  5260.        GROUP#.A??   :  These  files are  displayed  to users  of  a
  5261.                        particular group directly after the SEC#.A??
  5262.                        file.    For example,  the  file  GROUP1.A??
  5263.                        would be displayed to all users belonging to
  5264.                        user group 1.
  5265.  
  5266.        HANDLE.A??   :  This file is displayed just  before the user
  5267.                        is asked to choose a new handle.
  5268.  
  5269.        LANGUAGE.A?? :  This file is displayed in place  of the hard
  5270.         *              coded language selection list.
  5271.  
  5272.        LOCKOUT.A??  :  This  file is  displayed if  the sysop  uses
  5273.         *              ALT-L  while  a  user  is  on-line  to  lock
  5274.                        him/her out of the system.
  5275.  
  5276.        LOGO.A??     :  This   file  is   displayed  as  soon  as  a
  5277.                        connection is made.  This should contain the
  5278.                        name  of your system and perhaps some  other
  5279.                        general   information.  If  the  "Auto ANSI"
  5280.                        option  is enabled  in  RACONFIG,   RA  will
  5281.                        attempt  to  automatically   detect  if  the
  5282.                        remote terminal  is using  ANSI,  and  if so
  5283.                        will send the ANS file in place  of the  ASC
  5284.                        file. 
  5285.  
  5286.        MAILHELP.A?? :  This file is displayed if the  user asks for
  5287.                        help at the mailbox scan  prompt.  Note that
  5288.                        the user is only offered  help if  this file
  5289.                        actually exists.
  5290.  
  5291.        MAXPAGE.A??  :  This  file  is displayed  if a user tries to
  5292.         *              page  the sysop for a chat more  times  than
  5293.                        you have specified in RACONFIG.
  5294.  
  5295.        MSGAREA.A??  :  If present, this file is displayed  when the
  5296.                        user is  asked  to  select a message area in
  5297.                        place of the normal hard-coded list.
  5298.  
  5299.        MSGFWD.A??   :  If the user has message forwarding enabled  
  5300.                        this file will be displayed at logon.  
  5301.  
  5302.        NEWS.A??     :  This file is a general news bulletin that is
  5303.                        displayed  after  RemoteAccess  checks   for
  5304.                        waiting mail (if the option is enabled),  or
  5305.                        straight after the WELCOME file.     
  5306.  
  5307.  
  5308.                                     84
  5309.        NEWUSER1.ASC :  This file is displayed to a new user as soon
  5310.                        as  he/she  confirms  that  he/she   entered
  5311.                        his/her name correctly.
  5312.  
  5313.        NEWUSER2.A?? :  This  file  is displayed after the user  has
  5314.                        confirmed  that   he/she  entered  all   the
  5315.                        standard logon questions correctly.
  5316.  
  5317.        NO300.ASC    :  This file is  displayed if a 300 baud caller
  5318.         *              attempts  to log  on during hours  when  300
  5319.                        baud   is   not  allowed,   as  defined   in
  5320.                        RACONFIG.
  5321.  
  5322.        NOCREDIT.A?? :  This  file is displayed if a caller attempts
  5323.         *              to  enter a netmail message for which he/she
  5324.                        does not have sufficient credit.
  5325.  
  5326.        NOTAVAIL.A?? :  This  file  is displayed  if a user tries to
  5327.         *              page  the  sysop for a chat  outside  paging
  5328.                        hours, as defined in RACONFIG.
  5329.  
  5330.        NOTFOUND.ASC :  This   file  is  displayed  if  RemoteAccess
  5331.         *              cannot  locate the name of a user at  logon,
  5332.                        but before the user is asked to confirm that
  5333.                        he/she entered the name correctly.
  5334.  
  5335.        NOTSYSOP.A?? :  This file is displayed if a user attempts to
  5336.         *              post  a  message to "Sysop" in  an  EchoMail
  5337.                        message area.
  5338.  
  5339.        ONCEONLY.A?? :  This  file  is   displayed  just  after  the
  5340.                        NEWS.A?? file only once whenever the file is
  5341.                        altered, to each user.
  5342.  
  5343.        PAGEABRT.A?? :  This  file is displayed if the sysop chooses
  5344.         *              to abort a page for chat by the user.
  5345.  
  5346.        PAGED.A??    :  This  file is  displayed  after the user has
  5347.                        paged  for  a  chat if the  sysop  does  not
  5348.                        answer the page.  Something like "Okay,  the
  5349.                        sysop has been paged and will break in for a
  5350.                        chat if he/she walks past."
  5351.  
  5352.        PASSWORD.A?? :  This  file  is displayed before the user  is
  5353.                        asked  to select a new password.  This  file
  5354.                        should  stress the importance of choosing  a
  5355.                        suitable password!
  5356.  
  5357.        PRIVATE.ASC  :  This file  is displayed  if a new user tries
  5358.         *              to log on to your system and you have set it
  5359.                        up as a private, pre-register BBS. 
  5360.  
  5361.        RATIO.A??    :  This  file is displayed if the user tries to
  5362.         *              do  a  download which would  exceed  his/her
  5363.                        ratio of number of files.
  5364.  
  5365.        RATIOK.A??   :  This  file is displayed if the user tries to
  5366.         *              do  a  download which would  exceed  his/her
  5367.                        ratio of K of uploads to K of downloads.
  5368.  
  5369.                                     85
  5370.        READHELP.A?? :  This  file is displayed if the user asks for
  5371.                        help while reading messages.
  5372.  
  5373.        SEC#.A??     :  These  files are  displayed  to users  of  a
  5374.                        particular security level directly after the
  5375.                        WELCOME file,  but before the mail check (if
  5376.                        enabled).     For    example,    the    file
  5377.                        SEC10.ASC/ANS/AVT,  if  present,  would   be
  5378.                        displayed  to all users with security  level
  5379.                        10. 
  5380.  
  5381.        STARTCHT.A?? :  This file is displayed when the sysop breaks
  5382.         *              in for a chat  via  ALT-C.  Using the  shell
  5383.                        from    textfile    function    this   could
  5384.                        conceivably  be used to activate an external
  5385.                        chat utility.  See also ENDCHT.A??
  5386.  
  5387.        TIMEhh.A??   :  This  file is  displayed after WELCOME1.A??,
  5388.                        when  "hh" matches  the current  hour number
  5389.                        (24  hour  format). 
  5390.  
  5391.        TIMEWARN.A?? :  This  file  is displayed  at log  on if  the
  5392.         *              user's  time  limit  has  been  adjusted  to
  5393.                        accomodate an upcoming event.
  5394.  
  5395.        TODAYK.A??   :  This  file is displayed if the user attempts
  5396.         *              a download which would exceed his/her  daily
  5397.                        download limit.
  5398.  
  5399.        TOOSLOW.ASC  :  This  file  is displayed if a user tries  to
  5400.         *              log  on  at a speed lower than  the  minimum
  5401.                        required to log on to your system as defined
  5402.                        in RACONFIG. 
  5403.  
  5404.        TRASHCAN.ASC :  This  file  is displayed if a user enters an
  5405.         *              unacceptable  name at log on,  as listed  in
  5406.                        the TRASHCAN.CTL file. 
  5407.  
  5408.        VIP.A??      :  If  the user  who has logged on is listed in
  5409.                        the   VIP.CTL   file,  this  file   will  be
  5410.                        displayed just before the SEC#.A?? file.    
  5411.  
  5412.        WELCOME.A??  :  This file is displayed after the user logged
  5413.                        on,  or  in the case of a  new  user,  after
  5414.                        completing the new user procedure.  This can
  5415.                        be  a  fairly  elaborate title  screen  that
  5416.                        welcomes your users to the BBS.
  5417.  
  5418.        WELCOME1.A?? :  This file is  displayed  directly after  the
  5419.                        WELCOME file, and could contain extra system
  5420.                        information,   maybe  a  "today  in history"
  5421.                        quote, or something similar.
  5422.  
  5423.        XFERHELP.A?? :  This file is  displayed if the user  presses
  5424.                        the "?" key  on the  file  transfer protocol
  5425.                        selection menu.  It  should contain  general
  5426.                        information about  the  different  protocols
  5427.                        themselves.
  5428.  
  5429.  
  5430.                                     86
  5431.        XFERPROT.A?? :  This file is displayed  in place of the hard
  5432.         *              coded file transfer protocol selection.
  5433.  
  5434.        XFERTIME.A?? :  This  file is displayed if the user attempts
  5435.         *              a  download that would exceed his/her  daily
  5436.                        time limit.
  5437.  
  5438.  
  5439.  
  5440.  
  5441.        In   addition to these ASC/ANS/AVT files, there are a number
  5442.        of *.CTL files  that define various security aspects  of the
  5443.        system:
  5444.  
  5445.        BADFILES.CTL :  This file  allows you to  specify a list  of
  5446.                        files  that  users  may not  upload.  Simply
  5447.                        specify one file per line (wildcards valid),
  5448.                        for example:
  5449.  
  5450.                        *.GIF
  5451.                        NORTON*.*
  5452.  
  5453.                        Would not allow any files matching either of
  5454.                        these two patterns to be uploaded.
  5455.  
  5456.        FILES.CTL     : This   file   allows   you   to   mark   any
  5457.                        downloadable  file  on  your  system as free
  5458.        {+}             and/or  password  protected.  The  format of
  5459.        Registered      this file is:
  5460.        Only
  5461.                        <filespec> [/FREE] [/PWD=xxx]
  5462.  
  5463.  
  5464.                        Example:
  5465.  
  5466.                        \RAFILES\RA_110.ARJ /FREE
  5467.                        \RABETAS\RABETA.ARJ /FREE /PWD=RACCESS
  5468.  
  5469.  
  5470.                        Note  that  each   filename  must  be  fully
  5471.                        qualified with a path (drive name optional).
  5472.  
  5473.                        Here, RA_110.ARJ is  free.   Downloading  it
  5474.                        will   not   affect   the  user's   download
  5475.                        statistics.  Note that  even though the file
  5476.                        is free in this regard,  the user must still
  5477.                        have enough time remaining for the download.
  5478.  
  5479.                        RABETA.ARJ   is  both  free   and   password
  5480.                        protected with  the  password  RACCESS.  The
  5481.                        user must supply the correct password before
  5482.                        being allowed to  proceed with the download.
  5483.                        Passwords are case insensitive and a maximum
  5484.                        of 15 characters in length. 
  5485.  
  5486.  
  5487.        HANDLES.CTL   : This  file  allows you to list handles  that
  5488.                        you don't want people to be able to use.  It
  5489.                        is identical in format  to the TRASHCAN.CTL.
  5490.  
  5491.                                     87
  5492.        LIMITS.CTL    : This   file  allows  you  specify,  for each
  5493.                        security  level,  a daily time  limit,  file
  5494.                        download  limit  for  each  baud  rate,  and
  5495.                        optional  file ratios,  either in number  of
  5496.                        uploads to number of downloads,  or in total
  5497.                        kilobytes   uploaded   to  total   kilobytes
  5498.                        downloaded.  The  format of the file  is  as
  5499.                        follows:
  5500.  
  5501.        <Sec Lvl> <Time> <300> [1200] [2400] [4800] [9600]
  5502.          or:
  5503.        <Sec Lvl> <Time> <300> <1200> <2400> <4800> <9600> <R#> [RK]
  5504.  
  5505.                        Where  <Sec  Lvl>  is  the  security  level,
  5506.                        <Time>  is  the daily time limit,  <300>  to
  5507.                        <9600>   are  respective   download   limits
  5508.                        depending  on what baud rate the user  calls
  5509.                        at.   <R#>   is  the  ratio  of  uploads  to
  5510.                        downloads,  and [RK] is the ratio of uploads
  5511.                        in K to downloads in K.
  5512.  
  5513.                        If you only specify a download limit for say
  5514.                        300, 1200 and 2400 baud, the download limits
  5515.                        for  the  higher baud rates default  to  the
  5516.                        highest  baud rate specified,  in this  case
  5517.                        the limit set for 2400 baud.
  5518.  
  5519.                        If you specify a ratio by number (R#) value,
  5520.                        then the user will be required to upload one
  5521.                        file for every n they  download.  Similarly,
  5522.                        setting  the ratio by K will allow the  user
  5523.                        to  download only the specified kilobytes of
  5524.                        files per 1 kilobyte uploaded.
  5525.  
  5526.  
  5527.                        This is fairly complicated,  so look at this
  5528.                        example LIMITS.CTL:  
  5529.  
  5530.                            5  35  0
  5531.                            10 60  100 200 350 650 900 5 10
  5532.                            20 90  150 250 470 750 900 5
  5533.                            30 120 250 400 600 900 1200
  5534.                            50 300 900
  5535.  
  5536.  
  5537.                        Security  level  5 entitles the user  to  35
  5538.                        minutes per day, but no downloads.
  5539.  
  5540.                        Security  level 10 entitles the user  to  60
  5541.                        minutes  per day,  100k of downloads at  300
  5542.                        baud,  200k at 1200 baud, 350k at 2400 baud,
  5543.                        650k at 4800 baud,  and 900k at 9600 baud or
  5544.                        faster. In addition, the user must upload at
  5545.                        least  one  file for every five  downloaded,
  5546.                        and may not download more than ten times the
  5547.                        total size of files uploaded.
  5548.  
  5549.  
  5550.  
  5551.  
  5552.                                     88
  5553.                        Security  level 20 entitles the user  to  90
  5554.                        minutes  per day,  150k of downloads at  300
  5555.                        baud,  250k at 1200 baud, 470k at 2400 baud,
  5556.                        750k  at 4800 baud and 900k at 9600 baud  or
  5557.                        faster.  In  addition,  the  user  may  only
  5558.                        download  five  times  the number  of  files
  5559.                        he/she uploaded.
  5560.  
  5561.                        Security  level 30 entitles the user to  120
  5562.                        minutes  per day,  250k of downloads at  300
  5563.                        baud,  400k at 1200 baud, 600k at 2400 baud,
  5564.                        900k at 4800 baud and 1,200k at 9600 baud or
  5565.                        faster. There are no ratio restrictions.
  5566.  
  5567.                        Security  level 50 entitles the user to  300
  5568.                        minutes  per day,  and 900k of downloads  at
  5569.                        all speeds without any ratio restrictions.
  5570.  
  5571.        NAMES.CTL     : RemoteAccess    allows    you   to    assign
  5572.                        "shortnames"  to  users  you frequently send
  5573.                        messages to. Set up this  text file with the
  5574.                        following format, one entry per line:
  5575.  
  5576.                        <shortname>,<realname>,<address>[,<subject>]
  5577.  
  5578.                        Eg:
  5579.                        rahq,Andrew Milner,2:270/18,RemoteAccess..
  5580.  
  5581.                        To  use  this  feature,   simply  enter  the
  5582.                        shortname   preceded  by  an  asterisk  when
  5583.                        RemoteAccess asks you who the message is to.
  5584.                        In the above  example,  addressing a message
  5585.                        to "*rahq" would fill  in the to  field with
  5586.                        "Andrew Milner",  and the subject field with
  5587.                        "RemoteAccess..". If the message is netmail,
  5588.                        it would automatically be sent to 2:270/18.
  5589.  
  5590.  
  5591.        PHONENUM.CTL  : Use this file to  specify phone  numbers or 
  5592.                        segments  of phone  numbers  that you  know 
  5593.                        to be false. A PHONENUM.CTL  that contains:
  5594.  
  5595.                            00-
  5596.                            000-
  5597.                            -0000
  5598.  
  5599.                        Would  disallow  the numbers  "00-123-4567",
  5600.                        "000-123-4567",  "009-0000-1234".  The  rule
  5601.                        here  is that none of the specified  numbers
  5602.                        is  allowed to be imbedded anywhere  in  the
  5603.                        user's phone number.
  5604.  
  5605.        PWDTRASH.CTL  : Allows  you  to specify a list of  passwords
  5606.                        that  users  are not allowed  to  use.  This
  5607.                        could  contain  passwords  like  SECRET,  or
  5608.                        TEST.
  5609.  
  5610.  
  5611.  
  5612.  
  5613.                                     89
  5614.        TRASHCAN.CTL  : Allows  you  specify  a list of  names  that
  5615.                        users may not use to log on to your  system.
  5616.                        In this file,  specify the undesirable names
  5617.                        one  per  line.  If for example you did  not
  5618.                        want  the names "Sysop",  "Jack  Daniels" or
  5619.                        "Superman"  used,  simply put the  following
  5620.                        lines in this file:
  5621.  
  5622.                            Sysop
  5623.                            Jack Daniels
  5624.                            Superman
  5625.  
  5626.                        The   tests  done  on  names  is  NOT  case-
  5627.                        sensitive, so the name "SYSOP" would also be
  5628.                        invalid. Names that contain any part of  the
  5629.                        names in the list are not allowed either.
  5630.  
  5631.  
  5632.        VIP.CTL       : When a user who is listed in this file logs 
  5633.                        on,  a  short  bell is sounded at the local 
  5634.                        console,  and  if  the there is any text in 
  5635.                        the user's COMMENT  field (see "Information 
  5636.                        stored  in  the  user   database"),  it  is 
  5637.                        displayed on the status bar.
  5638.  
  5639.                        The format for this file is the same as the 
  5640.                        TRASHCAN.CTL and HANDLES.CTL files.
  5641.  
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.  
  5665.  
  5666.  
  5667.  
  5668.  
  5669.  
  5670.  
  5671.  
  5672.  
  5673.  
  5674.                                     90
  5675.        THE USER DATABASE
  5676.        ────────────────────────────────────────────────────────────
  5677.  
  5678.        The  user file is possibly the most important single file on
  5679.        your BBS.  It contains all the information about each user's
  5680.        history, screen settings,  and vital security  data.  To use
  5681.        the user editor  fire up RACONFIG and  select Users from the
  5682.        Manager menu.  This  editor  allows  you  to add,  modify or
  5683.        delete any  user's record.  If  there are already some users
  5684.        in the user-file,  you will be presented with a list showing
  5685.        each user's  name,  location and  security  level.  Select a
  5686.        user either by typing in the name,  or moving the  highlight
  5687.        bar to the entry on the screen and pressing RETURN.
  5688.  
  5689.        After  the  user is selected you will be presented with  the
  5690.        Edit Screen.  This lists the entire user's record which  can
  5691.        be modified and saved if you wish. 
  5692.  
  5693.        If  there  are no users already in the user-file,  the  Edit
  5694.        Screen will appear immediately for you to enter the  details
  5695.        of  the  first user.  Note that the only required  piece  of
  5696.        information (or "field") is the name,  and you can't proceed
  5697.        any further until you enter one.  You'll want to be included
  5698.        in  the  user file,  so enter your own name in  this  field.
  5699.  
  5700.        After entering the user name,  you may continue to enter all
  5701.        fields.    When  you have finished  editing the  user record
  5702.        press  [CONTROL-ENTER]  to  save  the information  and  then
  5703.        ESCAPE to exit. If you don't want to save, just press ESCAPE
  5704.        by itself.
  5705.  
  5706.         
  5707.        The following keys can be used to assist  you in editing the
  5708.        user database:
  5709.  
  5710.  
  5711.           [INS]    This allows  you to add a new user, when pressed
  5712.                    in the  user list  screen,  a blank record  will
  5713.                    be created for you to  edit.
  5714.  
  5715.           [DEL]    Deleting a user  is accomplished  by  moving the
  5716.                    highlight bar to the user you want to delete and
  5717.                    pressing the DEL  key.  A marker  will appear in
  5718.                    the right hand column to  signify that the  user
  5719.                    is marked for deletion. Note that the user isn't
  5720.                    actually  removed  from  the user  file at  this
  5721.                    stage.  Users that have been marked for deletion
  5722.                    are  removed  by  packing  the user-file,  which
  5723.                    should be  done  regularly  using   the  utility
  5724.                    RAUSER.
  5725.  
  5726.           [ALT-S]  If you  want  to search  for a  particular  user
  5727.                    record to  edit,  you can  press ALT-S,  you are
  5728.                    then prompted for the search criteria at the top
  5729.                    of the screen.
  5730.  
  5731.        You can  run the user editor directly   without having to go
  5732.        through the RACONFIG menus by entering "RACONFIG -U".
  5733.  
  5734.  
  5735.                                     91
  5736.        Information stored in the user database
  5737.        ────────────────────────────────────────────────────────────
  5738.  
  5739.        This  section  details all  the information  contained about
  5740.        each user in the user database:
  5741.  
  5742.  
  5743.        Name               : User's full name
  5744.        Handle             : User's registered handle
  5745.        Location           : Where the user is calling from
  5746.        Password           : Secret password
  5747.        Security           : Security level (1-64000, 0 to lock out)
  5748.        Home#              : Home/voice telephone number
  5749.        Business#          : Business/data telephone number
  5750.        A flags            : "A" flag settings ("-" or "X")
  5751.        B flags            : "B" flag settings ("-" or "X")
  5752.        C flags            : "C" flag settings ("-" or "X")
  5753.        D flags            : "D" flag settings ("-" or "X")
  5754.        Credit             : Netmail credit remaining
  5755.        Pending            : Value of unsent (unexported) netmail
  5756.        Uploads            : Total number of uploads
  5757.        Dnloads            : Total number of downloads
  5758.        UploadK            : Total kilobytes of uploads
  5759.        DnloadK            : Total kilobytes of downloads
  5760.        TodayK             : Kilobytes downloaded today
  5761.        Comment            : Comment, can contain anything
  5762.        Forward            : Name person mail is being forwarded to
  5763.        Last time          : Time user last called
  5764.        Last date          : Date user last called
  5765.        1st date           : Date user first called
  5766.        Sub date           : Subscription expiry date
  5767.        Birthdate          : Date of birth
  5768.        Time used today    : Minutes used today
  5769.        Screen length      : User's screen length
  5770.        Last Pwd change    : Number of calls since last pwd change
  5771.        Messages posted    : Total number of messages posted
  5772.        High msg read      : Highest message read
  5773.        Number of calls    : Number of calls the user has made 
  5774.        Last msg area      : Last msg area the user had selected 
  5775.        Last file area     : Last file area the user had selected
  5776.        Deleted            : Delete user when database is packed?
  5777.        Screen clear       : Send screen clear codes?
  5778.        Page pausing       : Pause at the end of each screen?
  5779.        ANSI graphics      : Send ANSI codes?
  5780.        AVATAR graphics    : Send AVATAR codes?
  5781.        No Kill            : Never kill user?
  5782.        Xfer priority      : Ignore download hours and ratios? 
  5783.        Full screen editor : Use the full screen ANSI msg editor?
  5784.        Quiet mode         : Ignore online messages?
  5785.        Hot-keys           : Use hotkeys?
  5786.        Full screen viewer : Use the full screen msg viewer?
  5787.        Hidden             : Hidden from the user list?
  5788.        Group number       : User's group number (1 - 255)
  5789.        Language           : Language number selected
  5790.        Date Format        : Date entry format
  5791.  
  5792.  
  5793.  
  5794.  
  5795.  
  5796.                                     92
  5797.        Packing and sorting the user file               
  5798.        ────────────────────────────────────────────────────────────
  5799.  
  5800.        RAUSER.EXE is the utility that is used to maintain the user-
  5801.        file.  Not only will it remove users marked for deletion, it
  5802.        can  also delete users that have not called your BBS  for  a
  5803.        certain number of days as well as sort the users in order of
  5804.        security  level  and surname.  RAUSER may be  run  from  any
  5805.        directory,  will automatically locate system and user files,
  5806.        and will insert an activity summary in your system log.  The
  5807.        following command-line parameters are valid:
  5808.  
  5809.  
  5810.             -P       Pack the user-file, removing users marked  for
  5811.                      deletion.
  5812.  
  5813.             -S       Sort users in  order  of  security  level  and
  5814.                      surname.
  5815.  
  5816.             -D[n]    Delete users who have not called for [n] days.
  5817.                      Note that this parameter implies a pack       
  5818.                      operation.
  5819.  
  5820.             -V       Verbose logging; list any users that were     
  5821.                      deleted during a pack operation.
  5822.  
  5823.             -M[s]    Specify the maximum security level user to be 
  5824.                      affected by a pack or delete  operation.  Put 
  5825.                      another way : "exempt all users with security 
  5826.                      level [s] and above from being deleted" .
  5827.  
  5828.  
  5829.  
  5830.  
  5831.  
  5832.  
  5833.  
  5834.  
  5835.  
  5836.  
  5837.  
  5838.  
  5839.  
  5840.  
  5841.  
  5842.  
  5843.  
  5844.  
  5845.  
  5846.  
  5847.  
  5848.  
  5849.  
  5850.  
  5851.  
  5852.  
  5853.  
  5854.  
  5855.  
  5856.  
  5857.                                     93
  5858.        THE MESSAGE DATABASE
  5859.        ────────────────────────────────────────────────────────────
  5860.  
  5861.        RAMSG is the RemoteAccess message  base maintenance utility.
  5862.        It's primary function is  to trim the number of  messages in
  5863.        local   and echomail conferences  and maintain them   at   a
  5864.        manageable   level. RACONFIG provides the  ability to enter,
  5865.        add  and  maintain     message  areas  -  RAMSG  uses   this
  5866.        information (contained in MESSAGES.RA)  to delete old and/or
  5867.        excess  messages.   RAMSG will   also   attempt   to  repair
  5868.        damaged  message bases; it has a  number of integrity checks
  5869.        built  in so that  if it detects  that the message  base  is
  5870.        damaged in  any way,  it will automatically  re-create index
  5871.        files  (even   if  they are  missing)  and warn  of possible
  5872.        problems.
  5873.  
  5874.        All of   RAMSG's activities are logged in  the  system  log.
  5875.        Some options are provided for statistical information.
  5876.  
  5877.        Note that a value of 0 in any of  the fields on the  message
  5878.        area entry  screen in  RACONFIG will cause  RAMSG to  ignore
  5879.        that  option. For example, if the maximum number of messages
  5880.        is set  to 0, RAMSG will not  kill messages based on number.
  5881.        Prior to running  RAMSG, you  should  ensure  that all areas
  5882.        have been set up correctly.
  5883.  
  5884.        RAMSG invoked  without a command line  results  in   a  help
  5885.        screen being displayed.
  5886.  
  5887.        When  one or more of the arguments below is specified, RAMSG
  5888.        searches  for CONFIG.RA  (first the current  directory, then
  5889.        via the  RA  environment  variable),  MESSAGES.RA  (in   the
  5890.        current directory,  then the system directory)  and then the
  5891.        message base files.   Failure to  find one or more  of these
  5892.        files will result in  RAMSG aborting. If CONFIG.RA is  found
  5893.        and the system  log file can be  opened, RAMSG will  log any
  5894.        errors there.
  5895.  
  5896.  
  5897.  
  5898.  
  5899.  
  5900.  
  5901.        Message database size limitations
  5902.        ────────────────────────────────────────────────────────────
  5903.  
  5904.        Due  to the  message  database file  structures, there  is a
  5905.        maximum  physical limit  on the  number  of messages  it can
  5906.        contain.  The maximum  number of  messages the  database can
  5907.        hold is approximately 16,000.  You should configure RAMSG so
  5908.        that this limit is never exceeded.
  5909.  
  5910.        There  is  also a  limitation on  the  value of  the highest
  5911.        numbered message, which may never  exceed 32,767. It is good
  5912.        practice  to regularly  (preferably  nightly)  renumber  the
  5913.        message  database  to  ensure   that  this  limit  is  never
  5914.        breached.
  5915.  
  5916.  
  5917.  
  5918.                                     94
  5919.        Packing and renumbering the message base
  5920.        ────────────────────────────────────────────────────────────
  5921.  
  5922.        RAMSG Command summary
  5923.        ---------------------
  5924.  
  5925.         -I Re-create index files & check
  5926.            C=Kill crosslinked messages
  5927.            U=Kill unknown boards
  5928.            R=Renumber
  5929.  
  5930.         -P Pack (compress) message base
  5931.            K=Purge 
  5932.            R=Renumber
  5933.            O=Overwrite
  5934.            A=Overwrite if necessary 
  5935.  
  5936.         -K Purge messages from info in MESSAGES.RA
  5937.  
  5938.         -L Link reply chains
  5939.  
  5940.         -R Renumber messages
  5941.  
  5942.         -S Display/log message base statistics
  5943.            All options:  S=Statistics  V=Verbose stats
  5944.  
  5945.  
  5946.  
  5947.  
  5948.        RAMSG functions (NOT case sensitive)
  5949.        ------------------------------------
  5950.  
  5951.                -I      INDEX [Options : C, R, U]
  5952.  
  5953.                        This  option  rebuilds   the   message  base
  5954.                        index files,  MSGIDX.BBS,  MSGTOIDX.BBS  and
  5955.                        MSGINFO.BBS. It also checks the integrity of
  5956.                        all  message  base  files and rebuilds other
  5957.                        information  as  necessary.  Errors  in  the
  5958.                        message base are logged.
  5959.  
  5960.                        During the  index  rebuild,  you  may choose
  5961.                        to  delete  messages  from  unknown  message
  5962.                        areas (those areas which  have no  entry  in
  5963.                        the name field)  and  messages  with message
  5964.                        board  numbers  outside  the valid  range of
  5965.                        1-200.
  5966.  
  5967.                        Under some circumstances RAMSG  may detect a
  5968.                        "sequence error" (when  numbers are  out  of
  5969.                        order).  Since   this   causes   significant
  5970.                        problems with  software  using  the  message
  5971.                        base,  RAMSG  considers  this  serious,  and
  5972.                        therefore   will   not  proceed   with   any
  5973.                        operation other than an index  rebuild until
  5974.                        this is corrected using the "R"  option,  to
  5975.                        force message base renumbering.
  5976.  
  5977.  
  5978.  
  5979.                                     95
  5980.                        "Crosslinking"   of  message  text  is  also
  5981.                        considered a serious problem, and this  will
  5982.                        prevent  RAMSG  repacking  the message base.
  5983.                        Cross-linking  occurs  when  more  than  one
  5984.                        message references the  same section of text
  5985.                        in MSGTXT.BBS.
  5986.  
  5987.                        Following are some examples  of  what  an   
  5988.                        index rebuild command might look like:
  5989.  
  5990.                        RAMSG -Icu
  5991.  
  5992.                        Rebuild indices,  kill  messages in  unknown
  5993.                        areas and crosslinked messages.
  5994.  
  5995.                        RAMSG -I
  5996.  
  5997.                        Rebuild index files only.
  5998.  
  5999.  
  6000.                -P      PACK  [options : K, R, O, A]
  6001.                
  6002.                        Packs the message base, by  eliminating all 
  6003.                        deleted messages and message text. Deleting 
  6004.                        (the -K option, for example) messages  does 
  6005.                        not  remove  them  from  the  message  base
  6006.                        files, it simply marks them  for  deletion. 
  6007.                        You  MUST  pack the message base to reclaim 
  6008.                        the   space   occupied  by  these   deleted 
  6009.                        messages.
  6010.  
  6011.                        PACK also provides options  to  purge  old/ 
  6012.                        excess messages (same as -K, except that -K 
  6013.                        does  not  pack) and renumber (same as -R), 
  6014.                        so all standard  maintenance  functions can 
  6015.                        be carried out in the one command.
  6016.                        
  6017.                        RAMSG  normally  packs  the message base by 
  6018.                        copying messages from the existing  message 
  6019.                        base  into  temporary  files,  deleting the 
  6020.                        original files, then renaming the temporary 
  6021.                        files to their  correct names.  This is the 
  6022.                        safest option to  use, since it is possible 
  6023.                        to  rebuild  the  message  base if  for any 
  6024.                        reason the PACK process is interrupted (for 
  6025.                        example, by  power  failure). However, this 
  6026.                        requires t hat  at least as  much  space as 
  6027.                        occupied by  the  old message base files be 
  6028.                        free on your hard disk.                     
  6029.             
  6030.  
  6031.  
  6032.  
  6033.  
  6034.  
  6035.  
  6036.  
  6037.  
  6038.  
  6039.  
  6040.                                     96
  6041.                        To get around this, RAMSG provides an option
  6042.                        to pack the  message  base "on top"  of  the
  6043.                        existing one without using temporary  files.
  6044.                        This directly overwrites the existing files;
  6045.                        and  the problem with  this is  that  if the
  6046.                        process is interrupted, the message base may
  6047.                        be irreparably  damaged and  data  could  be
  6048.                        lost.  To use overwrite mode, RAMSG requires
  6049.                        the 'o'  option  in the  PACK  command; this
  6050.                        forces   overwriting   unconditionally.   To
  6051.                        ensure that the message  base  is processed,
  6052.                        while    taking   advantage   of   a   safer
  6053.                        environment,  RAMSG  also  provides  an  'a'
  6054.                        option, which will use  overwrite  mode only
  6055.                        if there is insufficient space for a regular
  6056.                        pack.
  6057.  
  6058.                        Examples:
  6059.  
  6060.                        RAMSG -Pkra
  6061.  
  6062.                        Pack  the   message   base,  kill   messages
  6063.                        according  to  information  in  MESSAGES.RA,
  6064.                        renumber  messages  and  use overwrite  mode
  6065.                        only  if   insufficient  disk  space  for  a
  6066.                        regular pack.
  6067.  
  6068.                        RAMSG -Po
  6069.  
  6070.                        Pack the message base, using overwrite mode.
  6071.  
  6072.  
  6073.                -K      Purge messages
  6074.  
  6075.                        This option purges messages according to the
  6076.                        maximum  number  of   messages   and   aging
  6077.                        information  specified  for  each   area  in
  6078.                        MESSAGES.RA. Note  that the messages are not
  6079.                        actually removed, they are simply marked for
  6080.                        deletion.  Use the  pack command  to reclaim
  6081.                        the space that these messages occupy.
  6082.  
  6083.  
  6084.                -L      Link reply chains
  6085.  
  6086.                        Links  reply  chains  in  each  area   (this
  6087.                        is  automatically  done by other maintenance
  6088.                        functions  where  necessary). You  would use
  6089.                        this  option by  itself  after  an import by
  6090.                        your echomail processor, for example.
  6091.  
  6092.  
  6093.                -R      Renumber messages
  6094.  
  6095.                        Renumbers the message base.  This option may
  6096.                        also  be  used to  cure  "out  of  sequence"
  6097.                        errors.
  6098.  
  6099.  
  6100.  
  6101.                                     97
  6102.                -S      Display/log message base statistics
  6103.  
  6104.                        Simply logs message base and disk statistics
  6105.                        for  your  own information. A 'v' after this
  6106.                        option  displays verbose statistics for each
  6107.                        message area.
  6108.  
  6109.  
  6110.        You may  run several  operations on  the same  command line,
  6111.        but since there is  some overlap in functionality,  the need
  6112.        to do  this is rare.   One instance of where  you might need
  6113.        this  facility  is  to force the message base to  be "clean"
  6114.        prior running a pack; for example:
  6115.  
  6116.                RAMSG -Pkra
  6117.  
  6118.        Checks/rebuilds index files, deleting  messages in unknown  
  6119.        areas,  fixes cross-linked messages and forces a  renumber  
  6120.        to fix sequence errors.  It then will proceed to pack and   
  6121.        renumber the message base   after  killing  excess/expired  
  6122.        messages using overwrite mode if required.
  6123.  
  6124.  
  6125.        Several errorlevel  exits are provided to  allow  management
  6126.        by batch file:
  6127.  
  6128.                1       No arguments specified; help message given. 
  6129.                2       Cannot access/locate CONFIG.RA
  6130.                3       Out of or insufficient memory
  6131.                4       Error opening/locating a file
  6132.                5       Serious IO error
  6133.  
  6134.  
  6135.  
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.  
  6143.  
  6144.  
  6145.  
  6146.  
  6147.  
  6148.  
  6149.  
  6150.  
  6151.  
  6152.  
  6153.  
  6154.  
  6155.  
  6156.  
  6157.  
  6158.  
  6159.  
  6160.  
  6161.  
  6162.                                     98
  6163.        MAIL NETWORKING
  6164.        ────────────────────────────────────────────────────────────
  6165.                    
  6166.        What  is a mail network?  Basically it is a set of  bulletin
  6167.        board  systems  that are capable of exchanging messages  and
  6168.        files   with   each  other  without  the  need   for   human
  6169.        intervention.  All  the discussion which follows relates  to
  6170.        FidoNet,  the world's largest amateur mail network.  FidoNet
  6171.        consists of approximately 10000 bulletin board systems, each
  6172.        of  which is assigned a unique "address".  A file  called  a
  6173.        nodelist   stores  all  these  addresses  along  with  other
  6174.        information  about  each  system.   Think  of  it  like   an
  6175.        international "telephone book".
  6176.  
  6177.        Being  part of a network has two basic attractions;  NetMail
  6178.        and EchoMail.  NetMail allows you to send a private  message
  6179.        to  any  user  of  any one of the bulletins  boards  in  the
  6180.        network at little or no cost to you. EchoMail is a method of
  6181.        creating  a huge message area that many hundreds of  systems
  6182.        can potentially participate in.  Usually all EchoMail  areas
  6183.        will  contain only public messages,  and are organised  into
  6184.        either  general  discussion areas,  or areas that deal  with
  6185.        specific issues and or topics.
  6186.  
  6187.        The net is organised into several levels,  which are usually
  6188.        based on geographical proximity.  At the highest level there
  6189.        are five "zones";  zone 1 is the USA, zone 2 is Europe, zone
  6190.        3  is the Pacific Rim,   zone 4 is  South America, zone 5 is
  6191.        Africa and zone 6 is Asia.  Within each zone are a number of
  6192.        "regions"  that span  large geographical  areas.   Typically
  6193.        there will be between 5 and 18 regions per zone. Each region
  6194.        is further divided into "nets".   Each  net  has  a   unique
  6195.        net   number,   and   the distribution of these nets is also
  6196.        based  on  geographical   and  technical     considerations.
  6197.        Finally,  within   the net are  a number   of nodes.  A node
  6198.        refers to a single bulletin  board system. 
  6199.  
  6200.        To find out about obtaining a node number,  or an "address",
  6201.        contact  the nearest FidoNet bulletin board.  The sysop will
  6202.        usually be more than happy to help you out.
  6203.  
  6204.        Before  going  any  further,  let's  talk  about  the  extra
  6205.        software you will need to set up as a node. Firstly you will
  6206.        need  an  echomail  processor.  This is  the  program  which
  6207.        unpacks the mail you will receive,  and imports it into your
  6208.        RemoteAccess  message-base,  as well as packing up  outbound
  6209.        mail  that  needs  to be sent  out.  RemoteAccess  does  NOT
  6210.        include  such  a beast.  There are several other  processors
  6211.        around that will do the job:
  6212.  
  6213.             ZMailH, by Jason Steck,
  6214.             TosScan, by Joaquim Homrighausen,
  6215.             GEcho, by Gerard van der Land,
  6216.             IMAIL, by Fabiano Fabris.
  6217.  
  6218.  
  6219.  
  6220.  
  6221.  
  6222.  
  6223.                                     99
  6224.        The  other  piece  of  software you'll  need  is  a  mailer.
  6225.        RemoteAccess  will  not  directly  communicate  with   other
  6226.        network  bulletin  boards,  so a separate program fills  the
  6227.        gap. The  two most  widely used  different types of  mailers
  6228.        are:
  6229.  
  6230.             FrontDoor, by Joaquim Homrighausen,
  6231.             BinkleyTerm, by Bit Bucket Software.
  6232.  
  6233.        Both of these products  are available on a  shareware basis,
  6234.        and  like  the  echomail processors,    will    usually   be
  6235.        available   on  most  FidoNet bulletin boards if you ask the
  6236.        sysop nicely enough.
  6237.  
  6238.        The  node  number  you are assigned will be  of  the  format
  6239.        Zone:Net/Node.Point.  This initial node number should be put
  6240.        into  your  configuration file using the ADDRESS  option  of
  6241.        RACONFIG. Don't worry about the AKA addresses at this stage.
  6242.  
  6243.        The next step is to set up your EchoMail message areas.  You
  6244.        will  usually be given a list of areas that are available to
  6245.        you.  Each  area is identified by an uppercase  alphanumeric
  6246.        name. As far as RemoteAccess is concerned, all you need is a
  6247.        description  of each area you plan to "plug into".  Fire  up
  6248.        RACONFIG,  and  go to the MESSAGE AREAS  window.  Select  an
  6249.        unused  message area,  and enter the area's name in the NAME
  6250.        field.  Next,  set the TYPE OF MAIL field to  ECHOMAIL,  and
  6251.        MESSAGE  STATUS to PUBLIC.  Most EchoMail areas don't  allow
  6252.        the  use of aliases,  so set the area  to "real names only".
  6253.        The AKA   ADDRESS line shows  your assigned node number.  If
  6254.        it   doesn't,   hit  RETURN on  this option  and  select the
  6255.        correct address.
  6256.  
  6257.        Each  EchoMail message  that is posted on your system  could
  6258.        potentially be read by hundred of other sysops and users, so
  6259.        you can put a "one-liner" at the end of each message. In the
  6260.        ORIGIN LINE field enter a short message. This should contain
  6261.        at least the name of your system,  and possibly where it  is
  6262.        or the phone-number, so that other users know where to call.
  6263.        Your node number is also appended to the end of the message,
  6264.        so a typical origin line might read:
  6265.  
  6266.             * Origin : RemoteAccess Central (2:270/18)
  6267.  
  6268.        Don't  put  the "* Origin" part in - this is added  by   the
  6269.        software).  If  you  don't  specify an  origin  line  for  a
  6270.        particular  area,  RemoteAccess will use the DEFAULT  ORIGIN
  6271.        LINE.
  6272.  
  6273.        If running  a multi-node  system, the  line number  that the
  6274.        message was posted on may be inserted in the origin line  by
  6275.        using the '@' macro character in any origin line definition.
  6276.  
  6277.  
  6278.  
  6279.  
  6280.  
  6281.  
  6282.  
  6283.  
  6284.                                     100
  6285.        The  next  step  is to configure RemoteAccess  for  NetMail.
  6286.        Select another unused message area,  and call it  "NetMail",
  6287.        or something similar. Next, set the TYPE OF MAIL to NETMAIL,
  6288.        and  MESSAGE STATUS to PRIVATE.  NetMail messages don't have
  6289.        origin lines appended to them so leave the origin line entry
  6290.        blank.  RemoteAccess  incorporates  a  comprehensive  online
  6291.        nodelist browsing facility, which allows users to search for
  6292.        nodes  in particular zones,  regions or  nets.  The  section
  6293.        INSTALLING  NODELIST  FILES  explains  how  to  enable  this
  6294.        feature.
  6295.  
  6296.        That's it!  RemoteAccess is now fully configured for network
  6297.        mail.  Assuming that you have a suitable mailer and echomail
  6298.        processor,  all that is required is to set them up correctly
  6299.        and you're in business.  An explanation of setting these  up
  6300.        is beyond the scope of this document,  full instructions are
  6301.        available with each respective package.
  6302.  
  6303.  
  6304.  
  6305.  
  6306.  
  6307.  
  6308.  
  6309.  
  6310.  
  6311.  
  6312.  
  6313.  
  6314.  
  6315.  
  6316.  
  6317.  
  6318.  
  6319.  
  6320.  
  6321.  
  6322.  
  6323.  
  6324.  
  6325.  
  6326.  
  6327.  
  6328.  
  6329.  
  6330.  
  6331.  
  6332.  
  6333.  
  6334.  
  6335.  
  6336.  
  6337.  
  6338.  
  6339.  
  6340.  
  6341.  
  6342.  
  6343.  
  6344.  
  6345.                                     101
  6346.        Installing the nodelist files 
  6347.        ────────────────────────────────────────────────────────────
  6348.  
  6349.        Most  other BBS software requires you to maintain large  and
  6350.        unwieldy   custom  nodelist  files  for  NetMail  operation.
  6351.        RemoteAccess  uses the "raw" (St.  Louis) nodelist that  you
  6352.        already  have for your front-end mailer,  in addition  to  a
  6353.        small  (around 5K) index file.  The key to the system is the
  6354.        nodelist index compiler (RANODE.EXE). You should adjust your
  6355.        batch files so it is run every time any changes are made  to
  6356.        your  raw nodelist (when you receive a NODEDIFF update,  for
  6357.        example).  RANODE can be run from any directory, and locates
  6358.        your raw nodelist via the NODELIST PATH defined in RACONFIG.
  6359.  
  6360.        It  scans the most recent nodelist present and produces  the
  6361.        index     files    (NODEIDX.RA  and NODEINC.RA)   in    your
  6362.        RemoteAccess     system directory.   If   you  have multiple
  6363.        nodelists  to process,    simply specify  the  names of  any
  6364.        additional  nodelists  on  the command-line  when  RANODE is
  6365.        executed.  
  6366.  
  6367.        Example  :  Compiling  a  FidoNet  nodelist  only.  The  raw
  6368.        nodelist  is in the C:\NODELIST directory.  Simply set  your
  6369.        NODELIST  PATH  in RACONFIG to C:\NODELIST,  and run  RANODE
  6370.        whenever you process  a nodediff,  without any  command-line
  6371.        parameters.
  6372.  
  6373.        Example : Compiling a FidoNet and ParaNet combined nodelist.
  6374.        The  FidoNet  NODELIST.nnn  and  ParaNet  PARALIST.PVT   raw
  6375.        nodelist  files  are in C:\NODELIST. Simply run  RANODE with
  6376.        the following parameter:
  6377.  
  6378.             RANODE PARALIST.PVT
  6379.  
  6380.        Up  to ten  nodelists  (including the  FidoNet  one) may  be
  6381.        specified -  wildcards and pattern  matching characters  are
  6382.        valid.
  6383.  
  6384.        Note that  it  is  not  necessary  to  specify  the  FidoNet
  6385.        NODELIST.nnn  as well,  as RANODE  includes the  most recent
  6386.        FidoNet nodelist automatically.
  6387.  
  6388.  
  6389.        In  order to control the volume of netmail your users  send,
  6390.        each user has a "netmail credit" field in his or her record.
  6391.        RemoteAccess   will  give  all  new  users  a  credit  limit
  6392.        based  on  the NEW USER NETMAIL CREDIT setting in  RACONFIG.
  6393.  
  6394.        You  define  the  cost  of sending a  single  message  to  a
  6395.        particular node in a control file called NODECOST.CTL  which
  6396.        is located in the RemoteAccess system directory. Each time a
  6397.        user sends a netmail message, it's cost is deducted from his
  6398.        or her account.
  6399.  
  6400.        The cost structure for your entire nodelist is set up by one
  6401.        or more entries of five keywords:
  6402.  
  6403.  
  6404.  
  6405.  
  6406.                                     102
  6407.        DEFAULT <cost>
  6408.  
  6409.        Assigns <cost> to any nodes that are not assigned a specific
  6410.        cost later on in the control file.
  6411.  
  6412.  
  6413.  
  6414.        ZONE <zone> <cost>
  6415.  
  6416.        Assigns  <cost> to all nodes in <zone>.  This overrides  the
  6417.        DEFAULT keyword.
  6418.  
  6419.  
  6420.  
  6421.        REGION <region> <cost>
  6422.  
  6423.        Assigns <cost> to all nodes in <region>.  This overrides the
  6424.        DEFAULT and ZONE keywords.
  6425.  
  6426.  
  6427.  
  6428.        NET <net> <cost>
  6429.  
  6430.        Assigns  <cost>  to all nodes in <net>.  This overrides  the
  6431.        DEFAULT, ZONE and REGION keywords.
  6432.  
  6433.  
  6434.  
  6435.        NODE <node> <cost>
  6436.  
  6437.        Assigns  <cost> to <node>. <Node>  is a fully qualified node
  6438.        address. This overrides all other keywords.
  6439.  
  6440.  
  6441.        Sample NODECOST.CTL:
  6442.  
  6443.        DEFAULT       200 ; A message to anywhere costs 200 cents,
  6444.        ZONE      3    60 ; except in zone 3, which costs 60 cents.
  6445.        ZONE      2   260 ; Messages to zone 2 cost a bit more,
  6446.        REGION   55    30 ; Within our region only costs 30 cents.
  6447.        NET     690     0 ; Msgs within our net are free,
  6448.        NODE    690/999 5 ; except this node which isn't local.
  6449.  
  6450.  
  6451.        The  control  file may contain a maximum of 150  entries  of
  6452.        each  keyword,  and  duplicate  entries  are  obviously  not
  6453.        permitted.
  6454.  
  6455.  
  6456.  
  6457.  
  6458.  
  6459.  
  6460.  
  6461.  
  6462.  
  6463.  
  6464.  
  6465.  
  6466.  
  6467.                                     103
  6468.        MULTI - NODE OPERATION
  6469.        ────────────────────────────────────────────────────────────
  6470.  
  6471.        It  is  assumed  that  you have some  knowledge  of  running
  6472.        RemoteAccess already, or have at least run a single line BBS
  6473.        for some time.  If you haven't,  it is strongly  recommended
  6474.        that   you run one line  for a little while  to  familiarise
  6475.        yourself with the terminology and operation of RemoteAccess.
  6476.  
  6477.        The  idea of multi-node operation is that more than one user
  6478.        can be on-line at the same time to the same BBS.  To do this
  6479.        safely,  it  is  necessary for RemoteAccess  to  manage  the
  6480.        configuration   and  data  files  it  uses  very  carefully.
  6481.  
  6482.        Firstly,  tell RemoteAccess that it's running in  multi-node
  6483.        mode  by setting the MULTI LINE option to "Yes" in RACONFIG.
  6484.        You  should  also set CHECK FOR MULTI LOGON  to  "Yes".  Not
  6485.        doing this can cause unpredictable  results when a user logs
  6486.        on to more than one line at once.
  6487.  
  6488.        Set the  SYSTEM LOG NAME to  "RA.LOG". Make sure you  do NOT
  6489.        specify a full path with the name.
  6490.  
  6491.        Next create one child directory of your system directory for
  6492.        each line you intend to operate. For example, assuming  that
  6493.        the  system  directory  is   C:\RA,  for  two  lines  create
  6494.        C:\RA\LINE1 and C:\RA\LINE2 (the actual directory  names are
  6495.        not important).
  6496.  
  6497.        At  this  stage, ensure  that  the  RA environment  variable
  6498.        points to the system  directory so each line will be able to
  6499.        locate the configuration files.
  6500.  
  6501.        Why  separate directories? Many  on-line utilities and doors
  6502.        are not  multi-node aware,  so they  must  be isolated  from
  6503.        themselves in the  event that more than one copy of the same
  6504.        door is executed at the same  time. Thus it may be necessary
  6505.        to place  extra configuration files  for some doors  in each
  6506.        line directory. 
  6507.  
  6508.        For example, to install QuickEd in a multi-node environment,
  6509.        ensure that QUICKED.EXE is in the system directory (C:\RA in
  6510.        this  example)  and  that  the EXTERNAL  EDITOR  setting  in
  6511.        RACONFIG  is set  to  "C:\RA\QUICKED.EXE".  To complete  the
  6512.        installation, copy  the  files QUICKED.HLP  and  QUICKED.CFG
  6513.        into  each  line  directory; these  two  files  need not  be
  6514.        present in the system directory.
  6515.  
  6516.        All that is necessary now is to  create the batch files that
  6517.        call each copy of RA for each line:
  6518.  
  6519.        REM Sample batch file to fire up line 1
  6520.        :START
  6521.          CD \RA\LINE1
  6522.          RA -N1
  6523.          REM Check errorlevels etc
  6524.          GOTO START
  6525.  
  6526.  
  6527.  
  6528.                                     104
  6529.        Note  that   the  -N1   parameter  is  not   required  since
  6530.        RemoteAccess defaults  to line 1;  it is  included only  for
  6531.        completeness.
  6532.  
  6533.        REM Sample batch  file to  fire up line  2, using  FrontDoor
  6534.        REM as a front-end mailer in shell to mailer mode
  6535.        :START
  6536.          CD \RA\LINE2
  6537.          RA -M\FD\FD.EXE*M -N2
  6538.          REM Check errorlevels etc
  6539.          GOTO START
  6540.  
  6541.        RemoteAccess will  keep a  separate system log  (RA.LOG) and
  6542.        usage graph file (TIMELOG.BBS) in each line directory.
  6543.  
  6544.        The  placement  of the EXITINFO.BBS  and  DORINFO1.DEF  door
  6545.        files is handled differently in a multi-node environment. In
  6546.        a  single  line installation these files are written to  the
  6547.        RemoteAccess system directory.  In multi-node mode they  are
  6548.        written  to the current  (default) directory,  thus ensuring
  6549.        that each door has it's  own set of info files from  the BBS
  6550.        at all times.
  6551.  
  6552.        Additional  configuration  flexibility  is  provided  in the
  6553.        method RemoteAccess uses to locate  the configuration (*.RA)
  6554.        files. If one or more of the *.RA config files is present in
  6555.        a particular  line directory, then the  information in those
  6556.        files  will  override  the   information  contained  in  the
  6557.        corresponding config file in the system directory.
  6558.  
  6559.        For  example, it  may  be necessary  for  each line  to  use
  6560.        different  modem  configuration  information. This  data  is
  6561.        contained in CONFIG.RA, so make a copy of  this file in each
  6562.        line  directory.  Change to  the  line 1  directory  and use
  6563.        RACONFIG to edit the  modem settings. Save your changes  and
  6564.        repeat the procedure for line 2. When RemoteAccess fires up,
  6565.        it  will use the CONFIG.RA in the current directory that you
  6566.        just edited,  and  the  other  config files  in  the  system
  6567.        directory.
  6568.  
  6569.        The  LIMITS.CTL file works in the same way; you may override
  6570.        the global settings in the system directory by making a copy
  6571.        of LIMITS.CTL in  one or more  line directories and  editing
  6572.        with an ASCII text editor. This enables each line to exhibit
  6573.        different  download  and  time  limits  for  one  particular
  6574.        security level.
  6575.  
  6576.        Beware  of  third party utilities that write to  the  system
  6577.        files!  RemoteAccess  is specifically written so  that  many
  6578.        users  can read and post messages simultaneously to the same
  6579.        message-base,  but other programs probably AREN'T. Check the
  6580.        documentation  very  carefully  before  you  fire  up   your
  6581.        favourite  off-line  mail editor and start posting  messages
  6582.        while someone else is on-line.  Similarly,  if your echomail
  6583.        processor  does  not  lock  the  message-base  files   while
  6584.        working,  you  should set up your system to ensure that mail
  6585.        is  never imported when there is a user  on-line.  Exporting
  6586.        messages however, IS permitted.
  6587.  
  6588.  
  6589.                                     105
  6590.        It's  quite  likely that you'll need to increase  the  FILES
  6591.        setting  in  your  CONFIG.SYS  if  RemoteAccess  is  running
  6592.        several  lines  under  a multitasker.  You'll  also  need  a
  6593.        separate  batch-file  for each line to  invoke  RemoteAccess
  6594.        with the correct command-line parameters.  See the reference
  6595.        section on command-line parameters for information on the -N
  6596.        parameter.
  6597.  
  6598.        It  is  ESSENTIAL that  you  load  SHARE.EXE when  operating
  6599.        multi-node. SHARE is  a utility  that comes  with DOS  which
  6600.        RemoteAccess uses  to lock the  database files  it uses,  to
  6601.        ensure  that no conflicts  occur. Not using  SHARE is asking
  6602.        for trouble; you  risk severe corruption  of both your  user
  6603.        and message database files.
  6604.  
  6605.  
  6606.  
  6607.  
  6608.  
  6609.  
  6610.  
  6611.  
  6612.  
  6613.  
  6614.  
  6615.  
  6616.  
  6617.  
  6618.  
  6619.  
  6620.  
  6621.  
  6622.  
  6623.  
  6624.  
  6625.  
  6626.  
  6627.  
  6628.  
  6629.  
  6630.  
  6631.  
  6632.  
  6633.  
  6634.  
  6635.  
  6636.  
  6637.  
  6638.  
  6639.  
  6640.  
  6641.  
  6642.  
  6643.  
  6644.  
  6645.  
  6646.  
  6647.  
  6648.  
  6649.  
  6650.                                     106
  6651.        REFERENCE SECTION
  6652.        ────────────────────────────────────────────────────────────
  6653.  
  6654.  
  6655.        Sysop keys                     
  6656.        ────────────────────────────────────────────────────────────
  6657.  
  6658.        The following keys work while a user is on-line:
  6659.  
  6660.  
  6661.        [F1]          : This  displays   the  users name,  location,
  6662.                        security,  time remaining,  connection speed
  6663.                        and the line  number he/she is on.   If  the
  6664.                        user has ANSI or AVATAR emulations  on  this
  6665.                        is also displayed on this line.
  6666.  
  6667.        [F2]          : This displays the users voice and data phone
  6668.                        numbers, the date and time on which the user
  6669.                        last called, the date the user first called,
  6670.                        the number of times the user  has called and
  6671.                        the age and birthday of the user.   
  6672.  
  6673.        [F3]          : The number  of files  the user  has uploaded
  6674.                        and downloaded is displayed,  including  the
  6675.                        total  kilobytes  of the  uploads/downloads.
  6676.                        Also,  on  this line,  is the users security
  6677.                        flag combinations.
  6678.  
  6679.        [F4]          : This displays the system statistics such as;
  6680.                        Last caller,  total  system  calls,  current
  6681.                        time,  printer  status,  local screen status
  6682.                        and the  time  and errorlevel  of  the  next
  6683.                        system  event.  
  6684.  
  6685.        [F5]          : This displays the total  number of  messages
  6686.                        posted by the user,  highest  message number
  6687.                        the   user  has  read,  the  users  selected
  6688.                        language,  the  users   group   number,  the
  6689.                        amount of  netmail  credit the  user has and
  6690.                        the users handle.
  6691.  
  6692.        [F6]          : User's reason for wanting chat (if any).
  6693.  
  6694.        [F7]          : Interactive EMSI session information.
  6695.  
  6696.        [F9]          : Help! Hot-key summary.
  6697.  
  6698.        [F10]         : Turn off the status bar to show exactly what
  6699.                        the  user is seeing. [F1] to [F5] brings  it
  6700.                        back.
  6701.  
  6702.        [CTL-A]       : Opens  and  closes a capture file  during  a
  6703.                        chat session.
  6704.  
  6705.        [ALT-Fn]      : Activate one of ten programs in a shell,  or
  6706.                        exit to DOS at a certain errorlevel.
  6707.  
  6708.        [ALT-A]       : Disable/enable answering (only available at 
  6709.                        the "wait for call" screen).
  6710.  
  6711.                                     107
  6712.        [ALT-C]       : Break in for  a chat  if there is a user  on
  6713.                        remotely.  ESC finishes chat mode and  drops
  6714.                        the user back to the BBS.
  6715.  
  6716.        [ALT-D]       : Toggles  "Snoop" mode, ie. whether the local
  6717.                        screen shows what the user is doing.
  6718.  
  6719.        [ALT-E]       : Activates a pop-up user attribute editor for
  6720.                        the user currently online. 
  6721.  
  6722.        [ALT-H]       : Hang up on the user immediately.
  6723.  
  6724.        [ALT-J]       : Drop to a DOS shell while the user is  still
  6725.                        on-line.
  6726.  
  6727.        [ALT-L]       : Lock the  user out of the system by dropping
  6728.                        his/her security level to zero  and  hanging
  6729.                        up.  
  6730.  
  6731.        [ALT-N]       : Toggle "sysop on next".  When  this mode  is
  6732.                        activated   (indicated  by  [NS]  on  the F1
  6733.                        status  bar),  RemoteAccess  will pause  and
  6734.                        page  the  sysop  for  two  minutes when the
  6735.                        current user  logs  off.  After  paging  the
  6736.                        sysop RA will then exit with  and errorlevel
  6737.                        of "2".    {+} Registered only.
  6738.  
  6739.        [ALT-O]       : Override paging  hours.  This allows you  to
  6740.                        enable or disable sysop paging regardless of
  6741.                        the time.  Note that this is permanent,  and
  6742.                        affects all lines until reset.
  6743.  
  6744.        [ALT-P]       : Toggle printer logging.
  6745.  
  6746.        [ALT-S]       : Modify the current user's security level.
  6747.  
  6748.        [Up-Arrow]    : Increase the user's time by one minute.
  6749.  
  6750.        [Down-Arrow]  : Decrease the user's time by one minute.
  6751.  
  6752.        [Scroll
  6753.         Lock] : Disables the paging tune. When a user  pages       
  6754.                 the SysOp no sound will be  produced  at the       
  6755.                 local console. {+} Registered only.
  6756.  
  6757.  
  6758.        When  the system is waiting for a call,  the only sysop keys
  6759.        that are  active are [ALT-O], [ALT-J],  [ALT-D], [ALT-P] and
  6760.        [ALT-A]. However,  pressing [L]  will  allow  you  to log-on
  6761.        locally,   and   [ESC]   will terminate   the   program  and
  6762.        return   to  DOS.   Note  that terminating in this way  will
  6763.        always  return  an  errorlevel of 0  to  DOS  regardless  of
  6764.        whether  the  -E  command-line parameter is invoked.
  6765.  
  6766.  
  6767.  
  6768.  
  6769.  
  6770.  
  6771.  
  6772.                                     108
  6773.        Command-line parameters 
  6774.        ────────────────────────────────────────────────────────────
  6775.  
  6776.        RemoteAccess accepts the following command-line parameters: 
  6777.                   
  6778.  
  6779.        * RA.EXE
  6780.        ---------
  6781.  
  6782.        -NOEMS  : Forces RemoteAccess to ignore any available EMS. 
  6783.        -L      : Run RemoteAccess in local mode.
  6784.        -S      : Set "snoop" mode off; disable local screen.
  6785.        -D      : Disable status bar by default.
  6786.        -R      : Log user back on-line after a menu type 15 exit.
  6787.  
  6788.        -G      : Used with the -R option;  forces  RemoteAccess  to
  6789.             {+}  return to  the last  menu the user  was in  at the
  6790.                  time of the  previous exit to DOS.  The default is
  6791.                  to return to the TOP menu.
  6792.  
  6793.        -P      : Log user activity to printer.
  6794.        -Nxx    : Line (node) number in a multi-line system (1-250).
  6795.        -Cx     : Communications port to use (1-4).
  6796.        -Bxxxxx : Log user on-line at baudrate xxxxx.
  6797.        -Exxx   : Exit at errorlevel xxx after caller logs off. 
  6798.        -Txxx   : Time (in minutes) until next system event.
  6799.  
  6800.                  NOTE: Some mailers have the capability to generate
  6801.                  a "standard format" batch file called DOBBS.BAT to
  6802.                  run the BBS program. In shell-to-mailer mode  (see
  6803.                  below) RemoteAccess will scan this  batch file (if
  6804.                  present) to  determine  the  time  until  the next
  6805.                  event.
  6806.  
  6807.        -M<f>   : Activate  the "shell to  mailer"   feature.   This
  6808.                  causes RemoteAccess, upon loading, to execute your
  6809.                  front-end mailer program in a DOS shell.  When the
  6810.                  mailer exits,  RemoteAccess detects the errorlevel
  6811.                  it  would normally pass to the batch-file.  If the
  6812.                  errorlevel  matches one defined in  RACONFIG,  the
  6813.                  user  is logged on to the BBS at  the  appropriate
  6814.                  baud rate.  If the errorlevel is not recognised as
  6815.                  an  incoming  call,  RemoteAccess   exits  to  its
  6816.                  batch-file at that errorlevel.  See the BATCH FILE
  6817.                  EXAMPLES section for more on this feature.
  6818.  
  6819.                  NOTE:  RemoteAccess  does  the swap by  storing  a
  6820.                  "swap  file"  in EMS (if available) and  on  disk.
  6821.                  Normally  this file would be stored in  the system
  6822.                  directory,   but   it   is   possible   to   force
  6823.                  RemoteAccess  to  put the file in a  directory  of
  6824.                  your  choice  by setting  the  RATEMP  environment
  6825.                  variable.  For  example,  if you executed the  DOS
  6826.                  command SET RATEMP=E:\TEMP\STORAGE,  then the swap
  6827.                  file   would  be  placed  in  the  E:\TEMP\STORAGE
  6828.                  directory.
  6829.  
  6830.  
  6831.  
  6832.  
  6833.                                     109
  6834.                  In "shell to mailer" mode,  it is possible for two
  6835.                  errorlevels to conflict. For example, errorlevel 5
  6836.                  is used by RA to indicate that a user entered both
  6837.                  net  and  echomail,  and by FrontDoor to  indicate
  6838.                  modem initialise failure. If the front-end returns
  6839.                  an   errorlevel  that  conflicts  in   this   way,
  6840.                  RemoteAccess  will  pass  to the batch  file  that
  6841.                  errorlevel  plus 10.  So,  if  FrontDoor  returned
  6842.                  errorlevel   5   because  the  modem   would   not
  6843.                  initialise,  RemoteAccess would pass errorlevel 15
  6844.                  to the batch file. 
  6845.  
  6846.  
  6847.  
  6848.        * RACONFIG.EXE
  6849.        --------------- 
  6850.  
  6851.        -B      : Runs RACONFIG in black and white (mono) mode.
  6852.  
  6853.        -L      : Runs RACONFIG in language editor mode.
  6854.        -M      : Runs RACONFIG in menu editor mode.
  6855.        -U      : Runs RACONFIG in user editor mode.  
  6856.  
  6857.  
  6858.  
  6859.  
  6860.  
  6861.  
  6862.  
  6863.  
  6864.  
  6865.  
  6866.  
  6867.  
  6868.  
  6869.  
  6870.  
  6871.  
  6872.  
  6873.  
  6874.  
  6875.  
  6876.  
  6877.  
  6878.  
  6879.  
  6880.  
  6881.  
  6882.  
  6883.  
  6884.  
  6885.  
  6886.  
  6887.  
  6888.  
  6889.  
  6890.  
  6891.  
  6892.  
  6893.  
  6894.                                     110
  6895.        Errorlevels
  6896.        ────────────────────────────────────────────────────────────
  6897.  
  6898.        When  RemoteAccess exits to DOS either after a user logs off
  6899.        or  because  of  a menu type 15 "Exit to  DOS"  function  it
  6900.        returns  an errorlevel that your batchfile should  test  for
  6901.        and act on accordingly:
  6902.  
  6903.  
  6904.        Errorlevel  Meaning
  6905.        ----------  -------
  6906.  
  6907.            0       User logged off OK,  default value.  Note - this
  6908.                    can  be  overridden  with the  -E  command  line
  6909.                    parameter. 
  6910.  
  6911.            1       Initialisation error - couldn't  find the FOSSIL
  6912.                    driver, or the modem failed to initialise.
  6913.  
  6914.            2       Sysop Next  function  was active  when  the user
  6915.                    logged off.  {+} Registered only.
  6916.  
  6917.            3       The  user  entered one or more NetMail  messages
  6918.                    during the session.  The message base should  be
  6919.                    scanned for outgoing NetMail.
  6920.  
  6921.            4       The  user entered one or more EchoMail  messages
  6922.                    during  the session.  The message base should be
  6923.                    scanned for outgoing EchoMail.
  6924.  
  6925.            5       Both NetMail AND EchoMail messages were entered.
  6926.  
  6927.  
  6928.  
  6929.        You can  force   RemoteAccess  to   exit   with  a  specific
  6930.        errorlevel  by   creating  a  file  called   "RAXITn.e".  If
  6931.        this file  is present  in   the  Semaphore  directory,  then
  6932.        node  "nnn" will terminate with  the errorlevel "nnn".  This
  6933.        file is  very powerful  and  will  disconnect any caller who
  6934.        is currently online.
  6935.  
  6936.  
  6937.  
  6938.  
  6939.  
  6940.  
  6941.  
  6942.  
  6943.  
  6944.  
  6945.  
  6946.  
  6947.  
  6948.  
  6949.  
  6950.  
  6951.  
  6952.  
  6953.  
  6954.  
  6955.                                     111
  6956.        Text file control codes                                     
  6957.        ────────────────────────────────────────────────────────────
  6958.  
  6959.        There are a range of special control characters that can  be
  6960.        inserted  in any of your ASCII/ANSI files that cause certain
  6961.        system and user information to be displayed. There are three
  6962.        classes of codes.  Each code is a two-character  combination
  6963.        of a control-code followed by a normal character:
  6964.  
  6965.                 Character
  6966.        ASCII#   Combination  Purpose
  6967.        ------   -----------  --------------------------------------
  6968.        01         ^A         Wait until the [Return] key is pressed
  6969.        02         ^B         Disable aborting with the "S" key 
  6970.        03         ^C         Enable aborting with the "S" key
  6971.        04         ^D         Enable the "Continue?" prompt
  6972.        05         ^E         Disable the "Continue?" prompt
  6973.        06         ^F       * Insert a user parameter 
  6974.        07         ^G         Produce a beep on the caller's console
  6975.        08         ^H         Backspace
  6976.        09         ^I         Tab (forward 8 characters)
  6977.        10         ^J         Linefeed
  6978.        11         ^K       * Insert a system parameter
  6979.        12         ^L         Clear screen
  6980.        13         ^M         Carriage return
  6981.        17         ^Q         RESERVED FOR XON/XOFF HANDSHAKING 
  6982.        19         ^S         RESERVED FOR XON/XOFF HANDSHAKING 
  6983.        22         ^V         RESERVED FOR AVATAR
  6984.        23         ^W         Pause for one second
  6985.        24         ^X       * Execute a program in a DOS shell
  6986.        26         ^Z         END OF FILE MARKER. DON'T USE THIS!
  6987.  
  6988.        EXECUTING A PROGRAM IN A DOS SHELL:
  6989.        This  gives you the ability to run an external program in  a
  6990.        DOS  shell whenever RemoteAccess encounters a ^X embedded in
  6991.        a text file. The ^X is followed by the command line you want
  6992.        to  execute,  and terminated with the pipe symbol  (|).  For
  6993.        example,  to  run an external mail checking utility  when  a
  6994.        user  logs  on  you could embed the following entry  in  the
  6995.        WELCOME.A?? file:
  6996.  
  6997.             ^X\RA\MAILCHEK.EXE *B *F *L|
  6998.  
  6999.        RemoteAccess would then execute the following DOS command:
  7000.  
  7001.             \RA\MAILCHEK.EXE 2400 FirstName LastName
  7002.  
  7003.        Note  that  you  MUST terminate the command  with  the  pipe
  7004.        symbol.  All special DOS shell control codes may be used  as
  7005.        per the type 7 menu function.
  7006.  
  7007.        BEWARE!  Use this feature with caution.  Imagine the  damage
  7008.        that this embedded command could do:
  7009.  
  7010.             COPY \RA\USERS.BBS \RA\FILES\IBM\NEWFILES
  7011.  
  7012.  
  7013.  
  7014.  
  7015.  
  7016.                                     112
  7017.        If  there is any possibility of a user being able to  modify
  7018.        any  of  the  text files that  your  system  displays,  then
  7019.        disable  the shell feature by using the option in  RACONFIG.
  7020.        "Note to next user"  programs are notorious for this! If you
  7021.        don't  think it ever happens, then maybe this will  convince
  7022.        you.  A local sysop was watching his board one afternoon and
  7023.        noticed  that when a user logged off,  he got the  following
  7024.        message:
  7025.  
  7026.  
  7027.        "Hey,  Joe!  What  sort of a password is ROCKET?  Next  time
  7028.        choose a harder one!!    ... Fred"
  7029.  
  7030.        The  sysop  couldn't believe his eyes.  How could this  have
  7031.        happened?  Well,  the  "note  to next user" utility  he  had
  7032.        installed  a  few weeks earlier was to  blame.  It  actually
  7033.        allowed a user upload a short text file that was appended to
  7034.        the  GOODBYE disconnect file.  "Fred" had simply inserted  a
  7035.        few control characters into the file that would display  the
  7036.        current  user's  first name and password,  which  of  course
  7037.        would  always  be correct for whoever viewed  it.  Well,  it
  7038.        shook that sysop up a bit, as well as teaching him a lesson.
  7039.  
  7040.        Luckily  the ^X feature wasn't enabled,  or  anything  could
  7041.        have happened...
  7042.  
  7043.  
  7044.  
  7045.  
  7046.  
  7047.  
  7048.  
  7049.  
  7050.  
  7051.  
  7052.  
  7053.  
  7054.  
  7055.  
  7056.  
  7057.  
  7058.  
  7059.  
  7060.  
  7061.  
  7062.  
  7063.  
  7064.  
  7065.  
  7066.  
  7067.  
  7068.  
  7069.  
  7070.  
  7071.  
  7072.  
  7073.  
  7074.  
  7075.  
  7076.  
  7077.                                     113
  7078.        * User parameter codes
  7079.        ----------------------
  7080.  
  7081.                Character
  7082.        ASCII#  Combination  Information displayed
  7083.        ------  -----------  ---------------------------------------
  7084.        48        ^F0        Full screen editor (ON/OFF)
  7085.        49        ^F1        Quiet/do not disturb mode (ON/OFF) 
  7086.        50        ^F2        Hot-Keys (ON/OFF)
  7087.        51        ^F3        Handle
  7088.        52        ^F4        Date of first call
  7089.        53        ^F5        Date of birth
  7090.        54        ^F6        Subscription expiry date
  7091.        55        ^F7        Days until subscription expiry
  7092.        56        ^F8        AVATAR setting (ON/OFF)
  7093.        57        ^F9        File ratio limit (number of files)
  7094.        58        ^F:        File ratio limit (kilobytes)
  7095.        59        ^F;        Full screen message viewer (ON/OFF) 
  7096.        60        ^F<        Users date format
  7097.        61        ^F=        Auto message forwarding ON/OFF
  7098.        62        ^F>        Name (if any) of message forwardee
  7099.        63        ^F?        Current file ratio (number of files)
  7100.        64        ^F@        Current file ratio (kb)
  7101.        65        ^FA        Users full name
  7102.        66        ^FB        Location
  7103.        67        ^FC        Password
  7104.        68        ^FD        Business/Data phone number
  7105.        69        ^FE        Voice/Home phone number
  7106.        70        ^FF        Date of last call
  7107.        71        ^FG        Time of last call
  7108.        72        ^FH        A Flags setting
  7109.        73        ^FI        B Flags setting
  7110.        74        ^FJ        C Flags setting
  7111.        75        ^FK        D Flags setting
  7112.        76        ^FL        NetMail credit remaining (cents)
  7113.        77        ^FM        Total messages posted
  7114.        78        ^FN        Last message read
  7115.        79        ^FO        Security level
  7116.        80        ^FP        Total calls to the BBS
  7117.        81        ^FQ        Number of uploads
  7118.        82        ^FR        Kilobytes of uploads
  7119.        83        ^FS        Number of downloads
  7120.        84        ^FT        Kilobytes of downloads
  7121.        85        ^FU        Minutes used today
  7122.        86        ^FV        Current screen length
  7123.        87        ^FW        First name only
  7124.        88        ^FX        ANSI setting (ON/OFF)
  7125.        89        ^FY        "Continue?" prompt setting (ON/OFF) 
  7126.        90        ^FZ        Screen clearing (ON/OFF)
  7127.        91        ^F[        Kilobyte download limit remaining today
  7128.        92        ^F\        Name of selected language
  7129.        93        ^F]        User's comment field
  7130.  
  7131.  
  7132.  
  7133.  
  7134.  
  7135.  
  7136.  
  7137.  
  7138.                                     114
  7139.        * System parameter codes
  7140.        ------------------------
  7141.  
  7142.                Character
  7143.        ASCII#  Combination  Information displayed
  7144.        ------  -----------  ---------------------------------------
  7145.        48        ^K0        Number of msgs in selected msg area 
  7146.        49        ^K1        Number of current template msg area 
  7147.        50        ^K2        Number of current template file area 
  7148.        65        ^KA        Total system calls
  7149.        66        ^KB        Last caller (any line)
  7150.        67        ^KC        Number of active messages
  7151.        68        ^KD        System starting message number
  7152.        69        ^KE        System ending message number
  7153.        70        ^KF        Number of times user has paged sysop 
  7154.        71        ^KG        Day of the week (full form)
  7155.        72        ^KH        Number of users in the user file
  7156.        73        ^KI        Time in 24 hour format
  7157.        74        ^KJ        Today's date
  7158.        75        ^KK        Minutes connected this call
  7159.        76        ^KL        Seconds connected (always returns 0) 
  7160.        77        ^KM        Minutes used today
  7161.        78        ^KN        Seconds used today (always returns 0)
  7162.        79        ^KO        Minutes remaining today
  7163.        80        ^KP        Seconds remaining today (always 0) 
  7164.        81        ^KQ        Daily time limit
  7165.        82        ^KR        Current baud rate
  7166.        83        ^KS        Day of the week (abbreviated form) 
  7167.        84        ^KT        Daily download limit (in K)
  7168.        85        ^KU        Minutes until next system event
  7169.        86        ^KV        24 hour format time of the next event
  7170.        87        ^KW        Line number (as set on command line) 
  7171.        88        ^KX        TERMINATES THE CALL
  7172.        89        ^KY        Name of current template message area
  7173.        90        ^KZ        Name  of  current  template  file  area
  7174.        91        ^K[cc      Change foreground and background colour
  7175.                             (cc  =  colour   code  number.  See the
  7176.                             section on  COLOUR CODES  for   further
  7177.                             information).
  7178.        92        ^K\        Clear to end of line.
  7179.        93        ^K]nnn     Displays  the  language  prompt  number
  7180.                             "nnn"  from   the   currently  selected
  7181.                             language. "Nnn"  must  be  padded  with
  7182.                             zeros.
  7183.  
  7184.  
  7185.  
  7186.  
  7187.  
  7188.  
  7189.  
  7190.  
  7191.  
  7192.  
  7193.  
  7194.  
  7195.  
  7196.  
  7197.  
  7198.  
  7199.                                     115
  7200.        Colour control numbers
  7201.        ────────────────────────────────────────────────────────────
  7202.  
  7203.        Colour code numbers are used by RemoteAccess  when you setup
  7204.        your   File  list  template   and  when  using  the  "^F[cc"
  7205.        control codes  to  define  colours  in  your  Menu displays,
  7206.        Language prompts and textfiles.    
  7207.  
  7208.  
  7209.        Foreground                       Background Colours
  7210.        (2nd "cc" digit)                 (1st "cc" digit)  
  7211.        ------------------               ---------------------
  7212.  
  7213.        0  -  Black                      0  -  Black
  7214.        1  -  Blue                       1  -  Blue
  7215.        2  -  Green                      2  -  Green
  7216.        3  -  Cyan                       3  -  Cyan
  7217.        4  -  Red                        4  -  Red
  7218.        5  -  Purple                     5  -  Purple
  7219.        6  -  Brown                      6  -  Brown
  7220.        7  -  White                      7  -  White
  7221.        8  -  Grey                   
  7222.        9  -  Bright Blue            
  7223.        A  -  Bright Green           
  7224.        B  -  Bright Cyan            
  7225.        C  -  Bright Red             
  7226.        D  -  Bright Purple          
  7227.        E  -  Bright Yellow           
  7228.        F  -  Bright White           
  7229.  
  7230.        0  -  Flashing Black             8  -  Black
  7231.        1  -  Flashing Blue              9  -  Blue
  7232.        2  -  Flashing Green             A  -  Green 
  7233.        3  -  Flashing Cyan              B  -  Cyan
  7234.        4  -  Flashing Red               C  -  Red
  7235.        5  -  Flashing Purple            D  -  Purple
  7236.        6  -  Flashing Brown             E  -  Brown
  7237.        7  -  Flashing White             F  -  White
  7238.        8  -  Flashing Grey
  7239.        9  -  Flashing Bright Blue
  7240.        A  -  Flashing Bright Green
  7241.        B  -  Flashing Bright Cyan
  7242.        C  -  Flashing Bright Red
  7243.        D  -  Flashing Bright Purple
  7244.        E  -  Flashing Bright Yellow
  7245.        F  -  Flashing Bright White
  7246.  
  7247.  
  7248.  
  7249.        Examples:
  7250.  
  7251.        43  -  Red foreground on a Cyan background. 
  7252.        01  -  Blue on a black background.
  7253.        FB  -  Flashing Bright White on a Cyan background.
  7254.  
  7255.  
  7256.  
  7257.  
  7258.            
  7259.  
  7260.                                     116
  7261.        Modem string translation
  7262.        ────────────────────────────────────────────────────────────
  7263.  
  7264.        RemoteAccess recognizes certain characters embedded in  your
  7265.        modem  initialise  strings,  and  converts them  to  special
  7266.        functions. The supported characters are:
  7267.  
  7268.        ^  Raise DTR, modem will answer the phone.
  7269.  
  7270.        v  Lower DTR, disconnect if connected.
  7271.  
  7272.        ~  Wait for 1/4 of a second before continuing
  7273.  
  7274.        |  Send a carriage-return [CR] to the modem
  7275.  
  7276.  
  7277.  
  7278.  
  7279.  
  7280.  
  7281.  
  7282.  
  7283.  
  7284.  
  7285.  
  7286.  
  7287.  
  7288.  
  7289.  
  7290.  
  7291.  
  7292.  
  7293.  
  7294.  
  7295.  
  7296.  
  7297.  
  7298.  
  7299.  
  7300.  
  7301.  
  7302.  
  7303.  
  7304.  
  7305.  
  7306.  
  7307.  
  7308.  
  7309.  
  7310.  
  7311.  
  7312.  
  7313.  
  7314.  
  7315.  
  7316.  
  7317.  
  7318.  
  7319.  
  7320.  
  7321.                                     117
  7322.        Questionnaire script language
  7323.        ────────────────────────────────────────────────────────────
  7324.  
  7325.        Questionnaire   script  files  are  stored  in  the   system
  7326.        directory  and have the extension .Q-A.  Each file is  plain
  7327.        ASCII,  and  contains one command per  line.  The  available
  7328.        commands are listed below. Note that the command interpreter
  7329.        is case-insensitive,  so the command "Ask" could be  entered
  7330.        as "ASK" or "ask". 
  7331.  
  7332.  
  7333.  
  7334.  
  7335.  
  7336.  
  7337.  
  7338.  
  7339.  
  7340.  
  7341.  
  7342.  
  7343.  
  7344.  
  7345.  
  7346.  
  7347.  
  7348.  
  7349.  
  7350.  
  7351.  
  7352.  
  7353.  
  7354.  
  7355.  
  7356.  
  7357.  
  7358.  
  7359.  
  7360.  
  7361.  
  7362.  
  7363.  
  7364.  
  7365.  
  7366.  
  7367.  
  7368.  
  7369.  
  7370.  
  7371.  
  7372.  
  7373.  
  7374.  
  7375.  
  7376.  
  7377.  
  7378.  
  7379.  
  7380.  
  7381.  
  7382.                                     118
  7383.        Ask <Len> <Var num>
  7384.        -------------------
  7385.  
  7386.        Waits  for  the  user  to input a string that is  up  to  80
  7387.        characters long,  and stores the string in the variable <Var
  7388.        num>.  Valid values for <Len> are 1 to 80. <Var num>  may be
  7389.        any number between 1 and 50.
  7390.  
  7391.  
  7392.            Example : Ask 30 5
  7393.  
  7394.            This example  will ask the user for an input of up to 30
  7395.            characters in  length,  and  then  store   the  inputted
  7396.            string in variable 5.
  7397.  
  7398.  
  7399.        Capitalise <ON|OFF>
  7400.        -------------------
  7401.  
  7402.        Turns on or off auto-input prompt capitalisation.  
  7403.  
  7404.        Example : Capitalise ON 
  7405.  
  7406.  
  7407.        ChangeColor <Foreground> <Background>
  7408.        -------------------------------------
  7409.  
  7410.        Changes the colour of the text if the user has ANSI graphics
  7411.        enabled.  The colour selected will remain the default colour
  7412.        for all subsequent text,  until the end of the questionnaire
  7413.        script or the next ChangeColour command.
  7414.  
  7415.        Valid colours are:
  7416.  
  7417.             <Foreground>                        <Background>
  7418.             ------------                        ------------
  7419.  
  7420.             0    Black                          0   Black
  7421.             1    Blue                           1   Blue
  7422.             2    Green                          2   Green
  7423.             3    Cyan                           3   Cyan
  7424.             4    Red                            4   Red
  7425.             5    Magenta                        5   Magenta
  7426.             6    Brown                          6   Brown
  7427.             7    Light Grey                     7   Light Grey     
  7428.             8    Dark Grey
  7429.             9    Light Blue
  7430.            10    Light Green
  7431.            11    Light Cyan
  7432.            12    Light Red
  7433.            13    Light Magenta
  7434.            14    Yellow
  7435.            15    White
  7436.  
  7437.  
  7438.            Example : ChangeColor 7 1
  7439.  
  7440.            This example would change the  text colour to light  red
  7441.            foreground on a black background.    
  7442.  
  7443.                                     119
  7444.        ClearScreen
  7445.        -----------
  7446.  
  7447.        Clears  the  user's  screen if  the user has  enabled screen
  7448.        clearing.
  7449.  
  7450.  
  7451.            Example : ClearScreen
  7452.  
  7453.            This command would simply clear the users screen. 
  7454.  
  7455.  
  7456.        Display "<Text>"
  7457.        ----------------
  7458.  
  7459.        Displays the specified text on the screen.  The vertical bar
  7460.        is  translated to a line-feed and carriage return.  If  this
  7461.        bar  is  omitted,  any  following  text starts at  the  next
  7462.        character on the same line.
  7463.  
  7464.  
  7465.            Example : Display "Please answer ALL questions|"
  7466.  
  7467.            In this example the text, "Please  answer ALL questions"
  7468.            would be displayed to the user with a linefeed/carriage 
  7469.            return.
  7470.             
  7471.  
  7472.        DisplayFile <1-8 character file name>
  7473.        -------------------------------------
  7474.  
  7475.        Causes a text file to be displayed in the same way as a menu
  7476.        type 5 would be displayed. The text file must be in the text
  7477.        file directory, and have the extension .ASC/.ANS/.AVT.
  7478.  
  7479.            Example : DisplayFile BBSRULES
  7480.  
  7481.            This example would display  the file BBRULES.ASC/ANS/AVT
  7482.            (ASC to ASCII users, ANS to  ANSI users and AVT to users
  7483.            with AVATAR enabled) to the  user.   Once  the file  has
  7484.            been displayed the user  would  then be  returned to the
  7485.            questionnaire.        
  7486.  
  7487.  
  7488.        EndIf
  7489.        -----
  7490.         
  7491.        Signifies the end of an IF statement.   The function of "If"
  7492.        and the relationship of the "EndIf" statement are more fully
  7493.        explained  later  in  this  chapter   under  the "If" script
  7494.        command.
  7495.  
  7496.             Example : EndIf
  7497.  
  7498.  
  7499.  
  7500.  
  7501.  
  7502.  
  7503.  
  7504.                                     120
  7505.        If <Var num> = "<String>"
  7506.        -------------------------
  7507.  
  7508.        The  IF  command  compares the  contents  of  the  specified
  7509.        variable number with <String>. If the two do not match, then
  7510.        all following lines are skipped until an ENDIF statement  is
  7511.        encountered.
  7512.  
  7513.  
  7514.            Example : If 5 = "Perth"
  7515.                      Display "That's where I live|"
  7516.                      EndIF
  7517.  
  7518.            The above section  of script would examine  the contents
  7519.            of variable 5 and check  to see if it matches  the text,
  7520.            "Perth". If it does the text "That's where I live" would
  7521.            be displayed.  If  variable  5 does not match  the text,
  7522.            the  script  would  jump  to  the  EndIF  statement  and
  7523.            continue  with  the questionnaire without displaying the
  7524.            text. 
  7525.  
  7526.  
  7527.  
  7528.        Exec <commandline>
  7529.        ------------------
  7530.  
  7531.        Executes  a  program  in   a  DOS  shell.  All  command-line
  7532.        parameters valid in a menu type 7 command may be used.
  7533.  
  7534.  
  7535.            Example : Exec C:\RA\NEWMAIL.EXE *B*M
  7536.  
  7537.            This  command would  force RemoteAccess  to execute  the
  7538.            DOS command "MAIL.EXE"  whilst the user is on-line.  The
  7539.            "*M" tells RemoteAccess  to swap itself  out  of  memory
  7540.            before  executing  the command.   This  is  useful  when
  7541.            running  programs that  require large amounts of memory.
  7542.            For further  information on  executing DOS commands  see
  7543.            MENU TYPE, type 7. 
  7544.  
  7545.  
  7546.  
  7547.        GetChoice <Valid choices> <Var num>
  7548.        -----------------------------------
  7549.  
  7550.        Waits  for the user to enter one of the characters in <Valid
  7551.        choices>, and stores the response in the variable <Var num>.
  7552.  
  7553.  
  7554.            Example : GetChoice YN 2
  7555.  
  7556.            This command would wait for the user to press "Y" or "N"
  7557.            and then store the response in variable 2.
  7558.  
  7559.  
  7560.  
  7561.  
  7562.  
  7563.  
  7564.  
  7565.                                     121
  7566.        Goto <Label> 
  7567.        ------------
  7568.  
  7569.        Causes the script to jump to  the  specified  <Label>.   The
  7570.        Label can be any 12 character alphanumeric sequence.  Labels
  7571.        can be placed into the  script by  placing  a ':' before the
  7572.        label string.
  7573.  
  7574.  
  7575.             Example : If 5="Y"
  7576.                       Goto EXT
  7577.                       EndIf
  7578.                       Quit
  7579.                       
  7580.                       :EXT
  7581.                         Display "You answered Yes!"
  7582.                         Quit
  7583.  
  7584.  
  7585.            In this case,  if  variable 5 is "Y"  RemoteAccess  will
  7586.            jump to the  segment of script  beginning  with  ":EXT",
  7587.            then  display  the text,  "You answered YES!".  If   the
  7588.            variable is not equal to "Y", the questionnaire would be
  7589.            terminated immediately.
  7590.  
  7591.  
  7592.  
  7593.        ListAnswer <Var num>
  7594.        --------------------
  7595.  
  7596.        Displays  (to the screen) the contents of the variable  <Var
  7597.        num> followed by a CR/LF.
  7598.  
  7599.  
  7600.            Example : ListAnswer 5
  7601.  
  7602.            This example would display  the contents of variable 5.
  7603.  
  7604.  
  7605.  
  7606.        MenuCmnd <Num> <Data>
  7607.        ---------------------
  7608.  
  7609.        Executes a  menu command. Simply specify  the command number
  7610.        followed by  the contents of  the optional data  field. Note
  7611.        that menu navigation commands  (GOTO, GOSUB, RETURN etc) may
  7612.        not be used.
  7613.  
  7614.  
  7615.            Example : MenuCmnd 27 60 /T=Andrew_Milner
  7616.  
  7617.            This example  will force  RemoteAccess to  run  the menu
  7618.            command  type  27,  with  an   optional  data  field  of
  7619.            "60 /T=Andrew_Milner".  This  is the  command to  post a
  7620.            message in message area 60 addressed to "Andrew Milner".
  7621.            For  further  information  on  menu   commands  see  the
  7622.            section on MENU TYPES.
  7623.         
  7624.  
  7625.  
  7626.                                     122
  7627.        OutputAnswer "<Descriptor>" <Var num>
  7628.        -------------------------------------
  7629.  
  7630.        Outputs  <Descriptor>  followed  by  the  contents  of   the
  7631.        variable  <Var  num> to the questionnaire answer  file.  The
  7632.        answer file is given the same name as the questionnaire file
  7633.        but has an extension of .ASW.
  7634.  
  7635.  
  7636.            Example : OutputAnswer "Hobbies  : " 6
  7637.  
  7638.            The answer  stored in varable 6 will be outputted to the
  7639.            file <filename.ASW>,  where  "filename" is the same name
  7640.            as the questionnaire file.  If  this answer is the first
  7641.            outputted answer in the questionnaire it  is a good idea
  7642.            to first  use the command  "PostInfo" to output a header
  7643.            detailing information about the  person who is answering
  7644.            the  questionnaire.
  7645.  
  7646.  
  7647.  
  7648.        PostInfo
  7649.        --------
  7650.  
  7651.        This option tells RemoteAccess to output the users name  and
  7652.        the date and time to the answer file.
  7653.  
  7654.  
  7655.            Example : PostInfo
  7656.  
  7657.  
  7658.  
  7659.        Quit
  7660.        ----
  7661.  
  7662.        Terminates the questionnaire and returns to the BBS.
  7663.  
  7664.             Example : Quit
  7665.  
  7666.  
  7667.  
  7668.        SetFlag <Flag set><Flag number> <ON|OFF>
  7669.        ----------------------------------------
  7670.  
  7671.        Turns on or off the specified user flag.  <Flag set> is "A",
  7672.        "B",  "C" or "D",  and <Flag number> is a number between one
  7673.        and  eight.   Changes   to  the   users  flag  settings  are
  7674.        permanently recorded in the user database.
  7675.  
  7676.  
  7677.            Example : SetFlag C3 OFF
  7678.  
  7679.            In this example the users C3 flag would be turned off.
  7680.  
  7681.  
  7682.  
  7683.  
  7684.  
  7685.  
  7686.  
  7687.                                     123
  7688.        SetSecurity <Security level>
  7689.        ----------------------------
  7690.  
  7691.        Simply   sets  the  user's  security  level  to  the  number
  7692.        specified. The level may be any number from 1 to 64,000. Any
  7693.        changes  to the  users  security  level will be  permanently
  7694.        recorded in the user database.
  7695.  
  7696.  
  7697.            Example : SetSecurity 10
  7698.  
  7699.            This  would  set the users  security to a level of 10.
  7700.  
  7701.  
  7702.  
  7703.        WaitEnter
  7704.        ---------
  7705.  
  7706.        Waits for the user  to press [ENTER].   If the user  presses
  7707.        any other key,  then the input will be ignored.
  7708.  
  7709.  
  7710.            Example :  WaitEnter
  7711.  
  7712.            When   this  line  is  encountered  in  the script,  the
  7713.            user will  have to press the Enter key before he/she can
  7714.            continue.
  7715.  
  7716.  
  7717.  
  7718.  
  7719.  
  7720.  
  7721.  
  7722.  
  7723.  
  7724.  
  7725.  
  7726.  
  7727.  
  7728.  
  7729.  
  7730.  
  7731.  
  7732.  
  7733.  
  7734.  
  7735.  
  7736.  
  7737.  
  7738.  
  7739.  
  7740.  
  7741.  
  7742.  
  7743.  
  7744.  
  7745.  
  7746.  
  7747.  
  7748.                                     124
  7749.        Terminal emulations
  7750.        ────────────────────────────────────────────────────────────
  7751.  
  7752.        A terminal emulation is the method that RemoteAccess uses to
  7753.        communicate  with the  user's  software. The  most basic  of
  7754.        these is  straight ASCII.  The ASCII terminal  emulation can
  7755.        only display normally visible  characters plus a few others,
  7756.        such as backspace, linefeed and clearscreen.
  7757.  
  7758.        RemoteAccess supports two  additional emulations -  ANSI and
  7759.        AVATAR.  ANSI  is   currently  the  most  popular   terminal
  7760.        emulation in the bulletin board world; it has the capability
  7761.        to change text  colour, cursor position,  and can do  simple
  7762.        animations.  Some  implementations  of ANSI  can  even  play
  7763.        simple  tunes  at  the  user's  end.  ANSI  does  have  some
  7764.        drawbacks; each  special control code is  several characters
  7765.        long. To  change the  text colour  for  example, requires  a
  7766.        control  code of up to 8 characters. These lengthy codes can
  7767.        severely slow the  user's display, and  for this reason  the
  7768.        usefulness  of  ANSI at  speeds of  1200  baud and  lower is
  7769.        limited.
  7770.  
  7771.        AVATAR,  on the  other  hand, uses  control  codes that  are
  7772.        typically a quarter to  a third of the length  of their ANSI
  7773.        equivalents,  making it  usable  at lower  speeds. Not  only
  7774.        that,  but AVATAR  has  much more  advanced screen  control,
  7775.        making possible  relatively  complex animations  and  screen
  7776.        displays. AVATAR is a newcomer - there are comparatively few
  7777.        terminal programs  that support it, even  fewer that support
  7778.        it properly.  At  this  time  there  are  no  utilities  for
  7779.        creating AVATAR  screens. You can however  convert your ANSI
  7780.        screens to AVATAR with the supplied utility.
  7781.  
  7782.        RemoteAccess  uses  AVATAR  level  0+  (AVT/0+).   The  only
  7783.        terminal programs  which have been tested  successfully with
  7784.        AVT/0+    are   Joaquim   Homrighausen's   FrontDoor,   Adam
  7785.        Stanislav's TinyTerm  and  Adam Blake's Communique.  If  you
  7786.        make use of AVT/0+  you should make  it clear  to your users
  7787.        that they should  be  using  one of  these  two,  until more
  7788.        terminal programs  implement AVATAR support.
  7789.  
  7790.  
  7791.  
  7792.  
  7793.  
  7794.  
  7795.  
  7796.  
  7797.  
  7798.  
  7799.  
  7800.  
  7801.  
  7802.  
  7803.  
  7804.  
  7805.  
  7806.  
  7807.  
  7808.  
  7809.                                     125
  7810.        Text file naming conventions
  7811.        ────────────────────────────────────────────────────────────
  7812.  
  7813.        RemoteAccess displays  text files at specific  points and in
  7814.        response  to  specific  events. The  EXTERNAL  SUPPORT FILES
  7815.        section  details all these  text files. Files  that have the
  7816.        .A??  extension  may  be  displayed  in  any  one  of  three
  7817.        "flavours":
  7818.  
  7819.        .ASC : ASCII only, no special control codes
  7820.        .ANS : ANSI, should only contain text and ANSI codes
  7821.        .AVT : AVATAR, may contain text and AVATAR codes.
  7822.  
  7823.        If a  user has  both ANSI  and AVATAR  enabled, RemoteAccess
  7824.        will  search first for a .AVT file, and if unsuccessful will
  7825.        then try .ANS  and then .ASC.  If only  ANSI *or* AVATAR  is
  7826.        selected and  the preferred  file type isn't  available, the
  7827.        .ASC version will be displayed.
  7828.  
  7829.  
  7830.  
  7831.  
  7832.  
  7833.  
  7834.  
  7835.  
  7836.  
  7837.  
  7838.  
  7839.  
  7840.  
  7841.  
  7842.  
  7843.  
  7844.  
  7845.  
  7846.  
  7847.  
  7848.  
  7849.  
  7850.  
  7851.  
  7852.  
  7853.  
  7854.  
  7855.  
  7856.  
  7857.  
  7858.  
  7859.  
  7860.  
  7861.  
  7862.  
  7863.  
  7864.  
  7865.  
  7866.  
  7867.  
  7868.  
  7869.  
  7870.                                     126
  7871.        Interactive EMSI
  7872.        ────────────────────────────────────────────────────────────
  7873.  
  7874.        Interactive  EMSI (IEMSI) is a protocol which can be used by
  7875.        communications software to  establish certain parameters for
  7876.        an interactive session, for  example a user logging on  to a
  7877.        bulletin board.  The only BBS  software to  support IEMSI at
  7878.        this time is RemoteAccess 1.11.
  7879.  
  7880.        From within the Terminal setup utility,  the user can define
  7881.        a number of user  "profiles", each of which includes  a user
  7882.        name, handle, password, telephone number, location etc. When
  7883.        IEMSI is enabled from within the terminal and the user calls
  7884.        a RemoteAccess  BBS, the user's  information is sent  to the
  7885.        BBS automatically.
  7886.  
  7887.        This  makes it possible for a  user (the "client") to log on
  7888.        to a BBS (the "server")  without even touching the keyboard.
  7889.        The terminal and RemoteAccess will   automatically  exchange
  7890.        information such as software name and version number, screen
  7891.        parameters and local time.
  7892.  
  7893.        One  useful  feature  is  the   ability  of  the  server  to
  7894.        temporarily modify  the user's  display  parameters for  the
  7895.        current  session only.  For  example, normally  when a  user
  7896.        calls  a particular  BBS  he/she  might  use  25  line  mode
  7897.        locally, so  the "screenlength"  field in his/her  record is
  7898.        set  to  25 accordingly.  However,  on  one occasion  he/she
  7899.        activates the terminal   in   50   line  mode.  RemoteAccess
  7900.        will   recognise this and set   the screen length  to 50 for
  7901.        the  current session only, restoring it to 25 when the  user
  7902.        disconnects.     In    addition,       RemoteAccess     will
  7903.        automatically activate whatever terminal emulations  both it
  7904.        and the client supports.
  7905.  
  7906.        Another benefit is the ability  to chat to a  users using  a
  7907.        full screen chat mode.   This  is accomplished  by the IEMSI
  7908.        remote terminal being able to maintain the chat screen.
  7909.  
  7910.        To  see if a  user is connected  in IEMSI mode  to your BBS,
  7911.        press F7. If IEMSI is active,  RemoteAccess will display the
  7912.        relevant information about the client's system on the status
  7913.        bar. At  the right hand  end of  the status  bar the  user's
  7914.        request flags  are displayed.  A request  flag is an  option
  7915.        that the  user  asked for.  RemoteAccess currently  supports
  7916.        these request flags:
  7917.  
  7918.  
  7919.             CHT : Split screen chat mode capability indicator
  7920.             CLR : Clear screen codes
  7921.            NEWS : Display the NEWS.A?? file
  7922.            MAIL : Check for new mail
  7923.            FILE : Check for new files
  7924.             HOT : Use hot-keys
  7925.            HUSH : Activate "do not disturb"
  7926.            FSED : Use the full screen message editor
  7927.  
  7928.  
  7929.  
  7930.  
  7931.                                     127
  7932.        BATCH FILES       
  7933.        ────────────────────────────────────────────────────────────
  7934.  
  7935.        You  will  require   a  batch   file  to  run   RemoteAccess
  7936.        successfully.  A batch file is a  DOS file which  contains a
  7937.        list of  commands  which  will be executed in the designated
  7938.        order (one per line).   Along  with normal DOS  commands you
  7939.        can execute programs and use special commands only available
  7940.        in batch files.  (Refer to  your DOS manual  for information
  7941.        on BATCH file commands).  
  7942.  
  7943.  
  7944.        To help in  the construction of  batch files,  the following
  7945.        files are generated by RemoteAccess: {+} Registered only.
  7946.  
  7947.  
  7948.           RAREADY.nnn  : When   there   are   no   callers  on-line
  7949.                          RemoteAccess  will  produce  a file called
  7950.                          "RAREADY.nnn" in the semaphore  directory,
  7951.                          "Nnn"  is  the  node  which  generated the
  7952.                          file. When a caller logs on  this file  is
  7953.                          deleted.
  7954.  
  7955.           RABUSY.nnn   : This  file  will   be  generated   in  the
  7956.                          semaphore directory when a caller logs on.
  7957.                          The file  extension "nnn"  corresponds  to
  7958.                          the node number. When the caller  logs off
  7959.                          this file is deleted.
  7960.  
  7961.        Additionally,  it  is  possible  to  force  RemoteAccess  to
  7962.        terminate and return  to DOS  at any time  (while a user  is
  7963.        online  or  while  waiting  for  a  call)  by  creating  the
  7964.        following file in the semaphore directory:
  7965.  
  7966.           RAXITn.e
  7967.  
  7968.        Where 'n' is  the target node, and 'e' is  the errorlevel to
  7969.        exit with. For example, the file RAXIT3.45 would  cause node
  7970.        three to exit to DOS with errorlevel 45.
  7971.  
  7972.  
  7973.  
  7974.  
  7975.  
  7976.  
  7977.  
  7978.  
  7979.  
  7980.  
  7981.  
  7982.  
  7983.  
  7984.  
  7985.  
  7986.  
  7987.  
  7988.  
  7989.  
  7990.  
  7991.  
  7992.                                     128
  7993.        BATCH FILE EXAMPLES       
  7994.        ────────────────────────────────────────────────────────────
  7995.  
  7996.        These examples are not usable in their presented form.  They
  7997.        are provided as a starting point for your own batch files:
  7998.  
  7999.  
  8000.        Using RemoteAccess stand-alone (ie. without a mailer)
  8001.        -----------------------------------------------------
  8002.  
  8003.        :START
  8004.           Cd \RA
  8005.  
  8006.           REM Run the main program:
  8007.           RA -E20
  8008.  
  8009.           REM User logged off, cycle back:
  8010.           if errorlevel 20 goto START
  8011.  
  8012.           REM RemoteAccess exits to the batchfile with errorlevel 7
  8013.           REM once a night:
  8014.           
  8015.           if errorlevel  7 goto CLEAN
  8016.  
  8017.           if errorlevel  3 goto START
  8018.  
  8019.           if errorlevel  2 goto LOCAL
  8020.  
  8021.           REM An errorlevel of 1 means a fatal error, an
  8022.           REM errorlevel of 0 means that ESCape was pressed while  
  8023.           REM in "wait for call" mode - so we quit:  
  8024.           goto END
  8025.  
  8026.        :CLEAN
  8027.           REM Do nightly message and user maintenance with RAUSER  
  8028.           and RAMSG
  8029.           goto START
  8030.  
  8031.        :LOCAL
  8032.           REM Load RemoteAccess in local mode
  8033.           RA -L 
  8034.           goto START
  8035.  
  8036.        :END
  8037.           echo RemoteAccess HQ Line 1 Down.
  8038.  
  8039.  
  8040.        NOTE:    Unlike some other BBS packages,  RemoteAccess  will
  8041.        ALWAYS exit back to DOS (or your batch file) after a  caller
  8042.        logs  off.  This means that you can only run in  stand-alone
  8043.        mode with a batch file that will recycle back to restart the
  8044.        main program.
  8045.  
  8046.  
  8047.  
  8048.  
  8049.  
  8050.  
  8051.  
  8052.  
  8053.                                     129
  8054.        Using RemoteAccess with a mailer (FrontDoor or  BinkleyTerm)
  8055.        (using either TosScan or Echogen to process mail)
  8056.        -------------------------------------------------
  8057.  
  8058.        :START 
  8059.  
  8060.           cd \RA
  8061.  
  8062.           REM Run the main program and run the mailer in a "shell".
  8063.           REM The *M tells RemoteAccess to swap out of memory      
  8064.           REM before running the mailer.
  8065.  
  8066.           REM Either FrontDoor : RA -m\FD\FD.EXE*M -E20
  8067.           REM   or BinkleyTerm : RA -m\BT\BT.EXE*M -E20
  8068.  
  8069.           REM Any errorlevels that RemoteAccess does not understand
  8070.           REM it passes back to the batchfile:
  8071.           if errorlevel 150 goto CLEAN
  8072.           if errorlevel  99 goto UNPACK
  8073.           if errorlevel  20 goto START
  8074.           if errorlevel  10 goto END
  8075.           if errorlevel   5 goto NET&ECHO
  8076.           if errorlevel   4 goto ECHO
  8077.           if errorlevel   3 goto NET
  8078.           if errorlevel   2 goto LOCAL
  8079.           goto END
  8080.  
  8081.        :CLEAN
  8082.           REM Do your nightly maintenance here. In this example    
  8083.           REM the mailer is set to exit at errorlevel 150 nightly.
  8084.  
  8085.        :UNPACK
  8086.           REM Toss incoming mail
  8087.           REM Either : TOSSCAN toss
  8088.           REM     or : ECHOGEN -A -P -T -U
  8089.           goto START
  8090.  
  8091.        :NET&ECHO
  8092.           REM Net and EchoMail needs to be exported from the 
  8093.           REM message base.
  8094.           REM Either : TSUTIL export
  8095.           REM     or : MAILSCAN
  8096.  
  8097.        :ECHO
  8098.           REM Export EchoMail.
  8099.           REM Either : TOSSCAN scan
  8100.           REM     or : ECHOGEN -A -E -P
  8101.           goto START
  8102.  
  8103.        :NET
  8104.           REM Only export NetMail
  8105.           REM Either : TSUTIL export
  8106.           REM     or : MAILSCAN
  8107.           goto START
  8108.                 
  8109.        :LOCAL
  8110.           REM Load RemoteAccess in local mode
  8111.           RA -L 
  8112.           goto START
  8113.  
  8114.                                     130
  8115.        :CLEAN
  8116.           REM Do nightly message and user maintenance with RAUSER  
  8117.         and RAMSG
  8118.           goto START 
  8119.  
  8120.        :END
  8121.           REM Some fatal error occurred.
  8122.           echo RemoteAccess HQ Line 2 Down.
  8123.  
  8124.  
  8125.  
  8126.  
  8127.  
  8128.        * The Echogen command-line switches shown assume a FrontDoor
  8129.          environment.
  8130.  
  8131.        Note  that the  particular command-line  switches for all of
  8132.        these      utilities  (BinkleyTerm,  FrontDoor,  TosScan  or
  8133.        Echogen)  will vary according to your set up.  All of  these
  8134.        programs are supplied with documentation which will  provide
  8135.        you  with this information.  It is stressed again that these
  8136.        examples are only intended to give you a starting point  for
  8137.        creating your own batch files.
  8138.  
  8139.  
  8140.  
  8141.  
  8142.  
  8143.  
  8144.  
  8145.  
  8146.  
  8147.  
  8148.  
  8149.  
  8150.  
  8151.  
  8152.  
  8153.  
  8154.  
  8155.  
  8156.  
  8157.  
  8158.  
  8159.  
  8160.  
  8161.  
  8162.  
  8163.  
  8164.  
  8165.  
  8166.  
  8167.  
  8168.  
  8169.  
  8170.  
  8171.  
  8172.  
  8173.  
  8174.  
  8175.                                     131
  8176.