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 doesnt 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/


==========================================================================
