IPWorks SNMP 2020 Kotlin Edition

Questions / Feedback?

Response Event

Fired when a GetResponse packet is received.

Syntax

public open class DefaultSnmpmgrEventListener : SnmpmgrEventListener {
  ...
  public override fun response(e: SnmpmgrResponseEvent) {}
  ...
}

public class SnmpmgrResponseEvent {
  val requestId: Int
  val snmpVersion: Int
  val community: String?
  val user: String?
  val securityLevel: Int
  val sourceAddress: String?
  val sourcePort: Int
  val errorIndex: Int
  val errorStatus: Int
  val errorDescription: String?
}

Remarks

The ErrorStatus and ErrorIndex parameters contain information about possible errors. ErrorDescription is a textual description of ErrorStatus. This value is parsed directly from the SNMP response, which will be a one-based value, so a value of i here maps to index i-1 in the Objects collection.

The following is a list of valid SNMP status code values:

0 (noError) No error.
1 (tooBig) The response cannot fit in a single SNMP message.
2 (noSuchName) Variable does not exist.
3 (badValue) Invalid value or syntax.
4 (readOnly) Variable is read-only.
5 (genError) Other error (SNMPv1).
6 (noAccess) Access denied.
7 (wrongType) Wrong object type.
8 (wrongLength) Wrong length.
9 (wrongEncoding) Wrong encoding.
10 (wrongValue) Wrong value.
11 (noCreation) No creation.
12 (inconsistentValue) Inconsistent value.
13 (resourceUnavailable) Resource unavailable.
14 (commitFailed) Commit failed.
15 (undoFailed) Undo failed.
16 (authorizationError) Authorization error.
17 (notWritable) Variable is not writable.
18 (inconsistentName) Inconsistent name.

The ErrorIndex parameter indicates the index of the first variable (object) that caused an error. The default value is 0.

Variable indexes start with 0. ErrorIndex has no meaning when ErrorStatus is 0 (no error).

The list of variables in the SNMP packet, including optional values and types, is provided through the Objects collection. Each object is of type SNMPObject. This type describes the Oid, ObjectType, and Value of each SNMP object. These variables must be copied to another location before the event has completed executing, or they may be overridden by other events.

The SourceAddress and SourcePort parameters show the address and port of the sender as reported by the TCP/IP stack.

Copyright (c) 2021 /n software inc. - All rights reserved.
IPWorks SNMP 2020 Kotlin Edition - Version 20.0 [Build 7941]