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