home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / OCDFAM1.ZIP / OCDFAM.DOC next >
Encoding:
Text File  |  1993-08-01  |  13.8 KB  |  355 lines
  1.  
  2.  
  3.                                  OCDFAM V1.01
  4.         
  5.                                 Copyright 1993
  6.         
  7.                                     = By =
  8.         
  9.                               Trevor B Roydhouse
  10.         
  11.                               All Rights Reserved 
  12.  
  13.  
  14.  
  15.         OVERVIEW
  16.  
  17.         Usage:
  18.  
  19.         OCDFAM -s nn -e nn -an name -at "title" -dp path -cf filename 
  20.  
  21.         -s nn        Start areas at number nn
  22.         -e nn        Last area number to create
  23.         -an name     Area name for area change command
  24.         -at "title"  Area title eg "SIMTEL-20 CD ROM"
  25.         -dp <path>   Download path for files.bbs directories
  26.         -cf filename Filearea.ctl filename 
  27.         -nodir       Do not create the directories (see below) 
  28.         
  29.         Note:
  30.         
  31.         OCDFAM needs a file called DIRS.CD which contains the result 
  32.         of a "dir z:\cdrom > dirs.cd" after removing all non-directory 
  33.         lines. The directory names in this file are used to create 
  34.         similarly named directories on your hard disk in the specified 
  35.         download path for the relevant files.bbs files. This version 
  36.         for Opus 1.73a. 
  37.  
  38.         Safety feature:
  39.  
  40.         OCDFAM will display its settings and ask you to press C to 
  41.         Continue or any other key to exit BEFORE it does anything.
  42.  
  43.         
  44.         CREATING THE FILES.BBS DIRECTORIES ON YOUR HARD DISK
  45.         
  46.         OCDFAM can be used to create the directories on your hard disk 
  47.         to contain the FILES.BBS files which OFARE will use to add the 
  48.         CD-ROM files to your Opus files database. To do this, OCDFAM 
  49.         needs a directory listing which looks like this: 
  50.  
  51.         BBS          <DIR>     05-20-92   6:35a
  52.         GAMES        <DIR>     05-20-92   6:35a
  53.         MSDOS        <DIR>     05-20-92   9:34a
  54.         
  55.         Such a listing is easily created by using the DOS "dir" 
  56.         command and DOS redirection. For example: 
  57.  
  58.         dir z:\ > dirs.cd
  59.  
  60.         might yield:
  61.  
  62.          Volume in drive Z is SIMTEL_0692
  63.          Directory of Z:\
  64.  
  65.         BBS          <DIR>     05-20-92   6:35a
  66.         DIRS     TXT      8107 05-20-92   9:36a
  67.         GAMES        <DIR>     05-20-92   6:35a
  68.         INDEX    TXT    572669 05-20-92   6:08a
  69.         INDEX    Z      253141 05-20-92   5:15a
  70.         INDEX    ZIP    235893 05-20-92   5:15a
  71.         MSDOS        <DIR>     05-20-92   9:34a
  72.         PKUNPAK  EXE     15112 05-04-92   1:58p
  73.         PKUNZIP  EXE     23528 05-04-92   1:58p
  74.         PKZIPFIX EXE      9224 05-04-92   1:58p
  75.         README   TXT      3532 05-20-92   9:58a
  76.                11 file(s)    1121206 bytes
  77.                                    0 bytes free
  78.  
  79.         You need to remove all non-directory and blank lines so that 
  80.         the above would look like: 
  81.  
  82.         BBS          <DIR>     05-20-92   6:35a
  83.         GAMES        <DIR>     05-20-92   6:35a
  84.         MSDOS        <DIR>     05-20-92   9:34a
  85.  
  86.         The filename used for the file containing the above should be 
  87.         DIRS.CD.
  88.  
  89.         OCDFAM will create the directories from this file by default. 
  90.         If you do not want the directories created, then use the 
  91.         -nodir command line argument. Note: the DIRS.CD file must 
  92.         exist because it is also used to create the file area 
  93.         definitions (see below).
  94.  
  95.  
  96.         CREATING THE FILE AREA DEFINITIONS FOR BBS.CTL
  97.  
  98.         OCDFAM uses the information supplied on the command line to 
  99.         create area definitions for the CD-ROM directories contained 
  100.         in the DIRS.CD file (see above for how to create this file).
  101.  
  102.         -s nn         Start areas at number nn
  103.  
  104.         This specifies the first area number to be used for the new 
  105.         file area definitions. It should not conflict with your 
  106.         existing file area numbers. 
  107.         
  108.         Note: if the control filename you are using is that of your 
  109.         existing file area control file, this number must be greater 
  110.         than your current highest file area number. So, if you have 
  111.         areas 1-100 and you send newly uploaded files to area 999 and 
  112.         you are adding areas 200-294, you should consider using a 
  113.         different control file name and then merging the control file 
  114.         containing the new file area definitions with your old one in 
  115.         the appropriate place. 
  116.  
  117.         -e nn         Last area number to create
  118.  
  119.         This specifies the last area number to be used for the new 
  120.         file area definitions. It should not conflict with your 
  121.         existing file area numbers. 
  122.         
  123.         -an name      Area name for area change command
  124.  
  125.         This specifies the name to be given to the file area for use 
  126.         at the A)rea change command on the F)ile menu. Note: the name 
  127.         is treated as a "stem" to which is added the file area number. 
  128.         For example, if you specify -an SIM with -s 100 and -e 120, 
  129.         the area names generated will be SIM100, SIM101, SIM102 etc on 
  130.         up to SIM120. 
  131.  
  132.         -at "title"   Area title eg "SIMTEL-20 CD ROM"
  133.         
  134.         This specifies the title to be given to all the file areas. I 
  135.         find it useful to use the name of the CD-ROM for this. You 
  136.         could of course go through and replace each of these with 
  137.         something more descriptive ... if you have the time :-)
  138.         
  139.         -dp <path>    Download path for files.bbs directories
  140.         
  141.         This specifies the directory off which you wish to have OCDFAM 
  142.         create the new file area directories matching the CD-ROM 
  143.         directories. For example, if you specify c:\cdfiles, then 
  144.         OCDFAM would create directories named:
  145.  
  146.         c:\cdfiles\bbs
  147.         c:\cdfiles\games
  148.         c:\cdfiles\msdos
  149.  
  150.         These directories are used to store the FILES.BBS for each CD-
  151.         ROM directory on your hard disk. Note: the FILES.BBS should 
  152.         contain the filenames preceded by the CD-ROM path to each 
  153.         file. For example,
  154.  
  155.         z:\bbs\file.1 This is file 1
  156.         z:\bbs\file.2 This is file 2
  157.         etc.
  158.  
  159.         -cf filename  Filearea.ctl filename
  160.  
  161.         This specifies the control file name to which to add the new 
  162.         file area definitions. 
  163.         
  164.         Note: do not use BBS.CTL as the filename or everything after 
  165.         the END FILE AREAS line will be overwritten with the new file 
  166.         area definitions!
  167.  
  168.         If you use a separate file area control filename like 
  169.         fileareas.ctl, make sure you do not specify a starting area 
  170.         number with the -s option that is lower than your highest 
  171.         existing file area number. Otherwise NACL will laugh at you 
  172.         later :-) 
  173.  
  174.         See the "Opus 1.70 Sysop Operations Manual" for details on 
  175.         splitting your BBS.CTL file up into separate files for message 
  176.         areas, file areas etc. 
  177.  
  178.  
  179.         THE FILE AREA DEFINITIONS
  180.  
  181.         Unfortunately, the new file area definitions created will not 
  182.         be exactly what you want as they use a default template which 
  183.         is customised for my system. All is not lost! I suggest you 
  184.         use your trusty wordprocessor to do a find/replace on the 
  185.         items which you wish to change. Here's a sample of the area 
  186.         definition produced by OCDFAM (the items you will not want to 
  187.         change because you control them with OCDFAM are asterisked): 
  188.         
  189.              %
  190.         *    AREA    1    SIM1
  191.              %
  192.              %    MENU    <Number>
  193.                   SECTION    I
  194.         *         TITLE    SIMTEL-20 CD-ROM
  195.              %    PREFILES
  196.                  %
  197.                   ACCESS PRIV    Disgrace
  198.              %    ACCESS LOCK
  199.                  %
  200.                   DOWNLOAD PRIV  Worthy
  201.              %    DOWNLOAD LOCK
  202.         *         DOWNLOAD PATH  d:\opus\BBS\
  203.                  %
  204.              %    BARRICADE
  205.              %    RULES
  206.              %    PICTURE
  207.              %    HELP
  208.                   RATIO PRIV     Twit
  209.                  %
  210.              %    Default Upload Area
  211.                   UPLOAD PRIV    Disgrace
  212.              %    UPLOAD LOCK
  213.                   UPLOAD PATH    N:\NEWFILES\
  214.                   UPLOAD AREA    9999
  215.                   NEW PRIV       Disgrace
  216.              %    DUPES
  217.              %    FREE
  218.                  %
  219.                  %
  220.              %    PRIVATE Upload area by Privilege
  221.                   PUPLOAD PRIV    Twit
  222.              %    PUPLOAD PATH
  223.                   PUPLOAD AREA    9999
  224.                  %
  225.                  %
  226.              %    PRIVATE Upload area by Keys
  227.              %    KUPLOAD LOCK
  228.              %    KUPLOAD PATH
  229.                   KUPLOAD AREA    9999
  230.                  %
  231.                  %
  232.              %    APPLICATION
  233.                  %
  234.              %
  235.              END AREA
  236.              %
  237.              %
  238.              END FILE SECTION
  239.              %
  240.  
  241.  
  242.  
  243.         STEPS FOR UPDATING THE FILES DATABASE
  244.  
  245.         1. Run OCDFAM and merge/add the new file area definitions to 
  246.            your BBS.CTL or FILEAREAS.CTL file. Find/replace items in 
  247.            the new file area definitions which you need to change to 
  248.            suit your system.
  249.         
  250.         2. Create the appropriate FILES.BBS in each of the new file 
  251.            area directories OCDFAM created on your hard disk.
  252.  
  253.            If you have the good luck to have a CD-ROM which has 
  254.            existing FILES.BBS type files in a separate CD-ROM 
  255.            directory, then you can quickly copy them to your hard disk 
  256.            directories with a command like the following (this works 
  257.            for Night Owl disks: run it from the \text CD-ROM 
  258.            directory):
  259.            
  260.            for %1 in (dir*) do copy %1 c:\cdfiles\%1\files
  261.  
  262.            This relies on the fact that the dir001a files are in the 
  263.            same order as the directories on the CD-ROM and on your 
  264.            hard disk. You still need to add the full path to the files 
  265.            listed in these FILES files. The following QBASIC or 
  266.            GWBASIC program will speed this up. It reads a line from 
  267.            FILES and writes it out with the path prefixed to each 
  268.            entry to FILES.BBS: 
  269.            
  270.            10 CLS : KEY OFF : Z$ = "files"
  271.            40 LINE INPUT "Enter the PATH ONLY to the actual files (include final backslash): "; FILPAT$ 
  272.            50 INPUT"How many spaces over do the descriptions begin";SKIP:IF SKIP=0 THEN 65 
  273.            60 LINE INPUT"What character is used to begin multi-line descriptions (default is |): ";DELIM$
  274.            65 IF DELIM$ = "" THEN DELIM$ = "|"
  275.            70 INPUT "Is the above correct"; AN$: IF LEFT$(AN$, 1) <> "Y" AND LEFT$(AN$, 1) <> "y" THEN RUN
  276.            100 OPEN "i", 1, Z$: OPEN "a", 2, "FILES.BBS": Y$ = FILPAT$
  277.            110 IF NOT EOF(1) THEN LINE INPUT #1, A$ ELSE CLOSE : SYSTEM
  278.            120 Z = INSTR(A$, DELIM$): IF Z <> 0 THEN 200
  279.            130 IF FLAG = 1 THEN FLAG = 0
  280.            140 PRINT #2, "": IF SKIP = 0 THEN 142
  281.            141 Z = INSTR(A$, " "): A$ = LEFT$(A$, Z - 1) + "    " + RIGHT$(A$, (LEN(A$) - SKIP))
  282.            142 PRINT #2, Y$ + A$ + ""; : GOTO 110
  283.            200 Z = INSTR(A$, DELIM$): A$ = RIGHT$(A$, LEN(A$) - Z): PRINT #2, A$; : FLAG = 1: GOTO 110
  284.  
  285.            NOTE: It must be run from the relevant directory on your 
  286.            hard disk which contains the FILES file to be modified. I 
  287.            use the following batch file (FIX.BAT) to speed up the 
  288.            process: 
  289.  
  290.            @ECHO OFF
  291.            REM I guess gwbasic c:\opus\utils\stripper.bas would also work
  292.            qbasic /run c:\opus\utils\stripper.bas
  293.            REM ncd is Norton's Change Directory program
  294.            ncd
  295.            REM Chance to Control-C here and get out of the loop :-)
  296.            pause
  297.            REM loop forever
  298.            fix
  299.            
  300.            For the Walnut Creek CD-ROMs, I have modified the 2OPUS.EXE 
  301.            program and batch files to add the filepath automatically 
  302.            when creating the FILES.BBS files. Look for the archive 
  303.            OWALNUT.ZIP. 
  304.  
  305.  
  306.         3. Run NACL.
  307.  
  308.         4. Run OFARE.
  309.         
  310.  
  311.         BUGS/MITES/SUGGESTIONS
  312.  
  313.         OCDFAM has been extensively tested on the Sentry BBS with no 
  314.         apparent ill effects. Should you discover what you suspect is 
  315.         a bug, or even just a mite, or have any suggestions for the 
  316.         program feel free to: 
  317.          
  318.         a) send a netmail message to me at the Sentry BBS or Sentry's 
  319.            Shadow BBS  (FidoNet Addresses: 3:711/401 and 3:711/501);
  320.  
  321.         b) call the Sentry BBS on (02) 428-4687 (PEP/V32 modem) or 
  322.            Sentry's Shadow BBS (02) 418-6682 (V32bis modem) and leave 
  323.            me a message; 
  324.  
  325.         c) write to me at P.O. Box 1605, Macquarie Centre,
  326.                           New South Wales 2113, Australia.
  327.  
  328.  
  329.         LICENSE
  330.  
  331.         All Sysops are hereby authorised to use and/or distribute 
  332.         OCDFAM.EXE provided only that (1) no money is charged for 
  333.         either its use or distribution and (2) it is distributed 
  334.         together with this document file and (3) it is used in a 
  335.         lawful and friendly manner. WOC on.
  336.  
  337.  
  338.         DISCLAIMER OF LIABILITY
  339.  
  340.         The author expressly disclaims any and all liability to any 
  341.         person in respect of anything, and of the consequences of 
  342.         anything, done or omitted to be done by OCDFAM.EXE. Be warned: 
  343.         Slippery when wet! 
  344.  
  345.  
  346.         LATEST VERSION
  347.  
  348.         The latest version of OCDFAM may always be Wazoo or Bark File 
  349.         Requested from Sentry (3:711/401 - PEP/V32 modem) or Sentry's 
  350.         Shadow (3:711/501 - V32bis modem) outside of the Zone 1 mail 
  351.         hour and the Zone 3 mail hour (plus and minus 1.5 hours). File 
  352.         requests for the magic filename OCDFAM will always result in 
  353.         your obtaining the latest version. 
  354.  
  355.