home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FDRN111.ZIP / FDRN.DOC < prev    next >
Encoding:
Text File  |  1994-12-25  |  13.8 KB  |  370 lines
  1.  
  2.         ▀██▀▀██ ▀██▀█▄  ▀██▀█▄   ▀██▄  █▀            ▄▄       ▄▄   ▄▄
  3.          ██ ▄ ▀  ██  ██  ██▄█▀    ███▄ █    ▄▄▄ ▄▄ ▄▀██     ▄▀██ ▄▀██
  4.          ██▀█    ██  ██  ██▀█▄    █ ██▄█     ██ █    ██       ██   ██
  5.          ██      ██  ██  ██ ▐█▌   █  ███     ▐██▌    ██       ██   ██
  6.         ▄██     ▄██▄█▀  ▄██  ██▄ ▄█   ██      ██    ▄██▄ ██  ▄██▄ ▄██▄
  7.         --------------------------------------------------------------
  8.  
  9.         FrontDoor<tm> - Read Nodelist
  10.  
  11.         Version 1.11     -       shareware
  12.  
  13.         (c) Peter Hampf                         2:241/1090@fidonet
  14.             Graf von Galen Str. 27              246:6101/0@pb-net
  15.             49377 Vechta
  16.             Germany
  17.  
  18.  ────────────────────────────────────────────────────────────────────────────
  19.  
  20.         ┌───┐┌───┐┌───┐┌───┐┌───┐ ┌───┐┌───┐┌───┐┌───┐
  21.         │ F ││ D ││ - ││ R ││ N │ │ 1 ││ . ││ 1 ││ 1 │
  22.         └───┘└───┘└───┘└───┘└───┘ └───┘└───┘└───┘└───┘
  23.  
  24.  
  25. ■ Disclaimer
  26.   ══════════────────────────────────────────────────────────────────────
  27.  
  28.    This program and all files out of the original distribution archive
  29.     are copyrighted material of Peter Hampf.
  30.  
  31.    FDRN in the current version is SHAREWARE. You may use it without
  32.     registration in a non-commercial and non-governmental environment
  33.     for a trial period of 21 days. After this you must register it
  34.     with me or stop using it. For registration-information and prices
  35.     have a look into FDRNREG.TXT.
  36.  
  37.    If you want to use it in a commercial or governmental environment,
  38.     you must contact me for details. (See the address listed below.)
  39.  
  40.    I reserve the right to quit support for this program at any time.
  41.  
  42.    You are not allowed to modify the original distribution archive in
  43.     any way. This includes deleting or adding files. Further you must
  44.     not repack it. The original archive is enclosed in a valid security
  45.     envelope.
  46.  
  47.    You are not allowed to reverse-engineer the program, nor are you
  48.     allowed to extract the executable, which comes in a packed form.
  49.  
  50.    Feel free to distribute the unmodified, original archive as long as
  51.     no fee is charged for its distribution.
  52.  
  53.    The software is provided "AS IS" without warranty of any kind.
  54.  
  55.  
  56.  
  57. ■ LOOKUP-MODE
  58.   ═══════════───────────────────────────────────────────────────────────
  59.  
  60.   FDRN has been designed to read and verify data from your FrontDoor or
  61.   Intermail nodelist. You may call it with parameters or use it in inter-
  62.   active mode. Note: in LOOKUP-MODE there is no "LIST-MODE" available (as
  63.   it is in HISTORY-MODE)
  64.  
  65.   Examples:
  66.  
  67.   1.) FDRN Peter Hampf
  68.  
  69.         will look for sysop-name "Peter Hampf" and wait for keystrokes.
  70.  
  71.   2.) FDRN Peter Hampf /Auto
  72.  
  73.         same as 1.) but will NOT wait for keystrokes. (/Auto may be
  74.         abbreviated up to /A)
  75.  
  76.   3.) FDRN Peter Hampf>node
  77.  
  78.         searches the nodelist for ALL occurrences of sysop-name "Peter Hampf"
  79.         and will print the output to file NODE. Will NOT wait for any
  80.         keystroke.
  81.  
  82.   4.) FDRN 2:246/1013
  83.  
  84.         searches the nodelist for the unique nodenumber 2:246/1013.
  85.  
  86.   5.) FDRN 2:246/1013 /ROUTEINFO
  87.  
  88.         same as above, but will show in addition the routing-information for
  89.         this node. (/ROUTEINFO may be abbreviated up to /R)
  90.  
  91.   6.) FDRN
  92.  
  93.         interactive mode. You will be asked for a nodenumber or a sysopname
  94.         to search for.
  95.  
  96.   7.) FDRN >node
  97.  
  98.         =invalid=
  99.  
  100.   8.) FDRN /?
  101.  
  102.         = show parameters and other stuff :-)
  103.  
  104.   ---------------------------------------------------------------------------
  105.  
  106.   You may also want to use FDRN to verify the existence of a certain node via
  107.   batchfile. FDRN will exit with errorlevel 0, if NO matching entry could be
  108.   found and will increase the errorlevel for each single found entry.
  109.  
  110.   Example:
  111.  
  112.   FDRN Constantin Spiess>nul                    (no display at all)
  113.   if errorlevel 1 goto OK
  114.   echo NO ENTRY FOUND!!
  115.   goto Ende
  116.   :OK
  117.   Echo Yep! This is a valid sysop-name!
  118.   ... Process what you want here ...
  119.   :Ende
  120.  
  121.   ---------------------------------------------------------------------------
  122.  
  123.  
  124. ■ HISTORY-MODE
  125.   ════════════──────────────────────────────────────────────────────────
  126.  
  127.   To activate the HISTORY-MODE, you must use INBOUND and OUTBOUND as
  128.   parameter. They may be abbreviated up to INB or OUT.
  129.  
  130.   Examples:
  131.  
  132.   FDRN INBOUND
  133.  
  134.         reads INB<task>.HIS and lets you walk through this file ... try it.
  135.         If INB<task>.HIS does not exist, INBOUND.HIS will be assumed.
  136.  
  137.   FDRN OUTBOUND
  138.  
  139.         same as above, but for OUTB<task>.HIS
  140.  
  141.   FDRN OUTBOUND /ROUTEINFO      (or FDRN OUT /R)
  142.  
  143.         same as above, but with routing-information.
  144.  
  145.   FDRN INBOUND /PATCH           (or FDRN INB /PA)
  146.  
  147.         patches the real nodelist-data in your inbound history-file's LAST
  148.         entry. Does NOT require ANY keystroke.
  149.  
  150.   FDRN INBOUND /PA /ALL
  151.  
  152.         same as above, but patches ALL entries!
  153.  
  154.   FDRN INBOUND /PA /ALL /NLC
  155.  
  156.         same as above, but will NOT patch the lastcaller-infofile
  157.         LAST<task>.FD/IM.
  158.  
  159.   FDRN OUTBOUND /PA /ALL /NLC
  160.  
  161.         same as above, but patches OUTBOUND history file.
  162.  
  163.   FDRN INBOUND /PATCH /NOBOSS     (or FDRN INBOUND /PA /NOB)
  164.  
  165.         paths last inbound history entry. If the entry could not be found
  166.         AND it is a point entry, FDRN will by default look for the bossnode
  167.         and insert "Point of: <boss>" in the historyfile. With /NOBOSS,
  168.         FDRN will add "[UNL] " in front of the systemname.
  169.  
  170.   FDRN INB | LIST /S
  171.  
  172.         reads inbound-history file and redirects output to LIST.
  173.  
  174.   FDRN INB /TASK=3>in3.txt
  175.  
  176.         reads inbound-history from line #3 and redirects output to IN3.TXT.
  177.  
  178.   FDRN INB /REPORT=2:241/1090.4 /TASK=2
  179.  
  180.        creates an inbound-report for my .4 and line 2. See a bit later in
  181.        this document where FDRN will write this stuff to ... .
  182.  
  183.   > Note: if you are using the parameter /PATCH (which may be abbreviated up
  184.           to /PA) in conjunction with INBOUND or OUTBOUND, NO keyboard input
  185.           will be required. You may use this for your import- and/or export
  186.           batchfiles to ever patch FD's history files after every inbound
  187.           and/or outbound call!
  188.  
  189.   While in HISTORY-MODE, there are several keys available. (e.g. patch
  190.   entries, pop up a list, goto entry directly, switch from inbound to
  191.   outbound-mode and vice versa, switch to line-number ... and so on.)
  192.  
  193.   For available keys in interactive history-browsing mode press F1 on the
  194.   mainscreen! Some of them must be explained, though ...:
  195.  
  196.   TEMPFILE: while in LIST-MODE (TAB) you can tag some entries and write
  197.             them to a temporary .HIS - file (OUTBFDRN/INBFDRN.HIS).
  198.             This is only intended to have some kind of "storage" or just
  199.             to have a better overview ... . To do so, press W (one
  200.             entry), ALT-W (all tagged entries) or CTRL-W (all entries).
  201.             The TEMPFILE itself can be loaded when NOT in LIST-MODE by
  202.             pressing T. The D-key deletes the TEMPFILE.
  203.  
  204.             Example:
  205.  
  206.             - switch to line 1 ("1" or "0")
  207.             - switch to list-mode (TAB)
  208.             - tag all entries "2:241/1090"
  209.             - press ALT-W
  210.             - press Tab (back to normal HISTORY-MODE)
  211.             - switch to line 2 ("2" or "0")
  212.             - switch to list-mode (TAGs are already active)
  213.             - press ALT-W again
  214.             - press Tab (back to normal HISTORY-MODE)
  215.             - press T to select TEMPFILE
  216.  
  217.             Now you can see the TEMPFILE with all entries for 2:241/1090
  218.             on line 1 and 2. To delete the TEMPFILE, switch back to
  219.             normal INBOUND (or OUTBOUND)-HISTORY-MODE and press D.
  220.  
  221.  
  222.   REPORT:   while in LIST-MODE you can write one entry (E), all entries
  223.             (ALT-E) or all tagged entries (ALT-E as well) to a file
  224.             called FDRN_ASC.TMP, which will always be located in Front-
  225.             Door's directory (the same as the .HIS files!).
  226.  
  227.             If you are using ALT-E, FDRN will write all tagged entries
  228.             (or all, if nothing has been tagged before!) to this file and
  229.             calculate a summary.
  230.  
  231.             This mode can be forced from the commandline by adding the
  232.             parameter /REPORT{=nodenumber/name}. e.g.:
  233.  
  234.             FDRB INBOUND /Report=.4
  235.             FDRB INBOUND /Report=Peter /Task=3
  236.  
  237.             The /Report - parameter causes FDRN to exit immediately after
  238.             creating the report. Note: the FDRN_ASC.TMP file will
  239.             always be appended!
  240.  
  241.  
  242.   LOGFILE-EXCERPT:
  243.  
  244.             In HISTORY mode you may press L (or F3 or CTRL-Return) to
  245.             inspect the logfile for this entry. FDRN will try to find the
  246.             corresponding data. If it was successful, the part of the
  247.             logfile will be shown in colorized mode. While you are
  248.             viewing the logfile, you may write it's contents to a file!
  249.  
  250.             FDRN will ask you whether to overwrite an existing file AND will
  251.             ask you whether you want the pathinformation to be stripped _or_
  252.             to be replaced by *PATH*\! (This string may be overruled by
  253.             setting the DOS environment variable SET FDRN_P=<new_string>)
  254.             This is very useful if you are planning to post the logentry but
  255.             do not want everybody to see your directory-structure... .
  256.  
  257.   When FDRN prompts you for "Username/nodenumber/INBound/OUTbound" , you may
  258.   insert INB (or INBOUND or OUT or OUTBOUND) to enter the HISTORY MODE.
  259.  
  260.   If you have any trouble with the automatically detection of redirection,
  261.   you may use the parameter /NOREDIR or set the environmentvariable SET
  262.   FDRN=NOREDIR to force FDRN to ignore redirections.
  263.  
  264.   ---------------------------------------------------------------------------
  265.  
  266. ■ PARAMETER-SUMMARY
  267.   ═════════════════─────────────────────────────────────────────────────
  268.  
  269.   For HISTORY-MODE:
  270.   -----------------
  271.  
  272.   /Task=x       use this for HISTORY-MODE, if you are running FDRN from a
  273.                 workstation that has no SET TASK= variable defined (or an
  274.                 invalid one).
  275.  
  276.   /Patch        patch real nodelist-data in you historyfile(s)
  277.  
  278.   /All          patch ALL entries (default: only the last one)
  279.  
  280.   /NOBoss       do NOT use BOSS-data for unlisted points (only for the
  281.                 "location"-field), but patch "[UNL]" instead.
  282.  
  283.   /SystemFirst  write the SYSTEM's name first to history files.
  284.                 Default: SYSOP-name.
  285.  
  286.   /NLC          do not patch LASTC<task>.FD
  287.  
  288.   /REPORT=nn    create a report for nn (number or name)
  289.                 Cannot be used together with /Patch!
  290.  
  291.   /Hot=<mins>   Specify the age in minutes for an entry to be shown as
  292.                 "hot" entry. This does only effect the color on screen.
  293.                 The default value is 20. This means: in HISTORY-mode every
  294.                 entry younger than 20 minutes will be shown with a different
  295.                 color (only for the first line on screen, but it's useful,
  296.                 believe me :-)
  297.  
  298.  
  299.   GENERAL:
  300.   --------
  301.  
  302.   /28           start in 28-row mode.
  303.   /33           start in 33-row mode.
  304.   /50           start in 50-row mode.
  305.   /M            force MONO (b/w) mode.
  306.   /NOColor      do NOT use FDRN.COL, even if it is present.
  307.   /Quiet        don't beep.
  308.   /Auto         do not wait for keystrokes.
  309.   /Routeinfo    show routing-information for found nodes.
  310.   /Nodelist=pp  path to your FD-nodelist. There should be NO need to use
  311.                 this parameter!!!
  312.   /Noredir      ignore output-redirections (in case of trouble)
  313.  
  314.  
  315. ■ ADDITIONAL STUFF
  316.   ═════════════════─────────────────────────────────────────────────────
  317.  
  318.   The following ENVIRONMENT variable is known by FDRN:
  319.  
  320.   - FDRN_P      -> you may choose to replace the pathinformation out of
  321.                    the logfile ("W" in LOGFILE-MODE). The default string
  322.                    for this is "*PATH*\". This can be redefined using
  323.                    SET FDRN_P=<new_string> from DOS!
  324.  
  325.  
  326.   ---------------------------------------------------------------------------
  327.  
  328. ■ LAST STUFF
  329.   ══════════────────────────────────────────────────────────────────────
  330.  
  331. ∙ FDRN has been developed using Borland Pascal 7.01, Turbo Assembler 3.2,
  332.   TSE 2.0 (the really best editor around!), coffee, beer, Drum ... and the
  333.   patience of Sally ... <g>
  334.  
  335. ∙ FDRN should be fully DesqView-aware and release timeslices if it's idle.
  336.  
  337. ∙ If present either in the current or in the homedirectory of FDRN, the file
  338.   FDRN.COL will be read. You may define your own colors here. For an example
  339.   see (and edit) the file COL_EXAM.PLE. The first 20 lines that are beginning
  340.   with a valid numeric value will be read as color-definitions. Others are
  341.   simply ignored.
  342.  
  343. ∙ There are no restrictions in the unregistered version. The only difference
  344.   is an annoying window which reminds you from time to time to think about
  345.   registering. This window will not disturb you more than 4 times ;-))
  346.  
  347.   ---------------------------------------------------------------------------
  348. ■ The following product names are copyrighted materials, trademarks
  349.   or registered trademarks of their respective holders:
  350.  
  351.   FidoNet             Tom Jennings and Fido Software
  352.   FrontDoor           Joaquim Homrighausen, Absolute Solutions
  353.   Intermail           Scandinavian PC Systems AB & InterZone Software, Inc.
  354.   MS-DOS              Microsoft Corporation
  355.   IBM, PC-DOS         International Business Machines Corp.
  356.   Turbo-Pascal        Borland International, INC.
  357.   TSE                 SemWare Corporation
  358.   DesqView            Quarterdeck Office Systems
  359.   ---------------------------------------------------------------------------
  360.  
  361.   I hope you enjoy this little program ... .
  362.  
  363.   If so, please consider registering with me.
  364.  
  365.   Greetings, $P
  366.  
  367.   Vechta, Sun., Dec. 25. 1994 01:11
  368.  
  369. [EOF]
  370.