EZ5 MIB Catalog

AGENTX-MIB

2000-01-10

Download AGENTX-MIB.txt Open AGENTX-MIB.txt in a new tab

This is the MIB module for the SNMP Agent Extensibility Protocol (AgentX). This MIB module will be implemented by the master agent.

SCALARS (5) · TABLES (3)

Scalars (5)

NameOID
agentxDefaultTimeout1.3.6.1.2.1.74.1.1.1
agentxMasterAgentXVer1.3.6.1.2.1.74.1.1.2
agentxConnTableLastChange1.3.6.1.2.1.74.1.2.1
agentxSessionTableLastChange1.3.6.1.2.1.74.1.3.1
agentxRegistrationTableLastChange1.3.6.1.2.1.74.1.4.1

Tables (3)

NameOID
agentxConnectionTable1.3.6.1.2.1.74.1.2.2
agentxSessionTable1.3.6.1.2.1.74.1.3.2
agentxRegistrationTable1.3.6.1.2.1.74.1.4.2

END OF TOC

Scalar details

agentxDefaultTimeout

1.3.6.1.2.1.74.1.1.1

INTEGER (0..255) · Integer32 · seconds

The default length of time, in seconds, that the master agent should allow to elapse after dispatching a message to a session before it regards the subagent as not responding. This is a system-wide value that may override the timeout value associated with a particular session (agentxSessionTimeout) or a particular registered MIB region (agentxRegTimeout). If the associated value of agentxSessionTimeout and agentxRegTimeout are zero, or impractical in accordance with implementation-specific procedure of the master agent, the value represented by this object will be the effective timeout value for the master agent to await a response to a dispatch from a given subagent.

agentxMasterAgentXVer

1.3.6.1.2.1.74.1.1.2

INTEGER (1..255) · Integer32

The AgentX protocol version supported by this master agent. The current protocol version is 1. Note that the master agent must also allow interaction with earlier version subagents.

agentxConnTableLastChange

1.3.6.1.2.1.74.1.2.1

TimeStampThe value of the sysUpTime object at which a specific occurrence happened. The specific occurrence must be defined in the description of any object defined using this type. If sysUpTime is reset to zero as a result of a re- initialization of the network management (sub)system, then the values of all TimeStamp objects are also reset. However, after approximately 497 days without a re- initialization, the sysUpTime object will reach 2^^32-1 and then increment around to zero; in this case, existing values of TimeStamp objects do not change. This can lead to ambiguities in the value of TimeStamp objects. · TimeTicks

The value of sysUpTime when the last row creation or deletion occurred in the agentxConnectionTable.

agentxSessionTableLastChange

1.3.6.1.2.1.74.1.3.1

TimeStampThe value of the sysUpTime object at which a specific occurrence happened. The specific occurrence must be defined in the description of any object defined using this type. If sysUpTime is reset to zero as a result of a re- initialization of the network management (sub)system, then the values of all TimeStamp objects are also reset. However, after approximately 497 days without a re- initialization, the sysUpTime object will reach 2^^32-1 and then increment around to zero; in this case, existing values of TimeStamp objects do not change. This can lead to ambiguities in the value of TimeStamp objects. · TimeTicks

The value of sysUpTime when the last row creation or deletion occurred in the agentxSessionTable.

agentxRegistrationTableLastChange

1.3.6.1.2.1.74.1.4.1

TimeStampThe value of the sysUpTime object at which a specific occurrence happened. The specific occurrence must be defined in the description of any object defined using this type. If sysUpTime is reset to zero as a result of a re- initialization of the network management (sub)system, then the values of all TimeStamp objects are also reset. However, after approximately 497 days without a re- initialization, the sysUpTime object will reach 2^^32-1 and then increment around to zero; in this case, existing values of TimeStamp objects do not change. This can lead to ambiguities in the value of TimeStamp objects. · TimeTicks

The value of sysUpTime when the last row creation or deletion occurred in the agentxRegistrationTable.

Table details

agentxConnectionTable

1.3.6.1.2.1.74.1.2.2

Index: agentxConnIndex

The agentxConnectionTable tracks all current AgentX transport connections. There may be zero, one, or more AgentX sessions carried on a given AgentX connection.

agentxConnIndex

1.3.6.1.2.1.74.1.2.2.1.1

Unsigned32 (1..4294967295)

agentxConnIndex contains the value that uniquely identifies an open transport connection used by this master agent to provide AgentX service. Values of this index should not be re-used. The value assigned to a given transport connection is constant for the lifetime of that connection.

agentxConnOpenTime

1.3.6.1.2.1.74.1.2.2.1.2

TimeStampThe value of the sysUpTime object at which a specific occurrence happened. The specific occurrence must be defined in the description of any object defined using this type. If sysUpTime is reset to zero as a result of a re- initialization of the network management (sub)system, then the values of all TimeStamp objects are also reset. However, after approximately 497 days without a re- initialization, the sysUpTime object will reach 2^^32-1 and then increment around to zero; in this case, existing values of TimeStamp objects do not change. This can lead to ambiguities in the value of TimeStamp objects. · TimeTicks

The value of sysUpTime when this connection was established and, therefore, its value when this entry was added to the table.

agentxConnTransportDomain

1.3.6.1.2.1.74.1.2.2.1.3

TDomainDenotes a kind of transport service. Some possible values, such as snmpUDPDomain, are defined in the SNMPv2-TM MIB module. Other possible values are defined in other MIB modules.Reference: The SNMPv2-TM MIB module is defined in RFC 1906. · OBJECT IDENTIFIER

The transport protocol in use for this connection to the subagent.

agentxConnTransportAddress

1.3.6.1.2.1.74.1.2.2.1.4

AgentxTAddressDenotes a transport service address. This is identical to the TAddress textual convention (SNMPv2-SMI) except that zero-length values are permitted. SIZE (0..255) · OCTET STRING

The transport address of the remote (subagent) end of this connection to the master agent. This object may be zero-length for unix-domain sockets (and possibly other types of transport addresses) since the subagent need not bind a filename to its local socket.

agentxSessionTable

1.3.6.1.2.1.74.1.3.2

Index: agentxConnIndex · agentxSessionIndex

A table of AgentX subagent sessions currently in effect.

agentxSessionIndex

1.3.6.1.2.1.74.1.3.2.1.1

Unsigned32

A unique index for the subagent session. It is the same as h.sessionID defined in the agentx header. Note that if a subagent's session with the master agent is closed for any reason its index should not be re-used. A value of zero(0) is specifically allowed in order to be compatible with the definition of h.sessionId.

agentxSessionObjectID

1.3.6.1.2.1.74.1.3.2.1.2

OBJECT IDENTIFIER

This is taken from the o.id field of the agentx-Open-PDU. This attribute will report a value of '0.0' for subagents not supporting the notion of an AgentX session object identifier.

agentxSessionDescr

1.3.6.1.2.1.74.1.3.2.1.3

SnmpAdminStringAn octet string containing administrative information, preferably in human-readable form. To facilitate internationalization, this information is represented using the ISO/IEC IS 10646-1 character set, encoded as an octet string using the UTF-8 transformation format described in [RFC2279]. Since additional code points are added by amendments to the 10646 standard from time to time, implementations must be prepared to encounter any code point from 0x00000000 to 0x7fffffff. Byte sequences that do not correspond to the valid UTF-8 encoding of a code point or are outside this range are prohibited. The use of control codes should be avoided. When it is necessary to represent a newline, the control code sequence CR LF should be used. The use of leading or trailing white space should be avoided. For code points not directly supported by user interface hardware or software, an alternative means of entry and display, such as hexadecimal, may be provided. For information encoded in 7-bit US-ASCII, the UTF-8 encoding is identical to the US-ASCII encoding. UTF-8 may require multiple bytes to represent a single character / code point; thus the length of this object in octets may be different from the number of characters encoded. Similarly, size constraints refer to the number of encoded octets, not the number of characters represented by an encoding. Note that when this TC is used for an object that is used or envisioned to be used as an index, then a SIZE restriction MUST be specified so that the number of sub-identifiers for any object instance does not exceed the limit of 128, as defined by [RFC3416]. Note that the size of an SnmpAdminString object is measured in octets, not characters. SIZE (0..255) · OCTET STRING · hint 255t

A textual description of the session. This is analogous to sysDescr defined in the SNMPv2-MIB in RFC 1907 [19] and is taken from the o.descr field of the agentx-Open-PDU. This attribute will report a zero-length string value for subagents not supporting the notion of a session description.

agentxSessionAdminStatus

1.3.6.1.2.1.74.1.3.2.1.4

INTEGER1 = up2 = down · Integer32

The administrative (desired) status of the session. Setting the value to 'down(2)' closes the subagent session (with c.reason set to 'reasonByManager').

agentxSessionOpenTime

1.3.6.1.2.1.74.1.3.2.1.5

TimeStampThe value of the sysUpTime object at which a specific occurrence happened. The specific occurrence must be defined in the description of any object defined using this type. If sysUpTime is reset to zero as a result of a re- initialization of the network management (sub)system, then the values of all TimeStamp objects are also reset. However, after approximately 497 days without a re- initialization, the sysUpTime object will reach 2^^32-1 and then increment around to zero; in this case, existing values of TimeStamp objects do not change. This can lead to ambiguities in the value of TimeStamp objects. · TimeTicks

The value of sysUpTime when this session was opened and, therefore, its value when this entry was added to the table.

agentxSessionAgentXVer

1.3.6.1.2.1.74.1.3.2.1.6

INTEGER (1..255) · Integer32

The version of the AgentX protocol supported by the session. This must be less than or equal to the value of agentxMasterAgentXVer.

agentxSessionTimeout

1.3.6.1.2.1.74.1.3.2.1.7

INTEGER (0..255) · Integer32 · seconds

The length of time, in seconds, that a master agent should allow to elapse after dispatching a message to this session before it regards the subagent as not responding. This value is taken from the o.timeout field of the agentx-Open-PDU. This is a session-specific value that may be overridden by values associated with the specific registered MIB regions (see agentxRegTimeout). A value of zero(0) indicates that the master agent's default timeout value should be used (see agentxDefaultTimeout).

agentxRegistrationTable

1.3.6.1.2.1.74.1.4.2

Index: agentxConnIndex · agentxSessionIndex · agentxRegIndex

A table of registered regions.

agentxRegIndex

1.3.6.1.2.1.74.1.4.2.1.1

Unsigned32 (1..4294967295)

agentxRegIndex uniquely identifies a registration entry. This value is constant for the lifetime of an entry.

agentxRegContext

1.3.6.1.2.1.74.1.4.2.1.2

OCTET STRING

The context in which the session supports the objects in this region. A zero-length context indicates the default context.

agentxRegStart

1.3.6.1.2.1.74.1.4.2.1.3

OBJECT IDENTIFIER

The starting OBJECT IDENTIFIER of this registration entry. The session identified by agentxSessionIndex implements objects starting at this value (inclusive). Note that this value could identify an object type, an object instance, or a partial object instance.

agentxRegRangeSubId

1.3.6.1.2.1.74.1.4.2.1.4

Unsigned32

agentxRegRangeSubId is used to specify the range. This is taken from r.region_subid in the registration PDU. If the value of this object is zero, no range is specified. If it is non-zero, it identifies the `nth' sub-identifier in r.region for which this entry's agentxRegUpperBound value is substituted in the OID for purposes of defining the region's upper bound.

agentxRegUpperBound

1.3.6.1.2.1.74.1.4.2.1.5

Unsigned32

agentxRegUpperBound represents the upper-bound sub-identifier in a registration. This is taken from the r.upper_bound in the registration PDU. If agentxRegRangeSubid (r.region_subid) is zero, this value is also zero and is not used to define an upper bound for this registration.

agentxRegPriority

1.3.6.1.2.1.74.1.4.2.1.6

Unsigned32

The registration priority. Lower values have higher priority. This value is taken from r.priority in the register PDU. Sessions should use the value of 127 for r.priority if a default value is desired.

agentxRegTimeout

1.3.6.1.2.1.74.1.4.2.1.7

INTEGER (0..255) · Integer32 · seconds

The timeout value, in seconds, for responses to requests associated with this registered MIB region. A value of zero(0) indicates the default value (indicated by by agentxSessionTimeout or agentxDefaultTimeout) is to be used. This value is taken from the r.timeout field of the agentx-Register-PDU.

agentxRegInstance

1.3.6.1.2.1.74.1.4.2.1.8

TruthValue1 = true2 = falseRepresents a boolean value. · Integer32

The value of agentxRegInstance is `true' for registrations for which the INSTANCE_REGISTRATION was set, and is `false' for all other registrations.

↑ To TOC