home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMNETML / ARTNOD13.ZIP / ARTNODE.DOC < prev    next >
Encoding:
Text File  |  1993-02-03  |  29.6 KB  |  912 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.               ██│     └██┌┘ ██┌────┘ └──██┌──┘ ██┌────┘ ██┌──██│
  25.               ██│      ██│  ███████┐    ██│    █████┐   ███████│
  26.               ██│      ██│  └────██│    ██│    ██┌──┘   ██┌─██┌┘
  27.               ██████┐ ████┐ ███████│    ██│    ███████┐ ██│ ███┐
  28.               └─────┘ └───┘ └──────┘    └─┘    └──────┘ └─┘ └──┘
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                         The Art Node Lister version 1.2
  35.                               A Nodelist Utility
  36.  
  37.                          A TequilaNetmailware Product
  38.                    Copyright (c)1992 by Philippe Feuerstein
  39.                                2:323/3@fidonet
  40.  
  41.  
  42.  
  43.  
  44.                                   User Guide
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                 - Page 1 -
  66.  
  67.                                                     The Art Node Lister 1.2
  68.  
  69.  
  70.    ╓───────────────────────────────────────────────────────────────────────╖
  71.    ║ ▒▒▒▒ Table of contents ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  72.    ╙───────────────────────────────────────────────────────────────────────╜
  73.  
  74.  
  75.        1. Features . . . . . . . . . . . . . . . . 3
  76.  
  77.        2. Legal Notice . . . . . . . . . . . . . . 4
  78.  
  79.        3. Requirements . . . . . . . . . . . . . . 5
  80.  
  81.        4. Installation . . . . . . . . . . . . . . 5
  82.  
  83.        5. Command Line Options . . . . . . . . . . 6
  84.  
  85.            5.1 Main Switches . . . . . . . . . . . 6
  86.                /e. . . . . . . . . . . . . . . . . 6
  87.                /s. . . . . . . . . . . . . . . . . 6
  88.                /l. . . . . . . . . . . . . . . . . 7
  89.                /v. . . . . . . . . . . . . . . . . 7
  90.                /b. . . . . . . . . . . . . . . . . 7
  91.  
  92.            5.2 Optional Switches . . . . . . . . . 8
  93.                /n <Nodelist Name>. . . . . . . . . 8
  94.                /p <Nodelist Dir> . . . . . . . . . 8
  95.                /d <Nodelist Name>. . . . . . . . . 9
  96.                /i <Nodediff Dir> . . . . . . . . . 9
  97.                /o <OutFile Dir>. . . . . . . . . . 9
  98.                /k <Packer> . . . . . . . . . . . . 9
  99.                /a <Address>. . . . . . . . . . . .10
  100.                /u <Hub Exclude>. . . . . . . . . .10
  101.                /c <Alternate Config File Path> . .10
  102.  
  103.        6. Configuration File . . . . . . . . . . .11
  104.                NODELIST_NAME <Nodelist Name> . . .11
  105.                NODELIST_DIR <Nodelist Dir> . . . .11
  106.                NODEDIFF_NAME <Nodelist Name> . . .11
  107.                NODEDIFF_DIR <Nodediff Dir> . . . .11
  108.                OUTDIR <OutFile Dir>. . . . . . . .11
  109.                PACKER <Packer> . . . . . . . . . .11
  110.                ADDRESS <Address> . . . . . . . . .11
  111.                HUB <Yes/No>. . . . . . . . . . . .11
  112.                BORDER_COLOR <Fg/Bg>. . . . . . . .11
  113.                SHADOW_COLOR <Fg/Bg>. . . . . . . .12
  114.                TEXT_COLOR <Fg/Bg>. . . . . . . . .12
  115.                REGION_COLOR <Fg/Bg>. . . . . . . .12
  116.                TITLE_COLOR <Fg/Bg> . . . . . . . .12
  117.                PUB_COLOR <Fg/Bg> . . . . . . . . .12
  118.  
  119.        7. Exit Error Levels. . . . . . . . . . . .12
  120.  
  121.        8. The TequilaNetmailware Concept . . . . .13
  122.  
  123.        9. Support. . . . . . . . . . . . . . . . .13
  124.  
  125.       10. Credits. . . . . . . . . . . . . . . . .14
  126.  
  127.  
  128.  
  129.  
  130.                                 - Page 2 -
  131.  
  132.                                                     The Art Node Lister 1.2
  133.  
  134.  
  135.    ╓───────────────────────────────────────────────────────────────────────╖
  136.    ║ ▒▒▒▒ 1. Features ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  137.    ╙───────────────────────────────────────────────────────────────────────╜
  138.  
  139.        The Art Node Lister is a utility for users of FTSC compliant
  140.        nodelist; if you don't know what is a nodelist, you certainly
  141.        don't have any use for this program.
  142.  
  143.        The main features are:
  144.  
  145.        ■ fully FTSC compatible
  146.  
  147.        ■ can use any nodelist/nodediff names
  148.  
  149.        ■ edit new nodelist from the old one and the nodediff
  150.  
  151.        ■ automatic determination of archive type such as ARC, ZIP, ARJ,
  152.          LZH and automatic calling of the correct program, with swapping
  153.          to EMS, XMS or disk for nodediff decompressing
  154.  
  155.        ■ can generate a subset nodelist for a zone, a region or a net
  156.  
  157.        ■ a calculated CRC line is included in the subset nodelist,
  158.          thus avoiding nodelist compiler complaints!
  159.  
  160.        ■ the newly created full or subset nodelist can be compressed
  161.          using ARC, ARJ, LZH or ZIP (with a correct A?? type
  162.          extension) in a chosen directory
  163.  
  164.        ■ a listing file can be generated for a zone, a region or a net,
  165.          in Asc-Ans-Avt with definable colors for easy creation of
  166.          BBS bulletins
  167.  
  168.        ■ a Dbase III compatible dbf file node list can be generated
  169.          for a zone, a region or a net
  170.  
  171.        ■ can do a CRC check on an existing nodelist
  172.  
  173.        ■ everything in one run for speed and small batch files
  174.  
  175.        ■ exit with errorlevel for use in batch files
  176.  
  177.        ■ can use multiple config files and/or command line switches
  178.  
  179.        ■ fully DesqView aware (screen writes, file sharing), requiring
  180.          no more than a 110 Ko window.
  181.  
  182.        ■ has been fully tested with Qemm 6.02, DesqView 2.42,
  183.          4DOS 4.01
  184.  
  185.        ■ the first TequilaNetmailware you ever saw!!!
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                 - Page 3 -
  196.  
  197.                                                     The Art Node Lister 1.2
  198.  
  199.  
  200.    ╓───────────────────────────────────────────────────────────────────────╖
  201.    ║ ▒▒▒▒ 2. Legal Notice ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  202.    ╙───────────────────────────────────────────────────────────────────────╜
  203.  
  204.        The Art Node Lister comes with limited warranty: it will occupy
  205.        disk space.
  206.  
  207.        The Art Node Lister is provided as is, without any other
  208.        warranty of any kind, either expressed or implied.
  209.  
  210.        In no event shall Philippe Feuerstein be liable to you or
  211.        anyone else for any damages, including any lost profits, lost
  212.        savings or other incidental or consequential damages arising
  213.        out of the use or inability to use The Art Node Lister.
  214.  
  215.        The Art Node Lister is not public domain, shareware or freeware;
  216.        it is TequilaNetmailware!
  217.  
  218.        You are allowed to use The Art Node Lister for an evaluation
  219.        period of thirty days. After this period you MUST send me a
  220.        TequilaNetmail (see below).
  221.  
  222.        You are allowed to distribute The Art Node Lister on BBS, Shareware
  223.        Disk, CD-Rom as long as:
  224.  
  225.              - The Artnode archive contains unmodified copies of the
  226.                following files: ■ ARTNODE.EXE
  227.                                 ■ ARTNODE.CFG
  228.                                 ■ ARTNODE.DOC
  229.                                 ■ TEQUILA.REG
  230.  
  231.  
  232.              - No fee is charged.
  233.  
  234.              - You don't run a commercial BBS or a French Minitel server.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                 - Page 4 -
  261.  
  262.                                                     The Art Node Lister 1.2
  263.  
  264.  
  265.    ╓───────────────────────────────────────────────────────────────────────╖
  266.    ║ ▒▒▒▒ 3. Requirements ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  267.    ╙───────────────────────────────────────────────────────────────────────╜
  268.  
  269.        ■ An IBM AT or 100% compatible PC (286, 386 or 486 processor)
  270.  
  271.        ■ A hard disk with at least 3,5 Mo of free space (the FidoNet
  272.          Nodelist is quite a huge file).
  273.  
  274.        ■ MS-DOS, PC-DOS or DR-DOS version 3.00 or later.
  275.  
  276.        ■ At least 110 Kb of RAM available. Artnode will use no more
  277.          than 110 Kb but, if you use archivers, you may need more.
  278.  
  279.        ■ If, as usual, you get your diff files in a compressed format
  280.          or if you want to compress a subset nodelist, you will need
  281.          archiver and dearchiver program(s). Supported programs are:
  282.  
  283.        ╔══════════════╦════════════╦══════════════╦══════════════════╗
  284.        ║ Archive Type ║  Archiver  ║ Dearchiver   ║Suggested Filename║
  285.        ╠══════════════╬════════════╬══════════════╬══════════════════╣
  286.        ║     ARC      ║ PkPak 2.61 ║ PkUnpak 2.61 ║  Filename.A??    ║
  287.        ╟──────────────╫────────────╫──────────────╫──────────────────╢
  288.        ║     ARJ      ║ ARJ 2.30   ║ ARJ 2.30     ║  Filename.J??    ║
  289.        ╟──────────────╫────────────╫──────────────╫──────────────────╢
  290.        ║     LZH      ║ LHA 2.13   ║ LHA 2.13     ║  Filename.L??    ║
  291.        ╟──────────────╫────────────╫──────────────╫──────────────────╢
  292.        ║     ZIP      ║ PkZip 1.10 ║ PkUnzip 1.10 ║  Filename.Z??    ║
  293.        ╚══════════════╩════════════╩══════════════╩══════════════════╝
  294.  
  295.        ■ One or more St.Louis nodelist :-))) and possibly diff files.
  296.  
  297.        ■ A disk cache is strongly recommended.
  298.  
  299.  
  300.  
  301.  
  302.    ╓───────────────────────────────────────────────────────────────────────╖
  303.    ║ ▒▒▒▒ 4. Installation ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  304.    ╙───────────────────────────────────────────────────────────────────────╜
  305.  
  306.        The installation is very easy: just put Artnode.Exe in any
  307.        directory...
  308.  
  309.        If want to you use it, edit the sample configuration file to
  310.        match your needs and put it on the same directory.
  311.  
  312.        If you use archivers, they MUST reside on your path.
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                 - Page 5 -
  326.  
  327.                                                     The Art Node Lister 1.2
  328.  
  329.  
  330.    ╓───────────────────────────────────────────────────────────────────────╖
  331.    ║ ▒▒▒▒ 5. Command Line Options ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  332.    ╙───────────────────────────────────────────────────────────────────────╜
  333.  
  334.        Using Artnode is very straightforward: just specify one (or
  335.        more) of the five main switches: e, s, l, v or b, combined with
  336.        one or more optional switches.
  337.  
  338.        If more than one switch is specified, a "one run" session will
  339.        start and, if asked for, /e will be treated first.
  340.  
  341.        The switch character can be either / or - as usual.
  342.  
  343.        5.1 Main Switches
  344.        ═════════════════
  345.  
  346.        /e: stands for Edit. To create the new nodelist from the old
  347.            nodelist and the relevant nodediff.
  348.  
  349.            Artnode first looks for a uncompressed nodediff and uses it
  350.            if found. Otherwise, a compressed one is searched for and
  351.            the correct decompression program will be called.
  352.  
  353.            The nodediff is extracted either in a preset TMP directory
  354.            (uses TMP or TEMP environmental variable), or in the
  355.            current directory.
  356.  
  357.            At end of the process, if the new nodelist passes the CRC
  358.            check the old nodelist and the uncompressed nodediff are
  359.            erased and the new nodelist is written in the nodelist dir.
  360.            The faulty new nodelist is erased if it fails this CRC
  361.            check.
  362.  
  363.            If a packer is defined (see /k below), the generated
  364.            nodelist will be compressed in the OutDir (see /o below)
  365.            with the correct classical nodelist extension (A?? for Arc,
  366.            Z?? for Zip, J?? for Arj, L?? for Lharc)
  367.  
  368.            This product uses the SPAWNO routines by Ralf Brown to
  369.            minimize memory usage while shelling to DOS and running
  370.            (de)archiver by swapping to EMS, XMS or disk. Hence, you
  371.            can use memory hungry archivers like ARJ.
  372.  
  373.  
  374.  
  375.        /s: stands for Subset. To create a subset nodelist for a zone,
  376.            a region or a net.
  377.  
  378.            The Art Node Lister will write a FTS-005 compliant first
  379.            line, including the calculated 16-bit CRC. This will enable
  380.            you to use Xlaxnode or other nodelist compiler without
  381.            getting any complaint about a wrong CRC!
  382.  
  383.            You MUST specify the "address" for the subset in the
  384.            configuration file (see ADDRESS below) or on the command
  385.            line (see /a below).
  386.  
  387.  
  388.  
  389.  
  390.                                 - Page 6 -
  391.  
  392.                                                     The Art Node Lister 1.2
  393.  
  394.  
  395.  
  396.            The created subset nodelist can be created in a specified
  397.            directory (see /o below) and compressed (see /k below).
  398.                                 ┌───────────┐
  399.                                 │Zone Number│
  400.                                 └─────┬─────┘
  401.                                       
  402.            The filename will be: ZONE_#.ddd, REG_##.ddd or NET_###.ddd.
  403.                                         
  404.                  ┌──────────────────────┴────────────────────┐
  405.                  │Day number taken from the original nodelist│
  406.                  └───────────────────────────────────────────┘
  407.  
  408.  
  409.  
  410.        /l: stands for List. To create a node listing for a zone, a
  411.            region or a net. That's an easily done and useful BBS
  412.            bulletin!
  413.  
  414.            You MUST specify a type parameter after /l, that can be
  415.            /l1, /l2 or /l3.
  416.  
  417.            /l1 will generate Ascii file.
  418.            /l2 will generate Ascii and Ansi files.
  419.            /l3 will generate Ascii, Ansi and Avatar files.
  420.  
  421.            Colors used in Ansi and Avatar are fully configurable (in
  422.            the configuration file, see below). If not defined, a
  423.            default color set will be used.
  424.  
  425.            You MUST specify the "address" for the list in the
  426.            configuration file (see ADDRESS below) or on the command
  427.            line (see /a below).
  428.  
  429.                                  ┌───────────┐
  430.                                  │Zone Number│
  431.                                  └─────┬─────┘
  432.                                        
  433.            The filenames will be: ZONE_#.ASC, REG_##.ASC or NET_###.ASC,
  434.                                   ZONE_#.ANS, REG_##.ANS or NET_###.ANS,
  435.                                   ZONE_#.AVT, REG_##.AVT or NET_###.AVT.
  436.  
  437.  
  438.  
  439.        /v: stands for Verify. To check the CRC of an existing nodelist.
  440.  
  441.  
  442.  
  443.        /b: stands for dataBase. To create a Dbase III compatible dbf
  444.            file node listing for a zone, a region or a net.
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.                                 - Page 7 -
  456.  
  457.                                                     The Art Node Lister 1.2
  458.  
  459.  
  460.            The format of the file is:
  461.  
  462.                    ╔═══════╦══════════╦═══════════╦═══════╗
  463.                    ║ Field ║   Name   ║   Type    ║ Width ║
  464.                    ╠═══════╬══════════╬═══════════╬═══════╣
  465.                    ║   1   ║ ZONE     ║ Number    ║    3  ║
  466.                    ╟───────╫──────────╫───────────╫───────╢
  467.                    ║   2   ║ NET      ║ Number    ║    5  ║
  468.                    ╟───────╫──────────╫───────────╫───────╢
  469.                    ║   3   ║ NODE     ║ Number    ║    5  ║
  470.                    ╟───────╫──────────╫───────────╫───────╢
  471.                    ║   4   ║ BBS      ║ Character ║   36  ║
  472.                    ╟───────╫──────────╫───────────╫───────╢
  473.                    ║   5   ║ SYSOP    ║ Character ║   36  ║
  474.                    ╟───────╫──────────╫───────────╫───────╢
  475.                    ║   6   ║ LOCATION ║ Character ║   36  ║
  476.                    ╟───────╫──────────╫───────────╫───────╢
  477.                    ║   7   ║ PHONE    ║ Character ║   15  ║
  478.                    ╟───────╫──────────╫───────────╫───────╢
  479.                    ║   8   ║ SPEED    ║ Number    ║    5  ║
  480.                    ╟───────╫──────────╫───────────╫───────║
  481.                    ║   9   ║ FLAGS    ║ Character ║   40  ║
  482.                    ╚═══════╩══════════╩═══════════╩═══════╝
  483.                                 ┌───────────┐
  484.                                 │Zone Number│
  485.                                 └─────┬─────┘
  486.                                       
  487.            The filename will be: ZONE_#.DBF, REG_##.DBF or NET_###.DBF.
  488.  
  489.  
  490.  
  491.  
  492.  
  493.        5.1 Optional Switches
  494.        ═════════════════════
  495.  
  496.        If specified, these switches override their configuration file
  497.        equivalents.
  498.  
  499.        /n: stands for Nodelist Name. This indicates the name, WITHOUT
  500.            extension, of the nodelist file, thus permitting Artnode to
  501.            work on the nodelist/nodediff of different networks.
  502.  
  503.            If not specified, neither on the command line nor in the
  504.            configuration file, defaults to NODELIST.
  505.  
  506.  
  507.  
  508.        /p: stands for Nodelist Dir. This indicates the directory where
  509.            nodelist to use is located.
  510.  
  511.            You may omit the trailing \.
  512.  
  513.            If not specified, neither on the command line nor in the
  514.            configuration file, defaults to current dir.
  515.  
  516.  
  517.  
  518.  
  519.  
  520.                                 - Page 8 -
  521.  
  522.                                                     The Art Node Lister 1.2
  523.  
  524.  
  525.  
  526.  
  527.        /d: stands for Nodediff Name. This indicates the name, WITHOUT
  528.            extension, of the nodelist file, thus permitting Artnode to
  529.            work on nodelist/nodediff of different networks.
  530.  
  531.            If not specified, neither on the command line nor in the
  532.            configuration file, defaults to NODEDIFF.
  533.  
  534.  
  535.  
  536.        /i: stands for Nodediff Dir. This indicates the directory where
  537.            is located the (compressed) nodediff to use.
  538.  
  539.            You may omit the trailing \.
  540.  
  541.            If not specified, neither on the command line nor in the
  542.            configuration file, defaults to current dir.
  543.  
  544.  
  545.  
  546.        /o: stands for Outfile Dir. This indicates the directory where
  547.            the subset or list will be created.
  548.  
  549.            If not specified, neither on the command line nor in the
  550.            configuration file, defaults to current dir.
  551.  
  552.  
  553.  
  554.        /k: stands for pacKer. This indicates the packer used to
  555.            compress a newly created subset nodelist.
  556.  
  557.            Correct values are: N for None, don't compress
  558.                                A for ARC (using PkPak 2.61)
  559.                                J for ARJ (using ARJ 2.30 or greater)
  560.                                L for LZH (using LHA 2.13 or greater)
  561.                                Z for ZIP (using PkZip 1.10 or greater)
  562.  
  563.                    ┌───────────┐             ┌─────────────┐
  564.                    │Zone Number├─────┐ ┌─────│Archiver Type│
  565.                    └───────────┘     │ │     └─────────────┘
  566.                                       
  567.           The filename will be: ZONE_#.tdd, REG_##.tdd or NET_###.tdd.
  568.                                         
  569.            ┌────────────────────────────┴─────────────────────────────┐
  570.            │Last 2 digits of the day number from the original nodelist│
  571.            └──────────────────────────────────────────────────────────┘
  572.  
  573.            If not specified, neither on the command line nor in the
  574.            configuration file, defaults to none.
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.                                 - Page 9 -
  586.  
  587.                                                     The Art Node Lister 1.2
  588.  
  589.  
  590.        /a: stands for Address. This indicates the address for subset
  591.            or list in the form Zone:Region.
  592.  
  593.            The address is Zone:0        for a zone subset nodelist
  594.                           Zone:Region   for a region subset nodelist
  595.                           Zone:Net      for a net subset nodelist
  596.  
  597.            ie: 2:0   extracts the whole zone 2 nodelist
  598.                2:32  extracts the zone 2 region 32 nodelist
  599.                2:323 extracts the zone 2 net 323 nodelist
  600.  
  601.  
  602.  
  603.        /u: stands for Hub. This is to fix a possible problem in Dbf and
  604.            List files with Hub nodes...
  605.  
  606.            What's the matter with Hub nodes? FTS-0005 says about Hub:
  607.  
  608.        Hub --
  609.           Begins the definition of a routing subunit within a multilevel
  610.           local network.  The hub is the routing focal point for nodes
  611.           listed below it until the next occurrence of a "Zone",
  612.         > "Region",  "Host",  or "Hub" keyword.  The hub entry MUST be a <
  613.         > redundant entry,  with a unique number,  for one of the nodes  <
  614.         > listed below it.  This is necessary because some nodelist      <
  615.           processors eliminate these entries in all but the local
  616.           network.
  617.  
  618.            In fact, in a lot of Regions in Zone 2, the Hub entry is not a
  619.            redundant one so you have to include them in the report files.
  620.            But, if they are redundant entries, you will get a duplicate
  621.            entry in your files...
  622.  
  623.            With the /u switch, you can choose to exclude Hub nodes from
  624.            the Dbf and List files. The default is to include them.
  625.  
  626.  
  627.  
  628.        /c: stands for config. Artnode will, by default, first search
  629.            for a configuration file called "Artnode.Cfg" in the same
  630.            path as Artnode.Exe and, if found, will use it.
  631.  
  632.            But you can use alternate configuration files; just specify
  633.            the full path with the /c switch: /cc:\nodelist\my_own.cfg
  634.  
  635.            See below for details on configuration file.
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.                                 - Page 10 -
  651.  
  652.                                                     The Art Node Lister 1.2
  653.  
  654.  
  655.    ╓───────────────────────────────────────────────────────────────────────╖
  656.    ║ ▒▒▒▒ 6. Configuration File ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  657.    ╙───────────────────────────────────────────────────────────────────────╜
  658.  
  659.        All of the optional switches can be saved in a configuration
  660.        file to avoid repetitive entries.
  661.  
  662.        Artnode will, by default, first search for a configuration file
  663.        called "Artnode.Cfg" in the same path as Artnode.Exe and, if
  664.        found, will use it.
  665.  
  666.        If an alternate configuration file is specified with the /c
  667.        switch and found, it will be used.
  668.  
  669.        The configuration file definitions ARE OVERRIDDEN BY THEIR
  670.        EQUIVALENT COMMAND LINE SWITCHES (if present).
  671.  
  672.        The color set for the Ansi and Avatar file list can be defined
  673.        here.
  674.  
  675.        This file is a plain vanilla ASCII text, where everything after
  676.        a ; or a % is considered as a comment. The general format is
  677.        "VARIABLE value". You don't need to define all the variables.
  678.  
  679.        Each optional command line switch has its configuration file
  680.        counterpart with the same type of value:
  681.  
  682.        NODELIST_NAME: equivalent to /n
  683.  
  684.        NODELIST_DIR : equivalent to /p
  685.  
  686.        NODEDIFF_NAME: equivalent to /d
  687.  
  688.        NODEDIFF_DIR : equivalent to /i
  689.  
  690.        OUTDIR       : equivalent to /o
  691.  
  692.        PACKER       : equivalent to /k
  693.  
  694.        ADDRESS      : equivalent to /a
  695.  
  696.        HUB          : equivalent to /u if value equal No
  697.  
  698.        The color definitions are very easy, the general format being:
  699.        WhatFor ForegroundColor/BackgroundColor
  700.  
  701.        Possible colors are: BLACK, BLUE, GREEN, CYAN, RED, MAGENTA,
  702.                             BROWN, WHITE for background
  703.  
  704.                             BLACK, BLUE, GREEN, CYAN, RED, MAGENTA,
  705.                             BROWN, WHITE, GRAY, B_BLUE, B_GREEN,
  706.                             B_CYAN, B_RED, B_MAGENTA, B_YELLOW,
  707.                             B_WHITE for foreground (B stands for bright)
  708.  
  709.        BORDER_COLOR: For the borders.
  710.  
  711.  
  712.  
  713.  
  714.  
  715.                                 - Page 11 -
  716.  
  717.                                                     The Art Node Lister 1.2
  718.  
  719.  
  720.        SHADOW_COLOR: For the shadow.
  721.  
  722.        TEXT_COLOR:   For the main text.
  723.  
  724.        REGION_COLOR: For the Net or Country text lines.
  725.  
  726.        TITLE_COLOR:  For the Name, Location, Telephone, Baud line.
  727.  
  728.        PUB_COLOR:    For my advertisement lines.
  729.  
  730.        See sample Artnode.Cfg file for an example.
  731.  
  732.  
  733.  
  734.  
  735.    ╓───────────────────────────────────────────────────────────────────────╖
  736.    ║ ▒▒▒▒ 7. Exit Error Levels ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  737.    ╙───────────────────────────────────────────────────────────────────────╜
  738.  
  739.        The Art Node Lister always returns an errorlevel on exit,
  740.        making it suitable for use in elaborate batch files.
  741.  
  742.        Here are the errorlevels and their meanings:
  743.  
  744.             0: No Error, Normal Termination
  745.             1: Argument Error
  746.             2: Memory Error
  747.             3: Configuration File Error
  748.             4: Zone Not Found
  749.             5: Region Not Found
  750.             6: Net Not Found
  751.             7: Error Opening Old Nodelist
  752.             8: Corrupted Old Nodelist
  753.             9: No Nodediff Found
  754.            10: Error Opening Nodediff
  755.            11: Corrupted Nodediff
  756.            12: Error Opening Subset Nodelist
  757.            13: Error Opening New Nodelist
  758.            14: CRC Error
  759.            15: Archiver Error
  760.            16: DeArchiver Error
  761.            17: Write File Error
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.                                 - Page 12 -
  781.  
  782.                                                     The Art Node Lister 1.2
  783.  
  784.  
  785.    ╓───────────────────────────────────────────────────────────────────────╖
  786.    ║ ▒▒▒▒ 8. The TequilaNetmailware Concept and the Registration ▒▒▒▒▒▒▒▒▒ ║
  787.    ╙───────────────────────────────────────────────────────────────────────╜
  788.  
  789.        This program was written for my own use. I was getting tired of
  790.        getting an errorlevel exit from Xlaxnode when compiling the
  791.        Reg_32 nodelist created by NlNet for my "France Calls Only"
  792.        machine, and also for the programming fun.
  793.  
  794.        The longest and most boring part was to write this f...... doc
  795.        you are reading right now!
  796.  
  797.        So I think it would be unlegitimate for me to ask you any money
  798.        for it. But then again, it's not exactly freeware ....
  799.  
  800.        Because I would like to know how many people are using The Art
  801.        Node Lister and also because I like Tequila, I'm asking you, if
  802.        you use Artnode, to send me a Netmail telling me that next time
  803.        we will meet (who knows...) you'll offer me a Tequila!
  804.  
  805.        If you do so, I'll put on hold a Netmail for you with your own
  806.        "registration" key to get rid of the annoying opening delay.
  807.  
  808.        The Netmail must be sent to Philippe Feuerstein 2:323/3@fidonet
  809.        and you can use the "Tequila.Reg" file for this purpose.
  810.  
  811.        Remember, you MUST send me a Netmail and offer me a Tequila
  812.        next time we meet!!!
  813.  
  814.                       ********ATTENTION********
  815.  
  816.        ZONE 1 users may now obtain their key from Richard Transue @
  817.        1:300/15! This will eliminate the gate problems (lost messages)
  818.        and provide a less expensive method of obtaining registration.
  819.        The same rules mentioned above will still apply........The
  820.        Tequila.Reg is still applicable. Richard will generate a key for
  821.        you and have it waiting for your poll if you are a LD caller to
  822.        his address. (After all, the registration is free.) Please allow
  823.        24 hours for the key to be generated, and the return message to
  824.        be generated. As an aside, the latest version of ARTNODE will
  825.        always be freqable from Richard, magic name ARTNODE.
  826.  
  827.  
  828.  
  829.    ╓───────────────────────────────────────────────────────────────────────╖
  830.    ║ ▒▒▒▒ 9. Support ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  831.    ╙───────────────────────────────────────────────────────────────────────╜
  832.  
  833.        Send any comments/suggestions/bug reports/questions to:
  834.  
  835.            Philippe Feuerstein, 2:323/3@fidonet
  836.  
  837.        or
  838.  
  839.        Leave a message in the ARTNODE conference on the support BBS:
  840.  
  841.            L'Art Des Choix!   (+33) 75-67-61-64     14400 HST V32bis
  842.  
  843.  
  844.  
  845.                                 - Page 13 -
  846.  
  847.                                                     The Art Node Lister 1.2
  848.  
  849.  
  850.    ╓───────────────────────────────────────────────────────────────────────╖
  851.    ║ ▒▒▒▒ 10. Credits ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║
  852.    ╙───────────────────────────────────────────────────────────────────────╜
  853.  
  854.        Many thanks to Michel Barthelemy, Jos Bergman, Georges Bourne,
  855.        Mathieu Chappuis, Roger Kirchhoff, Christian Perrier, Edmond
  856.        Vandermeersch. They were foolish enough to test the betas...
  857.  
  858.        Many thanks to Derrick Neve for the doc revision.
  859.  
  860.        4DOS is a trademark of J.P. Software / R.C. Conn and T. Rawson.
  861.  
  862.        ARC is a trademark of SEA inc.
  863.  
  864.        ARJ is a trademark of Robert K. Jung.
  865.  
  866.        ARTNODE is a trademark of Philippe Feuerstein :-)
  867.  
  868.        BORLAND C++ is a trademark of Borland International.
  869.  
  870.        DBASE is a trademark of Ashton-Tate.
  871.  
  872.        DESQVIEW is a trademark of QuarterDeck Office Systems.
  873.  
  874.        DR-DOS is a trademark of Digital Research.
  875.  
  876.        FIDONET is a trademark of Tom Jennings.
  877.  
  878.        LZH and LHarc are trademarks of Yoshi.
  879.  
  880.        MS-DOS is a trademark of Microsoft Corporation.
  881.  
  882.        NLNET is a trademark of Pietro Budicin .
  883.  
  884.        PC-DOS is a trademark of IBM.
  885.  
  886.        PKPAK, PKUNPAK, PKZIP and PKUNZIP are trademarks of PKWare Inc.
  887.  
  888.        REGKEY is a trademark of Brian Pirie.
  889.  
  890.        SPAWNO is a trademark of Ralf Brown.
  891.  
  892.        TEQUILA is a true pleasure :-)
  893.  
  894.        XLAXNODE is a trademark of Scott Samet.
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.                                 - Page 14 -
  911.  
  912.