home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / ndlist04 / ndlister.doc < prev    next >
Text File  |  1993-09-26  |  5KB  |  109 lines
  1.  
  2.          NDLISTER ~ Produces Human readable BBS list Nodelists
  3.          =====================================================
  4.  
  5.      Written By Paul Baker @ The Tavern BBS 44-(0)81-445-6514
  6.  
  7. Turbonet 100:1011/0 ~ NeSt 90:102/140 ~ Fido 2:440/108 Atarinet 51:501/100
  8.  
  9.                   Usenet : mettav.royle.org
  10.  
  11.           24 hours All Speeds to 14400 MNp5 / V42 Bis
  12.  
  13. This program will read any nodelist file (uncompiled) and produce an easy
  14. to read text output showing the name , location , phone number, speed and
  15. (if avaialble) the times of operation.
  16.  
  17. If the flag CM appears then the bbs is assumed to be 24hrs , if the U flag
  18. with a valid time appears then that time is taken and used , BBS with the
  19. MO flag are marked as Mailers Only , BBS with none of the above are left
  20. with blank times.
  21.  
  22. to run you need to create a text file with the following definitions to tell
  23. NDLISTER what nodlist you wish to use , what output file you want produced
  24. wether you want to restrict which area, zone or phone numbers that should
  25. appear in the list and what alterations to the phone numbers you want to
  26. make so they make sense to you locally (e.g. 44-81 converted to 081).
  27.  
  28. You can place the definitions for more than one nodelist in the same
  29. config file and NDLIST will read and output each one as it reaches it ,
  30. the command END: marks the end of the definitions for the current  nodelist.
  31.  
  32. Lines begining with a semi-colon are regarded as comments and are ignored.
  33.  
  34. One restriction is that your MUST end the config file with three minus signs
  35.  
  36. To actually run the program you pass the FULL path and filename of the config
  37. you wish to use as a parameter to the program
  38.  
  39. Commands Used (these are repeated in the example config)
  40. -------------
  41.  
  42. CONVERT= is used to change the phone numbers so they make locally.
  43.  
  44. e.g. CONVERT=44-,0   (Note the seperating comma) converts 44-81 to 081
  45.  
  46. APPEND= is used to append text to the start of a number
  47.  
  48. e.g. APPEND=1-,010- will change 1- to 010-1-
  49.  
  50. APPEND-DEFAULT= if you define this then any node which fails to match any
  51. of the CONVERT or APPEND arguments will have this text appended to the
  52. start of the phone number, this is useful if you only need to replace one
  53. code (e.g. 44- to 0) and the rest of your international phone numbers have
  54. a standard prefix (e.g. 010-)
  55.  
  56. So UK nodes for example will only need the following in the config
  57.  
  58. CONVERT=44-,0
  59. APPEND-DEFAULT=010-
  60.  
  61. If for any reason the altered phone number does not fit into the box
  62. provided then NDLISTER will start removing the minus signs from the number
  63. until it does , if it still doesn't fit then the original number from the
  64. nodelist will be used.
  65.  
  66. REGION= tells it to only show nodes in that region.
  67.  
  68. e.g. REGION=21       will only show nodes in region 21
  69.  
  70. RESTRICTNUM= tells it only to show nodes with phone numbers that start with
  71.             that particular sequence of numbers
  72.  
  73. e.g. RESTRICTNUM=44-  will only list numbers starting 44-  (UK)
  74.  
  75. ZONE= tells it to show only those nodes in that ZONE (Turbonet is ZONE 100,
  76.       NeST Zone 90 and FIDO Zone 2 (UK)) not a very useful feature unless
  77.       you combine your nodelists from different Networks or use the full
  78.       FIDO nodelist but only want UK nodes listed,, but you never know so
  79.       I included it.
  80.  
  81. e.g. ZONE=2  (UK FIDO)
  82.  
  83. You CAN't use more than one of the above 3 methods of restricting output
  84. at the same time.
  85.  
  86. TITLE= is just that , the title you want to be placed at the top of the
  87.        output.
  88.  
  89. NODELIST= is the path and name of the  nodelist.XXX files , note you don't
  90.           need to put an extension as the program will automatically take
  91.           the highest numbered uncompiled nodelist as it's input.
  92.           If no matching nodelist is found then that entry is skipped and
  93.           the next one is read.
  94.  
  95. FILE= defines the full path and filename of the output to be produced.
  96.       if no file is defined then that nodelist is skipped and the next read.
  97.  
  98. the command END: marks the end of the current nodelist in the config ,
  99. commands used in the previous nodelist are carried over into the next one
  100. , so you may only need to redefine NODELIST ,FILE and TITLE in most
  101. instances.
  102.  
  103. The command CLEAR: will clear all the previous commands , useful if you
  104. want to cancel the previous RESTRICNUM etc , it means you will have to
  105. re-define all the convert statements , an easier way would be to put your
  106. restricted nodelist outputs at the bottom of the config.
  107.  
  108. please see the example config for more details and examples.
  109.