SNMPEXMP.TXT
This file contains notes on building and using the SNMP
Examples in this directory.
GENERAL NOTES:
1. SNMP.NLM must be running on the server before any of
the examples in this directory can be loaded.
2. The MAKEFILEs discussed in this text file apply ONLY
to the WATCOM compiler.
3. The MAKEFILEs discussed in this text file require a
copy of MAKEINIT to be located in the machine's search
path. MAKEINIT is generated by a utility (MAKEINIT.EXE)
in the SDK (see NWSDK\TOOLS\MAKEINIT.*)
NOTES ON SPECIFIC EXAMPLES:
KENSUPPT
KENNEL.MIB
KENSUPPT.C
KENNEL.NLM
KENSUPPT contains an example of how to instrument a MIB for NetWare
SNMP services. It uses the image of dogs in a kennel to illustrate
associations between SNMP objects, tables and traps. When built
and run as an NLM, KENNEL registers its objects with SNMP so that
they'll be available for "get" and "set" functions.
A MIB browser can access the information in KENNEL.MIB remotely,
using standard SNMP functions. Use your MIB browser (ManageWise
for example) to read or write to the objects in this MIB.
KENNEL.MIB objects aren't accessed by any of the examples in this
directory, this sample illustrates instrumentation only.
1. Use MIBCOMP.EXE to generate KENNEL.C and KENNEL.H from
KENNEL.MIB: (Be sure MIBCOMP.EXE is in your machine's
search path. MIBCOMP.EXE is included with the SNMP SDK).
MIBCOMP KENNEL.MIB
This process will generate KENNEL.C and KENNEL.H
2. Use QMK386 to generate a makefile for KENNEL.NLM
QMK386 KENNEL /cskennel /cskensuppt
This will generate a MAKEFILE that includes kennel.c and
kensuppt.c into one nlm: KENNEL.NLM
3. Compile the example (assuming WATCOM executable files are
located in your machine's search path).
WMAKE
4. To compile the KENNEL.MIB into ManageWise, copy the file to
the SNMPMIBS\CURRENT directory. Edit KENNEL.MIB to remove
the "--#" string from line 87 (this was intentionally left in
to demonstrate custom ManageWise annotation). Run Tools/Mib
Compiler/Compile MIB. After KENNEL.NLM is loaded on the server
use Tools/Mib browser to browse the MIB.
MIBSUPPT
EXMPLMIB.MIB
MIBSUPPT.C
EXMPLMIB.NLM
EXMPLMIB contains an example of how to instrument a MIB for NetWare
SNMP services. It uses the image of a store and employees to
illustrate the relationship between MIB objects. When built and
run as an NLM, EXMPLMIB registers its objects with SNMP.NLM so that
they'll be available for "get" and "set" functions.
This MIB is accessed from the server by two of the examples in this
directory: SACRDTB.NLM and SACSETTB.NLM. Additionally, a MIB
browser can be used to access the objects in EXMPLMIB.MIB remotely,
using standard SNMP functions. Use your MIB browser (ManageWise
for example) to read or write to the objects in this MIB.
Complete the following steps to build EXMPLMIB.NLM:
1. Use MIBCOMP.EXE to generate EXMPLMIB.C and EXMPLMIB.H from
EXMPLMIB.MIB: (Be sure MIBCOMP.EXE is in your machine's
search path).
MIBCOMP EXMPLMIB.MIB
This process will generate EXMPLMIB.C and EXMPLMIB.H
2. Use QMK386 to generate a makefile for MIBSUPPT.NLM
QMK386 EXMPLMIB /csexmplmib /csmibsuppt
This will generate a MAKEFILE that includes exmplmib.c and
mibsuppt.c into one nlm: EXMPLMIB.
3. Compile the example (assuming WATCOM executable files are
located in your machine's search path).
WMAKE
SACSET.NLM
This example demonstrates the function SACSetAttributes().
SACSET.NLM sets the name on the System Contact object that is
part of the system group in mib-2.
To build this example, use QMK386 to generate a MAKEFILE then
use Watcom WMAKE to compile and link.
QMK386 SACSET /x
WMAKE
SACREAD.NLM
This example demonstrates the function SACReadSNMPObject(). This
example reads and displays the System Contact object name that
was set by the previous example (SACSET.NLM).
To build this example, use QMK386 to generate a MAKEFILE then
use Watcom WMAKE to compile and link.
QMK386 SACREAD /x
WMAKE
SACSETTB.NLM
SACSETTB.NLM demonstrates the function SACSetAttributes(). This
example sets the YearsOfResidence attribute on one of the
neighbor table objects (Owen Finkelstein) in EXMPLMIB.MIB.
To build this example, use QMK386 to generate a MAKEFILE then
use Watcom WMAKE to compile and link.
QMK386 SACSETTB /x
WMAKE
SACRDTB.NLM
SACRDTB.NLM demonstrates the function SACReadNextAttributes().
This example reads and displays all the neighbors in EXMPLMIB.MIB,
including Owen Finkelstein whose YearsOfResidence attribute was
changed by SACSETTB.NLM from 1 to 10 years.
To build this example, use QMK386 to generate a MAKEFILE then
use Watcom WMAKE to compile and link.
QMK386 SACRDTB /x
WMAKE
TESTTRAP.NLM
This shows how to use the SNMP SACTrap() API. This example will run on
any server running SNMP.NLM. To see this trap on a ManageWise console,
complete the following steps:
1. Copy TRAPTEST.MIB into the SNMPMIBS\CURRENT directory on the
ManageWise console machine.
2. Run ManageWise
3. Run Tools\Mib Compiler to intergrate the new test trap into
the ManageWise database.
4. Run TESTTRAP.NLM. The test trap should be displayed on the
alarm monitor of the ManageWise console.
To build this example, use QMK386 to generate a MAKEFILE then
use Watcom WMAKE to compile and link.
QMK386 TESTTRAP /x
WMAKE
SMILE
SYS1213.MIB
SMILEXMP.C
SMILEXMP demonstrates how an NLM can get and set SNMP values
from a local or remote agent.
Complete the following steps to build SMILEXMP.NLM:
1. SMILEXMP uses EXMPLMIB.MIB found in the SNMP\MIBSUPPT
directory. Copy EXMPLMIB.MIB from the SNMP\MIBSUPPT
directory into the SNMP\SMILE directory.
2. Use MIBCOMP.EXE to generate EXMPLMIB.C and EXMPLMIB.H from
EXMPLMIB.MIB: (Be sure MIBCOMP.EXE is in your machine's
search path).
MIBCOMP -mgt EXMPLMIB.MIB
This process will generate EXMPLMIB.C and EXMPLMIB.H
3. Use MIBCOMP.EXE to generate SYS1213.C and SYS1213.H from
SYS1213.MIB: (Again, be sure MIBCOMP.EXE is in your machine's
search path).
MIBCOMP -mgt SYS1213.MIB
This process will generate SYS1213.C and SYS1213.H
4. Use QMK386 to generate a makefile for SMILEXMP.NLM
QMK386 smilexmp /csexmplmib /cssmilexmp /cssys1213
This will generate a MAKEFILE that includes exmplmib.c, sys1213.c
and smilexmp.c into one nlm: SMILEXMP.C.
5. Compile the example (assuming WATCOM executable files are
located in your machine's search path).
WMAKE
Note, load EXMPLMIB.NLM before running SMILEXMP.NLM
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.