GETNODE Version 4.00


      Program and Documentation are Copyright (c) 1991 by Dick Lee.
                         All Rights Reserved.


Disclaimer:
----------

   GETNODE is supplied as-is.  The author hereby  disclaims all warranties,
expressed or  implied,  including, without  limitation, the  warranties  of
merchantability and of fitness for any purpose.  The author also assumes no
liability for  damages, direct or consequential, which may result  from the
use of this program.

                                 * * *

   GETNODE is a program that will  display the  node (station) address of a
ARCNET card.  GETNODE does not rely on the I/O address  of the ARCNET card.
GETNODE also does not  rely on what interrupt number is used for the ARCNET
card.  What GETNODE does  require is the memory address segment  setting of
the ARCNET card being tested.

  This program  does not  require any network software  to be loaded onto a
workstation and is therefore network independent.

   The following, are some of the  ARCNET cards that GETNODE has been  used
successfully on:

    1. Aquila AQ-PCA 108/208/308
    2. Corman CorNet ARCNET card
    3. Puredata PDI507/PDI508
    4. Puredata PDI516/PDI516T
    5. Standard Microsystems Corporation PC130/PC130E/PC270E
    6. Thomas-Conrad Corporation ARC-Card TC6142 Rev. DR6
    7. Tiara Computer Systems, Inc. LanCard A-286


Syntax:
------

   GETNODE [ [/A{addr}] [/B] [/E] [/H] [/I{addr}] | [/?] ]

where

/A{addr}   is the  memory address segment of  the ARCNET card.  If the '/A'
           option is specified, {addr} must be  a valid 4 digit HEX number.
           The use of this  option is optional.  If you do not  supply this
           option, the  default  memory address  segment of  D000h  will be
           used.

/B         indicates batch mode.  If this option is used, none of GETNODE's
           screens will be displayed.  The node address is simply displayed
           on the screen.

/E         will save  the node  (station) address of  the ARCNET  card in a
           master environment variable  called NODE.  The address  is saved
           as a decimal number.  By default, the node address  is NOT saved
           in a  master environment  variable.  If GETNODE  cannot  get the
           node address, and this option is used, NODE is set to 0.

/H         will convert  the node address  to a  hexadecimal  number.  This
           option is used in conjunction with either the '/E' option or the
           'B' option.

/I{addr}   is the I/O address  of the  ARCNET card.  This option  will only
           be used  by GETNODE, if GETNODE  cannot get the  node address of
           the ARCNET  card; othwerwise, GETNODE  will ignore  this option.
           GETNODE will  attempt to  reset the  ARCNET card  using the  I/O
           address supplied, if it cannot return the node address using its
           normal method.  If the '/I' option is  specified, {addr} must be
           a valid  3 digit HEX number.  GETNODE also maintains an internal
           list of valid  I/O  addresses  for  ARCNET cards.  An example of
           this  option would  be '/I300'.  The '/I' option is optional for
           interactive use.  If you have specified the '/B' option you must
           also specify  the '/I' option if you  wish GETNODE to attempt to
           reset the  ARCNET card  from batch mode; the reason  for this is
           explained below.  If you do  not specify  this '/I' option, from
           interactive mode, you will be prompted for an I/O address.

           WARNING: Resetting of the ARCNET card, while the  workstation is
           -------  connected to  a network, will  cause the  connection to
                    drop and may cause  the network software loaded  on the
                    workstation to  become corrupted.  Therefore, it is not
                    advisable that you use  this option if you wish to keep
                    the workstation connected to a network.

/?         this will display the list of valid options for GETNODE.


Examples:
--------

   GETNODE
   GETNODE /B
   GETNODE /Ae000
   GETNODE /Ae000/I300
   GETNODE /B/H/E
   GETNODE /E/Ae000/H
   GETNODE /?


History:
-------

26/05/90 - Version 1.01
              - Original program release.
27/06/90 - Version 2.00
              - Modification to allow the user to supply the memory address
                segment of the ARCNET card in HEX.
15/09/90 - Version 2.01
              - Changed the  address segment  parameter from  5 digits to 4
                digits to avoid confusion. ie. D000 instead of D0000
23/10/90 - Version 2.02
              - Added display of node address in hexadecimal and in binary.
              - Cosmetic change of screen.
16/02/91 - Version 3.00
              - Allow the  option of  resetting the  ARCNET card.  The user
                is asked to supply the I/O address of the ARCNET card.
              - List of  ARCNET cards (in this file) that GETNODE  has been
                successfully used on.
12/03/91 - Version 3.01
              - Display the I/O address of the card (when applicable).
              - Cosmetic change of screen.
16/03/91 - Version 3.01a
              - Change to copyright notice.
24/03/91 - Version 3.02
              - Fixed a problem  where the attempt of  resetting the ARCNET
                card would fail.
03/04/91 - Version 4.00
              - Added a simple command line parser.
              - Batch mode.
              - Node (station) address can now  be saved as  an environment
                variable (in the master environment.)


   Thanks go  to Walt  Thirion, of  the Thomas-Conrad  Corporation, for his
help in explaining how I would go about getting the ARCNET address.  Thanks
also go to all the people who have made  comments and suggestions regarding
GETNODE and its features.

   Although this program  has been placed  into the  public domain, GETNODE
carries a copyright notice.  I reserve  all rights to this program; however
GETNODE may be used, and distributed, freely.  In other words, this program
is FREEWARE.  The only request I have  of anyone that uses this program, is
that  they  send me,  via CompuServe  EasyPlex (E-Mail),  the name  any new
ARCNET card that this program  has been successfully executed on.  Although
GETNODE should  work successfully with  all ARCNET cards, I would just like
to be able to add the name of the ARCNET card to my documentation.

   If you  have  any  comments, questions,  or suggestions,  please do  not
hesitate in contacting me  via CompuServe.  My CompuServe userid  is listed
below.

                                          Dick Lee
                                          CIS: [72717,1603]

   GETNODE  was  written  and  compiled  using  Turbo  Pascal  Version 5.5,
Copyright (c) 1984, 1989 Borland International, Incorporated.

   CompuServe is a registered mark of CompuServe Incorporated, an H&R Block
Company.

   EasyPlex is a service mark of CompuServe Incorporated.
