home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / plst160 / parselst.doc < prev    next >
Text File  |  1993-03-12  |  34KB  |  873 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                        +---+-------------------------------
  24.                                        | o |
  25.                                        |   |  Zone,1,Intl_FidoNet_Co,Phoeni
  26.                                        | o |  ,1,FidoNews,FidoNews_Editor,D
  27.           ParseLst Version 1.52        |   |  ,2,Euro_Gate,Portland_OR,Rand
  28.                                        | o |  ,3,OZ_Gate,Portland_OR,Randy_
  29.           Original Nodelist Processing |   |  ,10,Int'l_FNet_Assn,St_Louis_
  30.           Program by Bob Hartman       | o |  ,11,IFNA_Finance,Honolulu_HI,
  31.                                        |   |  ,12,IFNA_Legal,Parsippany_NJ,
  32.           TOS/MultiTOS revision        | o |  ,16,IFNA_Mem._Data,Clevland_O
  33.           to 1.5 by Bryan Hall         |   |  ,17,IFNA_Mem._Info,Clevland_O
  34.                                        | o |  ,20,Fido_Tech_Stand,Portland_
  35.           Documentation Written        |   |  ,100,General_Help,Clifton_NJ,
  36.           by Alan Applegate            | o |  ,102,BinkleyTERM_Help,Chattan
  37.           revised by Bryan Hall        |   |  ,113,OPUS_Info,Chico_CA,Doug_
  38.                                        | o |  ,114,Quick_BBS_Help,Floral_Pa
  39.           NOTE: This documentation     |   |  ,116,Dutchie_Help,CapeGirarde
  40.                 pertains only to the   | o |  ,117,Fido_Help,San_Jose_CA,Jo
  41.                 TOS/MT usable          |   |  ,200,Nat'l_Echo_Coor,Concord_
  42.                 features.              | o |  ,201,EchoList_Coord,Toms_Rive
  43.                                        |   |
  44.                                        |  /\  /\/\/\/\/\  /\/\/\    /\  /\/
  45.                                         \/  \/          \/      \  /  \/
  46.                                                                  \/
  47.  
  48.  
  49.  
  50.  
  51.  
  52.                            ParseLst 1.52 - March 12, 1993
  53.  
  54.                                   TABLE OF CONTENTS
  55.  
  56.           INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . .    1
  57.  
  58.           NOTICE . . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  59.  
  60.           OPERATION  . . . . . . . . . . . . . . . . . . . . . . . . .    1
  61.  
  62.           CONFIGURATION FILE . . . . . . . . . . . . . . . . . . . . .    2
  63.                Node  . . . . . . . . . . . . . . . . . . . . . . . . .    2
  64.                Country . . . . . . . . . . . . . . . . . . . . . . . .    3
  65.                Complete  . . . . . . . . . . . . . . . . . . . . . . .    3
  66.                Gated . . . . . . . . . . . . . . . . . . . . . . . . .    3
  67.                UseZone . . . . . . . . . . . . . . . . . . . . . . . .    3
  68.                Version6  . . . . . . . . . . . . . . . . . . . . . . .    3
  69.                SmallIndex  . . . . . . . . . . . . . . . . . . . . . .    3
  70.                Nodelist  . . . . . . . . . . . . . . . . . . . . . . .    4
  71.                NoNodelist  . . . . . . . . . . . . . . . . . . . . . .    4
  72.                UserList  . . . . . . . . . . . . . . . . . . . . . . .    4
  73.                InterList . . . . . . . . . . . . . . . . . . . . . . .    4
  74.                NoUserList  . . . . . . . . . . . . . . . . . . . . . .    4
  75.                FidoTxt . . . . . . . . . . . . . . . . . . . . . . . .    4
  76.                FidoPrn . . . . . . . . . . . . . . . . . . . . . . . .    4
  77.                NoFidoList  . . . . . . . . . . . . . . . . . . . . . .    4
  78.                Report  . . . . . . . . . . . . . . . . . . . . . . . .    5
  79.                NoReport  . . . . . . . . . . . . . . . . . . . . . . .    5
  80.                Comments  . . . . . . . . . . . . . . . . . . . . . . .    5
  81.                NoComments  . . . . . . . . . . . . . . . . . . . . . .    5
  82.                Dash  . . . . . . . . . . . . . . . . . . . . . . . . .    5
  83.                NoDash  . . . . . . . . . . . . . . . . . . . . . . . .    5
  84.                Route . . . . . . . . . . . . . . . . . . . . . . . . .    5
  85.                NoRoute . . . . . . . . . . . . . . . . . . . . . . . .    5
  86.                MaxBaud . . . . . . . . . . . . . . . . . . . . . . . .    5
  87.                MyList  . . . . . . . . . . . . . . . . . . . . . . . .    5
  88.                PvtList . . . . . . . . . . . . . . . . . . . . . . . .    5
  89.                Password  . . . . . . . . . . . . . . . . . . . . . . .    6
  90.                Phone . . . . . . . . . . . . . . . . . . . . . . . . .    6
  91.                Baud  . . . . . . . . . . . . . . . . . . . . . . . . .    7
  92.                CM  . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  93.                Dial  . . . . . . . . . . . . . . . . . . . . . . . . .    7
  94.                Cost  . . . . . . . . . . . . . . . . . . . . . . . . .   10
  95.                Include . . . . . . . . . . . . . . . . . . . . . . . .   11
  96.  
  97.           NODELIST GENERATION FOR YOUR SYSTEM  . . . . . . . . . . . .   11
  98.  
  99.           COMMAND LINE PARAMETERS  . . . . . . . . . . . . . . . . . .   12
  100.  
  101.           PRODUCT SUPPORT  . . . . . . . . . . . . . . . . . . . . . .   13
  102.  
  103.  
  104.  
  105.                                           i
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                            ParseLst 1.52 - March 12, 1993
  112.  
  113.           INTRODUCTION
  114.                    
  115.           ParseLst is a program for processing a FidoNet, or other fidonet
  116.           compatible nodelist.  ParseLst uses a control file to process the
  117.           information contained in a raw, "St. Louis" nodelist, and turn
  118.           the information into a form usable by several FidoNet compatible
  119.           BBS and mailer packages, including BinkleyTerm, Fidodoor, and
  120.           QuickBBS/ST.
  121.  
  122.           ParseLst is capable of producing (Version 6) nodelist files for
  123.           use with BinkleyTerm 3.0 and above, and 'SmallIndex' index files
  124.           for use with Fidodoor and future BinkleyTerm versions. 
  125.  
  126.           ParseLst provides complete one-step processing of a FidoNet-type
  127.           nodelist into a form usable by a given BBS or mailer package. 
  128.           This functionality includes updating the nodelist based on
  129.           information provided by NODEDIFF update files, distributed weekly
  130.           within FidoNet.
  131.  
  132.           NOTICE
  133.                    
  134.           ParseLst is not supplied with any sort of guarantee.  You use
  135.           ParseLst at your own risk.
  136.                    
  137.           The following names are either trademarks or the work of the
  138.           individuals and/or companies shown: 
  139.                    
  140.           FidoNet - Tom Jennings and Fido Software 
  141.           Opus-CBCS - Wynn Wagner 
  142.           RouteGen, XlatList, SEAdog - Thom Henderson and System
  143.           Enhancement Associates, Inc. 
  144.           TBBS - Phil Becker, eSoft, Inc.
  145.           QuickBBS - Adam Hudson
  146.  
  147.           OPERATION
  148.  
  149.           ParseLst requires a configuration file, i.e. PARSELST.CFG, to be 
  150.           available to the program at run-time.  This file has in it the 
  151.           various control parameters required to customize the output of 
  152.           ParseLst to your specifications. 
  153.  
  154.           When invoked, ParseLst will search the current directory for
  155.           nodediff files (i.e NODEDIFF.nnn) whose julian date is one week
  156.           later than the latest numbered NODELIST.nnn file.  The "nnn" is
  157.           three digits that correspond to the julian date when the NODELIST
  158.           or NODEDIFF file was produced.  If such a NODEDIFF exists,
  159.           ParseLst will apply the changes to the NODELIST, and create a new
  160.           nodelist file (i.e. NODELIST.nnn) with the same number as the
  161.           NODEDIFF used for the update. 
  162.  
  163.  
  164.                                           1
  165.  
  166.  
  167.  
  168.  
  169.  
  170.                            ParseLst 1.52 - March 12, 1993
  171.  
  172.           ParseLst will produce various output as directed by the
  173.           configuration file. Although ParseLst can produce the familiar
  174.           NODELIST.BBS file of other nodelist processors, the user will
  175.           usually desire finished, ready-to-use nodelist files.  ParseLst
  176.           can produce these compiled nodelist files: 
  177.  
  178.                Opus Version 6      NODELIST.DAT, NODELIST.IDX
  179.                SmallIndex          NODELIST.ADR, NODELIST.NAM
  180.  
  181.           ParseLst can also produce special supplemental nodelist data
  182.           files to be used with BinkleyTerm when the master nodelist in use
  183.           does not contain complete information.
  184.  
  185.           ParseLst is different from some other nodelist processors, in
  186.           that it will NEVER output an "unpublished" node.  Instead,
  187.           ParseLst substitutes the information for the unpublished node's
  188.           host (phone number, baud rate, flags, etc.).  If the unpublished
  189.           number is for an independent, the node is omitted from the final
  190.           list - no mail can be sent to an independent node without the
  191.           proper phone number.  This way, the mail will always go out (even
  192.           crash mail on systems that support the nodelist flags) without
  193.           problems.
  194.  
  195.           CONFIGURATION FILE
  196.  
  197.           In this section, we describe the configuration file options
  198.           available for ParseLst.  
  199.  
  200.           In many local nets within FidoNet, ParseLst control files are
  201.           "shared" among Sysops.  Since the control files can be rather
  202.           complicated and lengthy, it might be wise to check with other
  203.           Sysops in your area to see if they can supply you with a working
  204.           ParseLst control file.  Then all you'll need to do is customize
  205.           the control file for your application, and run the program. 
  206.  
  207.           The options are explained here for reference.  NOTE:  ParseLst
  208.           for TOS/MultiTOS DOES NOT support the following parameters: 
  209.  
  210.                Addr, Index, Sindex, NoIndex, CleanUp, Ozone, Igate, Ogate,
  211.                Gate, Hub, PubList, Points, Version5, TBBSList, QuickBBS, or
  212.                Binkley
  213.  
  214.           Note also that the names of the various parameters are shown as
  215.           they are for visual clarity.  In practice, the configuration file
  216.           is NOT case sensitive.  Items in square brackets ([]) are
  217.           optional. 
  218.  
  219.                Node [<zone>:]<net>/<node> 
  220.  
  221.           Example:  Node 1:3000/45 
  222.  
  223.                                           2
  224.  
  225.  
  226.  
  227.  
  228.  
  229.                            ParseLst 1.52 - March 12, 1993
  230.  
  231.  
  232.           This informs ParseLst where you're located.  This is a full
  233.           network address.  In the example above, "1" is the zone, "3000"
  234.           is the net, and "45" is the node.  If the zone number is left
  235.           out, the resulting nodelist will not have zones present. 
  236.           Instead, the appearances of the ZONE keyword will be converted to
  237.           the REGION keyword. 
  238.  
  239.                Country <country> 
  240.  
  241.           Example:  Country 1 
  242.  
  243.           This tells ParseLst what country you're in.  In the various
  244.           dialing and cost tables, this entry defines what would qualify as
  245.           an "international" call.  For the United States, "1" is the
  246.           correct entry, and is the default value.
  247.  
  248.                Complete  <-- Default
  249.                Gated
  250.  
  251.           This tells ParseLst how much zone information to include in its
  252.           output files.  'Complete' will place node information from ALL
  253.           zones in the raw nodelist into any ParseLst output.  'Gated' will
  254.           place node information from YOUR ZONE ONLY in the raw nodelist
  255.           into any ParseLst output.
  256.  
  257.                UseZone
  258.  
  259.           This tells ParseLst to keep the ZONE keyword as it appears in the
  260.           raw nodelist in the proper place inside the NODELIST.BBS file, if
  261.           generated. 
  262.  
  263.           If NOT used, the ZONE keyword will be replaced with the keyword
  264.           REGION in the resulting NODELIST.BBS file.
  265.  
  266.           If the 'NoNodelist' statement is used in PARSELST.CFG, this
  267.           statement will have no effect. 
  268.  
  269.                Version6
  270.                SmallIndex
  271.  
  272.           These options tell ParseLst to directly produce compiled nodelist
  273.           output.  'Version6' will produce NODELIST.IDX and NODELIST.DAT
  274.           files.  These are compatible with BinkleyTerm 3.0 and later. 
  275.           'SmallIndex' will produce NODELIST.ADR and NODELIST.NAM files. 
  276.           These are compatible with Fidodoor 3.2.7 and later, and future
  277.           Binkleyterm versions. 
  278.                  
  279.           Note that one or more of these options can be used simultaneously
  280.           to produce output of multiple types.  The format of NODELIST.IDX
  281.  
  282.                                           3
  283.  
  284.  
  285.  
  286.  
  287.  
  288.                            ParseLst 1.52 - March 12, 1993
  289.  
  290.           is the same in all cases, and can used simultaneously.  The
  291.           default is not to generate any of these files.
  292.  
  293.                Nodelist
  294.                NoNodelist  <-- Default (Changed in ver 1.50)
  295.  
  296.           This tells ParseLst whether or not to output a NODELIST.BBS file
  297.           as the result of nodelist processing.  If you're using the
  298.           options explained above for processing to a compiled nodelist
  299.           format you probably will not need the NODELIST.BBS file at all. 
  300.  
  301.                UserList
  302.                InterList
  303.                NoUserList  <-- Default 
  304.  
  305.           These options inform ParseLst to create (or not to create)
  306.           various listings of Sysops in the raw nodelist.  
  307.  
  308.           'UserList' will generate a file called FIDOUSER.LST that contains
  309.           the names and node addresses of the Sysops in your zone. 
  310.  
  311.           'InterList' will generate a file called FIDOUSER.LST that
  312.           contains the names and node addresses of ALL the Sysops in ALL
  313.           zones. 
  314.  
  315.           'NoUserList' will generate no such listing at all. 
  316.  
  317.           The default value is 'NoUserList.'  Normally, this list will be
  318.           sorted by an internal qsort route.  However, if memory is short,
  319.           ParseLst will attempt to call QSORT in order to complete the
  320.           processing of FIDOUSER.LST if you have one of the options
  321.           enabled.  If FIDOUSER.LST is specified, then a program conforming
  322.           to the following command line must be provided:
  323.  
  324.           QSort FIDOUSER.$$1 /+1:41 /-61:5 /-41:13 /+55:6
  325.  
  326.           Where each field is defined by /osc:nc where o=+ (ascending) or -
  327.           (descending) and sc=starting col, nc=number of cols.
  328.  
  329.  
  330.                FidoTxt
  331.                FidoPrn
  332.                NoFidoList  <-- Default
  333.  
  334.           This tells ParseLst whether or not to produce a human readable
  335.           nodelist report.  'FidoTxt' produces an 80-column version of the
  336.           report, NODELIST.TXT.  'FidoPrn' produces a 132-column version of
  337.           the report NODELIST.PRN.  'NoFidoList' is the default value, and
  338.           tells ParseLst not to produce any such report. 
  339.  
  340.  
  341.                                           4
  342.  
  343.  
  344.  
  345.  
  346.  
  347.                            ParseLst 1.52 - March 12, 1993
  348.  
  349.                Report  <-- Default
  350.                NoReport
  351.  
  352.           This tells ParseLst whether or not to display a report outlining
  353.           the number of nets, nodes and other information that the program
  354.           has processed.  Output can be redirected at the ParseLst command
  355.           line to a printer or file.
  356.  
  357.                Comments
  358.                NoComments  <-- Default
  359.  
  360.           This tells ParseLst whether or not to display the comments in the
  361.           raw nodelist (comments frequently contain timely information from
  362.           the Zone Coordinator).  Output can be redirected at the ParseLst
  363.           command line to a printer or file. 
  364.  
  365.                Dash  <-- Default 
  366.                NoDash 
  367.  
  368.           This tells ParseLst whether or not to retain the hyphens found in
  369.           nodelist telephone number entries.  Leaving them out saves some
  370.           space in the output file(s) that ParseLst may produce.  Some
  371.           modems also have limitations on the length of the dial string
  372.           which may necessitate the use of the 'NoDash' option. 
  373.  
  374.                Route
  375.                NoRoute  <-- Default
  376.  
  377.           This tells ParseLst whether or not to output a data file for use
  378.           by System Enhancement Associates' RouteGen program.  The name of
  379.           the data file will be NODELIST.FON if this option is enabled. 
  380.  
  381.                MaxBaud <baud> 
  382.  
  383.           Example:  MaxBaud 2400 
  384.  
  385.           This tells ParseLst the maximum baud rate you're capable of
  386.           supporting.  Baud rates in the nodelist that are higher than this
  387.           value are changed to it in ParseLst's output. 
  388.  
  389.                MyList <filename> 
  390.                PvtList <filename> 
  391.  
  392.           Example:  PvtList mylist.lst 
  393.  
  394.           These options tell ParseLst the names of raw nodelist files that
  395.           are to be processed with the primary nodelist.  The designated
  396.           nodelists must be in the same format as the primary list
  397.           (following FidoNet specifications).  You may use multiple
  398.           'MyList' and 'PvtList' entries in the configuration file if
  399.  
  400.                                           5
  401.  
  402.  
  403.  
  404.  
  405.  
  406.                            ParseLst 1.52 - March 12, 1993
  407.  
  408.           desired.  The two options work the same way, except: 
  409.  
  410.           When 'MyList' is used, information about the list is included in
  411.           the reports generated by ParseLst. 
  412.  
  413.           When 'PvtList' is used, information about the list is NOT
  414.           included in the reports generated by ParseLst. 
  415.  
  416.           ParseLst will not search for a "latest" listing if these options
  417.           are used, therefore, include a file extension when using either
  418.           of these options.  If you are using the 'SmallIndex' file format,
  419.           make sure to call your private list nnnnPRIV.LST, where nnnn is
  420.           the network four-letter code (i.e. FIDOPRIV.LST).
  421.  
  422.                Password [<zone>:]<net>/<node> <password> 
  423.  
  424.           Example:  Password 1:3000/45 mypass 
  425.  
  426.           Used in conjunction with the 'Version6' option, this allows the
  427.           insertion of a password in the nodelist entry for a given node. 
  428.           The password is used by BinkleyTerm to password protect a network
  429.           session.  This option has no effect on the NODELIST.BBS file, if
  430.           one is being produced by ParseLst. 
  431.  
  432.           You must specify a node address and the password to be associated
  433.           with that node. 
  434.  
  435.           The remote system must also have implemented the password
  436.           feature, and the passwords must match in order for the session to
  437.           be successful.  
  438.  
  439.           Refer to the documentation for your respective mailer or BBS for
  440.           more information.  This statement only applies when the
  441.           'Version6', statement is used.
  442.  
  443.                Phone [<zone>:]<net>/<node> <number> 
  444.  
  445.           Example:  Phone 1:3000/45 1-303-555-9876 
  446.  
  447.           This tells ParseLst to substitute the phone number given in lieu
  448.           of the one in the nodelist, for the node address given. You must
  449.           give the replacement telephone number in its full form to allow
  450.           other ParseLst configuration options to work correctly.  
  451.  
  452.           In the example above, regardless of the phone number listed for
  453.           3000/45 in the nodelist, 1-303-555-9876 will be the phone number
  454.           included for this node in any ParseLst output files. 
  455.  
  456.           This is handy for use with "unlisted" private nodes (when you
  457.           know their phone number).  This statement only applies when the
  458.  
  459.                                           6
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                            ParseLst 1.52 - March 12, 1993
  466.  
  467.           'Version6', statement is used.
  468.  
  469.                Baud [<zone>:]<net>/<node> <baud_rate> 
  470.  
  471.           Example:  Baud 1:3000/45 2400
  472.  
  473.           This tell ParseLst to substitute the baud rate given in lieu of
  474.           the one in the nodelist, for the node address given. 
  475.  
  476.           In the example above, regardless of the baud rate listed for
  477.           3000/45 in the nodelist, 2400 will be the baud rate included for
  478.           this node in any ParseLst output files.  This statement only
  479.           applies when the 'Version6, statement is used.
  480.  
  481.                CM [<zone>:]<net>/<node>
  482.  
  483.           Example:  CM 2:500/1
  484.  
  485.           This tells ParseLst to mark a node as #CM (continuous-mail
  486.           capable, or "crashable"), even though it may not be listed as
  487.           such in the raw nodelist. 
  488.  
  489.           This statement only applies when the 'Version6', statement is
  490.           used.
  491.  
  492.           This option is primarily intended for temporary use where a node
  493.           may not be listed correctly in the raw nodelist.  Use it
  494.           carefully...trying to send mail during non-mail hours to systems
  495.           that may not be able to accept it is inviting trouble. 
  496.  
  497.                Dial [<domestic>][<international>]
  498.  
  499.           Example:  Dial 10777- 011-
  500.                 1-303-989-     989-      ; Local Dialing Area
  501.                 1-303-1-        ; In-State, Non-Local
  502.                 1-913-/-010     ; Special Case 
  503.            End
  504.  
  505.           The 'Dial' statement begins a dial table, which is ended by an
  506.           'End' statement.  The 'Dial' statement itself can take two
  507.           parameters, the first of which is what is to be prepended to
  508.           domestic telephone numbers, the second what is to be prepended to
  509.           international telephone numbers.   These parameters are defaults,
  510.           and are used when none of the dial table entries match a given
  511.           telephone number.  Subsequent entries after the 'Dial' statement
  512.           (but before the 'End' statement) are used to change telephone
  513.           number entries in the nodelist during processing.  The parameter
  514.           on the left is the entry in the nodelist to match and replace,
  515.           the one on the right is the parameter to change the matched to.
  516.  
  517.  
  518.                                           7
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                            ParseLst 1.52 - March 12, 1993
  525.  
  526.           The table entries (as well as the 'Dial' statement parameters)
  527.           take the form: 
  528.  
  529.                <prefix>
  530.                <prefix/suffix>
  531.                /<suffix>
  532.                /
  533.  
  534.           Prefix entries deal with the beginning of the phone number,
  535.           suffix entries refer to the end of the phone number.  
  536.  
  537.           If a given phone number does not match any item in the dial
  538.           table, then the default items in the DIAL statement are applied. 
  539.           In the example above, "10777-" would be added to the beginning of
  540.           any domestic telephone number that does not match a dial table
  541.           entry; "011-" would be added to international numbers that do not
  542.           match an entry.  Note that since no forward slash was used (/),
  543.           it is assumed that the entry will be a prefix, and is added to
  544.           the beginning of the number. 
  545.  
  546.           In the dial table, the left argument is used to find a match, the
  547.           right argument REPLACES that match.  In other words, the first
  548.           argument means "match this and strip it from matching entries." 
  549.           The second argument means "add this to matching entries."  Any
  550.           combination of prefix, suffix, or both can be used. 
  551.  
  552.           Above, the first dial table entry (labeled "Local Dialing Area")
  553.           looks for any telephone numbers that begin with "1-303-989-" and
  554.           changes the entry to begin with just "989-" instead.  In the
  555.           third entry, telephone numbers that begin with "1-913-" will have
  556.           that prefix stripped, and the telephone number will have "-010"
  557.           appended to the end.  
  558.  
  559.           Some examples:
  560.  
  561.                1-213-555-1234
  562.  
  563.                This number does not match any dial table entries, and would
  564.                be changed to 10777-1-213-555-1234.  The default (on the
  565.                'Dial' line) says to add "10777-" to any domestic telephone
  566.                number that doesn't match a dial table entry. An entry like
  567.                this might be used as it is here, to add a carrier access
  568.                code to long distance numbers. 
  569.  
  570.                Had this number been international number, "011-" would have
  571.                been added to the beginning by default. 
  572.  
  573.                1-303-989-0000
  574.  
  575.                This number would be changed to 989-0000.  The first 
  576.  
  577.                                           8
  578.  
  579.  
  580.  
  581.  
  582.  
  583.                            ParseLst 1.52 - March 12, 1993
  584.  
  585.                portion of this phone number, 1-303-989-, matches a dial
  586.                table entry.  The entry says to change matching prefixes to
  587.                the second parameter, in this case, simply 989-.  An entry
  588.                like this is typically used for other local nodes, since you
  589.                don't need to dial "1" or the area code for local numbers. 
  590.                You'd need an entry like this for EACH prefix in your local
  591.                calling area. Note that the dial table entries are processed
  592.                in order.  This telephone number also matches the second
  593.                dial table entry in the example list, but since it already
  594.                matched a previous entry, subsequent matches are ignored. 
  595.  
  596.                1-303-245-0000
  597.  
  598.                This number would be changed to 1-245-0000.  The first
  599.                portion of this phone number, 1-303-, matches a dial table
  600.                entry.  The entry says to change the prefix shown to simply
  601.                1-.  Typically, an entry like this would follow the local
  602.                calling area entries described above. 
  603.  
  604.                1-913-555-9876
  605.  
  606.                This number would be changed to 555-9876-010.  The prefix of
  607.                this number matches a dial table entry.  The entry says to
  608.                replace the prefix with the given suffix (the "/" character
  609.                indicates a suffix).  This particular entry has no practical
  610.                use, but it demonstrates that the first portion of a dial
  611.                table entry means to "strip" that from matching entries, and
  612.                replace it with the information shown in the last portion of
  613.                the dial table entry.  Any combination of prefix, suffix or
  614.                both can be used. 
  615.  
  616.                This statement only applies when the 'Version6', statement
  617.                is used.
  618.  
  619.                Cost [<domestic>][<international>]
  620.  
  621.           Example:  Cost 25 325
  622.                 1-203-17   ;Connecticut
  623.                 1-204-100  ;Manitoba Canada
  624.                 1-214-17   ;Texas
  625.                 1-303-230-     0    ;Local, Lakewood
  626.                 1-303-279-     0    ;Local, Golden
  627.                 1-303-340-     0    ;Local, Aurora
  628.                 1-303-80   ;Colorado, Non-Local
  629.                 1-602-20   ;Arizona
  630.                 33-56-133  ;Bordeaux, France
  631.                 852-  238  ;Hong Kong
  632.                 354-  238  ;Iceland
  633.            End
  634.  
  635.  
  636.                                           9
  637.  
  638.  
  639.  
  640.  
  641.  
  642.                            ParseLst 1.52 - March 12, 1993
  643.  
  644.  
  645.           This statement marks the beginning of a cost table, which is
  646.           ended with the 'End' statement.  The cost table is used to set
  647.           the cost of dialing out to various areas that might be found in
  648.           the nodelist. 
  649.  
  650.           The 'Cost' statement itself can take up to two arguments, the
  651.           first being a default domestic cost, and the second being a
  652.           default international cost.  These are used if no matches are
  653.           found within the cost table for a given nodelist entry.
  654.  
  655.           The entries between the 'Cost' statement and the 'End' statement
  656.           make up the cost table, and define the amount in the lowest
  657.           denomination of money in your area (in the United States and
  658.           Canada, this would be cents, for example).  
  659.  
  660.           Like the dial table, the first entry is used to find matches in
  661.           the nodelist.  The second entry is assigned as the cost for
  662.           matching entries.  The cost table entries are used in the order
  663.           that they appear in the table.  Once a match is found, no further
  664.           matches are attempted. 
  665.  
  666.           Typically, the dial table lists domestic prefixes first,
  667.           including a section devoted to your local calling area.  The
  668.           latter portion is devoted to international prefixes, if
  669.           applicable.  The sample table above is for a node in Denver,
  670.           Colorado.  The sample, as well as your own cost table, will
  671.           probably be much, much bigger. 
  672.  
  673.           This statement only applies when the 'Version6', or 'SmallIndex'
  674.           statement is used.
  675.  
  676.           Some examples:
  677.  
  678.                1-213-555-1234
  679.  
  680.                This entry, a domestic call, does not match any of the cost
  681.                table entries.  The cost assigned to this entry is 25, the
  682.                default domestic cost. 
  683.  
  684.                33-60-122331
  685.  
  686.                This entry, an international call, does not match any of the
  687.                cost table entries.  The cost assigned to this entry is 325,
  688.                the default international cost. 
  689.  
  690.                1-303-228-1111
  691.  
  692.                This entry is in the same state as the node using the cost
  693.                table, but it is not one of the entries shown as being
  694.  
  695.                                          10
  696.  
  697.  
  698.  
  699.  
  700.  
  701.                            ParseLst 1.52 - March 12, 1993
  702.  
  703.                listed in the local calling area.  It is assigned a cost of
  704.                80.
  705.  
  706.                1-303-279-0000
  707.  
  708.                This number matches one of the entries listed as being
  709.                local, and is assigned a 0 cost.  
  710.  
  711.                Include <filename>
  712.  
  713.           Example:  Include altcmnds.txt
  714.  
  715.           This tells ParseLst to stop reading commands from the current
  716.           file, and start reading them from the beginning of the named
  717.           files.  Once the end of the file is reached, ParseLst will begin
  718.           reading commands from the initial file again, starting at the
  719.           command following the 'Include' statement that caused it to
  720.           branch. 
  721.  
  722.           NODELIST GENERATION FOR YOUR SYSTEM
  723.  
  724.           The following table illustrates the statements that should be
  725.           used to generate nodelist data files for listed systems.  Note
  726.           that in most cases, ParseLst can create nodelist data files for
  727.           more than one system simultaneously.
  728.  
  729.           System              Statements to Use
  730.           ------------------  ---------------------------------------------
  731.           BinkleyTerm 3.00+   NoNodelist Version6 Complete UseZone
  732.           BinkleyTerm ?.??+   SmallIndex Complete
  733.  
  734.           NOTE!  The 'Gated' keyword may be used by ANY system to create a
  735.           smaller finished nodelist that features only those nodes in your
  736.           zone (and some administrative nodes in other zones).
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.                                          11
  755.  
  756.  
  757.  
  758.  
  759.  
  760.                            ParseLst 1.52 - March 12, 1993
  761.  
  762.           COMMAND LINE PARAMETERS
  763.  
  764.           ParseLst offers a selection of command line options.  Note that
  765.           the items in angle brackets below, <baud> and <ATAR> excepted,
  766.           represent a complete drive, path and filename designation.
  767.  
  768.                -b<baud>
  769.  
  770.                Use <baud> in place of the rate shown with the 'Baud'
  771.                configuration file statement.
  772.  
  773.                -c<config>
  774.  
  775.                Use <config> as the ParseLst configuration file.
  776.  
  777.                -e   
  778.  
  779.                Let EditNL do the updating of the nodelist.  EditNL must be
  780.                available in the current directory.
  781.  
  782.                -n<nodelist>
  783.  
  784.                Use <nodelist> as the nodelist to be processed.  
  785.  
  786.                -m<mylist>
  787.  
  788.                Use <mylist> as an additional nodelist.  This works the 
  789.                same as the 'MyList' configuration file statement.
  790.  
  791.                -o<ATAR>
  792.  
  793.                The -o parameter tells Parselst to substitute ATAR (always
  794.                use four (4) letters after the -o option) for all filenames
  795.                such as FIDOUSER, NODELIST, etc.  This allows ParseLst to
  796.                compile other fidonet-compatible network nodelists.
  797.  
  798.                -p<pvtlist>
  799.  
  800.                Use <pvtlist> as an additional private nodelist.  This works
  801.                the same as the 'PvtList' configuration file statement.
  802.  
  803.                -w
  804.  
  805.                Use this to cause Parselst to pause when it has completed,
  806.                so that you may view the results.
  807.  
  808.                -z<1-9>
  809.  
  810.                Use a zone-specific nodelist (e.g. Z1-LIST) instead of the
  811.                normal NODELIST.  The optional parameter (a number of 1-9)
  812.  
  813.                                          12
  814.  
  815.  
  816.  
  817.  
  818.  
  819.                            ParseLst 1.52 - March 12, 1993
  820.  
  821.                allows use of this feature outside of zone 1, which is the
  822.                default.
  823.  
  824.  
  825.           PRODUCT SUPPORT
  826.  
  827.           Since ParseLst is "freely available," direct product support, per
  828.           se, is not available.  If you have problems or questions with
  829.           ParseLst, you are welcome to send an inquiry (TOS/MultiTOS
  830.           versions only) to: 
  831.  
  832.                Bryan Hall, FidoNet 1:206/2703
  833.                FIDOdoor BBS, Vandenberg AFB, California, USA
  834.                (805)-734-4742
  835.  
  836.           Inquiries will be answered on a time-available basis only. 
  837.           Flames are never dignified with a response. 
  838.  
  839.           Thanks for using ParseLst!  Enjoy!
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.                                          13
  873.