This is a README.TXT file for the evaluation version of 32-bit MG-WinSNMP DLL module Version 1.0 Beta 5 (dated: 26/November/1996). Copyright C-1995, 1996 by MG-SOFT Corporation. All rights reserved. Thank you for your interest in MG-WinSNMP V1.0b5. Please note that this is a shareware product and thus you are eligible to use it only for the evaluation purposes, no longer than 30 days. If you find MG-WinSNMP useful, please contact us for licensing agreement (details are given in the enclosed order.txt file)! ========================================================================== Table of contents ----------------- 1. About MG-WinSNMP SDK 2. MG-WinSNMP SDK features 3. Files included in this release 4. MG-WinSNMPSDK/sample applications revision history 5. Related products by MG-SOFT Corporation 6. About Net Inspector 7. About MONET LAN analyzer 8. About SNMP LAN analyzer 9. About MONET LAN analyzer LITE 10. Ordering from Public (software) Library 11. Warning: this is not the final release 12. Warning: limitation of liability 13. More information ========================================================================== 1. About MG-WinSNMP SDK ----------------------- MG-WinSNMP (wsnmp32.dll) is a 32-bit multithreaded DLL fully compliant to the Windows SNMP specification V1.1a Level 0 and Level 1. It provides a common Application Programming Interface to the Graphical User Interface and Console Applications running on Microsoft Windows 95 and Windows NT. Soon we will provide also support for the NT service applications. The aim of beta pre-releases is to gather as much valuable response from our users as possible and thus be able to fix as many bugs as possible and release stable MG-WinSNMP SDK. Please send any comments, suggestions and bug reports related to this pre-release of MG-WinSNMP version 1.0 beta 5 to MG-SOFT Corporation (info@mg-soft.si). Thank you very much! MG-WinSNMP distribution contains two sample applications with full source code in order to illustrate the usage of wsnmp32.dll library: * MIBB32 MIB browser, a sample application based on the wsnmp32.dll with all files (sources, headers, project,...) necessary to build it with Delphi 2.0. In this version MIBB32 contains the following extended fuctionality: - SNMP discovery utility - info windows for real-time polling * snmpping command-line utility, a sample application based on the wsnmp32.dll with all files (sources, headers, project,...) necessary to build it with MS VC4.* or BC5.*. Please note that you can order MG-WinSNMP Additional Source Code Samples package which includes many examples illustrating tips and tricks on how to build SNMP applications on 32-bit MS Windows platforms by using the MG-WinSNMP SDK. You can order it directly from MG-SOFT Corporation or from Public software Library (when ordering from PsL please list the item number 14980). The price of the package is 65 US$. If you wish to receive it on a floppy through the postal mail, please add 10 US$ for S & H. Deliveries through e-mail are free of any additional charges. ========================================================================== 2. MG-WinSNMP features ---------------------- * MG-WinSNMP SDK is compatible with Windows SNMP API as defined in Windows SNMP Version 1.1a specification by Bob Natale, American Computer & Electronic Corporation. * Full WinSNMP Level 0 and Level 1 support. * wsnmp32.dll is 32-bit multithread dll module. Internal data processing, network interface and local database interface are running in separate threads and therefore completely isolated from the main application. * wsnmp32.dll is thread-safe. Sessions can be simultaneously accessed from more than one thread, from any number of applications. Internal data is protected against simultaneous access, code is designed to prevent deadlocks. * Inter-process SNMP trap dispatching support for all registered applications. * MG-WinSNMP is VC4.0, BC 5.0 and Delphi 2.0 compatible (MG-WinSock also contains header files for Borland's Delphi 2.0). * wsnmp32.dll file name is used in order to prevent interference with 16-bit module's file name winsnmp.dll. * Sample applications with source code ready to compile: MIB browser utility with SNMP node discovery, Info windows, ICMP ping, SNMP ping, ... ========================================================================== 3. Files included in this release --------------------------------- MG-WinSNMP V1.0 Beta5 includes the folowing files placed on the following sub-directory structure. * Document files (located in the mgtools directory): readme.txt - this file snmpping.txt - information about SNMPPING utility bin\mibb32.hlp - MG-WinSNMP help file license.txt - licensing information warning.txt - important information, please read it * Common header files for building application using the wsnmp32.dll (located in the mgtools\include directory): winsnmp.h - C/C++ header file for WinSNMP API winsnmp.pas - PASCAL header file for WinSNMP API wsnmpmib.h - C/C++ header file for WSNMPMIB API wsnmpmib.pas - PASCAL header file for WSNMPMIB API icmp.pas - PASCAL header file for Win95/NT ICMP.DLL module wsnmp32.def - WinSNMP module definition file mgwinmib.def - WinSNMPMIB module definition file The original *.h and *.def files has been modified according to the Win32 requirements. All modifications are documented inside files. * Library files for linking an application with wsnmp32.dll (located in the mgtools\lib sub-directories): msvc4\wsnmp32.lib - Microsoft VC 4.* wsnmp32.dll library file msvc4\winmib32.lib - Microsoft VC 4.* WINMIB32.DLL library file bc5\wsnmp32.lib - Borland C++ 5.* wsnmp32.dll library file bc5\winmib32.lib - Borland C++ 5.* WINMIB32.DLL library file The user can build library files by using the LIB (Microsoft VC) or IMPLIB (Borland C++) utilities. * Source files for building the MIBB32.EXE sample application (located in the mgtools\samples\mibb32 directory): mibbrow.pas - mibb32 main application source file mibb32.dpr - Delphi 2.0 project file mibbrow.dfm - mibb32 main application form about.dfm - about box form handshak.ico - application icon (taken from Delphi 2.0 images/icon) mibb32.res - resource file created by Borland's Delphi mibb32_1.res - resource file mibb32.dof - Delphi 2.0 project settings cl.bat - deletes all unnecessary files created by Delphi * Pre-compiled Delphi units for building the MIBB32.EXE sample application (located in the mgtools\samples\mibb32\dcu directory): about.dcu - about component (pre-compiled) semaph.dcu - status bar semaphore component (pre-compiled) info.dcu - info form (pre-compiled) discover.dcu - discovery form (pre-compiled) * Source files for building the SNMPPING.EXE sample application (located in the mgtools\samples\mibb32 directory): snmpping.mdp - snmpping project file for MSVC4.* snmpping.mak - snmpping make file for MSVC4.* snmpping.cpp - snmpping application source file snmpping.ncb - snmpping program database file for MSVC4.* snmpping.def - snmpping definition file wsnmp32.lib - Microsoft VC 4.* wsnmp32.dll library file winmib32.lib - Microsoft VC 4.* wunmib32.DLL library file * Pre-compiled sample applications and wsnmp32.dll binaries (located in the mgtools\bin directory): mibb32.exe - pre-compiled sample application MIBB32.EXE snmpping.exe - SNMP ping utility (win32 console application) wstrap32.exe - 32-bit trap dispatching module wsnmp32.dll - 32-bit MG-WinSNMP module mgtree32.dll - 32-bit tree data structures handling module mgwsock.dll - 32-bit WinSock 1.1 transport layer module winmib32.dll - 32-bit mib database handling module snmpmib.db - pre-compiled MIB database ========================================================================== 4. MG-WinSNMPSDK/sample applications revision history ----------------------------------------------------- * MG-WinSNMP V1.0 Beta1 (MGT10B1.ZIP) initial release, published in mid-June 1996 only for business partners * MG-WinSNMP V1.0 Beta2 (MGT10B2.ZIP) first public release, published on 25/June/1996 * MG-WinSNMP V1.0 Beta3 (MGT10B3.ZIP) second public release, published on 25/July/1996 Major improvements: - WSNMP.DLL runs on Microsoft Windows NT 4.0b2 - extended functionality in the MIBB32 demo application. Besides browsing the whole MIB tree by using getNext(), MIBB32 sample application now allows browsing MIB sub-trees and single MIB entries. * MG-WinSNMP V1.0 Beta4 (MGT10B4.ZIP) third public release, published on 21/August/1996 Major improvements: - Added libraries for building wsnmp32.dll applications with BC 5.* and MSVC 4.* C/C++ compilers - MIBB32 demo application extended with ping (ICMP) - added SNMPPING.EXE console application * MG-WinSNMP V1.0 Beta5 binary pre-release (MGT10PREB5.ZIP) fourth public release, published on 12/November/1996 This release doesn't include any source files except header files. * MG-WinSNMP V1.0 Beta5 (MGT10B5.ZIP) fifth public release, published on 26/November/1996 Major improvements: - improved performance and stability of the wsnmp32.dll library. - extended functionality of MIBB32 sample application by adding examples for SNMP agent discovery and Info windows. - extended functionality of SNMPPING sample application by adding many new switches. ========================================================================== 5. Related products by MG-SOFT Corporation ------------------------------------------ Besides MG-WinSNMP wsnmp32.dll module, MG-SOFT offers the following related products for networking software developers and network maintainers/troubleshooters: * Net Inspector (more info in Section 6 of this file) * MONET LAN analyzer (more info in Section 7 of this file) * MONET SNMP analyzer (more info in Section 8 of this file) * MONET LAN analyzer LITE (more info in Section 9 of this file) * MG-WinSock Delphi 2.0 components (TCP client, TCP server, UDP client, UDP server). All components are designed as 32-bit multithreaded components to ensure easy development of stable networking software. The following bundled packages are available: * MG-WinSock Software Developers Workshop software development kit which contains: - MONET LAN analyzer LITE - MG-WinSock Delphi 2.0 components * MG-WinSock Software Developers Lab software development kit which contains: - MONET LAN analyzer LITE - MG-WinSock Delphi 2.0 components - MG-WinSNMP wsnmp32.dll module Currently under development: * Net Inspector - open designed network management software * Lemond - Remote MONET LAN analyzer (incl. RMON module) * MAIR - cellular telephone network monitoring system * LAN telephone/conferencing system For more information about our products please check our web site at URL http://www.mg-soft.si/ (from where you can download the latest evaluation/demo versions of our software packages) or contact us directly. ========================================================================== 6. About Net Inspector ---------------------- Net Inspector is a general remote management system running on MS Windows 95 and MS Windows NT platforms. It provides: * built-in framework for graphical presentation of managed devices * built-in event collecting, event logging and alarm dispatching mechanisms * API for developping PFS (proxy front-end server) plug-in modules Net Inspector platform can be used for managing devices running the SNMP agents as well as devices where implementation of the SNMP protocol is not possible for any reason. On the other hand these devices may support a management protocol of its own and by developing the appropriate PFS to manage that type of device, you can manage them by Net Inspector. That means that it is possible to simultaneously manage different types of devices on different types of networks, all from the same desktop. Graphical presentation ---------------------- Net Inspector offers an easy way for setting up a graphical presentation of network nodes sparsed around the network. This presentation is based on a principle of maps and sub maps. Devices and sub maps are presented as icons on a root map. Device icons are dynamic which means that they respond to a certain message by changing colors. Event status legend allows you to view a legend of colors used to indicate the status of nodes and devices on your map. However these colors and meanings depend on your module so they can change. Sub maps can be opened by clicking on the sub map icons. The map can also contain bitmaps, text and unknown objects. Event collecting, logging and alarming -------------------------------------- Net Inspector's Alarm Manager is a central system for collecting messages from agents. This system enables the user to notice the icon of the device that sends an error message or have stopped responding. PFS plug-in modules ------------------- Functionality of Net Inspector depends on the number and type of installed PFS (proxy front-end server) plug-in modules that conform to the Net Inspector API. Net Inspector API is a framework for defining agents (devices that we want to manage) and protocols which are used for communication between PFS and Net Inspector. Communication between PFSs and agents runs on a media of your choice. You may use LAN, WAN, ISDN, PSTN, serial,... whatever. In other words, the module should provide the gateway from the media/protocol of your choice to Net Inspectors internal protocol, defined by the Net Inspector API. Such architecture enables adding new types of agents without changing the Net Inspector itself. Agents should just be registered properly by calling API functions. Thus with Net Inspector it is possible to simultaneously manage different types of devices on different types of networks. Future extensions ----------------- * Extensions for delivering alarm messages via e-mail, pager and telephone. * Option which will enable to run Net Inspector as a service on the Windows NT platforms. * Client/server architecture for accessing Net Inspector. * Virtual objects for managing groups of network devices as a single object, e.g. a virtual object link can be defined by all nodes on the route of that link. * Graphical links between objects on the map. * ObjectBuilder API will provide a mechanism to visualize managed devices. For example, a device in Net Inspector is presented as an icon. By clicking that icon, the whole image of the device appears. By clicking a certain part of the device, Net Inspector will open a new window, where the user can have a closer look at the device detail, like which module doesn’t work properly. Currently provided PFS Plug-in modules for Net Inspector -------------------------------------------------------- In the existing version of Net Inspector we provide the following plug-in modules: * Echo module for pinging network devices with UDP/ECHO protocol * SNMP module running on MG-WinSNMP for polling network devices with SNMP protocol How to get Net Inspector ------------------------ The evaluation version of Net Inspector is available from our web server at URL http://www.mg-soft.si/download.html. ========================================================================== 7. About MONET LAN analyzer --------------------------- MONET LAN analyzer is a high-performance PC-based set of powerful tools for monitoring traffic on the local area network. It contains a wide variety of functions which offers a comprehensive support to network administrators, managers and troubleshooters as well as to networking software developers in many aspects of their activities. MONET LAN analyzer helps to increase productivity, to optimize network performance and to decrease network downtime. Please note that you can use MONET LAN analyzer also as a SNMP debugging utility. It can capture the conversation between SNMP managers and agents and produce high quality decodes of captured SNMP protocol packets (please check the example given in file mgtools\samples\snmpdeco.txt). The main features of MONET LAN analyzer are as follows: Real time monitoring: Volume of the network traffic is displayed in many different manners. A wide range of parameters indicating network condition are computed in real time and periodically updated (utilization and traffic volume, time-stamps and delay times, average values, peak times and values, various error indicators,...). Powerful graphical presentation of monitoring statistics with export to the BMP file format. Protocol decoding: Support for packets encapsulated into IEEE 802.2 (LLC and SNAP), IEEE 802.3 (Novell IPX) and Ethernet II frames. Multi-level interpreters for all major LAN protocol families: AppleTalk, DECnet, IPX/SPX, NBeui, NCP (NetWare), NetBios, OSI/TP4, SMB, TCP/IP, SNMP, XNS,.... Traffic generation: Transmitting user-defined packets to the network for network testing purposes (triggering network events or loading network with heavy traffic to examine its behavior in critical conditions). Multi-level filtering: Two levels of capture filters and triggers, display filters, classifying filter structures,.... Filters are completely user-definable and 'point-and-click' easy to build. Many sample filters provided. System requirements: IBM PC/AT or compatible computer using Intel 386 or higher microprocessor, DOS V3.30 or higher operating system, XMS RAM extension (recommended 4 MB or more), XMS memory manager himem.sys. A wide range of LAN adapters is supported, either by MGD interface (MONET Genuine Driver) or through standard Packet driver V1.09 drivers. ========================================================================== 8. About MONET SNMP analyzer ---------------------------- MONET SNMP analyzer is a downsized version of the full version MONET LAN analyzer, tailored to suit the needs of a SNMP software developer. MONET SNMP analyzer has been designed as a powerful debugging utility for the IP/SNMP networking software developers. You can use it for tracing and capturing the IP/SNMP protocol network packets and examining their contents, thus you can effectively follow the conversation between agent and manager software modules that you are developing and are scattered across the network. MONET SNMP analyzer includes the following features: * Runs on PC computes under the DOS operating system. It uses the Packet driver V1.09 network interface. * Program can capture IP, ARP and RARP protocol packets. * Protocol decoder can decode the following protocols: - DLC encapsulation layer, - IP, ARP and RARP layers on top of DLC, - TCP, UDP and ICMP layers on top of IP and - SNMP and SNMP TRAP layers on top of UDP. * Everything else carried by UDP or TCP layers is decoded as data which permits easy following of the conversation between agents and managers that the user is developing. * The number of captured packets is limited only by the amount of available RAM. * You can use filters for focusing on certain group of network packets that you want to capture or analyze (filters are just as powerful as those in the full version of MONET LAN analyzer!). * You can assign names to the frequently used addresses (IP and MAC) so that reports are much easier to follow. * You can save captured packets to files for latter off-line analysis. * You can send reports to printer. MONET SNMP analyzer is available as a standalone product as well as bundled in MG-SOFT's MG-WinSock Software Developers Lab software development kit (by the time the SDL becomes available). The price of MONET SNMP analyzer is 120 US$. For the fastest delivery of the software you can purchase MONET SNMP analyzer from Public (software) Library. Software is shipped on a floppy. Besides the floppy we ship also the printed manual (172 pages). Registered users are eligible for full support. The evaluation version of MONET SNMP analyzer (MONET LAN analyzer LITE) is available from our web server at URL http://www.mg-soft.si/download.html. ========================================================================== 9. About MONET LAN analyzer LITE -------------------------------- MONET LAN analyzer LITE has been designed as a powerful debugging utility for the IP networking software developers. You can use it for tracing and capturing the IP protocol network packets and examining their contents, thus you can effectively follow the conversation between client and server software modules that you are developing and are scattered across the network. MONET LAN analyzer LITE is a downsized version of the full version MONET LAN analyzer, tailored to suit the needs of a general TCP/IP software developer. MONET LAN analyzer LITE includes the following features: * Runs on PC computes under the DOS operating system. It uses the Packet driver V1.09 network interface. * Program can capture IP, ARP and RARP protocol packets. * Protocol decoder can decode the following protocols: - DLC encapsulation layer, - IP, ARP and RARP layers on top of DLC and - TCP, UDP and ICMP layers on top of IP. * Everything carried by UDP or TCP layers is decoded as data which permits easy following of the conversation between clients and servers that the user is developing. * Evaluation version of MONET LAN analyzer LITE can keep in memory only a limited number of captured packets while limitations in the registered version will be imposed only by the amount of available RAM. * Registered version can filter network packets, both while capturing as well as in analyzing mode (off-line, when the user analyzes the contents of captured packets). * Registered version can save captured packets to files. * Registered version can generate reports and send them to files or printers. MONET LAN analyzer LITE is available as a standalone product as well as bundled in MG-SOFT's MG-WinSock Software Developers Workshop software development kit (by the time the SDW becomes available). MONET LAN analyzer LITE registration fee is 60 US$. For the fastest delivery of the software you can purchase MONET LAN analyzer LITE from Public (software) Library. Software is shipped on a floppy. Besides the floppy we ship also the printed manual (172 pages). Registered users are eligible for full support. The evaluation version of MONET LAN analyzer LITE is available from our web server at URL http://www.mg-soft.si/download.html ========================================================================== 10. Ordering from Public (software) Library ------------------------------------------- On-line orders from PsL ----------------------- You can order on-line from PsL by pointing your web browser to the given URLs: For MONET LAN analyzer LITE: http://206.109.101.6/cgi-win/psl_ord.exe/ITEM14880 For MONET SNMP analyzer: http://206.109.101.6/cgi-win/psl_ord.exe/ITEM14881 For MG-WinSNMP Additional Source Code Samples http://206.109.101.6/cgi-win/psl_ord.exe/ITEM14980 Please note that URLs are case sensitive and that you have to copy them exactly as listed here. Credit card orders from PsL --------------------------- You can order MONET LAN analyzer LITE and MONET SNMP analyzer with MC, Visa, Amex, or Discover from Public (software) Library by: Phone 800-2424-PsL or 713-524-6394 Fax 713-524-6398 CIS e-mail 71355,470 Internet e-mail 71355.470@compuserve.com Postal mail PsL, P.O. Box 35705, Houston, TX 77235-5705, U.S.A. Please note that the above phone and fax numbers are located in Texas, U.S.A. and that PsL is accepting telephone calls only between 6:00am - 6:00pm Monday to Thursday and 6am - Noon on Fridays, except on holidays. When placing an order, please list also the following product codes: 14880 for MONET LAN analyzer LITE 14881 for MONET SNMP analyzer 14980 for MG-WinSNMP Additional Source Code Samples Please note that the above phone numbers are for credit card orders only! Authors of MONET LAN analyzer LITE, MONET SNMP analyzer and MG-WinSNMP Additional Source Code Samples cannot be reached at these numbers! Any questions about the status of the shipment of the order, refunds, registration options, product details, technical support, volume discounts, dealer pricing, site licenses, non-credit card orders, etc., must be directed to monet@mg-soft.si or monet@abit.co.jp To insure that you get the latest version, PsL will notify us the day of your order and we will ship the product directly to you. ========================================================================== 11. Warning: this is not the final release ------------------------------------------ This version is not the final shareware release of MG-WinSNMP DLL module, so it shouldn't be distributed from any site other than our official site (http://www.mg-soft.si/). This means that *nobody* has a right to place the current software distribution on any kind of publicly available site (web/ftp/gopher/BBS/...) or media (CD ROM/...)! However, we have no objections if you set an URL pointer related to MG-WinSNMP pointing to any of the following web pages: http://www.mg-soft.si/ (Home page of MG-SOFT Corporation) http://www.mg-soft.si/mgsnmp.html (MG-WinSNMP home page) http://www.mg-soft.si/netinsp.html (Net Inspector home page) http://www.mg-soft.si/monet.html (MONET LAN analyzer home page) http://www.mg-soft.si/monetlt.html (MONET LAN analyzer LITE home page) http://www.mg-soft.si/monetsn.html (MONET SNMP analyzer home page) When we produce the final shareware version of MG-WinSNMP DLL module, we will permit its distribution by all means without any restrictions to anybody. Thank you for your cooperation! ========================================================================== 12. Warning: limitation of liability ------------------------------------ MG-SOFT does not warrant the fitness of this software for any particular task, nor will MG-SOFT be liable for any loss of profits, loss of data, or any incidental or consequential damage caused by the use or misuse of this software. ========================================================================== 13. More information -------------------- For more information about MG-WinSNMP and our other products, please check our WEB site at URL http://www.mg-soft.si/ or contact us directly. You can subscribe to our mailing lists on-line by simply filling out the form at URL http://www.mg-soft.si/maillist.html If you don't have access to the Internet, please let us know by email that you wish to subscribe and we will add you to the list of recipients. Please send all questions, suggestions and bug reports related to MG-WinSNMP and MIBB32 to our address: MG-SOFT Corporation Phone +386 62 2295050 Strossmayerjeva 32A Fax +386 62 222725 2000 Maribor E-mail info@mg-soft.si Slovenia Web URL http://www.mg-soft.si/ ==========================================================================