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