Gets the error status for this sub-request. Calling this method is a
shortcut for SubRequest.getStatus() .getErrorStatus()
.
a SNMPv2/v3 error status. since: 1.0.1
Gets the query previously associated with this sub-request. A sub-request
is associated during requests processing with a instrumentation query.
a MOQuery that describes which manage objects matchthis sub-request.
Gets the scope for this subrequest. The scope is solely defined by this
sub-request and possible request processing that has already excluded
managed objects from the scope of this sub-request.
a MOScope instance.
Gets the undo value object associated with this sub-request.
an Object that has previously been associated with this request bycalling SubRequest.setUndoValue.
Returns the variable binding associated with the sub-request. In order to
process a sub-request this variable binding needs to be modified (if not
an error condition prevents that).
the VariableBinding that holds the sub-request resultor operation parameter (in case of a SET request).
Checks whether the sub-request has been completed and needs no further
processing.
true if the sub-request has been finished and should notbe processed any more.
Returns an iterator on the repetitions of this sub-request. On requests
other than GETBULK requests this method returns an empty iterator.
a SubRequestIterator enumerating the repetitions on this sub-requestsstarting with this sub-request.
Sets the error status for this sub-request. Calling this method is a
shortcut for SubRequest.getStatus() .setErrorStatus(int errorStatus)
.
Parameters: errorStatus - a SNMPv2/v3 error status. since: 1.0.1
Sets the query associated with this subrequest. The query is not used
by the request itself but may be stored here for further reference
while processing this sub-requests.
Parameters: query - a MOQuery instance representing the query resulting fromthis sub-request.
Sets the ManagedObject that is determined as the target object
of this sub-request by the agent framework. For SET requests the target
managed object is locked and referenced here to make sure that all locks
are released when a request is answered. In addition, SET requests are
processed in multiple phases and referencing the target managed objects
increases performance.
Parameters: managedObject - the ManagedObject responsible for processing this sub-request.
Associates an undo value object with this sub-request. The undo
value is internally used by the SNMP4J-Agent API and should therefore
not be altered externally. One exception to this rule is an implementation
of the
ManagedObject interface that does not extend any other
API class.
Parameters: undoInformation - an object that represents/contains all necessary information to undothis sub-request.
Sets the user object. The user object can be used to associate resources
or any other type of information necessary for a managed object instance
to process a SNMP request. When the request is processed, this reference
will be set to null.
Parameters: userObject - an object that is not processed or interpreted by the agent API. since: 1.0.1
Updates the next repetition's scope and reset any previously set query
to null. The scope of the next repetition is updated
according to the value of this variable binding. If this sub-request
has an error status or exception value, the following repetitions are
set to the same value and exception. Otherwise, the scope of the following
sub-request is the open interval from this sub-request's OID
(not-including) to any OID value.