Compaq TCP/IP Services for OpenVMS Programming And Reference Manual page 67

When restarting the eSNMP protocol by calling
registrations are cleared. All MIB subtrees must be reregistered.
A MIB subtree is identified by the base MIB variable name and its corresponding
OID. This tuple represents the parent of all MIB variables that are contained in
the MIB subtree; for example, the MIB II
All elements subordinate to this (those that have the same first 7 identifiers) are
included in the subtree's object table. A MIB subtree can also be a single MIB
object (a leaf node) or even a specific instance.
By registering a MIB subtree, the subagent indicates that it will process SNMP
requests for all MIB variables (or OIDs) within that MIB subtree's region.
Therefore, a subagent should register the most fully qualified (longest) MIB
subtree that still contains its instrumented MIB variables.
A subagent using the
subtree for the local node and for a cluster. To register the MIB subtree
for both, you must call the
ESNMP_REG_OPT_CLUSTER bit set in the options field and once with the
ESNMP_REG_OPT_CLUSTER bit clear in the options field. Alternatively, you
can register a MIB subtree for the cluster only or for the local node only, by
setting or clearing the ESNMP_REG_OPT_CLUSTER bit, respectively, in the
options field.
A subagent can also register MIB subtrees that overlap the OID range of
MIB subtrees that it previously registered or the OID ranges of MIB subtrees
registered by other subagents.
For example, consider the two subagents
subagent registers the
registers the
registrations are made with the ESNMP_REG_OPT_CLUSTER bit set in the
options field. Requests for
ipRouteIfIndex
for other
passed to the
the
ipRouteEntry
the
os_mibs
all ipRouteEntry
ipRouteIfIndex
Return Values
SNMP_LIB_OK
ESNMP_LIB_BAD_REG
ESNMP_LIB_LOST_
CONNECTION
Note that the return value indicates only the initiation of the request. The actual
status returned in the master agent's response will be returned in a subsequent
call to the
esnmp_register2
esnmp_register2
MIB subtree (1.3.6.1.2.1.4), and the
ip
ipRouteEntry MIB subtree (1.3.6.1.2.1.4.21.1). Both of these
MIB variables within
ip
(1.3.6.1.2.1.4.21.1.2), are passed to the
ip variables, such as ipNetToMediaIfIndex
subagent. If the
os_mibs
MIB subtree, subsequent requests for
subagent. This occurs because the
MIB variables, is now the authoritative region of requests for
.
The
successfully.
The
timeout
is not available, or this MIB subtree has already
been queued for registration. A message is also
in the log file.
The subagent lost communication with the
master agent.
esnmp_poll routine in the
eSNMP API Routines
esnmp_init
tcp subtree has an OID of 1.3.6.1.2.1.6.
routine can register the same MIB
routine twice: once with the
and
os_mibs gated
ipRouteEntry
gated
(1.3.6.1.2.1.4.22.1.1), are
subagent terminates or unregisters
gated
ipRouteIfIndex
MIB subtree, which includes
ip
esnmp_register2 routine has completed
routine has not been called, the
esnmp_init
parameter is invalid, a registration slot
state field.
eSNMP API Routines 5–9
esnmp_register2
, all MIB subtree
. The
os_mibs
subagent
gated
, such as
subagent. Requests
go to