Index of /netwaresl/ADMIN/NODINF

      Name                    Last modified       Size  Description

[DIR] Parent Directory 23-Apr-2005 03:11 - [   ] NODEINFO.EXE 20-Feb-1994 07:15 93k [TXT] NODEINFO.HLP 19-Feb-1994 11:19 20k [TXT] ORDER.FRM 19-Feb-1994 07:47 2k


NodeInfo v1.2x
--------------
The following notes are specific to the NodeInfo utility (NODEINFO.EXE)
developed by Avanti Technology, Inc.


STATEMENT OF TITLE AND WARRANTY
-------------------------------
NodeInfo (the Software) was developed by and is the property of Avanti
Technology, Inc., of 13492 Research Boulevard, Suite 120-271, Austin,
Texas 78750 USA (Avanti).  All rights are reserved worldwide under both
Federal and International Copyright Laws.  No distribution or use of the
Software in any form relinquishes Avanti's claim to ownership and title
of the Software and concept.

Avanti warrants that the Software, when used as intended, is free from
known defects at the time it was distributed.  Should a defect become
evident, a detailed report of the conflict or anomaly should be provided
to Avanti.  Upon confirmation of the report, Avanti will endeavor to
correct the problem and make the correction available to registered users.
If a registered user encounters a defect within the initial ninety (90)
days following original receipt of the software which Avanti is unable to
rectify, the software may, at Avanti's sole discretion, be replaced or
arrangements made for a refund of the license fee.

Avanti shall not be required to insure the compatibility of the Software
with future revisions to the workstation or network operating system, nor
the hardware on which it may be installed.  Nevertheless, Avanti reserves
the right to enhance, update, or change the Software in ways which may
alter its specification, operation, performance, and/or support levels.
However, such a modification does not obligate Avanti to continue doing
so.  Registered users of the Software may be eligible for such revisions
provided they adhere to the terms of the Software License Agreement
accompanying the Software.


NOTICE OF DISCLAIMER
--------------------
AVANTI TECHNOLOGY, INC. SPECIFICALLY DISCLAIMS ALL OTHER WARRANTIES
IMPLIED OR EXPRESSED, INCLUDING BUT NOT LIMITED TO, IMPLIED WARRANTIES
OF MERCHANTABILITY AND ANY IMPLIED OR EXPRESSED WARRANTY FOR PARTICULAR
USE.  IN NO EVENT SHALL AVANTI TECHNOLOGY, INC. BE LIABLE FOR ANY LOSS
WHICH IS GREATER THAN THE LICENSE FEE PAID BY THE REGISTERED USER.
AVANTI TECHNOLOGY, INC. SHALL NOT BE LIABLE UNDER ANY CIRCUMSTANCES FOR
DIRECT, INDIRECT, OR SPECIAL DAMAGES RESULTING FROM THE USE OF THE
SOFTWARE (some of these exclusions may not apply in some states).


Overview:
---------
	NodeInfo is a utility designed to help manage users and
	files on NetWare v2.1x, v2.2, v3.1x, and v4.0x servers,
	including 500 and 1000 user versions of NetWare.  As a
	client utility, it provides a visual map showing the
	number of active connections, logged in users, and open
	file activity.  It can be used to identify connections
	where users are logged in, find a connection by its node
	ID, locate connections accessing a specific file, check
	record locks against a file, send messages to individual
	or groups of connections, and to clear individual or
	groups of connections.

	It can also be used as a batch utility to identify, alert,
	and clear connections prior to performing critical tasks.

	(Note: NetWare v4.0x support requires Bindery emulation.)


Usage:
------
	Copy the NodeInfo files from the distribution media to
	any destination directory.  While users can run NodeInfo,
	clearing connections requires SUPERVISOR rights and most
	file access information requires File Server Console
	Operator status (granted through the Supervisor Options
	in SYSCON).  Attempts to perform tasks in excess of the
	user permissions will be trapped and the user informed.

	Note:	Upon registering a licensed copy of the software, 
		a bonus NLM (NODEINFO.NLM) will be provided which
		can be configured to grant users temporary Console
		Operator status to users while in NodeInfo under
		NetWare v3.1x/v4.0x.  This temporary status grants
		them the ability to view who has files open but
		not the ability to clear connections.  The licensed
		version of the software also allows the visual map
		update frequency to be selected from among 15, 30,
		and 60 second intervals (default is 30 seconds).

		Both of these features are configured through the
		CONFIG or RECONFIG command line options.  However,
		the granting of temporary FS Console Operator status
		only works when the NODEINFO NLM is loaded on the
		NetWare v3.1x/v4.0x server in use.


	The following command line options may be specified:

	  SET | MARK		- mark all active connections
	  RESET | UNMARK	- unmark any previously marked connections

	  F=[sys:path\file.ext]	- mark connections with specified file open
				  (vol:path\file.ext specification required -
				   wildcards allowed in file.ext)
	  G=[group]		- mark all connections for [group] members
	  -G=[group]		- unmark all connections for [group] members
				  (exact [group] name required)
	  N=[node] 		- mark connection for the specified node ID
	  -N=[node] 		- unmark connection for the specified node ID
				  (right justified exact match of node ID)
	  U=[user]		- mark all connections for specified user
	  -U=[user]		- unmark all connections for specified user
				  (left-based match of logged-in/marked users)

	  M="message"		- send message to marked connections
				  (maximum message length = 55 chars.)
	  CLR|CLEAR|DEL|DELETE	- terminate marked connections
				  (except program's connection - without
				   prompts, requires SUPERVISOR equiv.)
	  LIST			- display all marked connections
				  (useful for reports or action verification)

	  P=#####		- pause the specified number of seconds
	  R=#####		- repeat previous commands for a total
				  of the specified number of iterations

	  STATS			- displayed counts for Logged In, Logged Out,
				  Marked, and Inactive connections
	  BAT | BATCH		- process options as batch commands
				  (processed without operator intervention)

	The command line options can be combined.  However, they are
	processed in the order specified so any action (CLEAR or M=)
	or exclusion (-U=) options should be specified last.  The results
	of any actions or exclusions are displayed on the screen in a
	manner which allows them to be redirected (i.e., append '> filename'
	to the command line).

	Note that unless BAT or BATCH is specified, the program will
	merely pre-process the options and load in a manner requiring
	operator intervention (i.e., full screen display).  Use the
	BAT or BATCH options for batch file processing.

	Command line option examples:

	    F=SYS:MAIL\MAIL.DAT U=GUE M="Please logout!" BAT

	    Mark all connections which have SYS:MAIL\MAIL.DAT open or
	    are logged in under a user name beginning with GUE and
	    send them the message "Please logout!".  Process the
	    options as batch commands (i.e., terminate the program
	    once processed).

	    G=E_MAIL -U=MAIL_ADMIN M="Logout NOW!" P=60 RESET R=5 DEL BAT

	    Mark all connections where the logged in user is a member
	    of the GROUP E_MAIL.  Unmark any connections where the USER
	    MAIL_ADMIN is logged in.  Send remaining marked connections
	    the message "Logout NOW!"  Pause 60 seconds, reset any marked
	    connections, and repeat the previous operations for a total
	    of 5 iterations then clear any remaining marked connections.
	    Process the options as batch commands (i.e., terminate the
	    program once all options are processed).

	    F=SYS:MAIL\MAIL.* F:=SYS:MAIL\USR*.* -U=MAIL_ADMIN CLEAR BAT

	    Mark all connections which have SYS:MAIL\MAIL.* or
	    SYS:MAIL\USR*.* open.  Unmark any connections where the USER
	    MAIL_ADMIN is logged in. Terminate the marked connections.
	    Process the options as batch commands (i.e., terminate the
	    program once processed).

	    N=00608C116F2A

	    Mark the connection with the specified node ID.  Load in
	    normal interactive mode with the marked connection flashing
	    on the connection grid.

	    F=SYS:MAIL\*.*

	    Mark all connections which have any files open in the
	    SYS:MAIL\ subdirectory.  Pre-process the options before
	    loading in normal interactive mode.  Marked connections
	    will be flashing on the connection grid.


	In addition to being supported in the Main screen, the '?'
	key can be pressed in the following situations:

	- In the Main screen to show this help information, plus the
	  following areas within the Main screen:
	  - At the Change Servers prompts to provide explanations
	  - At the Find File prompt to show usage examples
	  - At the Find Node prompt to show usage examples
	  - At the Find User prompt to show usage examples
	- In the User Information screen to show file attribute explanations
	- In the Reconfiguration screen for both the Update Interval and
	  the Enable/Disable temporary FS Console Operator status prompts
	- In a help screen to show Technical Support contact information
	- In the Technical Support contact screen to show a NodeInfo overview
	- In the NodeInfo overview screen to show information on ordering

	Pressing Up, Down, PgUp, PgDn, Home, and End will move through those
	help screens with multiple pages.  Escape exits the help subsystem.

	A description of the keys supported in the Main screen follows:

	Cursor Movement: Up, Down, Left, Right, Home, & End
		    Tab: jump to next logged in connection
	      Shift-Tab: jump to previous logged in connection
	     Ctrl-Right: jump to next marked connection
	      Ctrl-Left: jump to previous marked connection
	         PageUp: previous block of nodes (500 & 1000 user NetWare)
	       PageDown: next block of nodes (500 & 1000 user NetWare)

	Enter:	additional user/open file details - Req. Console Operator status
		('?' will provide another help screen for this option)

	Ins:    change to a different file server
		(press Ins a second time to bring up a list of known servers)

	Del:    clear current/marked connections - Requires SUPERVISOR rights
		(if none are marked, only the current connection is cleared)
	Ctrl-Del: clear only the current connection (even if others are marked)

	F1:*	mark conns accessing a file - Requires Console Operator status
		(vol:path\file.ext required - wildcards allowed in file.ext)

	F2:*	locate an active connection by its six byte node ID
		(left-based search - i.e., 00008C116F2A & 8C116F2A are equal)

	F3:*	mark all connections where a specified user is logged in
		(left-based search - i.e., SU & SUPER match SUPERVISOR)

	F4:     send a NetWare message to current/marked connections
		(if none marked, only the current connection is notified)
	Ctrl-F4: send only to the current connection (even if others are marked)

	F5:     toggle (mark/unmark) this connection

	F6:     toggle (mark/unmark) all connections
		(if none marked, mark all - if any marked, clear all)

	   *	[Note: Previously marked connections are not cleared first.]


	The following connection information is shown on the main screen:

		Logged In  (###) - number of logged in connections
		Logged Out (###) - number of logged out connections
		Inactive   (###) - number of unused connection slots

	If the currently positioned connection has any files open on this
	server, a subset of up to 11 actively open file names will appear
  	 left portion of the screen.  If there is a dash (-) before the
	file name, it indicates the file is open in a restricted access mode
	(i.e., limited other users read or write access).  If there is a plus
	(+) before the name, it indicates the file is locked by the connection.

	Example:	 TEMPFILE.001 - Other users may read & write this file
			-TEMPFILE.002 - Other users have restricted access to
					this file - to check the restrictions,
					press Enter to view the full file list
					and defined attributes for each file
			+TEMPFILE.003 - Locked exclusively by the connection


	Only information regarding files residing on the current server is
	shown.  NodeInfo has no way to report on files residing on other
	than the current selected server (i.e., other servers or the local
	workstation drives).


	The following details about the connection number are also shown:

	[login name]:	If a connection logs out while the program is running,
			it saves the name for reference.  Otherwise, logged out,
			as well as inactive, connections show [NOT-LOGGED-IN].

	Node:		net:node address (Note: [N/A, possibly non-PC] is
			usually a Mac and internal NLM connections often
			return invalid net:node addresses)

	Status:		Inactive               - not an active connection
			Normal                 - normal operation
			File Lock Wait         - wait on file lock release
			Logical Rec Lock Wait  - wait on logical lock release
			Physical Rec Lock Wait - wait on physical lock release
			Semaphore Wait         - wait on semaphore lock release

	Type:		01 - User		- normal User connection
			05 - Job Server		- Job Server connection
			07 - Print Server	- Print Server connection
			09 - Archive Server	- Backup/Archive Server conn
			     [various others or UNKNOWN if not recognized]

	Service Requests: Total number of NCP requests made by this node since
			  it attached to the File Server.  This count does not
			  reset when a new User logs in, only if the connection
			  becomes inactive (i.e., once cleared by the watchdog).

	Disk Usage (Kb):  Total KBytes of disk space assigned on the File Server
			  for this User.  This is the cumulative space allocated
			  to all files for which this User is the owner.
			  (Note: This is not available for NetWare v2.1x/v2.2.)

	Read KBytes:	  Total KBytes of file read requests made by this User
			  since logging into the File Server.

	Write KBytes:	  Total KBytes of file write requests made by this User
			  since logging into the File Server.


Licensing:
----------
	Avanti Technology, Inc. offers NodeInfo as a licensed software
	product with continuous right to use so long as the registered
	user remains in adherence to the terms and conditions of the
	Software License Agreement.  NodeInfo is available under two
	licensing methods:

		       Site License at $95.00/Site
				  - or -
	   Corporate/Organization License at $395.00/Organization

	(Note:  Introductory pricing only in effect for the first
		90 days after the initial product release.)

	Under both licensing methods, the user is provided with free
	technical support for the product and free upgrades for the
	first year after registration.  Upgrades after the first
	year are available at the then current fee schedule which
	may vary based upon the licensing method.

	Prices quoted are pre-paid in US Dollars, excluding any
	applicable sales taxes or export duties.  The license
	fee includes software delivery via ground services within
	the continental United States (call for quotes on express
	or non-continental U.S. delivery).  The availability of
	credit terms and invoicing is at the sole discretion of
	Avanti Technology, Inc.


System Requirements:
--------------------
	The NodeInfo NLM requires NetWare v3.11, v3.12, or v4.0x.
	CLIB v3.11 rev D or later is required for the NodeInfo NLM
	(provided to registered users) to run under NetWare v3.11.
	The standard CLIB which ships with NetWare v3.12 or v4.0x
	will support this NLM.

	NetWare v4.0x support requires active Bindery emulation.

	Full NetWare v4.0x support requires File Server Console
	Operator rights (assigned or temporary).  This is due to an
	anomaly in Novell's support for File Server Information NCP
	queries which requires such rights in order to properly ascertain
	the maximum number of active user connections which can be
	supported by the copy of NetWare in use.  Under NetWare
	v2.1x, v2.2, and v3.1x, such information is available to
	any attached workstation.  However, NetWare v4.0x requires
	special access rights to determine this basic, non-security
	related, information.


Technical Support:
------------------
	In order to provide the best and most expedient technical
	support possible, it is requested that the following information
	be known prior to initiating technical support contact:

	Workstation:	DOS, IPX/NETx, or VLM versions, plus free RAM size
	File Server:	NetWare version and CLIB revision (if NetWare v3/v4)

	In addition, the more indepth the problem can be described & isolated
	(including any error message), the greater the chances are for quick
	resolution.  The following means may be used for technical support:

	Mail:		Avanti Technology, Inc.
			13492 Research Boulevard
			Suite 120-271
			Austin, Texas  78750  USA

	Telephone:	(+1)512/335-1168
			08:00 to 16:00 (US Central time zone)

	Facsimile:	(+1)512/335-7838

	CompuServe:	76517,3117


Release Notes for v1.25:
------------------------
      - Added support for the STATS option to display the Logged In,
	Logged Out, Marked, and Inactive connection counts
      - Added support for -G=[group] command line option to unmark/exclude
	connections which are a member of the specified group name
	(Note: The exact [group] name is require, e.g., -G=EVERYONE )
      - Added support for -N=[node] command line option to unmark/exclude
	the connection for the specified node ID
	(Note: The check is a right justified exact match of node ID)
      - Changed the X=[user] command line option (unmark/exclude all
	connections for the specified [user]) to utilize -U=[user]
      - Modified the Open Files list logic so that it does not require
	the allocation of temporary directory handles which sometimes
	failed due to problems with some of Novell's NetWare shells

Release Notes for v1.24:
------------------------
      - Added 'Processing command line options...' message for
	display during BAT | BATCH processing
      -	Added support for Ctrl-Del to CLEAR only the current pointed
	connection (even if other connections are marked)
      -	Added support for Ctrl-F4 to SEND only to the current pointed
	connection (even if other connections are marked)
      - Changed banner display logic so it is not written to the file
	when used in BATCH mode with the output being redirected
      - Corrected a logic problem which could keep a SEND message from
	being sent to an unmarked connection when individually selected
      - Corrected a logic problem which could cause the file Lock test
	to fail (i.e., locked files not properly identified)

Release Notes for v1.23:
------------------------
      - Added support for wildcards (* and ?) in the file.ext portion
	of the vol:path\file.ext file specifications for open file searches
      - Added support for the following command line options and batch
	processing functions ( [] are for example only, "" are required ):
	  SET | MARK		- mark all active connections
	  RESET | UNMARK	- unmark any previously marked connections
	  G=[group]		- mark connections who are members of [group]
	  X=[user]		- exclude (unmark) specified [user] from actions
	  P=#####		- pause processing for ##### number of seconds
	  R=#####		- repeat previous options for a total of
				  ##### iterations
	  LIST			- display a list of the marked connections
      - Changed support for ALL | MARKALL option to SET | MARK

Release Notes for v1.22:
------------------------
      - Further optimized code towards incorporating command line options
	and supporting batch file processing
      - Added support for the following command line options and batch
	processing functions ( [] are for example only, "" are required ):
	  ALL | MARKALL		- mark all active connections
	  F=[sys:path\file.ext]	- mark connections with specified file open
	  N=[node] 		- mark connection with specified node ID
	  U=[user]		- mark connections for specified user
	  M="message"		- send message to marked connections
	  CLR|CLEAR|DEL|DELETE	- terminate marked connections
	  BAT | BATCH		- process options as batch commands

Release Notes for v1.21:
------------------------
      - Hand coded around a bug in the NetWare Client API SDK which would
	result in an error for any connection with more than 22 files open
	running under NetWare v2.
	(Note: The SDK built a reply buffer to retrieve the open file
	information in blocks of records.  A bug in the SDK Library causes
	it to allocate too small of a buffer resulting in an error.)
      - Hand coded around a bug in the NetWare Client API SDK which would
	result in incomplete open file information for a connection with
	more than 17 files open running under NetWare v3/v4.
	(Note: The SDK retrieves open file information in blocks of 17
	records.  A bug in the SDK Library results in the information
	for the first file in each supplemental block, after the initial
	request for the first 17 files, being skipped.)

Release Notes for v1.20:
------------------------
      - Added support for granting temporary File Server Console Operator
	rights under NetWare v4.0x to the NLM and NodeInfo which is
	distributed to registered users
      -	Added support for Disk Space in Use to the NetWare v3.1x/v4.0x
	NLM and NodeInfo which is distributed to registered users
      -	Added support for NCP Requests to the NetWare v3.1x/v4.0x
	NLM and NodeInfo which is distributed to registered users
      -	Added support for file Bytes Read to the NetWare v3.1x/v4.0x
	NLM and NodeInfo which is distributed to registered users
      -	Added support for file Bytes Written to the NetWare v3.1x/v4.0x
	NLM and NodeInfo which is distributed to registered users

Release Notes for v1.10:
------------------------
      - First commercial release of the NodeInfo utility
      - Modified connection update logic to handle the difference in
	how NLM connections are managed between NetWare v3 and v4
      - Modified connection update logic to work around a NCP change in
	NetWare v3.12/v4.0x which returns an Invalid Connection error
	(even when within the supported connection count range) if an
	inactive connection is queried (no previous NetWare versions do
	this - this change also affects older versions of FCONSOLE)

Release Notes for v1.09:
------------------------
      - Added support for 500 and 1000 user versions of NetWare
      - Further expanded the on-line help information
      - Corrected a logic oversight which would cause indeterminate
	results in the User Information screen if one of the connection's
	open files included either a subdirectory or file name that
	had a numeric digit as the first character

Release Notes for v1.08:
------------------------
      - Through debug, isolated the anomaly in Novell's NetWare Client
	API for C libraries so that support for NetWare v2 record lock
	information could be properly supported
      - Optimized the file attribute routine for NetWare v2 support
      - Recompiled with latest release of Novell's NetWare Client API
	for C libraries (v1.00e - Beta)

Release Notes for v1.07:
------------------------
      - Added a configuration option to change the Update Interval
	for the visual map of connections (default is 30 seconds,
	supported intervals are 15, 30, and 60 seconds).
      - Added confirmation prompt prior to performing Clear Connection
      - Added support for Home, End, Page Down, and Page Up for scrolling
	through the open files list in the User Information screen
      - Cosmetic adjustment to screen colors based upon user feedback
      - Expanded the help system functionality and information
      - Further optimized some of the functions
      - Corrected a logic oversight which would not recognize NetWare v4.0
	ADMIN users as Supervisor Equivalent or a FS Console Operator

Release Notes for v1.06:
------------------------
      - Corrected a cosmetic display problem in the User Info screen
	where scrolling through a file listing could cause the
	attribute information for the top file listing to disappear
      - Corrected a logic problem in the User Info screen which
	occurred during the resolution of long file names that could
	cause the program to terminate (due to failure of either
	the Physical Lock Scan or the Temporary Directory Allocation)

Release Notes for v1.05:
------------------------
      - Added a configuration option (CONFIG or RECONFIG command
	line options) to the registered version which can provide
	users on NetWare v3.1x with temporary File Server Console
	Operator status when running NodeInfo with the NLM loaded
      -	Added display of current counts to Logged In, Logged Out, &
	Active icons on the Main screen
      - Added display of restricted access(-) and locked(+) status
	icons to the Open Files subwindow on the Main screen
      - Added display of record lock and access control attributes
	to the files listed in the User info screen
      - Added file access verification logic to the Find File option
      - Added the ability to locate connection by its 6 byte Node ID
      - Expanded the on-line help functionality and information

Release Notes for v1.04:
------------------------
      - Corrected a problem in Send Message which could cause it
	to send messages to inactive nodes

Release Notes for v1.03:
------------------------
      - Added real-time clock to screen display
      - Added 'Updating' message when remapping conns on large net

Release Notes for v1.02:
------------------------
      - Added support for foreign device identification (MACs)
      -	Added support for Ctrl-Left & Ctrl-Right cursor movement
	to move between marked nodes

Release Notes for v1.01:
------------------------
      -	Added the ability to attach/login to other known servers

Release Notes for v1.00:
------------------------
      -	Initial limited release of the NodeInfo utility