Download ActiveSocket Network Communications Toolkit 4.1

  Download Manual

ColdFusion SNMP Sample Source Code

• 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.

• 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.

For the usage of SNMP in ColdFusion, we're going to work with objects. Sending an OID to a server is quit simple. It can be done in four simple steps.

• Make the ActiveSocket object
• Fill in the properties
• Connect to the host
• Send the OID

Attention: Before using this sample, make sure you've configured SNMP properly.

Once the object is created the rest is easy. To make the ActiveSocket object in ColdFusion you need the following code snippet:

 <cfobject class="ActiveXperts.SnmpManager" type="com" name="objSnmp" Action="Create"> 

Trough this tag you are able to communicate trough the ActiveSocket toolkit. The program has a certain amount of options witch are to be found in the products manual that is shipped with it. In our sample just a few of them are used. You can call to a function of the object using a “.”.

We're also going to need a form that collects the required information to send an OID. We've made a form that looks like this:

Once the form is ready the first thing we're configuring is the “logfile” option. You can fill in the path and filename for the logfile. Trough this file you’re able to check what goes on during the execution of the script you are writing. Use the following code to configure the logfile:

 <cfset objSnmpManager.LogFile = “C:\temp\logfile.txt”> 

First of all we're going to initialise SNMP. Using "Initialize()":

 <cfset objSnmpManager.Initialize()> 

Then we're moving on to setting the protocol version. We're doing this with the "version" property of the object we have created. Versions can differ between version one and two.

 <cfset objSnmpManager.Version = URL.Version > 

If all of this is succesfully configured, we're able to open a connection to a host. We're able to do that using the "Open()" command. We need to fill in the host, the community and the portnumber.

 <cfset objSnmpManager.Open("localhost", "public", 161) > 

You're able to get an OID using the property "Get("someOid")". This makes the entire sourcecode to send an OID look like this:

function snmpget(getnext, OID){

   objSnmpManager.LogFile = strLogFile;
   objSnmpManager.Initialize();
   objSnmpManager.ProtocolVersion = strVersion;
   
   if(objSnmpManager.LastError eq 0){
      objSnmpManager.Open(strHost,strCommunity,strPort);
   }

   if(objSnmpManager.LastError eq 0){
     objSnmpData = objSnmpManager.get(OID);
     if (getnext eq "getnext") {
       objSnmpData = objSnmpManager.getnext();
     }
	   
   }
	 
   if(objSnmpManager.LastError eq 0){

     strOid = objSnmpData.oid;
     strValue = objSnmpData.value & "<br>";
		 
   }

   strResult = objSnmpManager.LastError & " : " & objSnmpManager.GetErrorDescription(objSnmpManager.LastError);
	 
   objSnmpManager.Close();
   objSnmpManager.Shutdown();	 

}

The ActiveSocket tool is a Network Communications ActiveX software component (SDK). This control supports SNMP, SMTP, POP3, Telnet, TCP, NTP, RSH, HTTP, HTTPs, FTP, DNS, ICMP and more, and can be used by any Windows development platform, including Visual Basic .NET, Visual CSharp .NET, ASP .NET (VB,CS), ASP, Visual Basic, Visual Studio/Visual C++, Delphi, PHP, ColdFusion, HTML, VBScript and any other ActiveX/COM compliant platform. The ActiveSocket Toolkit is an ActiveXperts Software B.V. Product.