home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMSPTFR / PMSTR101.ZIP / PMEISTER.DOC < prev    next >
Encoding:
Text File  |  1992-10-03  |  14.3 KB  |  313 lines

  1.  
  2.          ═╦═ ╦ ╦ ╔═╗     ╔═╗ ╔═╗ ╔═╗ ═╦═ ╔╦╗ ╔═╗ ═╦═ ╔═╗ ═╦═ ╔═╗ ╔═╗
  3.           ║  ╠═╣ ╠═      ╠═╝ ║ ║ ╠╦╝  ║  ║║║ ╠═   ║  ╚═╗  ║  ╠═  ╠╦╝
  4.           ╩  ╩ ╩ ╚══     ╩   ╚═╝ ╩╚═  ╩  ╩ ╩ ╚══ ═╩═ ╚═╝  ╩  ╚══ ╩╚═
  5.                Fast Port Lock and Unlock Utility for Spitfire
  6.  
  7.                           The PortMeister 1.01
  8.                             October 3, 1992
  9.  
  10.                       Copyright (C) 1992 Mike Robinson
  11.  
  12.                              The Soft Parade
  13.                          Shelton, Connecticut, USA
  14.                               203-924-5603
  15.  
  16.       The Portmeister is a PC communications port lock and unlock utility
  17.       designed for use on a Spitfire BBS. It adjusts the computer-to-modem
  18.       (DTE/DCE) data communications speed on the fly. It does not alter the
  19.       modem-to-modem link speed. It works well with the US Robotics Dual
  20.       Standard modem, including the new 16800 HST model. It may also work
  21.       with other modems which use the Hayes AT command set, but this has
  22.       not yet been tested.
  23.  
  24.       The PortMeister can handle the new high speed result codes returned
  25.       by some modems such as CONNECT 12000, CONNECT 14400, CONNECT 16800.
  26.       The high speed result codes can be suppressed on newer US Robotics
  27.       Dual Standards by setting S27=128. The PortMeister does NOT require
  28.       this setting. It will work fine as long as the word "CONNECT" appears
  29.       anywhere in the result code. On my BBS, I like to see the high speed
  30.       result codes, so I use the default S27=0. Download time estimates are
  31.       more accurate when the correct connect speed is passed to Spitfire.
  32.  
  33.       Many BBSs run with what is sometimes called a "locked" comm port.
  34.       This means the comm port is set to a fixed speed, usually either
  35.       19200 bps or 38400 bps. This is fine for most operations, but there
  36.       are some doors (external programs) which will not operate properly at
  37.       such high speeds. These are usually older programs that are limited
  38.       to a maximum speed of 9600 bps. One possible solution would be to run
  39.       the BBS full time at the slower speed. But this slows the entire BBS
  40.       down. A better solution for many is to change the port speed on the
  41.       fly as required.
  42.  
  43.  
  44.       *** SETUP ***
  45.  
  46.       The PortMeister requires these modem settings:
  47.  
  48.       1. The escape code response must be set to NOT DROP CARRIER when the
  49.          modem goes to command mode. On a US Robotics Dual Standard this is
  50.          done by setting DIP SWITCH 9 DOWN.
  51.  
  52.       2. The modem must return the word "CONNECT" somewhere in the result
  53.          code. Most modems using the Hayes AT command will do this when set
  54.          to any one of the following: X0, X1, X2, X3, X4, X5, X6, X7.
  55.          See also Q0 and V1 below. These are also required.
  56.  
  57.       3. The modem must also have the following command settings which are
  58.          usually the same as those used by Spitfire. Note that the actual
  59.          command may be different if you are not using a USR Dual Standard.
  60.          But the command function and effect must be the same.
  61.  
  62.          &B1  Fixed DTE Rate. A fixed DTE Rate (port speed) must be set.
  63.               Since this is a modem command, the computer port speed can
  64.               still be changed and the modem made to follow the DTE rate.
  65.               The PortMeister will not work correctly for link rates higher
  66.               than 9600 bps if the port speed is set to follow the link
  67.               rate.
  68.  
  69.          Q0   Result Codes Displayed. (With a US Robotics Dual Standard
  70.               this can also be done by setting DIP switch 3 down.)
  71.  
  72.          V1   Verbal Result Codes.    (With a US Robotics Dual Standard
  73.               this can also be done by setting DIP switch 2 up.)
  74.  
  75.         S2=1  Escape character is ASCII character number 1. (smiley face)
  76.               This is the same escape code as used by Spitfire.
  77.  
  78.  
  79.       In it's simplest form, The PortMeister is copied to the Spitfire home
  80.       directory and executed in a batch file like this:
  81.  
  82.       PMEISTER UNLOCK
  83.       SFMNUEXT         ( SFMNUEXT shown, but any program can be run here. )
  84.       PMEISTER LOCK
  85.  
  86.       This is the way I run it on my BBS. For most people, this will be all
  87.       that is required. It's that simple. The PortMeister will search the
  88.       current directory and find the data file SFDOORS.DAT, SFFILE.DAT,
  89.       SFMAIN.DAT or SFMESS.DAT.
  90.  
  91.       But if you like to get complicated about things, there are more
  92.       options. You can execute it from any directory and specify the path
  93.       and name of the data file like this:
  94.  
  95.       PMEISTER UNLOCK C:\SF\SFDOORS.DAT
  96.       SFMNUEXT
  97.       PMEISTER LOCK   C:\SF\SFDOORS.DAT
  98.  
  99.       And if you really want get fancy, you can do this:
  100.  
  101.       PMEISTER UNLOCK C:\SF\SFDOORS.DAT C:\SF\PMEISTER.CFG
  102.       SFMNUEXT
  103.       PMEISTER LOCK   C:\SF\SFDOORS.DAT C:\SF\PMEISTER.CFG
  104.  
  105.       In this case, you are specifying the path to the configuration file
  106.       too. The configuration file is OPTIONAL. The PortMeister will run
  107.       fine without it. It is only required if you want to change the timing
  108.       of the commands to the modem or you want to change the escape
  109.       character used. If the path and name to the configuration file is not
  110.       specified, then it will search the current directory for
  111.       PMEISTER.CFG. If the config file is not found, then the default
  112.       configuration values will be used.
  113.  
  114.  
  115.       *** OPTIONAL CONFIGURATION FILE ***
  116.  
  117.       The PortMeister reads each line in this file. If the line begins with
  118.       a keyword then the configuration is modified according to the
  119.       information that follows the keyword. If a line begins with anything
  120.       other than a letter, it is ignored. The order of the lines is not
  121.       important. The keywords are NOT case sensitive, but they must be
  122.       spelled correctly.
  123.  
  124.       EscapeChar 1
  125.       ; This defines command mode escape character sent to the modem.
  126.       ; I doubt you will ever have to change this since Spitfire requires
  127.       ; that the escape character be ASCII character 1 (smiley face).
  128.       ; The default is 1.
  129.  
  130.       PreTics 27
  131.       ; This is the pause in clock tics BEFORE the command mode escape code
  132.       ; is sent to the modem. There are approximately 18 clock tics in 1
  133.       ; second. This setting is critical to proper operation. Most modems
  134.       ; require at least a one second pause with no data before sending
  135.       ; the command mode escape code.
  136.       ; The default is 27 tics (which equals 1.5 seconds)
  137.       ; This seems to work best here. Experiment if you like, but be
  138.       ; careful. There is a wide variation of responses. If a certain
  139.       ; timing works for a 9600 bps caller, it may not work for a 1200.
  140.  
  141.       PostTics 18
  142.       ; This is the pause in clock tics AFTER the command mode escape code
  143.       ; is sent to the modem. Most modems require at least a one second
  144.       ; pause with no data after sending the command mode escape code.
  145.       ; The default is 18 tics (which equals 1 second)
  146.  
  147.  
  148.       *** HOW IT WORKS ***
  149.  
  150.       1. The PortMeister is executed in unlock mode. It reads the caller's
  151.          connect speed on line 5 of SFDOORS.DAT, SFFILE.DAT, SFMAIN.DAT or
  152.          SFMESS.DAT. It unlocks and sets the port to this speed. If the
  153.          connect speed is higher than 9600 bps, then the port speed will be
  154.          set to 9600. It then modifies and saves SFDOORS.DAT (or
  155.          equivalent) with both the connect speed (line 5) and maximum speed
  156.          (line 20) set to the new lower port speed. It saves the original
  157.          values in a temporary file named PMEISTER.DAT.
  158.  
  159.       2. The door or external program is then run. This is often an
  160.          extended menu type of program such as SFMNUEXT or SFEXTEND.
  161.  
  162.       3. The PortMeister is executed in lock mode. It reads and then erases
  163.          PMEISTER.DAT. It then restores the port and SFDOORS.DAT
  164.          (or equivalent) to their original settings.
  165.  
  166.  
  167.       *** REGISTRATION ***
  168.  
  169.       This is SHAREWARE. You may use this program for a free 30 day trial
  170.       period. After that, you must register it or stop using it.
  171.       You may give away free copies of this entire unmodified package,
  172.       but you may not sell it. I retain all rights to this program.
  173.  
  174.       In the registered version the * EVALUATION COPY *  message on the
  175.       logo is replaced by your name.
  176.  
  177.       Registration is $10 (TEN) dollars in US funds.
  178.       Personal check, bank check or money orders are acceptable.
  179.  
  180.       Registered Sysops are entitled to free program support, free
  181.       upgrades to all future versions, and free access to all files and
  182.       features on my BBS. Support is available from me on my BBS, in
  183.       CircuitNet and in FidoNet. Suggestions for future improvements from
  184.       registered Sysops will receive careful consideration.
  185.  
  186.       In order to register the program, you will have to call my BBS and
  187.       download your personal registration key and instruction file. This
  188.       key will work for all future versions, so there will be no need to
  189.       download any specially compiled versions of the executable program
  190.       itself.
  191.  
  192.       If you do not yet have access to my BBS, please be sure to send
  193.       along a password and birthdate with your registration. Then I can
  194.       set up your logon account in advance. Please be sure to specify
  195.       your name exactly as you would like them to appear on the logo.
  196.  
  197.       -------------------------------------------------------
  198.       -------------------------------------------------------
  199.       -------------------------------------------------------
  200.  
  201.       The PortMeister 1.01     REGISTRATION FORM
  202.  
  203.       Your Name:
  204.       (40 characters maximum)
  205.  
  206.       BBS Name:
  207.  
  208.       BBS Phone Number:
  209.  
  210.       Password to use on  Mike Robinson's BBS:
  211.       (14 characters maximum)
  212.  
  213.       BirthDate to use on Mike Robinson's BBS:
  214.       (mm-dd-yy)
  215.  
  216.       Your Address:
  217.  
  218.       Send this form and $10 (TEN) dollars in US funds to:
  219.  
  220.       Michael Robinson
  221.       9 Richard Boulevard
  222.       Shelton, CT. 06484
  223.  
  224.       Personal check, bank check or money orders are acceptable.
  225.  
  226.       -------------------------------------------------------
  227.       -------------------------------------------------------
  228.       -------------------------------------------------------
  229.  
  230.       InterNet address:  Mike.Robinson@485.n141.z1.fidonet.org
  231.  
  232.       ╔═══════════════════╗ ╔══════════════════════╗ ╔═══════════════════╗
  233.       ║  The Soft Parade  ║ ║ Sysop: Mike Robinson ║ ║ 1200 to 16800 bps ║
  234.       ║  Shelton, CT. USA ║ ║ Spitfire version 3.2 ║ ║   HST   V.32bis   ║
  235.       ║   203-924-5603    ║ ║ Open 24 hours 7 days ║ ║  MNP 5   V.42bis  ║
  236.       ║ FidoNet 1:141/485 ║ ║  CircuitNet  203004  ║ ║ USR Dual Standard ║
  237.       ╚═══════════════════╝ ╚══════════════════════╝ ╚═══════════════════╝
  238.       Latest version of The PortMeister may be File Requested (freq'ed)
  239.       by any Fido compatible mailer 24 hours a day using the
  240.       magic name: PMEISTER
  241.  
  242.       24 hour crash mail & file requests of any file listed in FILES.
  243.       Magic Names: PMEISTER   SFROM   EZROM   CATCHEM   RATIO   FILES
  244.  
  245.       File Name:  pmeister.exe
  246.            Size:  35,329
  247.            Date:  10-3-1992
  248.       File Authentication:
  249.       Check Method 1 - D844
  250.       Check Method 2 - 032E
  251.  
  252.       PKZIP archive security notice for this archive should read:
  253.       Authentic files Verified!   # FEZ251
  254.       MICHAEL N. ROBINSON
  255.  
  256.       Legal Stuff:
  257.       Use this program at your own risk. No guarantees of any sort.
  258.       "Spitfire" is a registered trademark of Buffalo Creek Software.
  259.  
  260.       The PortMeister Revision History
  261.       Version 1.00 - Sep 8, 1992 - Initial Public Release
  262.       Version 1.01 - Oct 3, 1992 - Documentation changes and elaborations.
  263.                      Fixed bug reading timing delays from PMEISTER.CFG.
  264.  
  265.       ********************************************************************
  266.  
  267.       OTHER PROGRAMS BY MIKE ROBINSON:
  268.  
  269.       SFROM120.ZIP   75,909  03-07-93  SF-Rom 1.20 Spitfire CD-ROM Door
  270.  
  271.       SF-Rom Door is a file access and download door designed for use on
  272.       Spitfire 3.x BBS. Files may be located on CD-ROM disk(s), magnetic
  273.       disk(s), or both. It provides browsing, text search and download
  274.       capabilities from within the door. It can even track the number of
  275.       files/bytes downloaded, enforce daily limits, and then record this
  276.       information in the main Spitfire database. The door can be run
  277.       online, locally in the BBS, and locally from the DOS command line.
  278.       Up to 100 CD-ROM disks are supported with up to 500 file areas on
  279.       each disk. Shareware with $20 registration.
  280.  
  281.       EZROM120.ZIP   79,877  05-31-93  EZ-Rom 1.20 CD-ROM Download Door.
  282.                                        For Wildcat or any DOOR.SYS BBS.
  283.  
  284.       EZ-Rom Door is a file access and download door designed for use on
  285.       Wildcat 3.x BBS or any BBS that can create a DOOR.SYS file. Files
  286.       may be located on CD-ROM disk(s), magnetic disk(s), or both. It
  287.       provides browsing, text search and download capabilities from
  288.       within the door. It can even track the number of files/bytes
  289.       downloaded, enforce daily limits, and then record this information
  290.       in the main Wildcat database. The door can be run online, locally
  291.       in the BBS, and locally from the DOS command line. Up to 100 CD-ROM
  292.       disks are supported with up to 500 file areas on each disk.
  293.       Shareware with $20 registration.
  294.       FidoNet file request EZROM for latest version.
  295.  
  296.       SFCAT20.ZIP    37,127  01-19-92  Catchem 2.0, View/Sort User Lists
  297.  
  298.       Catchem 2.0 is a Spitfire 3.x utility to display sorted user list
  299.       files. The idea is to display this information so that you can
  300.       easily observe patterns and weed out duplicate or bogus users. Even
  301.       though a birth date, phone number or password may not be exactly
  302.       the same for 2 users, they may be close enough to arouse suspicion.
  303.       Free Program.
  304.       FidoNet file request CATCHEM for latest version.
  305.  
  306.       RATIO101.ZIP   20,223  05-28-93  Ratio 1.01 Upload Ratio Bulletin
  307.  
  308.       RATIO 1.01 is a Spitfire 3.x BBS utility program that makes a nice
  309.       color/ascii bulletin of the 36 callers with the worst file
  310.       download/upload ratio. Free Program.
  311.       FidoNet file request RATIO for latest version.
  312.  
  313.