snmpGetInteger (Function)

This function will read an integer value from a managed device.

Input:

Handle : SYSHANDLE

The handle to the connection established from snmpConnect.

OID : STRING

The OID for the value to read.

Output:

V : DINT

The value read.

Returns: INT

Declaration

FUNCTION snmpGetInteger : INT;
VAR_INPUT
  Handle  : MANDATORY SYSHANDLE;
  OID     : MANDATORY STRING;
  V       : ACCESS DINT;
END_VAR;

Example:

INCLUDE rtcu.inc
 
VAR
  iface    : SINT := 2;
END_VAR;
 
PROGRAM test;
VAR
  rc       : INT;
  snmplabs : SYSHANDLE;
  var_int  : DINT;
END_VAR;
  // Open net interface.
  rc := netOpen(iface := iface);
  DebugFmt(Message := "netOpen (rc=\1)", v1 := rc);
  WHILE NOT netConnected(iface := iface) DO
    Sleep(Delay := 2000);
  END_WHILE;
 
  // Establish connection with client host.
  rc := snmpConnect(
                    handle   := snmplabs,
                    community := "public",
                    host     := "demo.snmplabs.com"
                   );
  IF rc = 1 THEN
     // Read 'sysServices'
     rc := snmpGetInteger(
                          handle := snmplabs,
                          oid   := "1.3.6.1.2.1.1.7",
                          v     := var_int
                         );
     IF rc = 1 THEN
        DebugFmt(message := "snmpGetInteger returned : \4", v4 := var_int);
     ELSE
        DebugFmt(message := "snmpGetInteger (rc=\1)", v1 := rc);
     END_IF;
  ELSE
    DebugFmt(message := "snmpConnect failed (rc=\1)", v1 := rc);
  END_IF;
  ...
BEGIN
  ...
END;
END_PROGRAM;