home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / MOUSE / LOCKER12.ZIP / LOCKER.DOC < prev    next >
Encoding:
Text File  |  1990-11-05  |  7.0 KB  |  265 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.                                    LOCKER
  33.                                 Version 1.2
  34.  
  35.                    Copyright (c) 1990 By Mark D. Goodwin
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.      In order to get the  most out of a high speed modem,  most sysops
  74.      lock their  serial ports at  either 19,200 or 38,400  baud.  This
  75.      allows for maximum data transfer rates with HST 14,400 baud, MNP,
  76.      and  V.42  connections.   Unfortunately,  most older  doors can't
  77.      handle locked serial ports.   Problems arise whenever the  actual
  78.      connect  baud rate  differs from  the locked  serial port's  baud
  79.      rate.   So the  sysop has three choices,  stop locking his serial
  80.      port, get rid  of any offending  doors, or unlock and  relock the
  81.      serial port when opening and closing  doors.  Obviously, the last
  82.      choice is  the most  desirable, but  you need  a special  utility
  83.      program to  perform the  unlocking and  relocking chores.   Enter
  84.      LOCKER.
  85.  
  86.      When properly used, LOCKER can successfully unlock and relock the
  87.      serial port  for just about any  door.  Although  there are other
  88.      utilities like LOCKER,  LOCKER is  much smaller  and faster  than
  89.      other utilities of  its type.   Whereas the competition can  take
  90.      from 15 to 20 seconds to unlock or lock a serial port, LOCKER can
  91.      unlock or  lock a  serial port  in about  3 to  5 seconds.  Also,
  92.      LOCKER  supports baud rates as high as 115,200 baud, comm ports 1
  93.      to  8,  and  thanks  to  the  power of  C++  and  object-oriented
  94.      programming it will work with  PCBoard (PCBOARD.SYS or DOOR.SYS),
  95.      Spitfire (SFDOORS.DAT (etc.) or DOOR.SYS), GAP (DOOR.SYS), or any
  96.      other  BBS software  that supports  the DOOR.SYS  door data  file
  97.      format.   Best  of all,  you  can register  LOCKER for  only $10.
  98.      That's a  lot less than the unreasonable fees others charge for a
  99.      similar utility.
  100.  
  101.  
  102.                                 USING LOCKER
  103.  
  104.      Using LOCKER couldn't be simpler.  LOCKER is run from the command
  105.      line using the following format:
  106.  
  107.      LOCKER DOORFILE BBS FLAG
  108.  
  109.      Where:
  110.  
  111.      DOORFILE       is the pathname for the door data file.
  112.  
  113.      BBS            is P for PCBoard, S for Spitfire, or G for  GAP or
  114.                     any other BBS software that  uses a DOOR.SYS file.
  115.                     You should use G for both  PCBoard and Spitfire if
  116.                     you intend to use DOOR.SYS instead of their normal
  117.                     door data file types.
  118.  
  119.      FLAG           is either U  for unlock the  serial port or L  for
  120.                     lock the serial port.
  121.  
  122.      Here's a few examples of LOCKER command lines:
  123.  
  124.      locker pcboard.sys p u        (Unlocks a PCBoard door with a door
  125.                                    data filename of "pcboard.sys".)
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.      locker c:\doors\door.sys g l  (Locks a  GAP door with a door data
  140.                                    filename of "c:\doors\door.sys".)
  141.  
  142.      To  put LOCKER to practical use, you  are going to want to use it
  143.      in  a batch file.   The following  is an example of  a door batch
  144.      file that would use LOCKER:
  145.  
  146.      locker pcboard.sys p u        <- Unlocks the serial port
  147.      if errorlevel 1 goto end      <- Abort if the LOCKER failed
  148.      cd \doors\superg              <- Change to the door directory
  149.      superg superg.cfg             <- Run the door
  150.      cd \pcb                       <- Return to the LOCKER directory
  151.      locker pcboard.sys p l        <- Relock the serial port
  152.      :end
  153.      board                         <- Restart the BBS
  154.  
  155.      Note from the  above example,  that LOCKER will  return an  error
  156.      code of 1 if it should  fail.  If LOCKER should fail,  you should
  157.      not  run  the door.   Instead,  return  to the  BBS as  the above
  158.      example would do.
  159.  
  160.  
  161.                              SETTING YOUR MODEM
  162.  
  163.      For LOCKER to correctly  function, your modem's S2  register must
  164.      be set to  43 (S2=43).  This defines the escape code character as
  165.      a +.  Setting  the S2 register is  necessary because LOCKER  uses
  166.      the +++ escape sequence to return  the modem to the Command Mode.
  167.      Once in the Command Mode, LOCKER is able to work its magic.
  168.  
  169.      HST owners must also set DIP switch 9 to  on.  Setting DIP switch
  170.      9 is  necessary to  enable the modem  to return the  Command Mode
  171.      instead of dropping carrier.
  172.  
  173.  
  174.                            THINGS YOU SHOULD KNOW
  175.  
  176.      LOCKER  has  been  thoroughly  tested   with  a  USRobotics  Dual
  177.      Standard,  PCBoard,  and Spitfire.    The DOOR.SYS  interface was
  178.      tested  using the  DOOR.SYS file generated  by Spitfire.   LOCKER
  179.      will not work for 300 baud callers and an HST!  It will appear to
  180.      work correctly, but the door will not function properly.  Whether
  181.      or not LOCKER  will work with non-HST modems, I can't really say.
  182.      The only way to know for sure is to give LOCKER a try.  If you do
  183.      use LOCKER with  a non-HST modem, please  let me know whether  it
  184.      succeeds or fails.   I see no  reason why it won't  work, but who
  185.      knows?
  186.  
  187.  
  188.                                 REGISTRATION
  189.  
  190.      LOCKER is a copyrighted program and distributed as shareware.  If
  191.      you  find LOCKER useful, you are obligated to register it after a
  192.      30 day trial period.  Because LOCKER didn't take me all that long
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.      to develop,  I'm only  charging $10.00  for registration.   As  a
  206.      fellow sysop, I know a BBS can nickel and dime you to death.  But
  207.      if your BBS  has heavy door use,  LOCKER will be run  hundreds of
  208.      times a  day.  So $10.00  isn't all that  unreasonable a request.
  209.      Registered owners  will be sent  a serialized version  of LOCKER.
  210.      Future upgrades will be made available to registered owners at no
  211.      charge.  Registration fees should be sent to  me at the following
  212.      address:
  213.  
  214.      Mark Goodwin
  215.      P.O. Box 187
  216.      Orland, ME 04472
  217.  
  218.      I'll send you  your registered copy by either  mailing it on disk
  219.      or uploading  it to your  board.  If you  want me to  upload your
  220.      registered copy to your board, you  must preregister me under the
  221.      name MARK GOODWIN.   Be sure to let me know the password you have
  222.      assigned to  me  or I'll  have  no choice  but  to mail  you  the
  223.      registered copy.   If you don't  want me to  upload your copy  to
  224.      your board, please  let me know if  you require a 3  1/2" disk or
  225.      not.  Unless  I'm instructed to do  otherwise, I will use  5 1/4"
  226.      disks for all copies sent through the mail.
  227.  
  228.  
  229.                                   SUPPORT
  230.  
  231.      If  you have a  question about LOCKER,  you can call  my BBS, The
  232.      Lobster Buoy, at 207-469-7319 and leave me a message.  Registered
  233.      owners  will be  given my voice  number and  are free to  call me
  234.      anytime.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.