home *** CD-ROM | disk | FTP | other *** search
/ SysOp's Arsenal / SysOp's Arsenal 1 (Arsenal Computer).ISO / netmail / n_find10.exe / NODEFIND.DOC < prev    next >
Encoding:
Text File  |  1993-03-31  |  8.9 KB  |  207 lines
  1.                                   * NODEFIND *
  2.  
  3.                         Fidonet Nodelist Search Utility
  4.                               Copyright(c) 1993
  5.  
  6.                                   Jon Albright
  7.                               DataComm Enterprises
  8.                                   920 W. 58th.
  9.                              Anchorage, AK  99518
  10.                               FIDONET (1:355/507)
  11.  
  12.                              All rights reserved.
  13.  
  14.  
  15.         FrontDoor is Copyright 1989-1991 Advanced Engineering sarl
  16.                           All rights reserved.
  17.  
  18.                           *******************
  19.  
  20.  
  21.  
  22. Files included in this archive:
  23.  
  24.      INSTALL.EXE         Install Executable
  25.      NODEFIND.EXE        Program Executable
  26.      NODEFIND.CTL        Created & Maintained By INSTALL.EXE
  27.      PROGRAM.DAT         Nodefind Data File
  28.      PROGRAM.HLP         Nodefind Help File
  29.      REGISTER.DOC        Registration Form
  30.      LICENSE.DOC         Software Licensing Information
  31.      NODEFIND.DOC        This File
  32.  
  33.  
  34.  
  35.                                   DESCRIPTION
  36.  
  37. Nodefind is a utility written to allow anyone with a St. Louis style node-
  38. list to peform searches based upon user selected search criteria.  Nodefind
  39. has been tested with Frontdoor and Binkleyterm.  It has also been tested
  40. with MDA, CGA, EGA and VGA graphics adapters.  Nodefind is also DOS SHARE
  41. compatible so those of you using DESQview and multi-node software can still
  42. access the nodelist without DOS reporting a sharing violation.  Nodefind
  43. uses direct screen writes for speedier screen updates and requires 256k
  44. free memory to operate properly.
  45.  
  46. Ever find yourself wanting to enter a netmail message to someone who is
  47. part of a LARGE Net within Fido?  Ever get tired of trying to use a text
  48. editor or other utility which will only search on a given string or string
  49. pattern and then display each and every word that matches what you entered
  50. even though what you entered was a sysops name and it keeps finding the
  51. string pattern in the city or state?  How about trying to load the nodelist
  52. into EDIT only to find that after 2 minutes of loading you run out of
  53. memory?  These are some of the reasons Nodefind was created.  Nodefind will
  54. only load 16k of the nodelist at any given moment thereby allowing you to
  55. traverse the entire nodelist without running out of memory AND what it
  56. displays is completely formatted for easy viewing.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                   INSTALLATION
  64.  
  65.  
  66. Installing Nodefind is easy.  Simply execute the self-extracting archive
  67. into any directory on your disk and run INSTALL.EXE, if you forget to run
  68. INSTALL.EXE Nodefind will prompt you for the location of your nodelist
  69. file.  What you enter for your path to the nodelist will determine how
  70. Nodefind will operate. If you enter an invalid path, Nodefind will simply
  71. abort and tell you that where you specified the location of your nodelist
  72. file was invalid.  The proper usage for entering the path to the nodelist
  73. file is <drive>:\<directory>\<directory>  i.e. I keep my nodelist in the
  74. D:FD\NODELIST directory so the answer to the install prompt is
  75. D:\FD\NODELIST.  Do not enter the file name or place a trailing backslash,
  76. if you do Nodefind will abort because it appends the path you specify with
  77. its own backslash.  So if you enter D:\FD\NODELIST\, Nodefind will try to
  78. find the nodelist in D:\FD\NODELIST\\ which obviously will not work. 
  79. Should you change the location of your nodelist file, simply run
  80. INSTALL.EXE to create a new NODEFIND.CTL file.
  81.  
  82.  
  83.  
  84.                                  USING NODEFIND
  85.  
  86.  
  87.  
  88. Using Nodefind is straightforward although it is necessary to lay out the
  89. operation of the search routines.  The main menu presents you with these
  90. selections:
  91.  
  92.  
  93.                       [1] Search Specific Nodelist Fields
  94.  
  95.                     [2] Display The Nodelist
  96.  
  97.                     [Q] Quit          
  98.  
  99.  
  100.                     Enter Selection ->
  101.  
  102. Search Specific Nodelist Fields    This will present you with the second
  103.                                    menu selection allowing you to perform
  104.                                    specific types of searches.
  105.  
  106. Display The Nodelist               Will display the entire nodelist one
  107.                                    screen at a time beginning with 1/0
  108.  
  109. Quit                               Need I explain?
  110.  
  111.  
  112.  
  113. The seach criteria menu presents you with these selections:
  114.  
  115.  
  116.        [A] Search By Node Address         [D] Search By System Operator
  117.  
  118.        [B] Search By System Name          [E] Display By Specific Net
  119.  
  120.        [C] Search By City Or State        [Q] Return To Main Menu
  121.  
  122.  
  123. Search By Node Address   This will perform a search on the net/node address
  124.                          you provide.
  125.  
  126. This function will do as it sounds.  It will search for and display the
  127. specific net/node address you provide.  The format for entering this is the
  128. standard FIDO format net/node.  Be advised that you do not enter the
  129. leading zone identifier i.e. 1:355/507, you only provide 355/507 as the
  130. node address to search for.
  131.  
  132. Search By System Name    This will perform a case-insensitive search for
  133. the name of a specific system you wish to display.  Be advised that if you
  134. do not know the entire name of the system, Nodefind will use the string
  135. pattern of your entry.  Example: If you wish to locate and display
  136. Fidonews, you can enter Fidonews and it will locate and display this
  137. system.  You can also enter news, or Fido and Nodefind will display all the
  138. systems which contain these string patterns.  You can narrow down the
  139. possibilities of what is displayed by using the spacebar.  For example, if
  140. you wish to search for systems named north, if you were to type in North
  141. then Nodefind would display any and all systems which contain the string
  142. pattern North such as Northern, Northway etc.  But if you want to display
  143. systems whose name really is North, such as North Land then enter the word
  144. North and press the spacebar to end the input.
  145.  
  146. Search By City Or State  This will perform a case-insensitive search based
  147. upon the name of a city and or state.  As in the above, it is not necessary
  148. to enter the complete name of the city as a partial string pattern will
  149. suffice.  There is one idiosyncracy about using a city and state together. 
  150. Where normally the city and state are separated by the ","comma character,
  151. the nodelist separates them with the "_"underscore character, the states
  152. are also abbreviated instead of spelled out.  To perform a search for
  153. systems located in Anchorage, Alaska you would enter Anchorage AK  Nodefind
  154. will parse out the underscore character separating all the fields in the
  155. nodelist, therefore if you were to enter Anchorage, AK Nodefind couldn't
  156. help you with this.  Always remember to use the spacebar when using this
  157. selection.  Also, if you wish to only display those systems located in
  158. California for example, you would press the spacebar then type CA.
  159.  
  160. Search By System Operator     Use this to display the information about the
  161. system which belongs to the system operator you are searching for.  As in
  162. the above examples, the search is case-insensitive and how you enter the
  163. name along with the spacebar will dictate how Nodefind performs its search.
  164.  
  165. Display By Specific Net  Use this to display a listing of systems in a
  166. user-defined Net within Fido.  This is a numeric only field and only
  167. requires the net id you wish to display.  For example if you wish to
  168. display the systems in Net 355, then you simply enter 355.  No need to
  169. worry about using the spacebar in this one.  However, like using the
  170. install program, if you enter 355/ then Nodefind will interpret this as you
  171. entering 355// and will choke.
  172.  
  173.  
  174.  
  175.                                   SPECIAL KEYS
  176.  
  177.  
  178. There are a couple of keys that can be used while using the program which
  179. do not deal with menu selections.  
  180.  
  181. F1   The F1 key used anywhere in the program with the exception of doing
  182. the actual search will display a help screen similiar to all this I have
  183. finished typing into this thing.
  184.  
  185. ESC  The only practical use for the ESC key is to abort a search in
  186. progress.  All search selections will search through the ENTIRE nodelist
  187. with the exception of choice A.  You can abort a search at any time. 
  188. Pressing the ESC key while in an entry field will abort the current
  189. selection and return you to the menu's prompt.
  190.  
  191. RETURN    Not only does this finalize your imput, but if you press RETURN
  192. on a blank field, like the ESC key it will abort the current selection and
  193. return you to the menu's prompt - Hence the term RETURN...
  194.  
  195. Nodefind is FREQ'able via 1:355/507 using the magic name NODEFIND.
  196.  
  197. Now that I have rambled on for what seems like an eternity, I'll get off
  198. the air and let you get onto bigger and better things, I'm sure there are
  199. plenty you can think of.
  200.  
  201.  
  202.  
  203.                                   Jon Albright
  204.                           Sysop Of Alaska Smart Homes
  205.                                 FIDO (1:355/507)
  206.  
  207.