ActiveXperts Network Component

Quicklinks

SNMP Sample Source Code in ASP

Network Component provides an easy-to-use development interface to a variety of IP protocols. By using Network Component, you can very easily create or enhance applications with network features.

Network Component features the following: DNS, FTP, HTTP, HTTPs, ICMP Ping, IP-to-Country, MSN, NTP, RSH, SCP, SFTP, SNMP v1/v2c (Get, GetNext, Set), SNMP Traps, SNMP MIB, SSH, TCP, Telnet, TFTP, UDP, Telnet, Wake-On-LAN and more.

Network Component can be well integrated into any development platform that supports ActiveX objects.


SNMP can be well integrated into ASP .NET (Visual Basic) environments.

This document describes how Network Component's SNMP objects can be integrated into ASP .NET (Visual Basic) projects.

Network Component is compliant with SNMP v1 and SNMP v2c. Different SNMP data types are supported, including:

  • String types (also called "octet strings");
  • Integer types (16bit, 32bit, 64bit and unsigned integers);
  • IP Address types;
  • Timetick types;
  • Counter types (32bit and 64bit counters);
  • OID types (also called "Object ID's");
  • Other, less frequently used datatypes.

The following operations are supported:

  • Get - retrieve an object variable from the (remote) agent;
  • GetNext - retrieve the next object variable from a table or list within an agent;
  • Set - set values for object variables within an agent.

Step 1: Download and install Network Component

Download Network Component from the ActiveXperts Download Site and start the installation. The installation guides you through the installation process.

Step 2: Create a new Web Site

First, create a new directory on the IIS Server's file system. This directory will hold the ASP later on.

From the 'Start menu', click on 'Administrative Tools' and click on 'Internet Information Services (IIS) Manager'. Right-click on the 'Web Sites' container and choose 'New->Web Site':

IIS

(Click on the picture to enlarge)

The 'Web Site Creation Wizard' is shown, guiding you thorugh the process of creating a new web site. Provide all necessary information:

  • Description - a friendly description of the new site;
  • IP / Port / Host Header - choose your preferred way to distinguish between other web sites on the server;
  • Path - select the directory that will store the ASP file(s);
  • Web Site Access Permissions - in the Web Site Access Permissions dialog, enable 'Read' and 'Run scripts (such as ASP)';

You're now able to write an ASP script to use IP protocols with Network Component.

Step 3: Create the from

First of all we need to create a form in HTML to get the login information for the ftp server. All we actually need is:

  • The log-in name.
  • The password.
  • The server we want to connect to.
  • And the directory we're going to list.

In this sample all we're going to do is create a ASP file that is able to list files and directories in a directory. Using Network Component it is easy to create a page that makes you able to upload and to download files.

You can create a form that looks like this:

(Click on the picture to enlarge)

Step 4:Create ActiveXperts Network Component objects in ASP

Create a new ASP script called DEFAULT.ASP in the directory that was created in Step2, using your favorite editor. On top of the ASP code, insert the following lines to declare and create the Dns object:

<object runat="server" progid="AxNetwork.Sftp" id="objSftp"></object>
<object runat="server" progid="AxNetwork.ASConstants" id="objConstants"></object>

Appendix: Full source code

<object runat="server" progid="AxNetwork.SnmpManager" id="objSnmpManager"> </object>
<object runat="server" progid="AxNetwork.NwConstants" id="objConstants"> </object>

<%
' HTML-CSS layout includes below, no code there!
%>
<!-- #include file="css/Header.html" -->
<!-- #include file="css/Menu.html" -->

<%
  ' A license key is required to unlock this component after the trial period has expired.
  ' Call 'Activate' with a valid license key as its first parameter. Second parameter determines whether to save the license key permanently 
  ' to the registry (True, so you need to call Activate only once), or not to store the key permanently (False, so you need to call Activate
  ' every time the component is created). For details, see manual, chapter "Product Activation".
  '
  ' objSnmpManager.Activate "XXXXX-XXXXX-XXXXX", False    
%>

<%
  Dim numLastError, strLastError, objSnmpObject, strOID, numDataType, strDataValue

  Set fso = CreateObject("Scripting.FileSystemObject")
  strLogfile = fso.GetSpecialFolder(2) & "\SnmpManager.log"

  strLastError = ""
  numDataType = objConstants.nwSNMP_TYPE_UNDEFINED
  strDataValue = ""

  If( Request( "btnGet" ) <> "" Or Request( "btnGetNEXT" ) <> "" ) Then
    strOID                 = Request( "txtOID" )
    objSnmpManager.LogFile = Request( "txtLogFile" )    ' Optional: set LogFile property for troubleshooting purposes

    If( Request( "txtProtocol" ) = "SNMP v1" ) Then
       objSnmpManager.ProtocolVersion = objConstants.nwSNMP_VERSION_V1
    Else
       objSnmpManager.ProtocolVersion = objConstants.nwSNMP_VERSION_V2C
    End If

    objSnmpManager.Initialize
    numLastError                      =  objSnmpManager.LastError

    If( numLastError = 0 ) Then
        objSnmpManager.Open Request( "txtAgent" ), Request( "txtCommunity" ), Request( "txtPort" )
        numLastError                  =  objSnmpManager.LastError
    End If

    On Error Resume Next
    Set objSnmpObject                 = objSnmpManager.Get ( strOID )
    On Error Goto 0

    numLastError                      = objSnmpManager.LastError
    If( numLastError = 0 And Request( "btnGetNEXT" ) <> "" ) Then
       
       On Error Resume Next
       Set objSnmpObject              = objSnmpManager.GetNext()
       On Error Goto 0

       numLastError                   = objSnmpManager.LastError
    End If
    If( numLastError = 0 ) Then
        numDataType                  = objSnmpObject.Type
        strDataValue                  = objSnmpObject.Value
        If( Request( "btnGetNEXT" ) <> "" ) Then
           strOID                     = objSnmpObject.OID
        End If
    End If

    strLastError                      =  numLastError & ": " & objSnmpManager.GetErrorDescription( numLastError )  

    objSnmpManager.Close
    objSnmpManager.Shutdown   
  End If
%>

<div class="ax_container">

  <h1>ActiveXperts Network Component ASP Sample - SNMP Get/GetNext</h1>

  <form action="snmp.asp" method="post">
    <h2>Component:</h2>
    <h3>Module [<% = objSnmpManager.Module %>]; Build [<% = objSnmpManager.Build %>]</h3>
    
    <!-- Remote Agent -->
    <label for="Remote Agent">Remote Agent:</label>
    <p>
      <input type="text" name="txtAgent" value="<% If Request( "txtAgent" ) = "" Then%>localhost<% Else %><% = Request( "txtAgent" ) %><% End If %>">
      <input style="width: 50px" type="text" name="txtPort" value="<% If Request( "txtPort" ) = "" Then%>161<% Else %><% = Request( "txtPort" ) %><% End If %>">
    </p>
    
    <!-- Community -->
    <label for="Community">Community:</label>
    <p>
      <input type="text" name="txtCommunity" value="<% If Request( "txtCommunity" ) = "" Then %>public<% Else %><% = Request( "txtCommunity" ) %><% End If %>">
    </p>
    
    <!-- Protocol -->
    <label for="Protocol">Protocol version:</label>    
    <p>
      <select name="txtProtocol">
        <% If( Request( "txtProtocol" ) = "SNMP v1" ) Then %>
        <option value="SNMP v1" selected>SNMP v1</option>
        <option value="SNMP v2c">SNMP v2c</option>
        <% Else %>
        <option value="SNMP v1">SNMP v1</option>
        <option value="SNMP v2c" selected>SNMP v2c</option>
        <% End If %>
      </select>
    </p>
    
    <!-- OID (Object ID) -->
    <label for="OID (Object ID)">OID (Object ID):</label>
    <p>
      <input type="text" name="txtOID" value="<% If strOID = "" Then %>system.sysName.0<% Else %><% = strOID %><% End If %>">
    </p>
    
    <!-- Get Set Buttons -->
    <div class="ax_clearLabel"></div>
    <p>
      <input type="submit" value="Get" name="btnGet" />
      <input type="submit" value="GetNext" name="btnGetNEXT" />
    </p>
    
    <!-- Empty Row -->
    <div class="ax_clearRow"></div>
    
    <!-- Logfile -->
    <label for="Logfile">Logfile:</label>
    <p>
      <input type="text" id="LogFile" name="txtLogFile" class="ax_FullWidth" value="<% = strLogfile %>" />
    </p>
    
    <!-- Result -->
    <label for="Result">Result:</label>
    <p>
      <input type="text" id="Result" name="txtResult" class="ax_FullWidth" style="font-weight: bold;" value="<% = strLastError %>" />
    </p>
    
    <!-- Data Type -->
    <label for="Data Type:">Data Type:</label>
    <p>
      <input type="text" name="txtType" value="<% = GetTypeString( numDataType ) %>">
    </p>
    
    <!-- Data Value -->
    <label for="Data Value">Data Value:</label>
    <p>
      <input type="text" name="txtValue" value="<% = strDataValue %>">
    </p>
    
  </form>
  <p>
    This sample is based on ActiveXperts Network Component, an <a href="http://www.activexperts.com/" target="_blank">ActiveXperts Software</a> product.<br />
    <a href="Default.asp">Back to main page</a>
  </p>
</div><!-- /container -->

<%
' HTML-CSS layout include below, no code there!
%>
<!-- #include file="css/Footer.html" -->


<% Function GetTypeString( numType)
    Select Case numType
     Case objConstants.nwSNMP_TYPE_INTEGER32: 
        GetTypeString = "nwSNMP_TYPE_INTEGER32"
     Case objConstants.nwSNMP_TYPE_BITS 
        GetTypeString = "nwSNMP_TYPE_BITS"
     Case objConstants.nwSNMP_TYPE_OCTETSTRING 
        GetTypeString = "nwSNMP_TYPE_OCTETSTRING"
     Case objConstants.nwSNMP_TYPE_NULL 
        GetTypeString = "nwSNMP_TYPE_NULL"
     Case objConstants.nwSNMP_TYPE_OBJECTIDENTIFIER
        GetTypeString = "nwSNMP_TYPE_OBJECTIDENTIFIER"
     Case objConstants.nwSNMP_TYPE_SEQUENCE 
        GetTypeString = "nwSNMP_TYPE_SEQUENCE"
     Case objConstants.nwSNMP_TYPE_IPADDRESS 
        GetTypeString = "nwSNMP_TYPE_IPADDRESS"
     Case objConstants.nwSNMP_TYPE_COUNTER32 
        GetTypeString = "nwSNMP_TYPE_COUNTER32"
     Case objConstants.nwSNMP_TYPE_GAUGE32
        GetTypeString = "nwSNMP_TYPE_GAUGE32"
     Case objConstants.nwSNMP_TYPE_TIMETICKS 
        GetTypeString = "nwSNMP_TYPE_TIMETICKS"
     Case objConstants.nwSNMP_TYPE_OPAQUE 
        GetTypeString = "nwSNMP_TYPE_OPAQUE"
     Case objConstants.nwSNMP_TYPE_COUNTER64
        GetTypeString = "nwSNMP_TYPE_COUNTER64"
     Case objConstants.nwSNMP_TYPE_UNSIGNED32 
        GetTypeString = "nwSNMP_TYPE_UNSIGNED32"
     Case Else 
        GetTypeString= "UNKNOWN" 
    End Select 
   End Function
%>

You can download the complete sample on our FTP site ftp.activexperts-labs.com/samples/network-component/. There are many other working Network Component scripts on our site and shipped with the product.