home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / OPUS / OMAKE171.ZIP / CONVERT.DOC < prev    next >
Encoding:
Text File  |  1991-07-13  |  13.1 KB  |  341 lines
  1. ******************************************************************************
  2. **              Opus - Computer Based Communications System                 **
  3. **                        Conversion Manual                                 **
  4. **                                                                          **
  5. **         Copyright (C) 1986, 1989, 1990, 1991 Wynn Wagner III             **
  6. ******************************************************************************
  7.  
  8.                 A Product of the Opus Covert Action Committee
  9.                                    and
  10.                     The Not Ready for Mainframe Players
  11.                            Chico and Elsewhere
  12.  
  13.  
  14.                     Opus 1.14 to Opus 1.70 Conversion
  15.  
  16.  
  17.      The files you should have before starting:
  18.  
  19.      OTEC_170.ZIP   Contains:      OTEC_170.TXT   Technical     information
  20.                                                   about Opus 1.70. Line-by-
  21.                                                   line  explanation of  CTL
  22.                                                   file, menus and OECs.
  23.        
  24.      OEXE_170.ZIP   Contains:      OPUS.EXE       The main program.
  25.                                    ENGLISH.ZIP    Language files.
  26.                                    LASTSEC.DOC    Last second feature.
  27.  
  28.  
  29.      OMMM_170.ZIP   Contains:      OMMM.DOC       Documentation  for  oMMM,
  30.                                                   the   Opus  Matrix   Mail
  31.                                                   Masher.
  32.                                    OMMM.CFG       A   sample  configuration
  33.                                                   file for OMMM.EXE
  34.                                    OMMM.EXE       The program.
  35.                                    OMMM286.EXE    An executable for  people
  36.                                                   who  have 80286+  proces-
  37.                                                   sors.
  38.                                    ROUTE.CTL      A sample routing  control
  39.                                                   file.
  40.                                    READ.ME        Small read.me file.
  41.  
  42.      OFAM091B.ZIP   Contains:      OPUS-FAM.EXE   File  maintenance program
  43.                                                   for all versions of Opus.
  44.                                    OPUS-FAM.DOC   Documents for Opus-Fam.
  45.                                    WHATSNEW.091   Upgrade notices.
  46.                                    OPUS-FAM.CFG   Sample      configuration
  47.                                                   file.
  48.  
  49.       OMAKE170.ZIP Contains:       This file and others.
  50.  
  51.  
  52.  
  53.                           Opus 1.14 to Opus 1.70 Conversion
  54.  
  55.  
  56.  
  57.      What to do:
  58.  
  59.      1.   Read ALL of this document.
  60.  
  61.      2.   Print it out for reference as you go through the setup.
  62.  
  63.      3.   Print out the Opus 1.70 technical manual for reference.
  64.  
  65.      4.   Read ALL the documents you've printed out.
  66.  
  67.      5.   Make a temporary  directory on a drive  for you to work  in while
  68.           you're doing  the conversion  so you  don't lose  your Opus  1.14
  69.           setup.
  70.  
  71.      6.   Read the  section of this document on  FILES.BBS and take care of
  72.           any editing or changes you want to make before proceeding.
  73.  
  74.      7.   Copy your Opus 1.14 PRM file into your temporary directory.
  75.  
  76.      8.   Rename your PRM file so it won't conflict with your Opus 1.14 PRM
  77.           file.
  78.  
  79.      9.   Run the program CONVERT.EXE and follow it. Skip to step 22.
  80.  
  81.                                        OR
  82.  
  83.      9a.  Run CAYENNE.EXE against your PRM file with verbose on. (-v)
  84.  
  85.      10.  Archive your  old language directory  for your language  and menu
  86.           files.  Unzip  the  language files  in  ENGLISH.ZIP  to this  new
  87.           directory.
  88.  
  89.      11.  Edit the new CTL file. Refer to  this document and the sample the
  90.           Opus Technical Reference  for explanations about the  new options
  91.           that have been added to Opus 1.70.
  92.  
  93.      12.  Copy the new  help files to wherever  you've put them in  the CTL
  94.           file.
  95.  
  96.      13.  Start  running NACL.EXE  to  generate your  new PRM  file, System
  97.           files, Indexes and menu files.
  98.  
  99.      14.  Move the new PRM file to your Opus directory.
  100.  
  101.      15.  Type in this line at the DOS prompt:
  102.  
  103.                Set Opus=C:\Opus\BBS.PRM
  104.  
  105.           (Or whatever you call your new PRM file and wherever it is.) 
  106.  
  107.  
  108.                           Opus 1.14 to Opus 1.70 Conversion
  109.  
  110.  
  111.      16.  After re-reading  the section about  FILES.BBS and  FILESBBS.DAT,
  112.           edit your  current FILES.BBS  files if  you  want to.  Especially
  113.           notice the  use of '>' to mark where  to insert new files, alter-
  114.           native paths for files and the use of Area 0.
  115.  
  116.      17.  Run CONFILE.EXE to generate your FILESBBS.* database.
  117.  
  118.      18.  Unzip the files FILTER.EXE, USERNDX.EXE and MAKELRED.EXE from the
  119.           archive UTILS.ZIP to the directory where you keep USER.DAT.
  120.  
  121.      19.  Run  USERNDX.EXE to  generate a  USER.NDX file. Opus  will ALWAYS
  122.           want to use this file. The command line for USERNDX.EXE is: 
  123.                USERNDX Drive:\Path\USER.Dat
  124.                USERNDX C:\Opus\User.Dat
  125.  
  126.      20.  Run MAKELRED.EXE to generate the files in your message areas that
  127.           store  user Last  Message  Read counters.  The  command line  for
  128.           MAKELRED.EXE is:
  129.                MAKELRED UserFile Sysmsg.Dat
  130.                MAKELRED C:\Opus\User.Dat C:\System\Sysmsg.Dat
  131.  
  132.      21.  Run FILTER.EXE to delete  the old Last Message Read  markers from
  133.           USER.DAT.  The "virgin"  user  file will  be  saved as  USER.OLD.
  134.           Simply run it as:
  135.                FILTER USER.DAT
  136.  
  137.      22.  Copy OPUS.EXE to your Opus directory.
  138.  
  139.      23.  Copy your old NERF.BAT  to a new name and edit it  to reflect the
  140.           new name for  your PRM  file and the  new housekeeping  programs.
  141.           Especially notice the change to the  O_RENUM command line to tell
  142.           it which version  of Opus you are using, the use of PTIC.EXE, and
  143.           OFARE.EXE.
  144.  
  145.      24.  Edit your AUTOEXEC.BAT file to include:
  146.  
  147.                SET OPUS=C:\Opus\BBS.PRM << Your PRM file name here!
  148.  
  149.           This tells the maintenance  programs where to find your  PRM file
  150.           to automatically read it.
  151.  
  152.      25.  Carefully read through your new CTL file and make any changes you
  153.           feel  you'd like to try.   Especially notice the new menu options
  154.           and turn them  on when and  where appropriate. Then run  NACL.EXE
  155.           again to create an updated PRM file.
  156.  
  157.      26.  Unpack any  of the  new help  files that  you need  to add  after
  158.           editing your CTL file. They can be found in the file HELP.ZIP.
  159.  
  160.      27.  Reboot your computer and let it go.
  161.  
  162.  
  163.                           Opus 1.14 to Opus 1.70 Conversion
  164.  
  165.  
  166.      Files that are history/ignored by Opus 1.70:
  167.  
  168.      SYSTEM*.DAT
  169.      USER.IDX
  170.      MSGNAME.DAT
  171.      FILENAME.DAT
  172.      FILES.BBS
  173.      ECHO.CTL
  174.  
  175.      Files that are new:
  176.  
  177.      SYSMSG.DAT     Contains  all the  information about  all  your message
  178.                     areas, including echo information. 
  179.  
  180.      NAME.MDX       Index file for area names in message areas.
  181.  
  182.      AREA.MDX       Area number index for message areas.
  183.  
  184.      ECHO.MDX       Echo name index for message areas.
  185.  
  186.      LREAD.DAT      Stored in each message area.  Keeps track of the user's
  187.                     last message  read and  highest message  read for  that
  188.                     area.
  189.  
  190.      SYSFILE.DAT    Contains all the information about your file areas.
  191.  
  192.      NAME.FDX       Name index for file areas.
  193.  
  194.      AREA.FDX       Area number index for file areas.
  195.  
  196.      LFILE.DAT      Stored in each file area to keep track of the last time
  197.                     the user has actually been in this file area.
  198.  
  199.      FILESBBS.DAT   Contains the information about what files, descriptions
  200.                     and comments are in all your file areas.
  201.  
  202.      FILESBBS.ADX   Index of where each area starts in FILESBBS.DAT
  203.  
  204.      FILESBBS.NDX   Index of all the file names you have online.
  205.  
  206.      USER.NDX       B+tree index of your USER.DAT file.
  207.  
  208.  
  209.                           Opus 1.14 to Opus 1.70 Conversion
  210.  
  211.  
  212.  
  213.      Files that can be shared with Opus 1.14:
  214.  
  215.      USER.DAT
  216.      SCHED.DAT
  217.      NODELIST.DAT
  218.      NODELIST.IDX
  219.      *.MSG 
  220.      RULES.BBS
  221.      All your help/OEC/barricade files.
  222.  
  223.      Files that will conflict with the Opus 1.14 versions: 
  224.      (Be sure to save these!)
  225.  
  226.      BBS.PRM
  227.      ENGLISH.USL   (And ALL other language files!)
  228.      ENGLISH.SYL
  229.      ENGLISH.MNU
  230.      COMMON.DAT
  231.  
  232.  
  233.  
  234.                           Opus 1.14 to Opus 1.70 Conversion
  235.  
  236.  
  237.  
  238.      FILESBBS Database:
  239.  
  240.      The  FILESBBS database is  a single file  that includes  all the files
  241.      listings for all areas. This offers a number of advantages:
  242.  
  243.           Expanded information in the file listing.
  244.                Who uploaded the file.
  245.                How many times the file has been downloaded.
  246.                Both the file's date and the time/date it was uploaded.
  247.                Descriptions can be up to 1k long. 
  248.                Full path to files that are not in the default directory.
  249.  
  250.           Opus will "wrap" descriptions that are longer than a single line.
  251.  
  252.           Each file can have its own privilege and locks.
  253.  
  254.           If a  user is in the wrong  area trying to download  a file, Opus
  255.           will jump to the "right" area to make the download automatically.
  256.  
  257.           New files can be inserted at some arbitrary point in each area.
  258.  
  259.           Files that are  in area zero are  considered to be in  all areas.
  260.           Opus will not have to make any jumps to find them.
  261.  
  262.           A single  file  area can  be made  up from  files from  different
  263.           directories and drives. 
  264.  
  265.      Before running CONFILE.EXE edit your FILES.BBS files to take advantage
  266.      of the new capabilities.
  267.  
  268.      If you want new files as they are added to your files list to be added
  269.      on the first screen, put a ">" at the beginning of the point where you
  270.      want new files inserted.
  271.  
  272.      If  you want to have files  listed that are not  in the current direc-
  273.      tory, include the path to the file(s) you want to add. For example:
  274.  
  275.           D:\files\DOS\PKZ110.EXE  Latest version of PKZIP/PKUNZIP!
  276.  
  277.      PKZ110.EXE would be  available in this file area, and  be listed, even
  278.      though the default directory is D:\msdos\.
  279.  
  280.      For  area 0  files, just list  the full  paths and file  names. Do not
  281.      include  descriptions,  they  won't be  displayed  anywhere.  This was
  282.      worked out before putting in the ability to jump to areas was put in.
  283.  
  284.      CONFILE.EXE will create the FILESBBS.DAT, FILESBBS.NDX  and FILESBBS.-
  285.      ADX files in your SYSTEM directory.
  286.  
  287.  
  288.                           Opus 1.14 to Opus 1.70 Conversion
  289.  
  290.  
  291.  
  292.      EVENT CHANGES:
  293.  
  294.           None really. Just the addition of a NO_REQUEST  flag. This is not
  295.           the same as the  TAKE_REQ flag, it affects making  outbound calls
  296.           based on  the presence of  your requests waiting  to go out.  For
  297.           example, during your Zone Mail Hour most FidoNet systems will not
  298.           accept file requests. Now you can  tell Opus not to try to  place
  299.           calls that have requests attached  to them, instead they're  held
  300.           on until this flag is off. With OEVENT you can toggle this on and
  301.           off with the '\' or '|' keys in 'Z' events.
  302.  
  303.  
  304.      UTILITY CHANGES:
  305.  
  306.      These are the programs and versions that work with Opus 1.70:
  307.  
  308.  
  309.           OEVENT81.ZIP        Knows about NO_REQ flags
  310.           OREN120.ZIP         Include "-2" on the command line!
  311.           OMAIL_41.ZIP        Does interzone stuff. Special request flags.
  312.           OFAM85B.ZIP         Edit the FILESBBS.DAT files.
  313.           OFUTIL4B.ZIP        Automatic FILESBBS maintenance.
  314.           UNCON.ZIP           Regurgitates FILES.BBS from FILESBBS.DAT.
  315.           OUFM129.ZIP         Opus User Editor.
  316.           OPFM105.ZIP         Opus PRM Editor.
  317.           FIXTOSS1.ZIP        Removes duplicate entries in ECHOTOSS.LOG.
  318.           OPTLT_02.ZIP        OPMED Translation files.
  319.  
  320.      Many of these files will be included in your gamma kit. The others can
  321.      be requested. 1:119/5.0  will have them if  no one else, but  I expect
  322.      3:711/401, 2:20/10, 1:106/2000 will also have most of them.
  323.  
  324.  
  325.      Changes to your batch file:
  326.      ---------------------------
  327.  
  328.      For the new  renum program you  need to add the  "-2" to tell  it what
  329.      version of Opus is in use. 
  330.  
  331.      Be sure you  include the change to your AUTOEXEC.BAT file shown at the
  332.      beginning  of  this file  to  tell utilities  where your  PRM  file is
  333.      located.
  334.  
  335.      For  automatic  FILESBBS  database  maintenance  you need  to  include
  336.      PTIC.EXE BEFORE TICK.EXE in your batch file.  And at some point in the
  337.      day, run  OFARE.EXE to re-build  FILESBBS.DAT. If you've  got programs
  338.      that need FILES.BBS in each  area remember to run UNCON.EXE before  to
  339.      re-generate FILES.BBS.
  340.  
  341.