home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / BBS / TPB71UTL.ZIP / LISTUPDT.DOC < prev    next >
Text File  |  1992-04-01  |  6KB  |  162 lines
  1.  
  2. ListUpdt Version 1.4   
  3.  
  4. Copyright (c) 1991,92 by:
  5.  
  6.   Plain Jayne Software    Jim McDaniel-Webb      
  7.   Fidonet 1:151/112       2452 Milburnie Road
  8.   (919) 831-0674          Raleigh  NC  27610   
  9.  
  10.  
  11. Purpose
  12. =======
  13.  
  14. Originally, ListUpdt was written to make TPBoard sysops less
  15. dependent on third-party utility authors for processing weekly
  16. NodeDiff update files into a raw NodeList file.  Because 
  17. ListUpdt itself is not dependent on any TPBoard configuration 
  18. files, it is also an alternative to other existing utilities
  19. for non-TPB sysops.
  20.  
  21. Unlike comparable alternatives, ListUpdt will not
  22.  
  23.   -  require registration to run in batch mode.
  24.   -  eat up your hard disk.  ListUpdt requires less than 30k!
  25.   -  take up your afternnon.  ListUpdt runs in LESS than half 
  26.      the time of other utilities.
  27.  
  28. On the other hand, ListUpdt WILL require that your NodeDiff files 
  29. be decompressed.  Poor design (idiot-proofing) is one of the
  30. factors that most contributes to my ever-increasing lack of hard
  31. disk space.  Every bbs utility I have seems to contain some 
  32. feature duplicated in another utility.  For example, I use FrontDoor
  33. and have FDNC; why would I want another utility containing the code 
  34. to create the FD index files that FD is quite capable of producing
  35. for itself?
  36.  
  37. ListUpdt ASSUMES you are going to process your NodeList updates on 
  38. a regular basis and are capable of creating a batch file to decompress 
  39. your NodeDiff.A?? file followed by a call to ListUpdt.  ListUpdt will
  40. then delete the actual NodeDiff file following processing.
  41.  
  42. By making the basic asumption that YOU know what you are doing,
  43. ListUpdt is freed of redundant tasks and redundant code.
  44.  
  45.  
  46. Options
  47. =======
  48.  
  49. The following are options recognized by ListUpdt:
  50.  
  51.    /T   TPBoard style Nodelist.TPB and Netlist.TPB
  52.    /F   process a raw nodelist from a nodediff file
  53.    /E   process a EggNet style nodelist
  54.    /A   process an AlterNet style nodelist
  55.    /?   displays this help screen
  56.    /S   turns SAVING the old nodelist ON
  57.    /D   creates a dBase file ALONG with TPBoard files
  58.    
  59.  
  60. /F  Update the local Nodelist file from the next (numerically the
  61.     next) Nodediff file.  The original NodeList is deleted upon
  62.     completion unless you also use the /S option.
  63.  
  64. /T  The option to create the TPBoard .tpb nodelist files.
  65.     The files are created in the local directory.
  66.  
  67. /E  same as /F but uses the EggNet naming conventions
  68.  
  69. /A  same as /F but uses the AlterNet naming conventions
  70.  
  71. /S  instructs ListUpdt to SAVE the old NodeList file
  72.  
  73. /D  Create a .DBF (dbaseIII compatible file) of the nodelist
  74.     according to the listupdt.ctl file.  This .dbf has the 
  75.     structure:
  76.  
  77.       Field   Type      Name         Length
  78.       -----   ----      ----         ------
  79.         1     Char      BBS_NAME      30
  80.         2     Char      SYSOP         25
  81.         3     Char      CITY          20
  82.         4     Char      STATE          2
  83.         5     Char      PHONE         15
  84.         6     Char      SPEED          4
  85.         7     logical   CSP_Y/N
  86.         8     logical   V32_Y/N
  87.         9     logical   HST_Y/N
  88.        10     logical   UUCP_Y/N
  89.        11     logical   SDS_Y/N
  90.        12     logical   GSDS_Y/N
  91.        13     logical   UGSDS_Y/N
  92.                  
  93.     A future version will allow YOU to specify which fields
  94.     to include.
  95.  
  96.  
  97. ListUpdt.ctl
  98. ============
  99.  
  100. This file controls the creation of the TPBoard specific files
  101. as well as the .dbf file by specifying which zones are to
  102. be processed, what the costs are per local and international
  103. calls, etc.  The structure of this file is:
  104.  
  105.   LABEL <space> VALUE
  106.  
  107. The labels currently recognized are:
  108.  
  109.   COUNTRY 1
  110.   ZONE 1
  111.   REGIONS 10 11 12 13 14 15 16 17 18 19 
  112.   COST 25 200 
  113.   DBFDIR D:\NODELIST
  114.   DBFNAME NODELIST.DBF
  115.   DBFNODENAME MYNET.LST
  116.  
  117.   For more on individual labels and settings, see the sample
  118.   Listupdt.Ctl file.
  119.  
  120.  
  121. If you are using ListUpdt to generate TPB nodelist files, the first
  122. portion of the ctl file establishes the costs fields and the zone(s) 
  123. to include in the TPB files.  
  124.  
  125. All of the fields that begin with 'DBF' are used solely in the
  126. creation of a .dbf file.   If you use both the /T and the /D options
  127. at the same time, the dbfxxxx options will affect the creation of
  128. the TPB files as well.
  129.  
  130. Also, note the manner in which costs are specified by local and 
  131. international using region numbers to separate the two.  This is
  132. a far simpler method than entering every local exchange in your
  133. dialing area.
  134.  
  135.  
  136. Multiple databases/lists
  137. ========================
  138.  
  139. Some users have suggested the ability to create separate database
  140. files from different nodelist files in order to have databases
  141. per Nodelist, region, and net.  This would make searching much 
  142. faster for callers browsing through online databases.  In order
  143. to achieve this, you would either have to have separate directories
  144. for each of these NODELIST files or have the ability to tell ListUpdt
  145. to use a nodelist file of a different name.  Listupdt makes the 
  146. second option available by accepting the name of a ctl file on the
  147. command line.
  148.  
  149. You can specify the name of a ctl file anywhere on the command line
  150. providing that the extension remains .CTL.  If you use any other
  151. extension, ListUpdt will not use the file.
  152.  
  153. By specifying a different ctl file per execution, you can instruct
  154. ListUpdt to:
  155.  
  156.   - process a nodelist file named something other than nodelist.xxx
  157.   - output the dbf file to a different directory
  158.   - name the dbf something other than NODELIST.DBF
  159.  
  160.  
  161.  
  162.