9808040000Z

IETF SNMPv3 Working Group

WG-email:   snmpv3@lists.tislabs.com
Subscribe:  majordomo@lists.tislabs.com
            In message body:  subscribe snmpv3

Chair:      Russ Mundy

            Trusted Information Systems
Postal:     3060 Washington Rd
            Glenwood MD 21738
            USA
EMail:      mundy@tislabs.com
Phone:      +1-301-854-6889

Co-editor:  David B. Levi
            SNMP Research, Inc.
Postal:     3001 Kimberlin Heights Road
            Knoxville, TN 37920-9716
EMail:      levi@snmp.com
Phone:      +1 423 573 1434

Co-editor:  Paul Meyer
            Secure Computing Corporation
Postal:     2675 Long Lake Road
            Roseville, MN 55113
EMail:      paul_meyer@securecomputing.com
Phone:      +1 651 628 1592

Co-editor:  Bob Stewart
            Cisco Systems, Inc.
Postal:     170 West Tasman Drive
            San Jose, CA 95134-1706
EMail:      bstewart@cisco.com
Phone:      +1 603 654 2686

This MIB module defines MIB objects which provide
mechanisms to remotely configure the parameters used
by an SNMP entity for the generation of SNMP messages.

A table of transport addresses to be used in the generation
of SNMP messages.

A table of SNMP target information to be used
in the generation of SNMP messages.

A transport address to be used in the generation
of SNMP operations.

Entries in the snmpTargetAddrTable are created and
deleted using the snmpTargetAddrRowStatus object.

A set of SNMP target information.

Entries in the snmpTargetParamsTable are created and
deleted using the snmpTargetParamsRowStatus object.

The locally arbitrary, but unique identifier associated
with this snmpTargetAddrEntry.

This object indicates the transport type of the address
contained in the snmpTargetAddrTAddress object.

This object contains a transport address.  The format of
this address depends on the value of the
snmpTargetAddrTDomain object.

This object should reflect the expected maximum round
trip time for communicating with the transport address
defined by this row.  When a message is sent to this
address, and a response (if one is expected) is not
received within this time period, an implementation
may assume that the response will not be delivered.

Note that the time interval that an application waits
for a response may actually be derived from the value
of this object.  The method for deriving the actual time
interval is implementation dependent.  One such method

is to derive the expected round trip time based on a
particular retransmission algorithm and on the number
of timeouts which have occurred.  The type of message may
also be considered when deriving expected round trip
times for retransmissions.  For example, if a message is
being sent with a securityLevel that indicates both
authentication and privacy, the derived value may be
increased to compensate for extra processing time spent
during authentication and encryption processing.

This object specifies a default number of retries to be
attempted when a response is not received for a generated
message.  An application may provide its own retry count,
in which case the value of this object is ignored.

This object contains a list of tag values which are
used to select target addresses for a particular
operation.

The value of this object identifies an entry in the
snmpTargetParamsTable.  The identified entry
contains SNMP parameters to be used when generating
messages to be sent to this transport address.

The storage type for this conceptual row.

The status of this conceptual row.

To create a row in this table, a manager must
set this object to either createAndGo(4) or
createAndWait(5).

Until instances of all corresponding columns are
appropriately configured, the value of the
corresponding instance of the snmpTargetAddrRowStatus
column is 'notReady'.

In particular, a newly created row cannot be made
active until the corresponding instances of
snmpTargetAddrTDomain, snmpTargetAddrTAddress, and
snmpTargetAddrParams have all been set.

The following objects may not be modified while the
value of this object is active(1):
    - snmpTargetAddrTDomain
    - snmpTargetAddrTAddress
An attempt to set these objects while the value of
snmpTargetAddrRowStatus is active(1) will result in
an inconsistentValue error.

The locally arbitrary, but unique identifier associated
with this snmpTargetParamsEntry.

The Message Processing Model to be used when generating
SNMP messages using this entry.

The Security Model to be used when generating SNMP
messages using this entry.  An implementation may
choose to return an inconsistentValue error if an
attempt is made to set this variable to a value
for a security model which the implementation does

not support.

The securityName which identifies the Principal on
whose behalf SNMP messages will be generated using
this entry.

The Level of Security to be used when generating
SNMP messages using this entry.

The storage type for this conceptual row.

The status of this conceptual row.

To create a row in this table, a manager must
set this object to either createAndGo(4) or
createAndWait(5).

Until instances of all corresponding columns are
appropriately configured, the value of the
corresponding instance of the snmpTargetParamsRowStatus
column is 'notReady'.

In particular, a newly created row cannot be made

active until the corresponding
snmpTargetParamsMPModel,
snmpTargetParamsSecurityModel,
snmpTargetParamsSecurityName,
and snmpTargetParamsSecurityLevel have all been set.
The following objects may not be modified while the
value of this object is active(1):
    - snmpTargetParamsMPModel
    - snmpTargetParamsSecurityModel
    - snmpTargetParamsSecurityName
    - snmpTargetParamsSecurityLevel
An attempt to set these objects while the value of
snmpTargetParamsRowStatus is active(1) will result in
an inconsistentValue error.

This object is used to facilitate modification of table
entries in the SNMP-TARGET-MIB module by multiple

managers.  In particular, it is useful when modifying
the value of the snmpTargetAddrTagList object.

The procedure for modifying the snmpTargetAddrTagList
object is as follows:

    1.  Retrieve the value of snmpTargetSpinLock and
        of snmpTargetAddrTagList.

    2.  Generate a new value for snmpTargetAddrTagList.

    3.  Set the value of snmpTargetSpinLock to the
        retrieved value, and the value of
        snmpTargetAddrTagList to the new value.  If
        the set fails for the snmpTargetSpinLock
        object, go back to step 1.

The total number of packets received by the SNMP
engine which were dropped because the context
contained in the message was unavailable.

The total number of packets received by the SNMP
engine which were dropped because the context
contained in the message was unknown.

A collection of objects providing basic remote
configuration of management targets.

A collection of objects providing remote configuration
of management targets for applications which generate
SNMP messages for which a response message would be
expected.

A collection of objects required for command responder
applications, used for counting error conditions.

The compliance statement for SNMP entities which include
a command responder application.