##############################################################################
# ########   #######   ########  ### ######### ###        #######   #######  #
# ########   #######   ########  ### ######### ###        #######   #######  #
# ###   ### ###   ###  ###   ### ###    ###    ###       ###   ### ###   ### #
# ###   ### ###   ###  ###   ### ###    ###    ###       ###   ### ###       #
# ###   ### ###   ###  ###   ### ###    ###    ###       ###   ### ###       #
# ########  #########  ########  ###    ###    ###       ###   ### ###       #
# ### ###   ###   ###  ###   ### ###    ###    ###       ###   ### ###       #
# ### ###   ###   ###  ###   ### ###    ###    ###       ###   ### ###       #
# ###  ###  ###   ###  ###   ### ###    ###    ###       ###   ### ###   ### #
# ###   ### ###   ###  ########  ###    ###    #########  #######   #######  #
# ###   ### ###   ###  ########  ###    ###    #########  #######   #######  #
##############################################################################

          .---- A COM-Port Locker/Unlocker for RemoteAccess BBS ----.
     . For your delight, delectation, and sanity using a locked bps-rate .

    What is RA BitLoc? (utterly amazing!)
    ~~~~~~~~~~~~~~~~~~

    RA  BitLoc is a little utility designed for everyone who has any kind of
    modem, running locked at any speed you like, that needs to run  standard
    doors.   Although  some cope with locked speeds (sometimes  with  slight
    alteration),   doors  will  often complain if you throw  any  more  than
    9600bps at them.  Even Yankee Trader will not allow a COM-port locked at
    38400bps. What this utility does is temporarily unlocks your modem, just
    while the user is in the door,  and then locks it back to whatever speed
    it should be at, before returning the user to RemoteAccess, or other BBS
    that writes a DORINFO1.DEF file compatible with RA's version (i.e. QBBS,
    SuperBBS, etc).

    NOTE: If you attempt to use RA BitLoc with doors, that send data through
    the standard FOSSIL communications driver, there will be problems.  This
    program is only for doors that don't work normally.  Doors that write to
    the FOSSIL driver will be sending data at high speed and your modem will
    not be expecting data to be sent so fast -  causing a lot  of garbage on
    the line, probably making your user hang up.

    NB  Some  other programs (for example, FORCE38) that claim to make doors
    work at high locked speeds do not succeed in all cases; RA BitLoc is the
    only thing that will in theory *always* help.

    How do I run RA BitLoc? (useful if you plan on using it)
    ~~~~~~~~~~~~~~~~~~~~~~~
    RA BitLoc, version 1.10, has changed since previous versions.  Please be
    sure to read this carefully if you're upgrading!! You may either specify
    parameters on the command line, or in a control file. It might be easier
    to have a lot of defaults in the control file - they can be easily over-
    ridden on the  command line.  The  RABITLOC.CFG file  you got  with this
    package contains the information you need for these;  so all I will tell
    you about  in these docs  is what you need on the command line. Read the
    sample file for instructions about the verbs you may use.

        RaBitLoc LOCK|UNLOCK (verb) (verb)

    ie, you must include the word LOCK or the word UNLOCK first; other words
    on the line are taken to override control file defaults. You can make do
    without a control file as well - for example:

        RaBitLoc LOCK LockRate 19200 DorInfo \RA Escape @@@ GuardTime 15

    This would re-lock the port after a door exit. The locked speed you have
    set up is 19200, the door information file will be in the \RA directory,
    the 'escape' sequence on the modem is @@@ and the 'guard time' used will
    be 1.5 seconds (check the config file for information about these).

    When RA BitLoc exits, it returns an errorlevel code depending on whether
    or not  it was successful in locking or unlocking the port.  If  it  was
    successful,  the  code 0 is returned.  If there was an  error  with  the
    unlocking or locking, the code 2 is returned.  If the DORINFO1.DEF shows
    that the program is being started in local mode, nothing is sent to  the
    modem, and the code 1 is returned.


    How does it work?
    ~~~~~~~~~~~~~~~~~

    RA  BitLoc  will  setup your modem so it unlocks or locks  the  COM-Port
    speed.  It does this by sending a command to the modem. To do this while
    a user is online, it has to be able to enter command mode by sending the
    character given in the S2 register on the modem three times.  Ie, If you
    have set S2=43 then the character is + so RaBitLoc will send +++ to your
    modem to make it enter command mode. **NB** Many modems have a mode that
    makes receipt of the +++ sequence disconnect the modem from the line. If
    your modem has a mode like this, it *must* be disabled. On a USR Courier
    modem, check that DIP-Switch 9 is set "ON" - in the down position. Other
    requirements: AT command-set enabled (switch 8 down). Verbal result code
    display (ATV1). Result code display (ATQ0).

    RA BitLoc v1.10 will also work with other modems. You specify the set of
    characters to send, to put the modem in command mode, in the controlfile
    with the ESCAPE verb. The LOCK verb sets the command to lock the modem's
    speed and the UNLOCK verb is the command to unlock the speed. Check your
    copy of RABITLOC.CFG inside the archive you found this,  and you'll find
    some more information.

    After the RA BitLoc welcome screen is sent, (NB the  welcome screen is a
    lot longer on unregistered versions!), RaBitLoc will wait for the amount
    of time specified in RABITLOC.CFG as the guard time. The default on HSTs
    is 1.0 seconds; you may  have increased  this on  your setup.  Note that
    with the unregistered version you may not change this parameter; it uses
    a default of 3.0 seconds, which is plenty of time for all modems. If you
    want to speed things up, then register, this will unlock this function &
    disable the long welcome screen. RaBitLoc waits  for up to eight seconds
    for the OK responses, and another eight for the CONNECT message after it
    tells the modem to return online. If the messages are not received after
    this time, then RaBitLoc drops DTR on the modem, hanging up on your user
    which may seem not very nice,  but it's just a little better than having
    the door wait for whatever inactivity timeout time you set... The error-
    level is also changed to indicate failure your batch files can check it.

    If your modem allows 14400bps, unfortunately this is not possible thru a
    door - it is not a "standard" speed and there is no way of communicating
    through the serial port at this speed.  Also if you use MNP level 5, you
    will have to put up with some sort of loss in performance. NB If the bit
    rate is actually 14400bps, it will be choked down to 9600bps after using
    RA BitLoc UNLESS you are registered when you can have a LOWLOCK command!


    Guarantee (you must be joking...)
    ~~~~~~~~~
    If RA BitLoc   doesn't work,  you get to keep all the pieces it ends  up
    in.   Neither  S/e/m/a/j Communications,  nor anyone else even  remotely
    connected with this project,  can take any responsibility at all for the
    actions of the program. If you paid S/e/m/a/j Communications anything to
    register this, contact the support board to arrange a refund.

    Registration
    ~~~~~~~~~~~~
    Should you wish to register this program, send .5 (sterling - not credit
    card or checks drawn on a foreign bank) - The fee is .5 per program that
    is in this scheme, or .20 for all current and future releases at the .5-
    rate (almost all, if not all, will be, and any that cost more will get a
    .5 reduction if you are in this scheme). Please see the enclosed form so
    you have a nice easy way of mailing the registrations (SEMAJ.REG) ... Oh
    yes, you can buy the source code for .500, contact James Berry for info.


    Having problems?
    ~~~~~~~~~~~~~~~~
    Netmail us! Recommended HST DipSwitch settings:

    o     QUAD    1   2   3   4   5   6   7   8   9   0
    n    ######  ### ###     ###     ### ###         ###
    .                    ###     ###         ### ###


    And then go into a terminal and type these commands:

    AT&F
    AT&K1&M4S19=3B0&B1&H1&R2&N0S15=72V1X7EQ
    ATS7=55M1S0=0S8=4S11=74
    AT&W
    ATZ

    Then you can use ATZ as an initialisation string.

    If that lot doesn't work....... Well you'll just have to ring my BBS and
    ask!