home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / comm1 / ntm_1113.lzh / NODE-TM.DOC < prev    next >
Text File  |  1990-09-17  |  17KB  |  419 lines

  1.  
  2.  
  3.     N O D E - T M                             ██████████▄
  4.                                               ███░░░░░░██░            ▓▓▓▓▓
  5.     Version 1.113                             ███░   ▓▓██░             ▓▓▓░░
  6.                                               ██████████░▓░           ▓▓▓░░
  7.     Copyright (c) 1990                        ███░░░░░░██░▓░  ▓▓▓▓░  ▓▓▓░░
  8.     by Daniel Pun                             ███░      ██░▓░▓▓░▓▓▓░▓▓▓░░
  9.     (1:153/743.0) Boogie Woogie               ███░     ███░▓▓▓▓░░▓▓▓▓▓░░
  10.     Daisy Information Gateway                 ███████████░░▓▓▓░░  ▓▓▓░░
  11.     All rights reserved.                       ░░░░░░░░░░░  ░░░    ░░░
  12.  
  13.  
  14.  
  15.                               NODE-TM v1.113
  16.                            Written by Daniel Pun
  17.  
  18.  
  19.  
  20.                           With Special thanks to :
  21.  
  22.            Kenny Tse (3:700/128.0) who gave the idea of NODE-TM.
  23.     Ken Watson (1:153/728.0) who corrected my English grammer and mistake
  24.             on the first release document and registration form.
  25.    My girl friend Kennie Kam who gave great support to me on writing this
  26.                               NODE-TM program.
  27.  
  28.  
  29.                                    A N D
  30.  
  31.                Thank _YOU_ for using this NODE-TM and probably
  32.               supporting me by registering your copy of NODE-TM.
  33.  
  34.  
  35.                 ---------------------------------------------
  36.  
  37. FILES INCLUDED :
  38.  
  39.    There should be 5 (five) files included in the distribution archive
  40.    which is as follow:
  41.  
  42.     NODE-TM.EXE   - The NODE-TM main program
  43.     NODE-TM.DOC   - The document of NODE-TM (the one that you're reading now)
  44.     REGISTER.FRM  - Registration form of NODE-TM
  45.     TMFON.TXT     - Example file of TM.FON file (Telemate phone directory file)
  46.     TOLLFREE.NTM  - Example file of TOLLFREE.NTM (TollFree Calling file)
  47.  
  48.  
  49.    We are using the VALIDATE 0.3 program from McAfee Association with the
  50.    checksum of NODE-TM.EXE as follow:
  51.  
  52.                 File Name:  NODE-TM.EXE
  53.                      Size:  22,086
  54.                      Date:  9-14-1990
  55.  
  56.      File Authentication:
  57.            Check Method 1 - D129
  58.            Check Method 2 - 1AF9
  59.  
  60.  
  61.                 ---------------------------------------------
  62.  
  63.  
  64. DESCRIPTION :
  65.  
  66.    Changes the IFNA Nodelist to a Telemate v2.11 phone directory file,
  67.    with extra functions to strip out toll call phone numbers and keeping
  68.    the old data from the old Telemate phone directory file.
  69.  
  70.  
  71.                 ---------------------------------------------
  72.  
  73. WARRANTY :
  74.  
  75.    Daniel Pun makes no warranty of any kind, express or implied.  There is
  76.    no guarantee or warranty of merchantability and/or fitness for a
  77.    particular purpose.  Daniel Pun shall not be liable for any damages,
  78.    whether direct, indirect, special or consequential arising from a
  79.    failure of this program to operate in the manner expected by the user.
  80.    Daniel Pun shall not be liable for any damage to data or property which
  81.    may be caused directly or indirectly by use of the program, even if he
  82.    has been informed of the possibility of such damage.
  83.  
  84.    IN NO EVENT WILL DANIEL PUN BE LIABLE TO YOU FOR  ANY DAMAGES, INCLUDING
  85.    ANY  LOST  PROFITS, LOST  SAVINGS, LOST  DATA  OR  OTHER  INCIDENTAL  OR
  86.    CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OF OR INABILITY TO USE THE
  87.    PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.  RUN WHAT YOU WISH AND LET
  88.    THE DEVIL TAKE THE HINDMOST. IF IT BREAKS YOU OWN BOTH PARTS.
  89.  
  90.  
  91.                 ---------------------------------------------
  92.  
  93. WHAT'S NEW :
  94.  
  95.   This would be probably what you want to know if you're currently using
  96.   NODE-TM, right ?
  97.  
  98.        o  Full color screen support. NODE-TM is now using full screen
  99.           window like editing menus and it is much colorful than the
  100.           previous version. (If you have a color monitor B-)  )
  101.  
  102.        o  No more assuming. All data and controls in TM.FON are now
  103.           configurable.
  104.  
  105.        o  Able to accept Configuration file. You can now run NODE-TM
  106.           in unattended mode. Especially for sysop in their daily
  107.           mid-night batch file.
  108.  
  109.        o  Restore the last call date and total call for _EACH_ bbs.
  110.           In previous version, NODE-TM will clear the last call date
  111.           and total call on each bbs, but now you can keep your record
  112.           clean and tidy.
  113.  
  114.        o  Exit errorlevel added. If there are any problem occur during
  115.           the operation of NODE-TM, while it exit back to DOS, it will
  116.           also give an errorlevel, much easy to handle in batch file.
  117.  
  118.        o  If your old Telemate phone directory contains some self-entered
  119.           BBSes, which is most probably doesn't exist in the IFNA Nodelist,
  120.           NODE-TM will now move them to the new TM.FON file. So, you can
  121.           keep some private BBSes number in your TM.FON now.
  122.  
  123.        o  Support Hercules to VGA Color display
  124.  
  125.                 ---------------------------------------------
  126.  
  127. SYSTEM REQUIREMENT:
  128.  
  129.  
  130.        o  IBM compatible computer
  131.        o  At least 256K system RAM
  132.        o  A copy of IFNA Nodelist
  133.        o  Hard Drive is suggested. I have not tested it on a floppy drive.
  134.  
  135.  
  136.                 ---------------------------------------------
  137.  
  138.  
  139. GETTING START :
  140.  
  141.   This program was written to support Telemate v2.11 which I am using now.
  142.   For other versions, I am not sure if the phone directory data is the
  143.   same or not.  If you are using Telemate with a version number below or
  144.   higher than v2.11, you can do 4 things with this NODE-TM program:
  145.  
  146.      1.  Find an updated version of Telemate from your favourite BBS or buy
  147.          a registered copy from the author of Telemate.
  148.  
  149.      2.  Use this program at your _OWN_ risk.  Remember, I make no guaran-
  150.          tee that this program will work on any other version of Telemate.
  151.  
  152.      3.  Find the suitable NODE-TM to suit your version of Telemate.
  153.          Unfortunately, the newest version of Telemate I got here is v2.11
  154.          and all I can do is supporting this v2.11 version.
  155.  
  156.      4.  Forget about this NODE-TM program: you'll have to type the phone
  157.          directory by yourself.  Too bad, I am sorry about that.
  158.  
  159.  
  160.   You must place NODE-TM in your Telemate sub-directory in order for it to
  161.   locate the files it needs, create its files in the correct place, and also
  162.   to make it work properly.
  163.  
  164.   If you had some `Self-Entered' BBSes entry in your TM.FON (Telemate Phone
  165.   Directory file), you need to place them at the end of the TM.FON with a
  166.   blank entry line in order to seperate the one that you'd enter from the
  167.   BBSes that was included in the Nodelist. For further `Self-Entered' BBSes
  168.   entry problem, please refer to the file TMFON.TXT.
  169.  
  170.   For your own safety, make a backup of your TM.FON and TM.MEM first before
  171.   starting up this program.  NODE-TM will overwrite your old TM.FON and TM.MEM
  172.   files !
  173.  
  174.   Although NODE-TM will create the phone directory, you may also want to edit
  175.   it to suit your needs. For example, the password of each board and Logon
  176.   script for each board, etc...
  177.  
  178.  
  179.                 ---------------------------------------------
  180.  
  181.  
  182. BRIEF ON THE USAGE OF NODE-TM:
  183.  
  184.   If you have a Hercules, Black and White or any monitor that NODE-TM
  185.   doesn't has its color display correctly, try to call up NODE-TM with
  186.   an option : NC - means no color, like this :
  187.  
  188.       C>NODE-TM NC
  189.  
  190.   If you had used Telemate v2.11 already, you will be familiar with the
  191.   configuration manual. Almost 80% of the configuration part is the same
  192.   as Telemate v2.11 except it will ask you for the directory where you
  193.   put your IFNA Nodelist, your country code and the internaional dialing
  194.   prefix of your country.
  195.  
  196.   In case you're lost or you need help, press F1 to get a small help
  197.   screen and press F1 to hide it back.
  198.  
  199.   After you had finished the configuration, it will re-display the
  200.   data/information that you have selected and ask whether you want to
  201.   proceed or not. Select OK to continue, EDIT to re-edit or QUIT to quit
  202.   NODE-TM program.
  203.  
  204.   It is almost automatic on processing the new Telemate phone directory
  205.   and you need not to worry about what the out come will be.
  206.  
  207.  
  208.  
  209. CONFIGURATION :
  210.  
  211.   Once you had finished the configuration, NODE-TM will create a file -
  212.   NODE-TM.CFG, which is the configuration file so it let you able to run
  213.   NODE-TM in unattended mode.
  214.  
  215.   This function is available for registered user only, if yours isn't a
  216.   registered copy, it will ask you to go through the configuration menu
  217.   every time you start NODE-TM.
  218.  
  219.   Sorry, convenience is alway provided to user who support us.
  220.  
  221.  
  222.  
  223. TOLL FREE OPTION:
  224.  
  225.   During NODE-TM's processes, you may find that there is a Toll Free Call
  226.   Option on the top of the window : this is the function that will strip
  227.   out toll call phone numbers to ensure that the phone numbers contained
  228.   in the Telemate phone directory are 100% toll free.
  229.  
  230.   In order to turn this option on, you need to do 2 things.
  231.  
  232.      1. Create a plain text file named TOLLFREE.NTM using any straight text
  233.         file editor and put it in your Telemate sub-directory together with
  234.         NODE-TM
  235.  
  236.         The content of this TOLLFREE.NTM file is the phone exchanges that
  237.         are _TOLL FREE_ to your district.
  238.  
  239.         Example 1 : I am living in Vancouver B.C., and the nearby suburb
  240.                     of Mission is a TOLL CALL from here.  Its phone
  241.                     number is 820-0000, so I _WON'T_ enter 820 into the
  242.                     list.
  243.  
  244.         Example 2 : Port Coquitlam is TOLL FREE from here, and there is
  245.                     a phone number 464-0000, so I WILL enter the phone
  246.                     prefix 464 into this file.
  247.  
  248.         An example TOLLFREE.NTM is included in this archive so that you can
  249.         see how it's done.
  250.  
  251.    ( To remember easily, the .NTM file extension stands for (N)ode-(T)(M). )
  252.  
  253.      2. The other thing you need to do is register your copy in order to make
  254.         this function workable. Even though you have created the file, if
  255.         yours isn't a registered copy, this function won't work and if you
  256.         had created a TOLLFREE.NTM in the same directory where NODE-TM is
  257.         placed, NODE-TM will attempt to reset the TOLLFREE.NTM, which is by
  258.         mean of erasing it.
  259.  
  260.         For registration, please refer to the section HOW TO REGISTER YOUR
  261.         COPY below.
  262.  
  263.   If your country doesn't have Toll Call phone prefixes, you would not need
  264.   to set up this file, athough you can make a blank file. B-)
  265.  
  266.   After NODE-TM has finished its work, you will notice how many Bulletin Board
  267.   Systems are available to you around town, and how many boards have been
  268.   stripped.
  269.  
  270.  
  271.  
  272. EXIT ERRORLEVELS:
  273.  
  274.   For easy error handling, I had included errorlevels when NODE-TM exit.
  275.  
  276.          Errorlevel 3 : Can't Locate <nodelist>
  277.                     2 : Nodelist doesn't have a HOST number
  278.                     1 : Nodelist too large, Telemate can only accept 1000 BBSes
  279.                     0 : No errors, new TM.FON and TM.MEM processed.
  280.  
  281.   where <nodelist> is the FileSpec for the IFNA Nodelist file.
  282.  
  283.  
  284.  
  285. ERROR and ANSWER:
  286.  
  287.   If you occur error(s) during NODE-TM process, the following may be helpful :
  288.  
  289.      Error :  Nodelist too large, Telemate can only accept 1000 BBSes.
  290.     Answer :  You have probably told NODE-TM to process a Full Nodelist. Heh,
  291.               don't you know that Telemate can only handle up to 1000 phone
  292.               entries ?  No problem. I got some solution for that.
  293.               Either you use some other program to optimize the nodelist,
  294.               for example, extract out the Net which you are in and are local
  295.               to you, OR using the Toll Free function provided by NODE-TM.
  296.               If you have a lots of self-entered BBSes in your Telemate
  297.               phone directory, you may also want to delete some of them which
  298.               you probably won't call, so as to give more limit to the entries
  299.               from the Nodelist.
  300.  
  301.      Error :  Nodelist doesn't have a HOST number.
  302.     Answer :  Your Nodelist doesn't have HOST number, thus it makes NODE-TM
  303.               unable to complete the Nodelist analyzing process. You better
  304.               check your Nodelist and see why there isn't a HOST node present
  305.               or you try to get a updated Nodelist from somewhere.
  306.  
  307.      Error :  Can't locate <nodelist>
  308.     Answer :  You had told NODE-TM to process a Nodelist that doesn't exist
  309.               in the drive/path that you had stated in the configuration
  310.               file or during your configuration. To solve this problem,
  311.               either you load up a text editor program to change the
  312.               NODE-TM.CFG file (if you know what is stated in the file) OR
  313.               you first erase the NODE-TM.CFG file and run NODE-TM again to
  314.               go through the configuration menu again. Most probably you had
  315.               told NODE-TM to process a Nodelist on the first time and then
  316.               you had erased that Nodelist.  If you want to run NODE-TM in
  317.               unattended mode, I suggest you to rename the new Nodelist that
  318.               come out every week to a standard file name, say NODELIST.NEW
  319.               and tell NODE-TM to look for the NODELIST.NEW every time.
  320.  
  321.  
  322.                 ---------------------------------------------
  323.  
  324. EFFICIENCY:
  325.  
  326.   In order to get the shortest and fastest running time of NODE-TM, you
  327.   should consider the following :
  328.  
  329.       -  The larger old TM.FON and TM.MEM you have, the longer it
  330.          takes to compile.
  331.  
  332.       -  The larger IFNA Nodelist is, the longer it takes to compile.
  333.  
  334.       -  The larger TOLLFREE.NTM file is, the longer it takes to compile.
  335.  
  336.       -  Have the configuration setted perfectly.
  337.  
  338.       -  The slower Hard Disk you have, the longer it takes to compile.
  339.  
  340.   As a conclusion to above, if you want to process the Nodelist as fast
  341.   as it could using NODE-TM, you need to :
  342.  
  343.       i) Optimize your old Telemate phone directory. Delete those Self-Entered
  344.          BBSes that you probably won't call them in the rest of your life.
  345.  
  346.      ii) Use a Nodelist extractor program to extract out the local Net from
  347.          the IFNA Nodelist first before running NODE-TM.
  348.  
  349.     iii) Register your copy and use the Toll Free option and have the
  350.          configuration file ready.
  351.  
  352.      iv) Buy a faster Hard Drive... B-)
  353.  
  354.  
  355.                 ---------------------------------------------
  356.  
  357.  
  358. BUG REPORTS:
  359.  
  360.   If you encounter a situation where NODE-TM fails to perform the correct
  361.   phone directory listing or gives you a wierd result that you aren't
  362.   expecting, please compress the Nodelist which you are using and all NODE-TM
  363.   related files using LHARC, PKZIP, ZOO, ARC (any flavor) or PAK and sent
  364.   it to me along with a complete description of your system including your
  365.   equipment list and the names of ALL memory resident programs in use at the
  366.   time of failure, and as complete an account of the failure as you can provide.
  367.  
  368.   I can be reached via Netmail to Daniel Pun at 1:153/743.0 Boogie Woogie.
  369.  
  370.                 ---------------------------------------------
  371.  
  372. HOW TO REGISTER YOUR COPY
  373.  
  374.  
  375.   This program is released as Shareware. You can distribute it and make
  376.   as many FREE copies as you like.  If, after a trial period, you find
  377.   the program useful, you should register your copy of NODE-TM.  To do
  378.   that, you need to fill in and mail the registration order form included
  379.   in this archive, with your Money order or cheque in the amount of
  380.   CA$15.00 or US$12.50; plus CA$2.50 or US$1.50 for shipping if you are
  381.   not a sysop. If you are a sysop, and you can not reach me by Netmail,
  382.   please also add in the shipping fees.
  383.   ( Shipping fees include a 360K diskette with all registered NODE-TM-
  384.   related files on it. )  Register key and related files will be sent out
  385.   to you using Netmail file attaches, or Snail mail if you have paid the
  386.   shipping fees.
  387.  
  388.   Please support the Shareware concept by registrating your shareware copy.
  389.  
  390.   Thank You for using NODE-TM.
  391.   Daniel Pun  1:153/743.0 Boogie Woogie
  392.    - Distribution site for the Powerful Apple BBS - Daisy !
  393.  
  394.  
  395.                 ---------------------------------------------
  396.  
  397. Release information :
  398.  
  399.         v1.113   :  Support Hercules to VGA color display
  400.  
  401.         v1.112   :  Source Code rewritten.
  402.                     Added window-like display.
  403.                     No more assuming, all data are configurable.
  404.                     Accept self-entered BBS entry.
  405.                     Able to restore old TM.FON's last call date and total call.
  406.                     Added configuration file.
  407.                     Added EXIT errorlevels.
  408.  
  409.         v1.020   :  Bug fixed version of v1.010. Added Toll Free Call option,
  410.                     Ignored Hub flag in the nodelist and added HOST to have
  411.                     separate Net information.
  412.  
  413.         v1.010   :  Bug fixed version.  Added baud rate to configuration
  414.                     section. Ignored Zone, Region, PVT, and Down flags.
  415.  
  416.         v1.000   :  First version of Node-TM, with lots of bugs jumping up
  417.                     and down on the screen.
  418.  
  419.