AGENTX-MIB DEFINITIONS ::= BEGIN

IMPORTS

 MODULE-IDENTITY, OBJECT-TYPE, Unsigned32, mib-2

    FROM SNMPv2-SMI

 SnmpAdminString

    FROM SNMP-FRAMEWORK-MIB

 MODULE-COMPLIANCE, OBJECT-GROUP

    FROM SNMPv2-CONF

 TEXTUAL-CONVENTION, TimeStamp, TruthValue, TDomain

    FROM SNMPv2-TC;

agentxMIB MODULE-IDENTITY

 LAST-UPDATED "200001100000Z" -- Midnight 10 January 2000

 ORGANIZATION "AgentX Working Group"

 CONTACT-INFO "WG-email:   agentx@dorothy.bmc.com

               Subscribe:  agentx-request@dorothy.bmc.com

               WG-email Archive:  ftp://ftp.peer.com/pub/agentx/archives

               FTP repository:  ftp://ftp.peer.com/pub/agentx

               http://www.ietf.org/html.charters/agentx-charter.html

               Chair:      Bob Natale

                           ACE*COMM Corporation

               Email:      bnatale@acecomm.com

               WG editor:  Mark Ellison

                           Ellison Software Consulting, Inc.

               Email:      ellison@world.std.com

               Co-author:  Lauren Heintz

                           Cisco Systems,

               EMail:      lheintz@cisco.com

               Co-author:  Smitha Gudur

                           Independent Consultant

               Email:      sgudur@hotmail.com

              "

 DESCRIPTION    "This is the MIB module for the SNMP Agent Extensibility

     Protocol (AgentX).  This MIB module will be implemented by

     the master agent.

    "

  REVISION     "200001100000Z" -- Midnight 10 January 2000

 DESCRIPTION

    "Initial version published as RFC 2742."

  ::= { mib-2  74 }

 -- Textual Conventions

 AgentxTAddress ::= TEXTUAL-CONVENTION

   STATUS       current

   DESCRIPTION

     "Denotes a transport service address.  This is identical to

      the TAddress textual convention (SNMPv2-SMI) except that

      zero-length values are permitted.

     "

   SYNTAX       OCTET STRING (SIZE (0..255))

 -- Administrative assignments

 agentxObjects OBJECT IDENTIFIER      ::= { agentxMIB 1 }

 agentxGeneral OBJECT IDENTIFIER      ::= { agentxObjects 1 }

 agentxConnection OBJECT IDENTIFIER   ::= { agentxObjects 2 }

 agentxSession OBJECT IDENTIFIER      ::= { agentxObjects 3 }

 agentxRegistration OBJECT IDENTIFIER ::= { agentxObjects 4 }

 agentxDefaultTimeout OBJECT-TYPE

  SYNTAX      INTEGER (0..255)

  UNITS       "seconds"

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "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.

     "

  DEFVAL      { 5 }

  ::= { agentxGeneral 1 }

 agentxMasterAgentXVer OBJECT-TYPE

  SYNTAX      INTEGER (1..255)

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "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.

     "

  ::= { agentxGeneral 2 }

 --      The AgentX Subagent Connection Group

 agentxConnTableLastChange OBJECT-TYPE

  SYNTAX      TimeStamp

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "The value of sysUpTime when the last row creation or deletion

      occurred in the agentxConnectionTable.

     "

  ::= { agentxConnection 1 }

 agentxConnectionTable OBJECT-TYPE

   SYNTAX      SEQUENCE OF AgentxConnectionEntry

   MAX-ACCESS  not-accessible

   STATUS      current

   DESCRIPTION

     "The agentxConnectionTable tracks all current AgentX transport

      connections.  There may be zero, one, or more AgentX sessions

      carried on a given AgentX connection.

     "

   ::= { agentxConnection 2 }

 agentxConnectionEntry OBJECT-TYPE

   SYNTAX      AgentxConnectionEntry

   MAX-ACCESS  not-accessible

   STATUS      current

   DESCRIPTION

     "An agentxConnectionEntry contains information describing a

      single AgentX transport connection.  A connection may be

      used to support zero or more AgentX sessions.  An entry is

      created when a new transport connection is established,

      and is destroyed when the transport connection is terminated.

     "

   INDEX { agentxConnIndex }

   ::= { agentxConnectionTable 1 }

 AgentxConnectionEntry ::= SEQUENCE {

          agentxConnIndex            Unsigned32,

          agentxConnOpenTime         TimeStamp,

          agentxConnTransportDomain  TDomain,

          agentxConnTransportAddress AgentxTAddress }

 agentxConnIndex OBJECT-TYPE

   SYNTAX       Unsigned32 (1..4294967295)

   MAX-ACCESS   not-accessible

   STATUS       current

   DESCRIPTION

     "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.

     "

   ::= { agentxConnectionEntry 1 }

 agentxConnOpenTime OBJECT-TYPE

   SYNTAX       TimeStamp

   MAX-ACCESS   read-only

   STATUS       current

   DESCRIPTION

     "The value of sysUpTime when this connection was established

      and, therefore, its value when this entry was added to the table.

     "

   ::= { agentxConnectionEntry 2 }

 agentxConnTransportDomain OBJECT-TYPE

   SYNTAX       TDomain

   MAX-ACCESS   read-only

   STATUS       current

   DESCRIPTION

     "The transport protocol in use for this connection to the

      subagent.

     "

   ::= { agentxConnectionEntry 3 }

 agentxConnTransportAddress OBJECT-TYPE

   SYNTAX       AgentxTAddress

   MAX-ACCESS   read-only

   STATUS       current

   DESCRIPTION

     "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.

     "

   ::= { agentxConnectionEntry 4 }

 -- The AgentX Subagent Session Group

 agentxSessionTableLastChange OBJECT-TYPE

  SYNTAX      TimeStamp

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "The value of sysUpTime when the last row creation or deletion

      occurred in the agentxSessionTable.

     "

  ::= { agentxSession 1 }

 agentxSessionTable OBJECT-TYPE

  SYNTAX      SEQUENCE OF AgentxSessionEntry

  MAX-ACCESS  not-accessible

  STATUS      current

  DESCRIPTION

     "A table of AgentX subagent sessions currently in effect.

     "

  ::= { agentxSession 2 }

 agentxSessionEntry OBJECT-TYPE

  SYNTAX      AgentxSessionEntry

  MAX-ACCESS  not-accessible

  STATUS      current

  DESCRIPTION

     "Information about a single open session between the AgentX

      master agent and a subagent is contained in this entry.  An

      entry is created when a new session is successfully established

      and is destroyed either when the subagent transport connection

      has terminated or when the subagent session is closed.

     "

  INDEX       { agentxConnIndex, agentxSessionIndex }

  ::= { agentxSessionTable 1 }

 AgentxSessionEntry ::= SEQUENCE {

  agentxSessionIndex         Unsigned32,

  agentxSessionObjectID      OBJECT IDENTIFIER,

  agentxSessionDescr         SnmpAdminString,

  agentxSessionAdminStatus   INTEGER,

  agentxSessionOpenTime      TimeStamp,

  agentxSessionAgentXVer     INTEGER,

  agentxSessionTimeout       INTEGER

 }

 agentxSessionIndex OBJECT-TYPE

  SYNTAX      Unsigned32 (0..4294967295)

  MAX-ACCESS  not-accessible

  STATUS      current

  DESCRIPTION

     "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.

     "

  ::= { agentxSessionEntry 1 }

 agentxSessionObjectID OBJECT-TYPE

  SYNTAX      OBJECT IDENTIFIER

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "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.

     "

  ::= { agentxSessionEntry 2 }

 agentxSessionDescr OBJECT-TYPE

  SYNTAX      SnmpAdminString

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "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.

     "

  ::= { agentxSessionEntry 3 }

 agentxSessionAdminStatus OBJECT-TYPE

  SYNTAX      INTEGER {

                 up(1),

                 down(2)

              }

  MAX-ACCESS  read-write

  STATUS      current

  DESCRIPTION

     "The administrative (desired) status of the session.  Setting

      the value to 'down(2)' closes the subagent session (with c.reason

      set to 'reasonByManager').

     "

  ::= { agentxSessionEntry 4 }

 agentxSessionOpenTime OBJECT-TYPE

  SYNTAX      TimeStamp

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "The value of sysUpTime when this session was opened and,

      therefore, its value when this entry was added to the table.

     "

  ::= { agentxSessionEntry 5 }

 agentxSessionAgentXVer OBJECT-TYPE

  SYNTAX      INTEGER (1..255)

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "The version of the AgentX protocol supported by the

      session.  This must be less than or equal to the value of

      agentxMasterAgentXVer.

     "

  ::= { agentxSessionEntry 6 }

 agentxSessionTimeout OBJECT-TYPE

  SYNTAX     INTEGER (0..255)

  UNITS      "seconds"

  MAX-ACCESS read-only

  STATUS     current

  DESCRIPTION

     "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).

     "

  ::= { agentxSessionEntry 7 }

 -- The AgentX Registration Group

 agentxRegistrationTableLastChange OBJECT-TYPE

  SYNTAX      TimeStamp

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "The value of sysUpTime when the last row creation or deletion

      occurred in the agentxRegistrationTable.

     "

  ::= { agentxRegistration 1 }

 agentxRegistrationTable OBJECT-TYPE

  SYNTAX      SEQUENCE OF AgentxRegistrationEntry

  MAX-ACCESS  not-accessible

  STATUS      current

  DESCRIPTION

     "A table of registered regions.

     "

  ::= { agentxRegistration 2 }

 agentxRegistrationEntry OBJECT-TYPE

  SYNTAX      AgentxRegistrationEntry

  MAX-ACCESS  not-accessible

  STATUS      current

  DESCRIPTION

     "Contains information for a single registered region.  An

      entry is created when a session  successfully registers a

      region and is destroyed for any of three reasons: this region

      is unregistered by the session, the session is closed,

      or the subagent connection is closed.

     "

  INDEX       { agentxConnIndex, agentxSessionIndex, agentxRegIndex }

  ::= { agentxRegistrationTable 1 }

 AgentxRegistrationEntry ::= SEQUENCE {

  agentxRegIndex           Unsigned32,

  agentxRegContext         OCTET STRING,

  agentxRegStart           OBJECT IDENTIFIER,

  agentxRegRangeSubId      Unsigned32,

  agentxRegUpperBound      Unsigned32,

  agentxRegPriority        Unsigned32,

  agentxRegTimeout         INTEGER,

  agentxRegInstance        TruthValue }

 agentxRegIndex OBJECT-TYPE

  SYNTAX      Unsigned32 (1..4294967295)

  MAX-ACCESS  not-accessible

  STATUS      current

  DESCRIPTION

     "agentxRegIndex uniquely identifies a registration entry.

      This value is constant for the lifetime of an entry.

     "

  ::= { agentxRegistrationEntry 1 }

 agentxRegContext OBJECT-TYPE

  SYNTAX      OCTET STRING

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "The context in which the session supports the objects in this

      region.  A zero-length context indicates the default context.

     "

  ::= { agentxRegistrationEntry 2 }

 agentxRegStart OBJECT-TYPE

  SYNTAX      OBJECT IDENTIFIER

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "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.

     "

  ::= { agentxRegistrationEntry 3 }

 agentxRegRangeSubId OBJECT-TYPE

  SYNTAX      Unsigned32

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "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.

     "

  ::= { agentxRegistrationEntry 4 }

 agentxRegUpperBound OBJECT-TYPE

  SYNTAX      Unsigned32

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

    "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.

    "

  ::= { agentxRegistrationEntry 5 }

 agentxRegPriority OBJECT-TYPE

  SYNTAX      Unsigned32

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "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.

     "

  ::= { agentxRegistrationEntry 6 }

 agentxRegTimeout OBJECT-TYPE

  SYNTAX      INTEGER (0..255)

  UNITS       "seconds"

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "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.

     "

  ::= { agentxRegistrationEntry 7 }

 agentxRegInstance OBJECT-TYPE

  SYNTAX      TruthValue

  MAX-ACCESS  read-only

  STATUS      current

  DESCRIPTION

     "The value of agentxRegInstance is `true' for

      registrations for which the INSTANCE_REGISTRATION

      was set, and is `false' for all other registrations.

     "

  ::= { agentxRegistrationEntry 8 }

 -- Conformance Statements for AgentX

 agentxConformance     OBJECT IDENTIFIER ::= { agentxMIB 2 }

 agentxMIBGroups       OBJECT IDENTIFIER ::= { agentxConformance 1 }

 agentxMIBCompliances  OBJECT IDENTIFIER ::= { agentxConformance 2 }

 -- Compliance Statements for AgentX

 agentxMIBCompliance MODULE-COMPLIANCE

  STATUS      current

  DESCRIPTION

     "The compliance statement for SNMP entities that implement the

      AgentX protocol.  Note that a compliant agent can implement all

      objects in this MIB module as read-only.

     "

  MODULE -- this module

     MANDATORY-GROUPS  { agentxMIBGroup }

     OBJECT agentxSessionAdminStatus

        MIN-ACCESS read-only

        DESCRIPTION

           "Write access is not required.

           "

  ::= { agentxMIBCompliances 1 }

 agentxMIBGroup OBJECT-GROUP

  OBJECTS {

     agentxDefaultTimeout,

     agentxMasterAgentXVer,

     agentxConnTableLastChange,

     agentxConnOpenTime,

     agentxConnTransportDomain,

     agentxConnTransportAddress,

     agentxSessionTableLastChange,

     agentxSessionTimeout,

     agentxSessionObjectID,

     agentxSessionDescr,

     agentxSessionAdminStatus,

     agentxSessionOpenTime,

     agentxSessionAgentXVer,

     agentxRegistrationTableLastChange,

     agentxRegContext,

     agentxRegStart,

     agentxRegRangeSubId,

     agentxRegUpperBound,

     agentxRegPriority,

     agentxRegTimeout,

     agentxRegInstance

    }

  STATUS      current

  DESCRIPTION

     "All accessible objects in the AgentX MIB.

     "

  ::= { agentxMIBGroups 1 }

 END