home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / MAXINE1.LZH / MAXINE.DOC < prev    next >
Text File  |  1991-02-17  |  11KB  |  266 lines
  1. Maxine V1.00 release notes,  Sun  02-17-1991
  2. --------------------------------------------
  3.  
  4. One small change:  The maxine.cfg parameter "Answer" is actually use
  5. now (the answer string was hard-coded as "`ATA" before).
  6.  
  7. This may well be the last version of Maxine (<sniff> -- just as soon
  8. as I promoted it to V1.00);  but don't despair!.   The next version
  9. of Maximus is going to answer the phone itself;  thus making Maxine
  10. obsolete.
  11.  
  12.  
  13. Maxine beta V0.40 release notes,  Sat  12-15-1990
  14. -------------------------------------------------
  15.  
  16. Sorry for the delay folks -- 0.40 has been ready for some time -- I
  17. simply forgot to release it.
  18.  
  19.  
  20. Fixes:
  21.  
  22.   -  Forget about what I was saying below. "CONNECT xxxx/other info"
  23.     really works this time.  Since 0.20,  Maxine was configuring the
  24.     port at the correct rate,  but was passing the wrong rate to the
  25.     bbs.  So even though everything worked ok,  the time
  26.     calculations for file transfers were incorrect.
  27.  
  28.  
  29. Features:
  30.  
  31.   - "CallTwice TRUE/FALSE" in maxine.cfg.  Breifly:  When FALSE,
  32.     this feature is disabled.  When TRUE,  maxine will only answer
  33.     the phone on the second call,  if the second call arrives within
  34.     45 seconds of the first call.   This was requested by a few
  35.     sysops that use their phone line for more than just the bbs.  It
  36.     is a simple security feature too -- only people that know that
  37.     they have to call once, hang up,  and call right back,  will be
  38.     able to get online.
  39.  
  40.  - The "(C) copright a:ware ..." line, after the first call,  is
  41.    replaced with a couple of stats.
  42.  
  43. Maxine beta V0.30 release notes,  Sun  10-21-1990
  44. -------------------------------------------------
  45.  
  46. Hey folks,  I need feedback!  Thus far, I've only had two bug
  47. reports (and I know there were more than 2 bugs!).   If you don't
  48. tell me,  nothing will get done.
  49.  
  50. Bugs fixed:
  51.  
  52.   - Spurious XOFFs,  under certain conditions,  would cause Maxine
  53.     to abort (after failing to INIT the modem several times).  I now
  54.     close (then re-open) the COM port after each such failure;  so
  55.     you still may see the odd ": Modem init failed [-1]." message,
  56.     but it should not end up aborting after 3 tries.
  57.  
  58. New Feature:
  59.  
  60.   - New config keyword "SlowModem" must be added,  and set to TRUE
  61.     or FALSE.  When TRUE,  modem command strings will be paced (at
  62.     56ms).  Some modems can not take command strings at "full
  63.     speed". "SlowModem TRUE" will fix this problem.
  64.  
  65.  
  66. Maxine beta V0.20 release notes,  Sat  09-01-1990
  67. -------------------------------------------------
  68.  
  69.         Maxine:  A mate for Maximus.  (Guess who wears the pants?).
  70.  
  71.  Bugs fixed:
  72.  
  73.    -  at midnight,  there was a good chance of Maxine getting
  74.      "stuck".  When this happened,  Maxine *would* still answer the
  75.      phone -- but it would not respond if you hit ESC.
  76.  
  77.     (This is one of those embarrassing bugs.  My high-level logic was
  78.      all prepared for the "00:00" syndrome;  but my os/2 code for
  79.      the dos-like _bios_timeofday() function had a bug in it!).
  80.  
  81.    - The code to initialize the modem has been battle hardened a bit.
  82.  
  83.    - Modems configured to return more than "CONNECT xxxx" were not
  84.      working.  I've relaxed the response checking,  so that a
  85.      response such as "CONNECT xxxx/some other info" will now work.
  86.  
  87.   There has been some confusion about how Maxine answers the phone.
  88.   Maxine uses the same method as most other front-end programs. Your
  89.   init string MUST NOT put your modem into "auto answer mode" (AAM)
  90.   -- just the opposite.  You should include "S0=0" in your init
  91.   string,  to make sure your modem is not in AAM.  When your phone
  92.   rings,  your modem will respond with "RING".  Maxine sees this,
  93.   then sends the "Answer" token in your Maxine.cfg.  This should be
  94.   "ATA".
  95.  
  96.   Why is this method used?  Simple:  If your modem is in AAM,  and
  97.   your computer crashes for any reason (loss of power, h/w failure,
  98.   NMI error, etc),  your modem will still answer the phone.  This
  99.   can cost a lot of people money,  if they are calling your system
  100.   from far away.  When we use the method that Maxine uses,  your
  101.   computer will only answer the phone if it is functioning.
  102.  
  103.   Other init string notes:
  104.  
  105.     Your modem must be configured to return "verbal" responses,  NOT
  106.     numeric responses.  You should have "V1" in your init string.
  107.  
  108.     Your "CONNECT" string should contain the baud rate.  You should
  109.     have "X1" in your init string.
  110.  
  111.     Your modem should disconnect on a high-to-low transition of DTR.
  112.     You should have "&D2" in your init string.
  113.  
  114.     Your modem's carrier detect line should reflect the actual state
  115.     of the carrier,  and not forced high.  You should have "&C1" in
  116.     your init string.
  117.  
  118.   The "standard" init string for a Hayes 2400 compatible modem is:
  119.  
  120.         Init       ATZ|~ATX1 V1 &C1 &D2 S0=0
  121.  
  122.   If you have a more full-featured modem,  such as a Hayes V-Series
  123.   or US Robotics HST,  you will only be ADDING to the above string.
  124.  
  125.   Your "BBS.CMD" file should call the OS/2 MODE.EXE program to set up
  126.   any handshaking options your modem needs.  For a Hayes 2400,  you
  127.   will probably want this:
  128.  
  129.         MODE COM1:2400,N,8,1,IDSR=ON,ODSR=OFF,OCTS=OFF,RTS=OFF
  130.  
  131.   If you have a very CHEAP 1200/2400 modem, that is not responding
  132.   at all, try:
  133.  
  134.         MODE COM1:2400,N,8,1,IDSR=OFF,ODSR=OFF,OCTS=OFF,RTS=OFF
  135.  
  136.   If you have a new full-featured modem (such as a USR HST),  you will
  137.   want to use h/w handshaking.  Your config stuff should be:
  138.  
  139.         MODE comx:<baud>,n,8,1,IDSR=ON,ODSR=OFF,OCTS=ON,RTS=HS
  140.  
  141.         Init ATZ|~ATX1 V1 &C1 &D2 S0=0 &B1 &H1 &I0 &R2
  142.  
  143.         LockBaud TRUE
  144.  
  145.  
  146.   New Features
  147.   ------------
  148.  
  149.    - The config file was self-documented a little more.  A new //
  150.      comment token was added.
  151.  
  152.    - config token "Priority" was added.  Under almost every
  153.      circumstance, this value should be left at "Normal".
  154.  
  155.      I can't imagine when "low" would be used,  since this is in a
  156.      class called "idle time",  and would cause Maxine/Maximus to
  157.      halt when anything else happened on your computer -- even
  158.      simple things like "DIR" would cause the bbs to be "starved" of
  159.      CPU cycles.
  160.  
  161.      I know many of you are going to be tempted to run at "High". If
  162.      you are only running ONE line,  go right ahead.  This will
  163.      simply make sure your users see a smooth & consistent stream of
  164.      data from your bbs.
  165.  
  166.      If you are running more than one line,  the line you run at
  167.      "high" will starve the other line (but not quite as badly as
  168.      what was described above, in the "low" discussion).
  169.      Furthermore, there's no point in running ALL of your lines at
  170.      high,  since this brings them all up to the same level but
  171.      removes OS/2's ability to dynamically adjust the priority of
  172.      each line based on what it is doing (this feature is only
  173.      active at "Normal" priority).  It is conceivable that running
  174.      all lines at "high" priority would end up in POORER performance
  175.      because of this!
  176.  
  177.      Selecting "Normal" causes Maxine not to set the priority at all;
  178.      it simply inherits the priority from whatever started it.
  179.      Assuming your config.sys has PRIORITY=DYNAMIC in it,  the
  180.      Normal setting will cause OS/2 to raise and lower the priority
  181.      of Maxine/Maximus based on system usage.  If it is the
  182.      foreground task,  it gets a boost.  If it is doing a lot of
  183.      disk i/o (for example,  using the Maximus L)ocate command to
  184.      search for a specific file),  it gets a boost.
  185.  
  186.      So why did I bother to add a "High" priority?  If you have a
  187.      slow computer (an 80286),  and a slow UART (ie: NOT a 16550, or
  188.      you are not using OS/2 1.20) AND you are running a very fast
  189.      modem (>=9600 bps),  you may find that you start to loose
  190.      characters whenever you touch your computer.  The High setting
  191.      will help you in this situation.
  192.  
  193.      Another possible use for "high" is if you have two lines,  and
  194.      you don't care too much about one of them.  For example, one
  195.      line may be used for receiving (fidonet) mail locked at 19200
  196.      bps, and the other line a 2400 bps line used only for human
  197.      callers.  In this case you may want to have the 2400 line at
  198.      "Normal",  and the 19200 line at "High".  (Maxine does not
  199.      receive fidonet mail,  so you it would be some other<tm> s/w
  200.      that you set to "high").
  201.  
  202.      In previous (Maximus) documentation,  I suggested that putting
  203.      "PRIORITY=ABSOLUTE" in your CONFIG.SYS may help slow 80286's
  204.      running at 9600.  I have changed my position on this.  Put it
  205.      back to "PRIORITY=DYNAMIC" (the default).  The new COMM.DLL
  206.      routines used in both Maxine and Maximus achieve much greater
  207.      throughput -- when I stated that "PRIORITY=ABSOLUTE" may help,
  208.      I was using some very inefficient routines.
  209.  
  210.   A little technical info on Priority:
  211.   -----------------------------------
  212.  
  213.     Low    == DosSetPrty(PRTYS_PROCESSTREE, PRTYC_IDLETIME, PRTYD_MAXIMUM, 0);
  214.     Normal == NOP
  215.     High   == DosSetPrty(PRTYS_PROCESSTREE, PRTYC_FOREGROUNDSERVER, 0, 0);
  216.  
  217.   (That's right -- "High" is NOT time critical.  You'll have to break
  218.    my arms first!.  If you REALLY think you need Maxine/Maximus in a
  219.    TC class, choose "Normal" priority in maxine.cfg and write a
  220.    program that sets the priority to TC before spawning Maxine).
  221.  
  222.  
  223.  Other notes
  224.  -----------
  225.  
  226.  A few people have asked me about source code for Maxine.  There
  227.  won't be any;  at least not in the form it is in now.  Large
  228.  portions of the code (the high-level modem logic,  and all of the
  229.  screen routines) have been used in another project that I sold the
  230.  source code rights to.  However, Maxine.exe will be the standard
  231.  "free for non-profit use" idea.
  232.  
  233.                              - o -
  234.  
  235. Maxine V0.00 release notes
  236. --------------------------
  237. Maxine:  A mate for Maximus.  (Guess who wears the pants?).
  238.  
  239. Maxine will answer the phone and spawn Maximus,  removing the need
  240. for BinkleyTerm for non-nodelist bbs's.
  241.  
  242. To start everything up,  use (& modify) the sample BBS.CMD.
  243.  
  244. Maxine.Cfg is a sample configuration file.  It's very simple.
  245.  
  246. I wrote this using my Hayes 2400,  so I never tested
  247. 'LockBaud TRUE', but it's a no-brainer,  so I think it will work fine.
  248.  
  249. You'll need the same stuff on your LIBPATH as Maximus does
  250. (comm.dll, snserver.dll).
  251.  
  252. Planned enhancements (comments welcome):
  253.  
  254.   - Implement "BigBro" (Carrier Watchdog) inside of Maxine.
  255.   - Automatically start/kill PmSnoop
  256.   - Automatically assign pipe name, task number, and log name for
  257.     Maximus;  thus making adding another phone line as easy as
  258.     starting up a new session and running "bbs.cmd".
  259.  
  260.  
  261. Bug reports to: Peter Fitzsimmons @ 1:250/628
  262.  
  263. Thanks for testing this!.
  264.  
  265.  
  266.