home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FLST115.ZIP / FASTLST.DOC < prev    next >
Encoding:
Text File  |  1993-08-19  |  41.9 KB  |  1,502 lines

  1. ******************************************************************************
  2. *                                                                            *
  3. *                                                                            *
  4. *           *******   **     ****   ******  ****     ****   ******           *
  5. *            **   *  ****   **  **  * ** *   **     **  **  * ** *           *
  6. *            ** *   **  **  **        **     **     **        **             *
  7. *            ****   **  **   ****     **     **      ****     **             *
  8. *            ** *   ******      **    **     **   *     **    **             *
  9. *            **     **  **  **  **    **     **  ** **  **    **             *
  10. *           ****    **  **   ****    ****   *******  ****    ****            *
  11. *                                                                            *
  12. *                                                                            *
  13. *               A new flexible and powerful nodelist compiler                *
  14. *                                                                            *
  15. *                                                                            *
  16. ******************************************************************************
  17. *                                                                            *
  18. *              (C)  Copyright 1992-1993  by  Alberto Pasquale                *
  19. *                                                                            *
  20. *                   A L L   R I G H T S   R E S E R V E D                    *
  21. *                                                                            *
  22. ******************************************************************************
  23. *                                                                            *
  24. *   FastLst required many hours of work: if you like it and would like to    *
  25. *   support me in developing this and other similar products, please         *
  26. *   register. See REGISTER.DOC for more details.                             *
  27. *                                                                            *
  28. ******************************************************************************
  29. *                                                                            *
  30. *                        How to contact the author:                          *
  31. *                                                                            *
  32. *   email:       Alberto Pasquale of 2:332/504.1@fidonet.org                 *
  33. *                When sending crash netmail, please call:                    *
  34. *                2:332/504@fidonet.org +39-59-450600 V32b                    *
  35. *                2:332/524@fidonet.org +39-59-581127 HST/V32                 *
  36. *                                                                            *
  37. *   postal mail: Alberto Pasquale                                            *
  38. *                Viale Verdi 106                                             *
  39. *                41100 Modena                                                *
  40. *                Italy                                                       *
  41. *                                                                            *
  42. ******************************************************************************
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                         FastLst ver 1.15 User Manual
  62.  
  63.  
  64.  
  65.                                  DISCLAIMER
  66.  
  67.          FastLst is provided as is and comes with no warranty of any
  68.          kind, either expressed or implied. In no event will the author
  69.          be liable for any damages resulting from the direct or indirect
  70.          use of this software.
  71.          The user of this program bears all risk as to its quality and
  72.          performance.
  73.  
  74.  
  75.                                    LICENSE
  76.  
  77.          FastLst
  78.          Copyright 1992-1993 by Alberto Pasquale, Modena, Italy
  79.          All rights reserved. Commercial distribution and/or use
  80.          prohibited without written permission of the author.
  81.  
  82.          You may copy and distribute verbatim copies of the original
  83.          distribution archive of FastLst, providing you don't charge
  84.          any fee exceeding your actual costs.
  85.  
  86.          You may enclose FastLst in CD-ROM collections of ShareWare
  87.          and Public Domain programs or keep it in BBS download areas
  88.          provided you do not charge any specific fee for the download.
  89.  
  90.          If you regularly use FastLst, you should REGISTER your copy
  91.          (See Register.FRM).
  92.  
  93.  
  94.          Files in the original archive:
  95.  
  96.          FastLst.Exe   The executable program (OS/2 or Dos version)
  97.          FastLst.Cfg   The sample configuration file
  98.          FastLst.Doc   This documentation file
  99.          Readme.1st    Important notes
  100.          Whatsnew.Txt  Fixes and additions
  101.          Register.Doc  Info on Registration
  102.          Register.Frm  The Registration Form
  103.          Register.Cum  Special offer for cumulative registrations
  104.          FlstWish.Txt  I ask for your opinion
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                      Pag.  1
  120.  
  121.          Main characteristics:
  122.  
  123.          - Compiles Version 6 and Version 7 format nodelists for use
  124.            with BinkleyTerm/Opus/Maximus.
  125.  
  126.          - Full 4D (point) support both in Version 6 and Version 7,
  127.            both via the "Point,..." and "Boss,..." keywords.
  128.  
  129.          - Integrated QuickSort (OS/2) / Merge-QuickSort (DOS) routines
  130.            to process Fidouser.Lst and Version 7 indexes.
  131.  
  132.          - In the case of SysOps of multiple nodes, keeps in the sysop
  133.            lists (fidouser.lst and sysop.ndx) all the name/address
  134.            entries. Allows to keep one address only for specified
  135.            ones.
  136.  
  137.          - With the command line switches -n and -d can be used on
  138.            nodelist/nodediff files that have different names from the
  139.            default NODELIST.nnn/NODEDIFF.nnn, thus making easy the
  140.            compilation of non-FidoNet nodelists.
  141.  
  142.          - The -o and -s command line switches allow to override the
  143.            basename of Version 7 files (NODEX.DAT, NODEX.NDX, SYSOP.NDX).
  144.  
  145.          - If more than one applicable nodediff file is present, all
  146.            of them are applied, in the correct order.
  147.  
  148.          - The -e command line switch allows to apply nodediffs without
  149.            compiling the nodelist (for those who compile a local
  150.            segment but like to keep the complete nodelist up to date).
  151.  
  152.          - Flexible MyList option to easily add pointlists or partial
  153.            nodelists even from other zones.
  154.  
  155.          - MergeList option to substitute a nodelist segment with a
  156.            local up to date one.
  157.  
  158.          - Easy addition of nodes via the "Node,<address>,..." keyword.
  159.  
  160.          - Very flexible modem type and cost setting/overriding for
  161.            use with Binkley's ModemTrans and Events.
  162.  
  163.          - User Cost (Msg Fee) can be set different from Call Cost.
  164.  
  165.          - DOS: 380KB of free memory are required, but all the available
  166.            conventional memory is used to speed-up the merge-sort process.
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.                                      Pag.  2
  180.  
  181.                                     OPERATION
  182.  
  183.  
  184.          After start-up FastLst will search for applicable NodeDiff
  185.          files, then it will process any necessary Merging of the
  186.          source nodelist (MergeList option), in the end it will compile
  187.          the main nodelist, adding any necessary segment (PvtList and
  188.          MyList options).
  189.  
  190.  
  191.  
  192.                    4D POINT SUPPORT: POINT and BOSS keywords
  193.  
  194.  
  195.          The source nodelist and nodediff must be in standard "St.
  196.          Louis" format, as described in FTS-0005. FastLst allows an
  197.          extension to the input nodelist format in order to support
  198.          true "4D" points.
  199.            Points are entered in the nodelist directly following their
  200.          bossnode.  Each one starts with the Point keyword, followed
  201.          by the point number. Example:
  202.  
  203.          ...
  204.          ...
  205.          ,504,Videl_3,Modena_I,Roberto_Zanasi,...
  206.          Point,1,Pasquale,Modena_I,Alberto_Pasquale,...
  207.          Point,2,SysOp,Modena_I,Roberto_Zanasi,...
  208.          Point,3,...
  209.          ...
  210.          ...
  211.  
  212.          An additional method is provided for Version 7 nodelist (no
  213.          output to Version 6 files): you can prefix a pointlist
  214.          segment with the keyword "Boss,<address>". Example:
  215.  
  216.          ...
  217.          ...
  218.          Boss,2:332/504
  219.          ,1,Pasquale,Modena_I,Alberto_Pasquale,...
  220.          ,2,SysOp,Modena_I,Roberto_Zanasi,...
  221.          ,3,...
  222.          ...
  223.          ...
  224.  
  225.          You can use ",0,..." to easily add the Boss entry together
  226.          with its points, when useful; e.g.:
  227.  
  228.          ...
  229.          ...
  230.          Boss,2:332/504
  231.          ,0,Videl,Modena_I,Roberto_Zanasi,...
  232.          ,1,Pasquale,Modena_I,Alberto_Pasquale,...
  233.          ,2,SysOp,Modena_I,Roberto_Zanasi,...
  234.          ,3,...
  235.          ...
  236.          ...
  237.  
  238.  
  239.                                      Pag.  3
  240.  
  241.                                 The NODE Keyword
  242.  
  243.  
  244.          Another extension over FTS-0005 is provided to allow easy
  245.          addition of nodes in small private lists (V7 only).
  246.  
  247.          When you need to add a node to your nodelist to call it or to
  248.          enforce a session password with it, you can use the
  249.          "Node,<address>,..." keyword to avoid the necessity of adding
  250.          its Zone and Host coordinators.
  251.  
  252.          You should specify a full 4D address (point optional); if you
  253.          omit zone (net/node[.point]) or zone and net (node[.point]),
  254.          yours are taken by default.
  255.  
  256.          Any subsequent entry will take the current address as a
  257.          starting point.
  258.  
  259.          E.g.: You want to add 9:8/7.3
  260.  
  261.          With "Node,...":
  262.          ...
  263.          ...
  264.          Node,9:8/7.3,Mickey,DisneyLand,Mickey_Mouse,1-800-111,9600,CM
  265.          ...
  266.          ...
  267.  
  268.          With "Boss,...":
  269.          ...
  270.          ...
  271.          Boss,9:8/7
  272.          ,3,Mickey,DisneyLand,Mickey_Mouse,1-800-111,9600,CM
  273.          ...
  274.          ...
  275.  
  276.          With the traditional method:
  277.          ...
  278.          ...
  279.          Zone,9,...
  280.          Host,8,...
  281.          ,7,...
  282.          Point,3,Mickey,DisneyLand,Mickey_Mouse,1-800-111,9600,CM
  283.          ...
  284.          ...
  285.  
  286.  
  287.          Now let's add 8:7/6 and 8:7/7:
  288.  
  289.          With "Node,...":
  290.          ...
  291.          ...
  292.          Node,8:7/6,Mickey,DisneyLand,Mickey_Mouse,1-800-111,9600,CM
  293.          ,7,Duck,DisneyLand,Donald_Duck,1-800-112,9600,CM
  294.          ...
  295.          ...
  296.  
  297.  
  298.  
  299.                                     Pag.  4
  300.  
  301.          With the traditional method:
  302.          ...
  303.          ...
  304.          Zone,8,...
  305.          Host,7,...
  306.          ,6,Mickey,DisneyLand,Mickey_Mouse,1-800-111,9600,CM
  307.          ,7,Duck,DisneyLand,Donald_Duck,1-800-112,9600,CM
  308.          ...
  309.          ...
  310.          The generated files are:
  311.  
  312.          Version6      NODELIST.DAT, NODELIST.IDX
  313.          Version7      NODEX.DAT, NODEX.NDX
  314.          FidoUserLst   FIDOUSER.LST
  315.          SysopNdx      SYSOP.NDX (with Version7 Only)
  316.          FidoTxt       NODELIST.TXT
  317.          FidoPrn       NODELIST.PRN
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.                                     Pag.  5
  360.  
  361.                              CONFIGURATION FILE
  362.  
  363.  
  364.          FastLst requires a configuration file (defaults to
  365.          FastLst.Cfg in the current directory). Before using FastLst
  366.          you should edit this file, following the comments in it.
  367.  
  368.          We will now describe some of the most complex statements.
  369.  
  370.          The names of the various parameters are NOT case sensitive.
  371.          Items in square brackets ([]) are optional.
  372.  
  373.  
  374.  
  375.          Country <country>
  376.  
  377.          Example:  Country 39-
  378.  
  379.          This is the string to be substituted with the Domestic
  380.          dialing prefix (see Dial statement): it must be your country's
  381.          international phone code. If the trailing '-' is omitted, it
  382.          will be present in the translated phone number after the
  383.          domestic prefix.
  384.          Nodes with a phone number that begins with this string
  385.          receive the default Domestic Cost (if no cost override is
  386.          present) (see Cost statement).
  387.  
  388.          
  389.  
  390.          MaxBaud <baud>
  391.  
  392.          Example:  MaxBaud 2400
  393.                   
  394.          Baud rates in the nodelist that are higher than this value
  395.          are changed to it in output Nodelist.DAT/Nodex.DAT files.
  396.  
  397.  
  398.  
  399.          MergeList <[path]filename[.ext]>
  400.  
  401.            If an extension is not present, the latest filename.nnn is
  402.          used, considering nnn as a 3 digit day of the year.
  403.            The specified nodelist segment is merged with the main one,
  404.          then the result is compiled.
  405.            This option is intended to merge YOUR zone, region, net or
  406.          hub nodelists to the world, zone or region nodelist.
  407.            This means that if you use the world nodelist and merge
  408.          your Region nodelist, the portion of world nodelist
  409.          corresponding to your region will be REPLACED by your
  410.          Region; then the resulting nodelist will be compiled.
  411.            This way you can use the world nodelist while having
  412.          your region segment always up to date.
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.                                      Pag.  6
  420.  
  421.            ATTENTION: using the MergeList option is different
  422.          from including your segment of nodelist with "mylist",
  423.          because mylist "appends" the output from the specified file
  424.          (to your zone if you use Version 6, to the end of the main
  425.          nodelist if you do not use Version 6), so that you have the
  426.          new nodes that were not present in the main nodelist, but you
  427.          DON'T have the modified entries updated in V6 (mylist does
  428.          NOT substitute or overlay the dupes, it only appends the
  429.          fragment to your zone (V6 used) or to the main nodelist
  430.          (no V6)).
  431.            Using Version 6 format, the changed entries in segments
  432.          appended by MyList will not be active.
  433.            Instead with Version 7 the appended segment entries are
  434.          put in the indexes in the place of their counterpart in
  435.          the previously compiled nodelist.
  436.  
  437.            Thus you generally should use MyList instead of MergeList
  438.          when using V7 only: you will save time and you will have the
  439.          changed entries active, even if the entries that are present
  440.          in the main nodelist and removed from the newer added segment
  441.          will still be present in the output nodelist.
  442.  
  443.            If you specify more than one MergeList files, each file
  444.          is merged with the preceding one: let's suppose you have
  445.  
  446.           MergeList Zone.002
  447.           MergeList Region.033
  448.           Mergelist Net.332
  449.           Mergelist Hub.500
  450.  
  451.          Hub.500 and Net.332 are merged into net.999, then net.999
  452.          is merged with Region.033 into region.999, then
  453.          region.999 is merged with Zone.002 into zone.999, in the
  454.          end zone.999 is merged with nodelist.ddd into
  455.          nodelist.999.
  456.           All .999 files except for the last are automatically
  457.          erased after use. The last .999 file (usually
  458.          nodelist.999) is compiled and NOT deleted.
  459.  
  460.            E.g. my HC could use:
  461.  
  462.           MergeList Region.033
  463.           MergeList Hub.500
  464.          WARNING: The MergeList option ONLY works with YOUR
  465.          segments of nodelist. If you merge a Hub segment, it
  466.          is searched for in YOUR zone and net. If you have
  467.          configured FastLst for a point system using your
  468.          fakenet in the "Address" verb, then you CANNOT merge your
  469.          hub segment, since the fakenet seems to be your net.
  470.  
  471.            However you can use your 4D address in the "Address"
  472.          verb of the configuration file, so that you have no
  473.          problems in merging your hub segment, if you wish to do
  474.          that.
  475.  
  476.  
  477.  
  478.  
  479.                                      Pag.  7
  480.  
  481.          MyList <[path]filename[.ext]> [default partial address]
  482.  
  483.          To add a local nodelist segment to the compilation.
  484.          Multiple MyList statements are allowed and the specified
  485.          segments are appended in the same order.
  486.          All the segments are included after the main nodelist (V6
  487.          not generated) or after your zone segment in the main
  488.          nodelist (V6 generated).
  489.          If an extension is not present, the latest filename.nnn is
  490.          used, considering nnn as a 3 digit day of the year.
  491.  
  492.          If you do not specify a default address, it is assumed equal
  493.          to your address.
  494.  
  495.          If you want to add a zone segment, you do not need the
  496.          optional default address.
  497.          If you want to add a region or net segment that is not in
  498.          your zone, you need to specify the zone number.
  499.          If you want to add a hub or node segment that is not in your
  500.          net, you need to specify the zone and net numbers.
  501.          if you want to add a point segment from an address different
  502.          from yours, you need to specify the zone, net and node
  503.          numbers.
  504.  
  505.          WARNING: Please note that Version 6 nodelist works correctly
  506.          only if you have a compiled coordinator line for each change
  507.          in zone or net numbers. When you add a hub segment
  508.          not prefixed with "ZONE,..." and "HOST,..." lines, the V6
  509.          nodelist can't work correctly if the previously compiled zone
  510.          and host lines do not match the zone and net numbers of the
  511.          added segment. When you add a point segment (with the
  512.          "POINT,.." method) you need to prefix "ZONE,<zone>...",
  513.          "HOST,<net>..." and ",<node>,..." lines to make it work with
  514.          V6.
  515.  
  516.          Examples:
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.                                      Pag.  8
  540.  
  541.          ==============================================================
  542.  
  543.          To add a list of your points:
  544.  
  545.           MyList mypoints.lst
  546.  
  547.          where mypoints.lst is:
  548.  
  549.          1st format:
  550.  
  551.          Point,1,Pasquale,Modena_I,Alberto_Pasquale,...
  552.          Point,2,SysOp,Modena_I,Roberto_Zanasi,...
  553.          Point,3,...
  554.          ...
  555.          ...
  556.  
  557.          If you use V6, you need to prefix valid Host and node lines:
  558.  
  559.          HOST,332,...
  560.          ,504,...
  561.          Point,1,...
  562.          ...
  563.          ...
  564.  
  565.  
  566.          2nd format (V7 only):
  567.  
  568.          Boss,2:332/504
  569.          ,1,Pasquale,Modena_I,Alberto_Pasquale,...
  570.          ,2,SysOp,Modena_I,Roberto_Zanasi,...
  571.          ,3,...
  572.          ...
  573.          ...
  574.  
  575.          ==============================================================
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.                                      Pag.  9
  600.  
  601.          ==============================================================
  602.  
  603.          To add a list of points of an address different from yours:
  604.  
  605.          1st format:
  606.  
  607.           Mylist othpnts.lst 1:120/250
  608.  
  609.          where othpnts.lst is:
  610.  
  611.          Point,1,...
  612.          Point,2,...
  613.          ...
  614.          ...
  615.  
  616.          If you use V6, you need to prefix valid Zone, Host and node
  617.          lines:
  618.  
  619.           Mylist othpnts.lst
  620.  
  621.          where othpnts.lst is:
  622.  
  623.          ZONE,1,...
  624.          HOST,120,...
  625.          ,250,...
  626.          Point,1,...
  627.          ...
  628.          ...
  629.  
  630.  
  631.          2nd format (V7 only):
  632.  
  633.           Mylist othpnts.lst
  634.  
  635.          Boss,1:120/250
  636.          ,1,Pasquale,Modena_I,Alberto_Pasquale,...
  637.          ,2,SysOp,Modena_I,Roberto_Zanasi,...
  638.          ,3,...
  639.          ...
  640.          ...
  641.  
  642.          ==============================================================
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.                                      Pag. 10
  660.  
  661.          ==============================================================
  662.  
  663.          To add a list of nodes (or hub segment) from your net:
  664.  
  665.           Mylist mynetnod.lst
  666.  
  667.          where mynetnod.lst is:
  668.  
  669.          ,598,...
  670.          ,599,...
  671.          ...
  672.          ...
  673.  
  674.  
  675.          If you use V6, you need to prefix a valid Host line:
  676.  
  677.          HOST,332,...
  678.          ,598,...
  679.          ,599,...
  680.          ...
  681.          ...
  682.  
  683.          ==============================================================
  684.  
  685.          To add a list of nodes (or hub segment) from another net:
  686.  
  687.           Mylist othnetnd.lst 1:120
  688.  
  689.          where othnetnd.lst is:
  690.  
  691.          ,598,...
  692.          ,599,...
  693.          ...
  694.          ...
  695.  
  696.  
  697.          If you use V6, you need to prefix valid Zone and Host lines:
  698.  
  699.           Mylist othnetnd.lst
  700.  
  701.          where othnetnd.lst is:
  702.  
  703.          ZONE,1,...
  704.          HOST,120,...
  705.          ,598,...
  706.          ,599,...
  707.          ...
  708.          ...
  709.  
  710.          ==============================================================
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.                                      Pag. 11
  720.  
  721.          ==============================================================
  722.  
  723.          To add a net segment from your zone:
  724.  
  725.           Mylist net336.lst
  726.  
  727.          where net336.lst is:
  728.  
  729.          HOST,336,...
  730.          ,1,...
  731.          ,2,...
  732.          ...
  733.          ...
  734.  
  735.          ==============================================================
  736.  
  737.          To add a net segment from another zone:
  738.  
  739.           Mylist net456.lst 7
  740.  
  741.          where net456.lst is:
  742.  
  743.          HOST,456,...
  744.          ,1,...
  745.          ,2,...
  746.          ...
  747.          ...
  748.  
  749.  
  750.          If you use V6, you need to prefix a valid Zone line:
  751.  
  752.           Mylist net456.lst
  753.  
  754.          where net456.lst is:
  755.  
  756.          ZONE,7,...
  757.          HOST,456,...
  758.          ,1,...
  759.          ,2,...
  760.          ...
  761.          ...
  762.  
  763.          ==============================================================
  764.  
  765.          To add a zone segment:
  766.  
  767.           Mylist zone7.lst
  768.  
  769.          where zone7.lst is:
  770.  
  771.          ZONE,7,...
  772.          ...
  773.          ...
  774.  
  775.          ==============================================================
  776.  
  777.  
  778.  
  779.                                      Pag. 12
  780.  
  781.          ==============================================================
  782.  
  783.          To add the latest region33.nnn region segment from your zone:
  784.  
  785.           Mylist region33
  786.  
  787.          where region33.nnn (nnn is the day of the year) is:
  788.  
  789.          REGION,33,...
  790.          ...
  791.          ...
  792.  
  793.          ==============================================================
  794.  
  795.          To add the latest region45.nnn region segment from another zone:
  796.  
  797.           Mylist region45 7
  798.  
  799.          where region45.nnn (nnn is the day of the year) is:
  800.  
  801.          REGION,45,...
  802.          ...
  803.          ...
  804.  
  805.  
  806.          If you use V6, you need to prefix a valid Zone line:
  807.  
  808.           Mylist region45
  809.  
  810.          where region45.nnn (nnn is the day of the year) is:
  811.  
  812.          ZONE,7,...
  813.          REGION,45,...
  814.          ...
  815.          ...
  816.  
  817.          ==============================================================
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.                                      Pag. 13
  840.  
  841.          PvtList <[path]filename[.ext]> [default partial address]
  842.  
  843.          As MyList, but there is no output to nodelist.txt/prn.
  844.          Points are never output to text files.
  845.          MyList and PvtList are equivalent for point lists.
  846.  
  847.  
  848.  
  849.          Include <[path]filename.ext>
  850.  
  851.          In your configuration file you can include other
  852.          configuration files: as an example you can put all of your
  853.          Password statements in a separate file and include it.
  854.          The inclusion process can be nested, so that you can use the
  855.          "Include" statement in included files too.
  856.  
  857.  
  858.  
  859.          TypeExact
  860.  
  861.          Binkley's "ModemTrans" has changed behaviour starting with
  862.          version 2.51. This option modifies the behaviour of "TypeDef"
  863.          to match that of new Binkley's "ModemTrans".
  864.          You could still find convenient the use of the old method
  865.          (TypeExact commented out) with the new Binkley if you want to
  866.          share the same nodelist among two or more Binkleys enabled to
  867.          call out.
  868.  
  869.  
  870.  
  871.          TypeDef <flag> <type>
  872.  
  873.          Case not significant in <flag>.
  874.          <flag> is a substring in the flag field of the nodelist.
  875.  
  876.          Defines the modem type so that you can use the "ModemTrans"
  877.          option in Binkley.cfg to select the dial string depending on
  878.          the modem type.
  879.  
  880.          Examples:
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.                                      Pag. 14
  900.  
  901.                            ------------------------
  902.                           |TypeExact commented out |
  903.                            ------------------------
  904.          ==============================================================
  905.  
  906.          With a USR H14+V32 modem you could use:
  907.  
  908.          Old Binkley:
  909.  
  910.          TypeDef HST  1  ; set bit 0 of type if HST flag present
  911.          TypeDef H14  1  ; set bit 0 of type if H14 flag present
  912.          TypeDef H16  1  ; set bit 0 of type if H16 flag present
  913.          TypeDef V32  2  ; set bit 1 of type if V32 (V32b) flag present
  914.  
  915.          Powers of 2 should be used.
  916.  
  917.          ModemTrans 1 <HSTdialstring>
  918.          ModemTrans 2 <V32dialstring>
  919.  
  920.          Since Old Binkley uses the first modemtrans that has at
  921.          least one bit in common with the modem type, it will
  922.          use ModemTrans 1 for HST and HST+V32(B) modems (types 1
  923.          and 1+2=3) and ModemTrans 2 for V32, V32B
  924.  
  925.          New Binkley:
  926.  
  927.          ModemTrans  1 <HSTdialstring>   ; for HST
  928.          ModemTrans  3 <HSTdialstring>   ; for HST+V32(b)
  929.          ModemTrans  2 <V32dialstring>   ; for V32
  930.  
  931.          ==============================================================
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.                                      Pag. 15
  960.  
  961.          ==============================================================
  962.  
  963.          With a USR H14+V32B modem you could use:
  964.  
  965.          Old Binkley:
  966.  
  967.          TypeDef HST  1  ; set bit 0 of type if HST flag present
  968.          TypeDef H14  1  ; set bit 0 of type if H14 flag present
  969.          TypeDef H16  1  ; set bit 0 of type if H16 flag present
  970.          TypeDef V32  2  ; set bit 1 of type if V32 (V32b) flag present
  971.          TypeDef V32B 4  ; set bit 2 of type if V32b flag present
  972.  
  973.          A V32B entry will have both bit 2 and 1 set since it
  974.          contains V32B as well as V32 as substrings in the FLAG
  975.          portion of the entry.
  976.  
  977.          ModemTrans 4 <V32dialstring>  ; for V32b capable nodes
  978.          ModemTrans 1 <HSTdialstring>  ; for HST without V32b
  979.          ModemTrans 2 <V32dialstring>  ; for V32 without HST
  980.  
  981.          This way you will call in V32B the entries that have
  982.          the V32B flag, in HST those ones that don't have the
  983.          V32B but have the HST, in V32 those ones that have
  984.          neither the V32B nor the HST but do have the V32.
  985.  
  986.          New Binkley:
  987.  
  988.          ModemTrans  6 <V32dialstring>  ; for V32b
  989.          ModemTrans  7 <V32dialstring>  ; for V32b+HST
  990.          ModemTrans  1 <HSTdialstring>  ; for HST
  991.          ModemTrans  3 <HSTdialstring>  ; for HST+V32
  992.          ModemTrans  2 <V32dialstring>  ; for V32
  993.  
  994.          ==============================================================
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.                                      Pag. 16
  1020.  
  1021.          ==============================================================
  1022.  
  1023.          With a USR H16+V32B modem you could use:
  1024.  
  1025.          Old Binkley:
  1026.  
  1027.          TypeDef HST  1  ; set bit 0 of type if HST flag present
  1028.          TypeDef H14  1  ; set bit 0 of type if H14 flag present
  1029.          TypeDef V32  2  ; set bit 1 of type if V32 (V32b) flag present
  1030.          TypeDef V32B 4  ; set bit 2 of type if V32b flag present
  1031.          TypeDef H16  8  ; set bit 3 of type if H16 flag present
  1032.  
  1033.          A V32B entry will have both bit 2 and 1 set since it
  1034.          contains V32B as well as V32 as substrings in the FLAG
  1035.          portion of the entry.
  1036.  
  1037.          ModemTrans 8 <HSTdialstring>  ; for H16
  1038.          ModemTrans 4 <V32dialstring>  ; for V32b without H16
  1039.          ModemTrans 1 <HSTdialstring>  ; for H14 without V32b
  1040.          ModemTrans 2 <V32dialstring>  ; for V32 without HST
  1041.  
  1042.          This way you will call in H16 the entries that have the H16
  1043.          flag, in V32b those ones that don't have H16 but have V32b,
  1044.          in H14 those ones that don't have the V32B but have the H14,
  1045.          in V32 those ones that have the V32 only.
  1046.  
  1047.          New Binkley:
  1048.  
  1049.          ModemTrans  8 <HSTdialstring>  ; for H16
  1050.          ModemTrans 14 <HSTdialstring>  ; for V32b+H16
  1051.          ModemTrans  6 <V32dialstring>  ; for V32b
  1052.          ModemTrans  7 <V32dialstring>  ; for V32b+H14
  1053.          ModemTrans  1 <HSTdialstring>  ; for H14
  1054.          ModemTrans  3 <HSTdialstring>  ; for H14+V32
  1055.          ModemTrans  2 <V32dialstring>  ; for V32
  1056.  
  1057.          ==============================================================
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.                                      Pag. 17
  1080.  
  1081.                         ----------------------------------
  1082.                        |TypeExact uncommented, New Binkley|
  1083.                         ----------------------------------
  1084.  
  1085.          With "TypeExact" active, the first match terminates the
  1086.          search.
  1087.  
  1088.          ==============================================================
  1089.  
  1090.          With a USR H14+V32 modem you could use:
  1091.  
  1092.          TypeDef HST  1  ; Type 1 if HST flag present
  1093.          TypeDef H14  1  ; Type 1 if H14 flag present
  1094.          TypeDef H16  1  ; Type 1 if H16 flag present
  1095.          TypeDef V32  2  ; Type 2 if V32 (or V32B) flag present
  1096.  
  1097.          ModemTrans 1 <HSTdialstring>    ; for HST capable nodes
  1098.          ModemTrans 2 <V32dialstring>    ; for V32/V32b without HST
  1099.  
  1100.          ==============================================================
  1101.  
  1102.          With a USR H14+V32B modem you could use:
  1103.  
  1104.          TypeDef V32B 1  ; Type 1 if V32B flag present
  1105.          TypeDef HST  2  ; Type 2 if HST flag present
  1106.          TypeDef H14  2  ; Type 2 if H14 flag present
  1107.          TypeDef H16  2  ; Type 2 if H16 flag present
  1108.          TypeDef V32  3  ; Type 3 if V32 flag present
  1109.  
  1110.          ModemTrans 1 <V32dialstring>    ; for V32b capable nodes
  1111.          ModemTrans 2 <HSTdialstring>    ; for HST without V32b
  1112.          ModemTrans 3 <V32dialstring>    ; for V32 without HST
  1113.  
  1114.          ==============================================================
  1115.  
  1116.          With a USR H16+V32B modem you could use:
  1117.  
  1118.          TypeDef H16  1  ; Type 1 if H16 flag present
  1119.          TypeDef V32B 2  ; Type 2 if V32B flag present
  1120.          TypeDef HST  3  ; Type 3 if HST flag present
  1121.          TypeDef H14  3  ; Type 3 if H14 flag present
  1122.          TypeDef V32  4  ; Type 4 if V32 flag present
  1123.  
  1124.          ModemTrans 1 <HSTdialstring>    ; for H16 capable nodes
  1125.          ModemTrans 2 <V32dialstring>    ; for V32B without H16
  1126.          ModemTrans 3 <HSTdialstring>    ; for H14 without V32b
  1127.          ModemTrans 4 <V32dialstring>    ; for V32 without H14
  1128.  
  1129.          ==============================================================
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.                                      Pag. 18
  1140.  
  1141.          TypeCost <type> <cost>
  1142.  
  1143.          where <type> is the modem type resulting from the nodelist
  1144.          flags and the "TypeDef"/"TypeExact" options.
  1145.  
  1146.          Examples:
  1147.  
  1148.          If you have two lines, one with PEP and one with HST
  1149.          DUAL STANDARD (HST+V32), then you could organize your
  1150.          system so that the PEP will call only PEP nodes and the
  1151.          HST/DS will call all nodes that cannot be connected in PEP.
  1152.          The Cost parameter could help you.
  1153.          Let's suppose you have defined:
  1154.  
  1155.          TypeDef HST   1
  1156.          TypeDef PEP   2
  1157.          TypeDef V32   4
  1158.  
  1159.          You should then use:
  1160.  
  1161.          TypeCost 1 100   ; cost 100 for HST
  1162.          TypeCost 2  50   ; cost  50 for PEP
  1163.          TypeCost 4 100   ; cost 100 for V32
  1164.          TypeCost 5 100   ; cost 100 for HST+V32
  1165.          TypeCost 6  50   ; cost 100 for PEP+V32
  1166.  
  1167.          Of course any V32B flag would be processed as a V32 one.
  1168.          
  1169.          If you configure your events so that the PEP line calls nodes
  1170.          with a cost <= 50 and the HST/V32 line calls nodes with a
  1171.          cost > 50 you have done it !
  1172.  
  1173.  
  1174.  
  1175.          Dial [<domestic>][<international>]
  1176.          
  1177.          Example:  Dial 0   00
  1178.                         39-59-58    /-010     ; Special Case
  1179.                         39-59-                ; Local Dialing Area
  1180.                    End
  1181.  
  1182.          The 'Dial' statement begins a dial table, which is ended by an 
  1183.          'End' statement.  
  1184.          
  1185.          It can take two arguments that specify the default prefix/suffix
  1186.          to be prepended/appended to domestic and international phone
  1187.          numbers (after removing the "Country" string from the
  1188.          domestic numbers).
  1189.  
  1190.          Subsequent entries after the 'Dial' statement are used to
  1191.          specify the prefix/suffix to be prepended/appended to telephone
  1192.          numbers that begin with the string on the left (that is
  1193.          removed).
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.                                      Pag. 19
  1200.  
  1201.          The first matching entry is used; if no entry apply, the
  1202.          defaults are used.
  1203.  
  1204.          All the prefix/suffix specifications take the form:
  1205.          
  1206.               [<prefix>][/[<suffix>]]
  1207.          
  1208.          So that you can use:
  1209.  
  1210.          <search_string>        ; to remove <search_string> from the
  1211.                                 ; beginning of the number.
  1212.          <search_string>  /     ; Same as above.
  1213.  
  1214.          <search_string> <prefix> ; to replace <search_string> with
  1215.                                   ; <prefix>
  1216.  
  1217.          <search_string> <prefix>/ ; Same as above.
  1218.  
  1219.  
  1220.          <search_string> /<suffix> ; to remove <search_string> and
  1221.                                    ; append <suffix>
  1222.  
  1223.          <search_string> <prefix>/<suffix> ; to replace
  1224.                                            ; <search_string> with <prefix> and
  1225.                                            ; append <suffix>
  1226.  
  1227.  
  1228.          Also the two arguments of the heading Dial statement take the
  1229.          described forms, but if you want to specify an international
  1230.          prefix/suffix while leaving empty the domestic one, then you
  1231.          MUST use a slash '/' as the domestic argument.
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.                                      Pag. 20
  1260.  
  1261.                              COMMAND LINE PARAMETERS
  1262.  
  1263.  
  1264.          -h or -?  for help
  1265.  
  1266.          -n<nodelist>
  1267.               Compile <nodelist>.nnn instead of NODELIST.nnn
  1268.  
  1269.          -d<nodediff>
  1270.               Apply <nodediff>.nnn instead of NODEDIFF.nnn
  1271.  
  1272.          -o<nodebase>
  1273.               Use <nodebase> instead of NODEX as the Version 7 base
  1274.               nodelist name. E.g. '-oFidoNet' generates FIDONET.DAT
  1275.               and FIDONET.NDX instead of NODEX.DAT and NODEX.NDX.
  1276.  
  1277.          -s<sysopndx>
  1278.               Use <sysopndx> instead of SYSOP as the Version 7 base
  1279.               sysop-index name. E.g. '-oFidoSys' generates FIDOSYS.NDX
  1280.               instead of SYSOP.NDX.
  1281.  
  1282.          -c<config>
  1283.               Use <config> configuration file instead of FASTLST.CFG
  1284.  
  1285.          -i<include>
  1286.               Include <include> configuration file.
  1287.               Allows easy use of different include files for different
  1288.               compilations. E.g. you could use different password
  1289.               files for different domain compilations.
  1290.  
  1291.          -l<logname>
  1292.               Log activity to <logname> file
  1293.  
  1294.          -g<mergelist>
  1295.               Merge main nodelist with <mergelist>
  1296.               This command can be substituted with a MergeList
  1297.               statement in the config file after all other
  1298.               MergeList lines.
  1299.  
  1300.          -m<mylist>
  1301.               Use <mylist> as an additional nodelist. If the main
  1302.               nodelist is the complete one, <mylist> is compiled just
  1303.               after your zone segment.
  1304.               This command can be substituted with a MyList
  1305.               statement in the config file after all other
  1306.               MyList/PvtList lines.
  1307.  
  1308.          -p<pvtlist>
  1309.               Use <pvtlist> as an additional private nodelist.
  1310.               This works the same as -m<mylist>, but there is no
  1311.               output to nodelist.txt/prn.
  1312.               This command can be substituted with a PvtList
  1313.               statement in the config file after all other
  1314.               MyList/PvtList lines.
  1315.  
  1316.  
  1317.  
  1318.  
  1319.                                      Pag. 21
  1320.  
  1321.          -b<baud>
  1322.               Use <baud> in place of the one set in the config file.
  1323.  
  1324.          -e
  1325.               Apply nodediffs only (don't compile nodelist)
  1326.  
  1327.          -r
  1328.               Do not exit on CRC Error: return the errorlevel (9 or 10)
  1329.               when compilation ends.
  1330.  
  1331.  
  1332.  
  1333.          ATTENTION: Any file specification can contain drive and path,
  1334.          including -n -d -o -s.
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.                                    ERRORLEVELS
  1342.  
  1343.           0    Normal termination
  1344.           1    Help requested
  1345.           2    File Open error
  1346.           3    Can't find nodelist file
  1347.           4    Disk Full
  1348.           5    Can't find config file
  1349.           6    Configuration error
  1350.           7    Out of memory
  1351.           8    Merge error
  1352.           9    CRC error (applying nodediff)
  1353.          10    CRC error (compiling nodelist)
  1354.  
  1355.  
  1356.  
  1357.  
  1358.          When applying a nodediff, if the nodediff or nodelist files
  1359.          are corrupted, FastLst detects a CRC error and logs it.
  1360.          Generally the nodelist is OK, provided you have not manually
  1361.          altered it, and you can assume the new nodediff is corrupted.
  1362.  
  1363.          If "Autoerase" is active, the nodediff and the resulting
  1364.          nodelist files are erased, otherwise they are renamed to
  1365.          NODEDIFF.BAD and NODELIST.BAD.
  1366.          Then FastLst exits with errorlevel 9.
  1367.  
  1368.          If you are not sure about your old nodelist, you can compile
  1369.          it without applying the nodediff: if it is corrupted FastLst
  1370.          will detect the CRC error and exit with errorlevel 10.
  1371.  
  1372.          When compiling nodelist files (the main one or those included
  1373.          via pvtlist/mylist) that have the expected CRC on the first
  1374.          line, FastLst always checks the CRC and in case of error
  1375.          exits with errorlevel 10.
  1376.  
  1377.  
  1378.  
  1379.                                      Pag. 22
  1380.  
  1381.                                 MISCELLANEOUS INFO
  1382.  
  1383.  
  1384.          In the case of SysOps of more than one system, all the
  1385.          name/address couples are put in the SysOp Name Lists
  1386.          (Fidouser.lst and Sysop.ndx).
  1387.  
  1388.          If you want to keep one only name/address couple for some
  1389.          multiple SysOps, you can use the "SysDup <address> <address>
  1390.          ..." option in the config file: the SysOps who have one of
  1391.          the listed addresses will be present in the SysOp lists with
  1392.          that entry only, even if they have other addresses.
  1393.  
  1394.          Example: Let's suppose that Robert Everywhere has 4 nodes:
  1395.  
  1396.          EveryWhere, Robert      1:456/987.0
  1397.          EveryWhere, Robert      2:123/457.0
  1398.          EveryWhere, Robert      2:123/457.8
  1399.          EveryWhere, Robert      6:321/567.0
  1400.  
  1401.          By default all the 4 addresses are available in the sysop
  1402.          lists (and some programs allows to choose among them, e.g.
  1403.          TimEd message editor by Gerard van Essen).
  1404.  
  1405.          If you prefer to keep one address only, you can specify the
  1406.          desired address in a SysDup line in the config file:
  1407.          e.g. "SysDup 2:123/457.8".
  1408.  
  1409.  
  1410.  
  1411.          Redirected systems (Unpublished phone number, on HOLD) are
  1412.          given the phone number, baud rate, modem type, call cost and
  1413.          flags of the node they are redirected to, the Board name is
  1414.          prepended with '-R-'.
  1415.            A node is redirected to its coordinator, a point is
  1416.          redirected to its boss (or to its boss' coordinator if the
  1417.          boss is redirected).
  1418.            If you have a session password with the system to be redirected
  1419.          or with the system it should be redirected to, no redirection
  1420.          is done in order to prevent password-mismatch errors in the
  1421.          case the Unpublished/Hold System calls you.
  1422.            These non-redirected systems take an EMPTY phone number string,
  1423.          so that your mailer does not send unwanted strings to your modem
  1424.          attempting to call these systems, should something appear in your
  1425.          outbound addressed to them.
  1426.            Pay attention: if you want to directly call these
  1427.          null_phone-systems or their coordinators, you have to give
  1428.          them a phone number using the "Phone <address> <number>"
  1429.          statement in the configuration file.
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.                                      Pag. 23
  1440.  
  1441.          The cost for a system is determined in the following way:
  1442.          - The phone number determines the default to be used
  1443.            (domestic or international).
  1444.          - The entries in the "cost/end" statement can modify defaults
  1445.            if a match is found with the phone number.
  1446.          - The TypeCost statement can override the Cost in relation
  1447.            to modem type.
  1448.          - The "Cost <address>" statement can override the cost
  1449.            established by the preceding statements.
  1450.          In the case of Phone and Type overrides, the number and modem
  1451.          type used for cost determination are the new ones.
  1452.  
  1453.  
  1454.  
  1455.          The Modem Type for a system is determined in the following
  1456.          way:
  1457.          - Nodelist flags (in relation to "TypeDef" and "TypeExact"
  1458.            statements).
  1459.          - Type Mask / Type List (optionally set by the "Cost/End"
  1460.            statement if a phone number match occurs).
  1461.          - "Type <address>" statement.
  1462.  
  1463.          The message fee (user cost) is especially useful when set to
  1464.          0, so that you do not have to manually give credits to all of
  1465.          your users.
  1466.          If you use the following UCost table, then all nodelist
  1467.          entries will have User_Cost = 0, thus allowing BBS users to
  1468.          enter netmail messages even if they have no credits:
  1469.  
  1470.          ucost 0 0
  1471.          end
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.                                      Pag. 24
  1500.  
  1501.  
  1502.