This is a readme.txt file for the current version of the SNMPPING utility 
shipped with the MG-WinSNMP SDK by MG-SOFT Corporation (dated 26/Nov/1996).


==========================================================================
Table of contents
-----------------
1. How to install SNMPPING
2. How to use SNMPPING
3. How to get the latest version of MG-WinSNMP
4. How to reach us



==========================================================================
1. How to install SNMPPING
--------------------------

You can run SNMPPING from the DOS prompt by simply typing it's name. 

You can also use the supplied snmpping.pif file in order 
to create a shortcut to the SNMPPING.EXE from desktop
or in any folder you preffer. 
Please note that you have to edit properties of the pif file 
before you can successfully use it, by following these steps:

1. create a shortcut icon to the snmpping.pif file on your 
   desktop or in any folder you preffer
2. right-click the new 'Shortcut to snmpping.pif' icon
3. select the 'Properties' entry from the pop-up menu
4. click the 'Program' tab 
5. into the 'Working' input line type the path to 
   the SNMPPING.EXE without program name SNMPPING.EXE 
   (for example, type: C:\MG-WinSNMP\BIN )
6. click the OK button
7. doubleclick the 'Shortcut to snmpping.pif' that you have
   created in the first step and you will be prompted to input 
   switches and parameters for SNMPPING (please read the next 
   section)


==========================================================================
2. How to use SNMPPING
----------------------

SNMPPING is a command-line utility. If you run it without
any parameters given, you will get the brief description of
all available switches:

SNMPPING Utility V1.0 Beta 5; C-1996 by MG-SOFT Corporation, Slovenia.

Usage: snmpping [-v] [-c(community)] [-r] [-u] [-f] [-i] [-o]
                [-a] [-s(start OID)] [-e(end OID)] [-m(type)(value)]
                [-l] [-t] [-p] [-d(interval)] ip.ip.ip.ip

Options (No space between switch and parameter):

   -v              Display WinSNMP module version.
   -c community    Community [default = public].
   -r              Number of retransmits [default = 1].
   -u              Timeout per retransmit in miliseconds [default = 5000].
   -f              Browse whole MIB tree.
   -i              Browse system info.
   -o              Don't resolve object ID names.
   -a              Resolve remote SNMP agent IP addfress.
   -s start-Oid    Start OID [default = 1.3.6.1.2.1.1.3 (sysUpTime)].
   -e end-Oid      End OID [default = 1.3.6.1.2.1.1.4 (sysContact)].
   -m type value   Set value (-s must be specified).
                   Types: o octets, .
   -l              Print line numbers.
   -t              Print value types.
   -p              Print parameters.
   -d interval-ms  Ping util interrupted [default interval = 1000 miliseconds].

Examples:

Ping: snmpping ip.ip.ip.ip
Ping: snmpping -d ip.ip.ip.ip
Info: snmpping -i -t ip.ip.ip.ip
Walk: snmpping -f -t ip.ip.ip.ip
Walk: snmpping -s1.3.6.1 ip.ip.ip.ip
Walk: snmpping -s1.3.6.1 -e1.3.6.1.2.1.2 ip.ip.ip.ip
Set:  snmpping -mo"Contact person name" -s1.3.6.1.2.1.1.4.0 ip.ip.ip.ip
Performance: snmpping -d0 -l ip.ip.ip.ip

Use 'snmpping > file' or 'snmpping | more' when output is larger than screen.


Please note:
------------

If you use only the -s<OID> switch, SNMPPING displays only the 
value of the given <OID>.

If you use the -s<OID1> and -e<OID2> switches together, SNMPPING 
displays values in the range from <OID1> to <OID2>.

If you use the -s<OID> and -f switches together, SNMPPING displays 
all values from <OID> to the end of the MIB tree.


==========================================================================
3. How to get the latest version of MG-WinSNMP
----------------------------------------------

You can download the latest version from the following URLs:

* http://www.mg-soft.si/mgt10p5.html
* http://www.abit.co.jp/varidocs/mgt10p5.html


==========================================================================
4. How to reach us
------------------

If you want to be promptly informed about news from MG-SOFT 
Corporation, please subscribe to our mailing lists by filling out
the form on the following URL:

http://www.mg-soft.si/maillist.html


Any questions, comments, suggestions and bug reports regarding 
SNMPPING and MG-WinSNMP should be directed to:

MG-SOFT Corporation      Phone:  +386 62 2295050
Strossmayerjeva 32 A     Fax:    +386 62 222725
2000 Maribor             E-mail: info@mg-soft.si
Slovenia                 URL:    http://www.mg-soft.si/


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