OpenNMS API 1.2.3

org.opennms.protocols.snmp
Class SnmpPduRequest

java.lang.Object
  extended byorg.opennms.protocols.snmp.SnmpPduPacket
      extended byorg.opennms.protocols.snmp.SnmpPduRequest
All Implemented Interfaces:
java.lang.Cloneable, SnmpSyntax

public class SnmpPduRequest
extends SnmpPduPacket

The SnmpPduRequest defines the SNMPv1 and SNMPv2 Protocol Data Unit (PDU) for certian message types. The types include: GetRequest, GetNextRequest, SetRequest, SNMPv2-Trap, InformRequest, and Response. By default the class is constructed as a SNMP GetRequest, but can be defined to any of the accepted types. For more information see [Stallings99] page 368.

Version:
1.1.1.1
Author:
Brian Weaver

Field Summary
 
Fields inherited from class org.opennms.protocols.snmp.SnmpPduPacket
ErrAuthorizationError, ErrBadValue, ErrCommitFailed, ErrGenError, ErrInconsistentName, ErrInconsistentValue, ErrNoAccess, ErrNoCreation, ErrNoError, ErrNoSuchName, ErrNotWritable, ErrReadOnly, ErrResourceUnavailable, ErrTooBig, ErrUndoFailed, ErrWrongEncoding, ErrWrongLength, ErrWrongType, ErrWrongValue, GET, GETBULK, GETNEXT, INFORM, m_errIndex, m_errStatus, REPORT, RESPONSE, SET, V2TRAP
 
Constructor Summary
SnmpPduRequest()
          Default class constructor.
SnmpPduRequest(int command)
          Constructs a new PDU Request with the specified command.
SnmpPduRequest(int command, SnmpVarBind[] vars)
          Constructs the PDU with the specified command and the passed variables.
SnmpPduRequest(SnmpPduRequest second)
          Class copy constructor.
 
Method Summary
 java.lang.Object clone()
          Used to get a duplicate of self.
 SnmpSyntax duplicate()
          Used to get a duplicate of self.
 void fix()
          Fixes a PDU in error.
 int getErrorIndex()
          Returns the index of the variable in error if the error status is non-zero.
 int getErrorStatus()
          Returns the error status for the request.
 void setErrorIndex(int ndx)
          Sets the current error index in the PDU.
 void setErrorStatus(int status)
          Used to set the value of the error status member.
 
Methods inherited from class org.opennms.protocols.snmp.SnmpPduPacket
addVarBind, addVarBindAt, decodeASN, encodeASN, getCommand, getLength, getPeer, getRequestId, getVarBindAt, nextSequence, removeVarBindAt, setCommand, setPeer, setRequestId, setVarBindAt, toVarBindArray, typeId
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SnmpPduRequest

public SnmpPduRequest()
Default class constructor. By default the request is a SNMP GetRequest.


SnmpPduRequest

public SnmpPduRequest(SnmpPduRequest second)
Class copy constructor. Constructs a new object that is an identical to the passed object.

Parameters:
second - The object to make a duplicate of.

SnmpPduRequest

public SnmpPduRequest(int command)
Constructs a new PDU Request with the specified command.

Parameters:
command - The type of PDU to construct
See Also:
SnmpPduPacket.GET, SnmpPduPacket.GETNEXT, SnmpPduPacket.SET, SnmpPduPacket.RESPONSE, SnmpPduPacket.INFORM, SnmpPduPacket.V2TRAP, SnmpPduPacket.REPORT

SnmpPduRequest

public SnmpPduRequest(int command,
                      SnmpVarBind[] vars)
Constructs the PDU with the specified command and the passed variables.

Parameters:
command - The type of PDU to construct
vars - The SNMP variables for the PDU.
See Also:
SnmpPduPacket.GET, SnmpPduPacket.GETNEXT, SnmpPduPacket.SET, SnmpPduPacket.RESPONSE, SnmpPduPacket.INFORM, SnmpPduPacket.V2TRAP, SnmpPduPacket.REPORT
Method Detail

getErrorStatus

public int getErrorStatus()
Returns the error status for the request. This is only value on RESPONSE pdu's. Otherwise the value should be equal to zero. For information on error conditions see the SnmpPduPacket class.

Returns:
The error status of the pdu
See Also:
SnmpPduPacket

setErrorStatus

public void setErrorStatus(int status)
Used to set the value of the error status member. This should normally be equal to zero, except for RESPONSE pdu's

Parameters:
status - The new error status for the pdu.

getErrorIndex

public int getErrorIndex()
Returns the index of the variable in error if the error status is non-zero. The index is base one, not zero. Thus an error index equal to one is the first variable in the PDU. An index equal to zero is not valid.

Returns:
The index of the bad variable.

setErrorIndex

public void setErrorIndex(int ndx)
Sets the current error index in the PDU. the index must be in the range (0..#variables] unless there is no error. If there is no error then the index should be equal to zero.

Parameters:
ndx - The new error index.

fix

public void fix()
Fixes a PDU in error. If the error index and error status is non-zero then the variable in error is removed from the PDU. Once the variable is removed the error index and error status are reset to zero.


duplicate

public SnmpSyntax duplicate()
Used to get a duplicate of self. The duplicate is identical to self but shares no common data.

Specified by:
duplicate in interface SnmpSyntax
Specified by:
duplicate in class SnmpPduPacket
Returns:
A newly created copy of self.

clone

public java.lang.Object clone()
Used to get a duplicate of self. The duplicate is identical to self but shares no common data.

Specified by:
clone in class SnmpPduPacket
Returns:
A newly created copy of self.

OpenNMS API 1.2.3

Generated by eevans on May 29 2005 2015.