home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbsdoor / library.zip / EXITINFO.ARJ / EXITINFO.DOC next >
Text File  |  1993-03-05  |  10KB  |  216 lines
  1.  
  2.         
  3.     ****************************
  4.  
  5.  
  6.         Lee Lefler
  7.         Infinity Software
  8.         7211 E 108th Street
  9.         Kansas City, Mo  64134
  10.  
  11.                or
  12.  
  13.         Lee Lefler
  14.         Infinity BBS
  15.         (816) 761-0860
  16.         FidoNet    (1:280/5)
  17.  
  18.  
  19.     ****************************
  20.  
  21.  
  22.     Standard Disclaimer:  
  23.  
  24.             This program is  provided  AS IS and as such the only 
  25.     guarantee I will make is that it will take up space.  I fully 
  26.     intend to  support this product  and make updates when I feel 
  27.     they are necessary  but I will  make no commitments to do so.  
  28.     Please  take  any precautions that  you feel are necessary to 
  29.     protect your files.
  30.      
  31.      
  32.     Purpose of this program:
  33.      
  34.             With the  release of  Remote  Access  2.0/gamma  came           
  35.     many  changes.  The  addition of  quite  a few  new  features            
  36.     made  it  necessary  to  modify  many  of  the  support  file 
  37.     structures.  While I'm sure  many utility writers are cussing
  38.     RA's author about now,  I personally see the long overdue new
  39.     structures as a fresh  start and a step forward by doing away
  40.     with all the update  kludges.  But of course this  means that
  41.     virtually  all of the  Remote Access  specific  utilities are
  42.     currently broken.  Well that's what this program is here for.
  43.     MKQwk (by Mark May) is one of my main utilities and my system     
  44.     just felt crippled without it's QWK mail door.  With a little
  45.     help from  Mark  I was  able to  work around  almost  all the 
  46.     incompatabilities  with a  couple minor DOS fixes.  The  main
  47.     problem was  that ExitInfo.BBS was one of the files  that had
  48.     changed.  So this program was born.  This program will create
  49.     a  RA 1.11  ExitInfo.BBS  file  so  that  many  of  the older 
  50.     utilities will run again.  Then, since RA re-reads  this file
  51.     when  it reloads, you can use this  program again to recreate    
  52.     the original 2.0/g version of ExitInfo.BBS.  One problem that
  53.     I ran  into is that there is information  in the new ExitInfo
  54.     that didn't exist in the old one.  So before I create the old
  55.     format I copy  the new  one to  Exit.BBS.  This  file will be
  56.     deleted as soon  as I'm through  with it and it  allows me to
  57.     re-read the  original  information  and  put  things  back to 
  58.     normal for RA.  Well, now that my  speech  is out of the way,
  59.     on to how you can use it.
  60.  
  61.     Warning ***** Well, just one more thing before we go on.  The
  62.            purpose of this program is to give utility programmers
  63.            a little breathing room to get their programs updated.
  64.            Most are programming for us  for free, or close to it,
  65.            and have a real life besides.  But kludging the system
  66.            this  way  opens  things  up to some real hazards.  RA
  67.            expects all the data in ExitInfo.BBS to be correct and
  68.            uses it accordingly.  If you trash your exitinfo I can
  69.            almost guarantee you will trash your Users.BBS.  So at
  70.            least keep  current  backups until you get the hang of
  71.            this  program.  Better yet,  keep current  backups all 
  72.            the time.  You  are strongly  encouraged again to take
  73.            any and all  precautions you  feel  are  necessary  to 
  74.            protect your data.
  75.  
  76.  
  77.     Operation:     
  78.  
  79.             Basically this program will run 3 ways and all  three        
  80.     start  with different command line parameters.  The  first is
  81.     'Help' (or '/?').  This is  just a  simple help  screen.  The
  82.     second  is with no command line parameters at all.  This will        
  83.     create  the 1.11 format  ExitInfo.BBS.  And  finally,  '/NEW'         
  84.     will  convert the 1.11  format back  to the 2.0/g format.  To 
  85.     create a  2.0/g file you must have previously run ExitInfo in
  86.     the 'old' mode so that  there is a  1.11 format  ExitInfo.BBS 
  87.     and a Exit.BBS available for processing.
  88.  
  89.                 ExitInfo /?             { Help Screen }
  90.                 ExitInfo Help           { Help Screen }
  91.                 ExitInfo                { Create 1.11 format  }
  92.                 ExitInfo /NEW           { Create 2.0/g format }
  93.  
  94.     And here's the batch file that I use here to call MKQwk:
  95.  
  96.     Qwk.Bat         @Echo Off
  97.                     Set Hold=
  98.                     Set Ra=C:\Ra\Node1\OldCfg
  99.                     ExitInfo /Old
  100.                     MkQwk
  101.                     ExitInfo /New
  102.  
  103.  
  104.         OK, some  explanations  are probably  in order...   MkQwk
  105.     also reads Messages.Ra and Config.Ra in addition to ExitInfo.
  106.     Since both of these files have changed I needed to work out a
  107.     way to have  multiple copies (new and old) of these two files
  108.     without killing my system.  Well, being a programmer I have a
  109.     tendancy to use a sledgehammer to drive a thumb tack and went
  110.     to great means to work around this problem.  I fired off some
  111.     netmail to Mark and he offered me the above, simple solution.
  112.     Just  change RA's  environment  variable in a batch file in a 
  113.     shell.  Exit the shell and it's all back to normal. So that's
  114.     the  reason  for  Set RA=...  I put my old .RA  files  in the 
  115.     OldCfg  directory and I'm a step closer.  But when I  shell I
  116.     get an  'out of environment space' error.  So I went  in with
  117.     my BBS batch  file and defined a new variable, Hold,  and set
  118.     it to  Hold=12345678901234567890.  Just saving  space  that I
  119.     can make available with a Set Hold=.  The rest is pretty much
  120.     self  explanitary,  I convert  ExitInfo to  1.11 format, load 
  121.     MKQwk, and then convert back to 2.0/g format.
  122.     
  123.             Well, that's  it.  You  can see  how I use it.  I use 
  124.     this method daily on  my BBS so that my  users can still read
  125.     their mail.  I'm sure there are many  other uses, but it's up
  126.     to you to find them.
  127.  
  128.             The  rest  is  just  some  more  of my ramblings.  If 
  129.     you're not  interested in the  technical  issues, then you're 
  130.     probably   not  going  to  be  interested   in  my  following 
  131.     observations.  It isn't necessary for you to read them to use
  132.     this program, but they might give you a little insight on how
  133.     it works.
  134.  
  135.  
  136.     { Information that is not passed from new style ExitInfo }
  137.     { to old style ExitInfo.                                 }
  138.     {                                                        }
  139.     { ExitInfoRec.LogonPassword                              }
  140.     { ExitInfoRec.UserInfo.Password                          }
  141.     { ExitInfoRec.UserXIInfo.CombinedInfo                    }
  142.     {                                                        }
  143.     { ExitInfoRec.UserInfo.DataPhone                         }
  144.     {   and                                                  }
  145.     { ExitInfoRec.UserInfo.HomePhone                         }
  146.     {   are smaller by 3 bytes and could truncate numbers    }
  147.  
  148.             Password  information  is  no  longer available.   RA 
  149.     doesn't store passwords anywhere any more.  Instead it stores 
  150.     a 32-bit  CRC of the  password.  It's  easy to CRC  input and 
  151.     compare it to this stored number, but  considerably harder to
  152.     generate the original  password  from  only  the CRC.  It's a 
  153.     security  feature  folks.  Just  try to  figure out someone's 
  154.     password by looking at your Users.BBS.
  155.  
  156.             CombinedInfo  has gone  from an  Array of 25 bytes to 
  157.     an  Array  of  100 words.   I suspect  that  Andrew  is  just 
  158.     expanding  it to handle up to 64k message areas, but I didn't
  159.     want  to  get  into  disecting  it to find out.  I doubt that 
  160.     there are very many doors that use the information anyway.
  161.  
  162.             Home Phone and Data Phone  have both been extended to
  163.     15 characters  each  from 12.  This could cause some  trouble
  164.     with programs that use this information, like  CBVs.  I would
  165.     suggest using caution if you use these fields.
  166.  
  167.     { Information that is not passed from old style ExitInfo }
  168.     { to new style ExitInfo and must be recovered from saved }
  169.     { Exit.BBS.                                              }
  170.     {                                                        }
  171.     { ExitInfo.LogonPasswordCRC                              }
  172.     { ExitInfo.PageReason                                    }
  173.     { ExitInfo.StatusLine                                    }
  174.     { ExitInfo.UserXIInfo                                    }
  175.     { ExitInfo.UserInfo.DefaultProtocol                      }
  176.     { ExitInfo.UserInfo.FileGroup                            }
  177.     { ExitInfo.UserInfo.LastDOBCheck                         }
  178.     { ExitInfo.UserInfo.Sex                                  }
  179.     { ExitInfo.UserInfo.MsgGroup                             }
  180.     { ExitInfo.UserInfo.PasswordCRC                          }
  181.     { ExitInfo.UserInfo.Organisation                         }
  182.     { ExitInfo.UserInfo.Address1                             }
  183.     { ExitInfo.UserInfo.Address2                             }
  184.     { ExitInfo.UserInfo.Address3                             }
  185.     { ExitInfo.UserInfo.CombinedInfo                         }
  186.     
  187.             And now back the other way.  All of this  information    
  188.     is  new in RA 2.0/gamma.   This  information, as well  as the 
  189.     phone  numbers,  is what I  use the old copy of  ExitInfo.BBS
  190.     (stored in Exit.BBS) for.   This information has to be in the 
  191.     file when RA reads it back in or it will definately blank the
  192.     fields  in the  user  record.  Saving  the  information  in a 
  193.     temporary file was the easiest way to do it.
  194.  
  195.  
  196.     Registration:
  197.  
  198.            This  part is  really  simple.   I don't  require  any
  199.     registration.  The only  thing that I ask is that the program
  200.     is distributed  in the  original archive  with all  the files
  201.     intact.  Changing the archive format,  from ARJ  to  ZIP  for
  202.     instance, is permissable.  Editing or reverse engineering any
  203.     of the files  contained in  the original archive  is strictly
  204.     prohibited.   Other  than  that, you  are  free  to use  this
  205.     program in any environment  necessary, whether  commercial or
  206.     non-commercial.  But if  you get  the chance, I'd  appreciate
  207.     it if you could drop me a note, (either US Mail or at my Fido
  208.     address) and  let me know how  far this program has travelled
  209.     and what you think of it.  Lee Lefler  and  Infinity Software
  210.     retain  all rights.   This  program  absolutely is NOT Public
  211.     Domain.
  212.  
  213.  
  214.  
  215.        CopyRight 1993, Infinity Software, All Rights Reserved
  216.