
Delivery-Date: Thu, 01 May 1997 10:42:57 -0700
Return-Path: <agentx-owner>
Received: (from daemon@localhost)
	by fv.com (8.8.5/8.8.5) id KAA24485
	for X-agentx; Thu, 1 May 1997 10:42:57 -0700 (PDT)
Received: from shekel.fv.com (shekel.fv.com [207.67.199.130])
	by fv.com (8.8.5/8.8.5) with ESMTP id KAA24482
	for <agentx-local@zloty.fv.com>; Thu, 1 May 1997 10:42:56 -0700 (PDT)
Received: from gauntlet.fv.com (gauntlet-in.fv.com [10.0.0.2])
	by shekel.fv.com (8.8.5/8.8.5) with ESMTP id KAA26854
	for <agentx@shekel.fv.com>; Thu, 1 May 1997 10:42:53 -0700 (PDT)
Received: (from uucp@localhost)
	by gauntlet.fv.com (8.8.5/8.8.5) id NAA05751
	for <agentx@fv.com>; Thu, 1 May 1997 13:38:04 -0400 (EDT)
X-Authentication-Warning: gauntlet.fv.com: uucp set sender to <battle@snmp.com> using -f
Received: from seymour16.snmp.com(192.147.142.16) by gauntlet.fv.com via smap (3.2)
	id xma005731; Thu, 1 May 97 10:37:45 -0700
Received:  
        by seymour16.snmp.com (cf v2.9s-SNMP)
	id NAA15124; Thu, 1 May 1997 13:42:29 -0400 (EDT)
Date: Thu, 1 May 1997 13:42:29 -0400 (EDT)
From: David Battle <battle@snmp.com>
Message-Id: <199705011742.NAA15124@seymour16.snmp.com>
To: agentx@fv.com
Subject: typo in draft 3

Discrepancy highlighted with **.

In secetion 7.1.5.  Processing the agentx-**Register**-PDU

>    3) If the NON_DEFAULT_CONTEXT bit is set, and the master agent
>      supports only a default context, the agentx-Response-PDU is
>      returned with res.error set to `unsupportedContext', and the
>      requested **allocation** fails.  Otherwise:  The value of

-David


Delivery-Date: Wed, 14 May 1997 07:47:46 -0700
Return-Path: <agentx-owner>
Received: (from daemon@localhost)
	by fv.com (8.8.5/8.8.5) id HAA17843
	for X-agentx; Wed, 14 May 1997 07:47:42 -0700 (PDT)
Received: from shekel.fv.com (shekel.fv.com [207.67.199.130])
	by fv.com (8.8.5/8.8.5) with ESMTP id HAA17840
	for <agentx-local@zloty.fv.com>; Wed, 14 May 1997 07:47:39 -0700 (PDT)
Received: from gauntlet.fv.com (gauntlet-in.fv.com [10.0.0.2])
	by shekel.fv.com (8.8.5/8.8.5) with ESMTP id HAA08982
	for <agentx@shekel.fv.com>; Wed, 14 May 1997 07:47:36 -0700 (PDT)
Received: (from uucp@localhost)
	by gauntlet.fv.com (8.8.5/8.8.5) id HAA19233
	for <agentx@fv.com>; Wed, 14 May 1997 07:42:22 -0700 (PDT)
Received: from mail11.digital.com(192.208.46.10) by gauntlet.fv.com via smap (3.2)
	id xma019220; Wed, 14 May 97 07:41:58 -0700
Received: from flume.zk3.dec.com by mail11.digital.com (8.7.5/UNX 1.5/1.0/WV)
	id KAA16459; Wed, 14 May 1997 10:33:58 -0400 (EDT)
Received: from bernie.zk3.dec.com by flume.zk3.dec.com; (5.65v3.2/1.1.8.2/16Jan95-0946AM)
	id AA18953; Wed, 14 May 1997 10:33:49 -0400
Received: from localhost by bernie.zk3.dec.com; (5.65/1.1.8.2/22Aug96-1117AM)
	id AA27135; Wed, 14 May 1997 10:29:52 -0400
Message-Id: <9705141429.AA27135@bernie.zk3.dec.com>
To: Smitha Gudur <sgudur@peer.com>
Cc: agentx@fv.com
Subject: Re: priority in Unregister PDU  
In-Reply-To: Your message of "Fri, 25 Apr 97 18:21:59 PDT."
             <199704260122.AA283567720@dorothy.peer.com> 
Date: Wed, 14 May 97 10:29:52 -0400
From: Mike Daniele <daniele@zk3.dec.com>
X-Mts: smtp

>Since Unregister PDU does not identity priority of the region to unregister,
>what happens when a subagent has registered the same region at two different  
>priorities?

Good catch.

>I propose, that the registration with the best priority will be the one that
>will be deleted. 

Given the current draft, that's a reasonable way to handle it.

The Unregister-PDU should contain a priority field.  In 6.2.4

   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |          <reserved>           | u.range_subid |  <reserved>   |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

should be

   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    <reserved> |  u.priority   | u.range_subid |  <reserved>   |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+


7.1.6 clause 4) should be

   4) If u.region, u.priority, and the indicated context do not match an existing
      registration made during this session, the agentx-Response-PDU
      is returned with res.error set to `unknownRegistration'.

Thanks for pointing this out,
Mike


Delivery-Date: Wed, 14 May 1997 08:09:11 -0700
Return-Path: <agentx-owner>
Received: (from daemon@localhost)
	by fv.com (8.8.5/8.8.5) id IAA19565
	for X-agentx; Wed, 14 May 1997 08:09:11 -0700 (PDT)
Received: from shekel.fv.com (shekel.fv.com [207.67.199.130])
	by fv.com (8.8.5/8.8.5) with ESMTP id IAA19562
	for <agentx-local@zloty.fv.com>; Wed, 14 May 1997 08:09:10 -0700 (PDT)
Received: from gauntlet.fv.com (gauntlet-in.fv.com [10.0.0.2])
	by shekel.fv.com (8.8.5/8.8.5) with ESMTP id IAA10581
	for <agentx@shekel.fv.com>; Wed, 14 May 1997 08:09:06 -0700 (PDT)
Received: (from uucp@localhost)
	by gauntlet.fv.com (8.8.5/8.8.5) id IAA20035
	for <agentx@fv.com>; Wed, 14 May 1997 08:03:53 -0700 (PDT)
Received: from mail13.digital.com(192.208.46.30) by gauntlet.fv.com via smap (3.2)
	id xma020024; Wed, 14 May 97 08:03:47 -0700
Received: from quarry.zk3.dec.com by mail13.digital.com (8.7.5/UNX 1.5/1.0/WV)
	id KAA11105; Wed, 14 May 1997 10:48:00 -0400 (EDT)
Received: from bernie.zk3.dec.com by quarry.zk3.dec.com; (5.65v3.2/1.1.8.2/16Jan95-0946AM)
	id AA09482; Wed, 14 May 1997 10:47:51 -0400
Received: from localhost by bernie.zk3.dec.com; (5.65/1.1.8.2/22Aug96-1117AM)
	id AA27269; Wed, 14 May 1997 10:43:53 -0400
Message-Id: <9705141443.AA27269@bernie.zk3.dec.com>
To: David Battle <battle@snmp.com>
Cc: agentx@fv.com
Subject: Re: response pdu  
In-Reply-To: Your message of "Fri, 25 Apr 97 14:55:40 EDT."
             <199704251855.OAA29470@seymour16.snmp.com> 
Date: Wed, 14 May 97 10:43:52 -0400
From: Mike Daniele <daniele@zk3.dec.com>
X-Mts: smtp

>I never got an answer to my question about response pdus: is there
>every anything other than a varbind list (or nothing at all) at
>the end of them?  If not, I think the draft should say so in
>section 6.2.16.  If so, I think something should be added to

David,

I believe you are correct in that nothing else may be appended to
the fixed part of a Response-PDU, except a VarBindList.

So the statement in 6.2.16

   Other data may follow these latter two fields, depending on
   which AgentX PDU is being responded to.  These data are
   specified in the subsequent elements of procedure.

should be changed to say so.  Perhaps


   A VarBindList may follow these latter two fields, depending on
   which AgentX PDU is being responded to.  This is specified in
   the subsequent elements of procedure.

Thanks,
Mike


Delivery-Date: Thu, 15 May 1997 17:48:04 -0700
Return-Path: <agentx-owner>
Received: (from daemon@localhost)
	by fv.com (8.8.5/8.8.5) id RAA26104
	for X-agentx; Thu, 15 May 1997 17:48:04 -0700 (PDT)
Received: from shekel.fv.com (shekel.fv.com [207.67.199.130])
	by fv.com (8.8.5/8.8.5) with ESMTP id RAA26101
	for <agentx-local@zloty.fv.com>; Thu, 15 May 1997 17:48:03 -0700 (PDT)
Received: from gauntlet.fv.com (gauntlet-in.fv.com [10.0.0.2])
	by shekel.fv.com (8.8.5/8.8.5) with ESMTP id RAA10598
	for <agentx@shekel.fv.com>; Thu, 15 May 1997 17:48:00 -0700 (PDT)
Received: (from uucp@localhost)
	by gauntlet.fv.com (8.8.5/8.8.5) id RAA08009
	for <agentx@fv.com>; Thu, 15 May 1997 17:42:44 -0700 (PDT)
Received: from dresden.bmc.com(198.64.253.250) by gauntlet.fv.com via smap (3.2)
	id xma008003; Thu, 15 May 97 17:42:38 -0700
Received: (from uucp@localhost)
	by dresden.bmc.com (8.8.5/8.8.5) id TAA05835
	for <agentx@fv.com>; Thu, 15 May 1997 19:47:56 -0500 (CDT)
Received: from cherry.bmc.com(172.17.1.25) by dresden.bmc.com via smap (3.2)
	id xma005808; Thu, 15 May 97 19:47:49 -0500
Received: from dorothy.peer.com (dorothy.peer.com [192.146.153.65]) by cherry.bmc.com with ESMTP (8.7.5/8.7.3) id TAA00851 for <agentx@fv.com>; Thu, 15 May 1997 19:47:46 -0500 (CDT)
Received: by dorothy.peer.com
	(1.39.111.2/16.2) id AA280913664 for  ; Thu, 15 May 1997 17:47:44 -0700
From: Smitha Gudur <sgudur@peer.com>
Message-Id: <199705160047.AA280913664@dorothy.peer.com>
Subject: draft-ietf-agentx-mib-01.txt
To: agentx@fv.com
Date: Thu, 15 May 1997 17:47:43 PDT
Cc: sgudur@peer.com
X-Mailer: Elm [revision: 111.1]


I am posting Maria's revised AgentX MIB.  The revisions were made
based on the inputs received from mailing list and others. This is a trimmed 
version of the previous draft.

The following changes are made to this draft:

added Utf8String textual convention.
 
agentXSANumber - changed the type to Unsigned32.

agentxSAIndex - changed the type to Unsigned32.

agentxRegIndex - changed the type to Unsigned32.

agentxRegPriority - changed the type to Unsigned32.

agentxSADescr - changed the type to Utf8String. 

agentxSATimeout, agentxRegTimeout - deleted the last sentence as it required
specific subagent behaviour that is not specified or required by the protocol 
specification and it may be inappropriate in certain configurations.

agentxSubagentEntry - Revised the description to make it pertinent to a
subagent session. Changed it to "Information about a single open session 
between the AgentX master agent and a subagent." 

agentxSAObjectID - removed 'type identification' from the description, but
retained the other description. 

agentxSAAdminStatus - removed the last sentence of description as it required 
subagent to behave that was not required by the protocol. 

agentxSATransportAddr - revised description, so that the table is viewed as
having one entry per session.  

agentxRegistrationEntry - removed the following sentence from the description
"It is recommended that the agent sort this table by those values." 

agentxRegContext - constraint on context length is removed as AgentX protocol
does not impose any limits on the length of context names. 

agentxStats - retained only agentxRegisterDuplicate, and removed other stats.
I have removed them unless we see a clear need for including these stats. 

agentxMasterSnmpVer - removed.  
agentxRegDispatchOrder - removed. 

Please send questions, comments and suggested changes on this MIB to the list
(agentx@fv.com). 


Thanks
Smitha Gudur
sgudur@bmc.com	




                   Definitions of Managed Objects for
                         Extensible SNMP Agents

                              May 14, 1997


                     <draft-ietf-agentx-mib-01.txt>

                              Maria Greene
                              Ascom Nexion
                            greene@nexen.com


                         Smitha Gudur (editor)
                           BMC Software, Inc.
                             sgudur@bmc.com





                          Status of this Memo

     This document is an Internet-Draft.  Internet-Drafts are working
documents of the Internet Engineering Task Force (IETF), its Areas, and
its Working Groups.  Note that other groups may also distribute working
documents as Internet-Drafts.

     Internet-Drafts are draft documents valid for a maximum of six
months and may be updated, replaced, or obsoleted by other documents at
any time.  It is inappropriate to use Internet-Drafts as reference mate-
rial or to cite them other than as a work in progress.

     To learn the current status of any Internet-Draft, please check the
1id-abstracts.txt listing contained in the Internet-Drafts Shadow Direc-
tories on ds.internic.net (US East Coast), nic.nordu.net (Europe),
ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim).

Abstract

     This memo defines an experimental portion of the Management Infor-
mation Base (MIB) for use with network management protocols in the
Internet community.  In particular, it describes objects managing SNMP
agents that use the Agent Extensibility (AgentX) Protocol.

     This memo specifies a MIB module in a manner that is both compliant
to the SNMPv2 SMI, and semantically identical to the peer SNMPv1 defini-
tions.



AgentX Working Group      Expires November 1997                 [Page 1]

Internet Draft                 AgentX MIB                    14 May 1997


     This memo does not specify a standard for the Internet community.


     The SNMP Network Management Framework presently consists of three
major components.  They are: the SMI, described in RFC 1902 [1] - the
mechanisms used for describing and naming objects for the purpose of
management.  the MIB-II, STD 17, RFC 1213 [2] - the core set of managed
objects for the Internet suite of protocols.  the protocol, RFC 1157 [3]
and/or RFC 1905 [4], - the protocol for accessing managed objects.

     The Framework permits new objects to be defined for the purpose of
experimentation and evaluation.

     Managed objects are accessed via a virtual information store,
termed the Management Information Base or MIB.  Objects in the MIB are
defined using the subset of Abstract Syntax Notation One (ASN.1) defined
in the SMI.  In particular, each object type is named by an OBJECT IDEN-
TIFIER, an administratively assigned name.  The object type together
with an object instance serves to uniquely identify a specific instanti-
ation of the object.  For human convenience, we often use a textual
string, termed the descriptor, to also refer to the object type.






























AgentX Working Group      Expires November 1997                 [Page 2]

Internet Draft                 AgentX MIB                    14 May 1997


     The SNMP Agent Extensibility Protocol (AgentX) is a protocol used
to distribute the implementation of an SNMP agent amongst a single "mas-
ter agent" and multiple "subagents". See [5] for details about the
AgentX protocol.

     The goals of the AgentX MIB are: List the set of subagents that
currently have logical sessions open with the master agent.  Identify
the subagent's type, vendor, transport address, AgentX protocol version
and other characteristics.  Identify the set of MIB objects each sub-
agent implements, the context in which the objects are registered and
the priority of the registration.  Provide statistics about the protocol
operation such as the number of packets to and from each subagent.
Determine protocol operational parameters such as the timeout interval
for responses from a subagent and the priority at which a subagent reg-
isters a particular MIB region.  Allow (but do not require) managers to
be able to modify AgentX protocol operational parameters and to explic-
itly close subagent sessions with the master agent.


































AgentX Working Group      Expires November 1997                 [Page 3]

Internet Draft                 AgentX MIB                    14 May 1997


     AGENTX-MIB DEFINITIONS ::= BEGIN

     IMPORTS
        MODULE-IDENTITY, OBJECT-TYPE, experimental, Counter32, Unsigned32
           FROM SNMPv2-SMI
        MODULE-COMPLIANCE, OBJECT-GROUP
           FROM SNMPv2-CONF
        DisplayString, TimeStamp
           FROM SNMPv2-TC;


     agentxMIB MODULE-IDENTITY
        LAST-UPDATED "9705141200Z" -- May 14, 1997
        ORGANIZATION "IETF AgentX Working Group"
        CONTACT-INFO
           "Smitha Gudur
            sgudur@bmc.com

            Send comments to the AgentX working group: agentx@fv.com."
        DESCRIPTION
           "The MIB module for the SNMP Agent Extensibility Protocol
            (AgentX). This MIB module will be implemented by the master
            agent."
     -- For testing purposes only. Need to get an experimental id
     --   ::= { experimental 2001 }
        ::= { experimental XX }

     agentxObjects OBJECT IDENTIFIER ::= { agentxMIB 1 }
     agentxGeneral OBJECT IDENTIFIER ::= { agentxObjects 1 }

     --
     -- Textual Conventions
     --
     Utf8String ::= TEXTUAL-CONVENTION
        DISPLAY-HINT "255a"
        STATUS  current
        DESCRIPTION
           "To facilitate internationalization, this TC represents
           information taken from the ISO/IEC IS 10646-1 character set,
           encoded as an octet string using the UTF-8 character encoding
           scheme described in RFC 2044 [8].  For strings in 7-bit US-ASCII,
           there is no impact since the UTF-8 representation is identical
           to the US-ASCII encoding."
        SYNTAX  OCTET STRING (SIZE (0..255))

     agentxDefaultTimeout OBJECT-TYPE
        SYNTAX      INTEGER (0..255)
        UNITS       "seconds"



AgentX Working Group      Expires November 1997                 [Page 4]

Internet Draft                 AgentX MIB                    14 May 1997


        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
           "The default length of time, in seconds, that the master agent
           should allow to elapse after dispatching a message to a subagent
           before it regards the subagent as not responding. This is a
           system-wide value that may be overridden by the values
           associated with a particular subagent (agentxSATimeout) or a
           particular registered MIB region (agentxRegTimeout)."
        DEFVAL      { 5 }
        ::= { agentxGeneral 1 }

     agentxMasterAgentXVer OBJECT-TYPE
        SYNTAX      INTEGER (1..256)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The AgentX protocol version supported by this master
           agent. Current version is 1. Note that the master agent must
           allow registration of earlier version subagents."
        DEFVAL      { 1 }
        ::= { agentxGeneral 2 }

     agentxMasterTransports OBJECT-TYPE
     -- For testing with a pre-v2c compiler
     --   SYNTAX      BIT STRING {
        SYNTAX      BITS {
                       unixDomainSockets(0),
                       tcp(1),
                       udp(2),
                       sharedMem(3),
                       other(4)
                    }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The transports that the master agent supports."
        DEFVAL      { { unixDomainSockets } }
        ::= { agentxGeneral 4 }

     --
     -- The AgentX Subagent Group
     --

     agentxSubagent OBJECT IDENTIFIER ::= { agentxObjects 2 }

     agentxSATableLastChange OBJECT-TYPE
        SYNTAX      TimeStamp



AgentX Working Group      Expires November 1997                 [Page 5]

Internet Draft                 AgentX MIB                    14 May 1997


        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The value of sysUpTime when the last row creation or deletion
           occurred in the agentxSubagentTable."
        ::= { agentxSubagent 1 }

     agentxSANumber OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The current number of entries in the agentxSubagentTable. Note
           that this may be smaller than the largest value of agentxSAIndex
           since index values are not reused when entries come and go from
           the agentxSubagentTable."
        ::= { agentxSubagent 2 }

     --
     -- The AgentX Subagent Table
     --

     agentxSubagentTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF AgentxSubagentEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
           "A table of AgentX subagents that have open sessions with the
           AgentX master agent."
        ::= { agentxSubagent 3 }

     agentxSubagentEntry OBJECT-TYPE
        SYNTAX      AgentxSubagentEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
           "Information about a single open session between the AgentX
           master agent and a subagent."
        INDEX       { agentxSAIndex }
        ::= { agentxSubagentTable 1 }

     AgentxSubagentEntry ::= SEQUENCE {
        agentxSAIndex         Unsigned32,
        agentxSAObjectID      OBJECT IDENTIFIER,
        agentxSADescr         Utf8String,
        agentxSAAdminStatus   INTEGER,
        agentxSAOpenTime      TimeStamp,
        agentxSAAgentXVer     INTEGER,



AgentX Working Group      Expires November 1997                 [Page 6]

Internet Draft                 AgentX MIB                    14 May 1997


        agentxSATimeout       INTEGER,
        agentxSATransportType INTEGER,
        agentxSATransportAddr OCTET STRING
     }

     agentxSAIndex OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
           "A unique, small-integer index for the subagent's session. Note
           that if a subagent's session with the master agent is closed for
           any reason its index will not be re-used, therefore, the values
           of agentxSAIndex may not be contiguous and will not be the same
           for the same subagent across multiple sessions."
        ::= { agentxSubagentEntry 1 }

     agentxSAObjectID OBJECT-TYPE
        SYNTAX      OBJECT IDENTIFIER
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "This is analogous to sysObjectID defined in MIB-2 [2] and is taken
           from the o.id field of the agentx-Open-PDU."
        ::= { agentxSubagentEntry 2 }

     agentxSADescr OBJECT-TYPE
        SYNTAX      Utf8String
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "A textual description of the subagent. This is analogous to
           sysDescr defined in MIB-2 [2] and is taken from the o.descr
           field of the agentx-Open-PDU."
        ::= { agentxSubagentEntry 3 }

     agentxSAAdminStatus OBJECT-TYPE
        SYNTAX      INTEGER {
                       up(1),
                       down(2)
                    }
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
           "The administrative (desired) status of the subagent. Setting
           the value to 'down(2)' closes the subagent (with c.reason set to
           'reasonByManager'). When read, the value returned is always
           'up(1)'."



AgentX Working Group      Expires November 1997                 [Page 7]

Internet Draft                 AgentX MIB                    14 May 1997


        DEFVAL      { up }
        ::= { agentxSubagentEntry 4 }

     agentxSAOpenTime OBJECT-TYPE
        SYNTAX      TimeStamp
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The value of sysUpTime when this session was opened and,
           therefore, this entry was added to the table."
        ::= { agentxSubagentEntry 5 }

     agentxSAAgentXVer OBJECT-TYPE
        SYNTAX      INTEGER (1..256)
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The version of the AgentX protocol supported by the
           subagent. This will be equal to or less than the value of
           agentxMasterAgentXVer."
        DEFVAL      { 1 }
        ::= { agentxSubagentEntry 6 }

     agentxSATimeout OBJECT-TYPE
        SYNTAX     INTEGER (0..255)
        MAX-ACCESS read-write
        STATUS     current
        DESCRIPTION
           "The length of time, in seconds, that a master agent should
           allow to elapse after dispatching a message to this subagent
           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 subagent-wide value that may be overridden by values
           associated with specific registered MIB regions (see
           agentxRegTimeout).  The default value of '0' indicates that the
           master agent's default timeout value should be used (see
           agentxDefaultTimeout).

           Note that, if the agent supports writing of this object the new
           value will be used for the next agentx-Open-PDU the subagent
           sends."
        DEFVAL     { 0 }
        ::= { agentxSubagentEntry 7 }

     agentxSATransportType OBJECT-TYPE
        SYNTAX      INTEGER {
                       unixDomainSockets(1),



AgentX Working Group      Expires November 1997                 [Page 8]

Internet Draft                 AgentX MIB                    14 May 1997


                       tcp(2),
                       udp(3),
                       sharedMem(4),
                       other(5)
                    }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The transport used for AgentX protocol messages between this
           subagent and the master agent."
        ::= { agentxSubagentEntry 8 }

     agentxSATransportAddr OBJECT-TYPE
        SYNTAX      OCTET STRING
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The 'address' of the session this subagent has open with the
           master agent. Interpretation of this value depends on the value
           of agentxSATransportType."
        ::= { agentxSubagentEntry 9 }


     --
     -- The AgentX Registration Table
     --

     agentxRegistrationTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF AgentxRegistrationEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
           "A table of registered OBJECT IDENTIFIER regions. This is the
           table used to dispatch AgentX PDUs to the appropriate subagent
           based on the requested OIDs in the SNMP messages. Note that a
           subagent registration may be broken up into multiple entries in
           this table, as described in the AgentX Protocol specification,
           [5]."
        ::= { agentxObjects 3 }

     agentxRegistrationEntry OBJECT-TYPE
        SYNTAX      AgentxRegistrationEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
           "A single registered region. Regions are added by the master
           agent when subagents register and are removed from the table
           when the subagents unregister the region or their sessions are



AgentX Working Group      Expires November 1997                 [Page 9]

Internet Draft                 AgentX MIB                    14 May 1997


           closed. Note that the combination of agentxRegContext,
           agentxRegStart and agentxRegDispatchOrder will be unique and
           could have been used for indexing purposes."
        INDEX       { agentxRegIndex }
        ::= { agentxRegistrationTable 1 }

     AgentxRegistrationEntry ::= SEQUENCE {
        agentxRegIndex           Unsigned32,
        agentxRegContext         OCTET STRING,
        agentxRegStart           OBJECT IDENTIFIER,
        agentxRegEnd             OBJECT IDENTIFIER,
        agentxRegPriority        Unsigned32,
        agentxRegSAIndex         Unsigned32,
        agentxRegTimeout         INTEGER
     }

     agentxRegIndex OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
           "An integer that uniquely identifies a registration entry."
        ::= { agentxRegistrationEntry 1 }

     agentxRegContext OBJECT-TYPE
        SYNTAX      OCTET STRING
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The context in which the subagent 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
           subagent identified by agentxRegSAIndex implements objects
           starting at this value (inclusive). Note that this value could
           identify an object type, an object instance, or a partial object
           instance identifier."
        ::= { agentxRegistrationEntry 3 }

     agentxRegEnd OBJECT-TYPE
        SYNTAX      OBJECT IDENTIFIER
        MAX-ACCESS  read-only



AgentX Working Group      Expires November 1997                [Page 10]

Internet Draft                 AgentX MIB                    14 May 1997


        STATUS      current
        DESCRIPTION
           "The ending OBJECT IDENTIFIER of this registration entry. The
           subagent identified by agentxRegSAIndex implements objects up to but
           not including this value. Note that this value could identify an
           object type, an object instance, or a partial object instance
           identifier."
        ::= { agentxRegistrationEntry 4 }

     --
     --
     --
     --agentxRegDispatchOrder OBJECT-TYPE
     --   SYNTAX      INTEGER (0..256)
     --   MAX-ACCESS  read-only
     --   STATUS      current
     --   DESCRIPTION
     --      "An indication of this range's order or precedence for
     --      dispatching purposes. This value will normally be 0 indicating
     --      that there is no duplicate OID registration for this range. If
     --      the value is anything but 0 then there is duplicate registration
     --      and the entry with the lowest value of agentxRegDispatchOrder
     --      will be the one selected."
     --   REFERENCE
     --      "Agent Extensibility (AgentX) Protocol Version 1, [5], section
     --      7.1.4.1 Handling Duplicate OID Ranges."
     --   DEFVAL     { 0 }
     --   ::= { agentxRegistrationEntry 5 }


     --
     --      To support other subagents types that can be visible to the manager.
     --
     agentxRegPriority OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
           "The subagent's priority when exporting this OID range. Lower
           values have higher priority.

           Note that, if the agent supports writing of this object the new
           value will be used for subsequent agentx-Register-PDUs the
           subagent sends for this region. In other words, if the manager
           wishes to change the value operationally, she must set this
           value then set the corresponding agentxSAAdminStatus to
           'down(2)' (as indicated by agentxRegSAIndex), which will close
           the subagent, after which is will automatically re-open the



AgentX Working Group      Expires November 1997                [Page 11]

Internet Draft                 AgentX MIB                    14 May 1997


           session and re-register its OID ranges with the new priority."
        DEFVAL      { 255 }
        ::= { agentxRegistrationEntry 5 }

     agentxRegSAIndex OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The value of agentxSAIndex for the subagent that registered
           this OID range."
        ::= { agentxRegistrationEntry 6 }

     agentxRegTimeout OBJECT-TYPE
        SYNTAX      INTEGER (0..255)
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
           "The timeout value, in seconds, for subagent responses to
           requests associated with this OID range. The value '0' indicates
           that default value (indicated by agentxSATimeout or
           agentxDefaultTimeout) is to be used. This value is taken from
           the r.timeout field of the agentx-Register-PDU.

           Note that, if the agent supports writing of this object the new
           value will be used for subsequent agentx-Register-PDUs the
           subagent sends for this region."
        DEFVAL      { 0 }
        ::= { agentxRegistrationEntry 7 }


     --
     -- The AgentX Statistics Group
     --
     -- The statistics in this group are maintained by the Master Agent.
     --
     --      Other stats have been removed. Support trap generation based
     --      on certain situations for  duplicate registration.
     --
     agentxStats OBJECT IDENTIFIER ::= { agentxObjects 4 }

     agentxRegisterDuplicate OBJECT-TYPE
        SYNTAX      Counter32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
           "The number of agentx-Response-PDU messages sent by the master
           agent in response to incoming agentx-Register-PDU messages where



AgentX Working Group      Expires November 1997                [Page 12]

Internet Draft                 AgentX MIB                    14 May 1997


           the res.error field was set to 'duplicateRegistration'."
        ::= { agentxStats 1 }

     --
     -- Conformance Statements for the AgentX MIB
     --

     agentxConformance     OBJECT IDENTIFIER ::= { agentxMIB 2 }
     agentxMIBGroups       OBJECT IDENTIFIER ::= { agentxConformance 1 }
     agentxMIBCompliances  OBJECT IDENTIFIER ::= { agentxConformance 2 }

     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 agentxDefaultTimeout
              MIN-ACCESS read-only
              DESCRIPTION
                 "Write access is not required."

           OBJECT agentxSATimeout
              MIN-ACCESS read-only
              DESCRIPTION
                 "Write access is not required."

           OBJECT agentxSAAdminStatus
              MIN-ACCESS read-only
              DESCRIPTION
                 "Write access is not required."

           OBJECT agentxRegPriority
              MIN-ACCESS read-only
              DESCRIPTION
                 "Write access is not required."

           OBJECT agentxRegTimeout
              MIN-ACCESS read-only
              DESCRIPTION
                 "Write access is not required."

        ::= { agentxMIBCompliances 1 }




AgentX Working Group      Expires November 1997                [Page 13]

Internet Draft                 AgentX MIB                    14 May 1997


     agentxMIBGroup OBJECT-GROUP
        OBJECTS {
           agentxDefaultTimeout,
           agentxMasterAgentXVer,
           agentxMasterTransports,
           agentxSATableLastChange,
           agentxSANumber,
           agentxSATimeout,
           agentxSAObjectID,
           agentxSADescr,
           agentxSAAdminStatus,
           agentxSAOpenTime,
           agentxSAAgentXVer,
           agentxSATransportType,
           agentxSATransportAddr,
           agentxRegContext,
           agentxRegStart,
           agentxRegEnd,
           agentxRegPriority,
           agentxRegSAIndex,
           agentxRegTimeout,
           agentxRegisterDuplicate
        }
        STATUS      current
        DESCRIPTION
           "All accessible objects in the AgentX MIB."
        ::= { agentxMIBGroups 1 }

     END

          This document is a product of the IETF's AgentX Working Group.

          Special acknowledgement is made to:


          Maria Greene Ascom Nexion 289 Great Road Acton, MA 01720
     Phone: (508) 266-4570 EMail: greene@nexen.com



          This MIB is an evolution of the Subagent MIB by Bert Wijnen
     (wijnen@vnet.ibm.com) which in turn was derived from the SMUX-MIB
     by Marshall Rose [6].








AgentX Working Group      Expires November 1997                [Page 14]

Internet Draft                 AgentX MIB                    14 May 1997


     SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
     S. Waldbusser, Structure of Management Information for Version 2 of
     the Simple Network Management Protocol (SNMPv2), RFC1902, SNMP
     Research,Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
     International Network Services, January 1996.  McCloghrie, K., and
     M. Rose, Editors, Management Information Base for Network Manage-
     ment of TCP/IP-based internets: MIB-II, STD 17, RFC 1213, Hughes
     LAN Systems, Performance Systems International, March 1991.  Case,
     J., Fedor, M., Schoffstall, M., and J. Davin, Simple Network Man-
     agement Protocol, RFC 1157, SNMP Research, Performance Systems
     International, Performance Systems International, MIT Laboratory
     for Computer Science, May 1990.  SNMPv2 Working Group, Case, J.,
     McCloghrie, K., Rose, M., and S. Waldbusser, Protocol Operations
     for Version 2 of the Simple Network Management Protocol (SNMPv2),
     RFC1905, SNMP Research,Inc., Cisco Systems, Inc., Dover Beach Con-
     sulting, Inc., International Network Services, January 1996.
     Daniele, M., Wijnen, B., Francisco, D., Agent Extensibility
     (AgentX) Protocol, Version 1, draft-ietf-agentx-ext-pro-01.txt,
     Digital Equipment Corporation, T.J. Watson Research Center, IBM
     Corp., Cisco Systems, November, 1996.  Rose, M., SNMP MUX Protocol
     and MIB, RFC1227, Performance Systems International, Inc., May
     1991.  Wijnen, B., Carpenter, G., Curran, K., Sehgal, A., and G.
     Waters, Simple Network Management Protocol: Distributed Protocol
     Interface, Version 2.0, RFC 1592, T.J. Watson Research Center, IBM
     Corp., Bell Northern Research, Ltd., March 1994.  F. Yergeau,
     UTF-8, a transformation format of Unicode and ISO 10646,, RFC 2044,
     October 1996.
























AgentX Working Group      Expires November 1997                [Page 15]

Internet Draft                 AgentX MIB                    14 May 1997


          Security issues are not discussed in this memo.

          Editor's Address:

          Smitha Gudur
          BMC Software, Inc.
          1190 Saratoga Avenue, Suite 130
          San Jose, CA 95129-3433
          Phone: (408) 556-0720
          EMail: sgudur@bmc.com









































AgentX Working Group      Expires November 1997                [Page 16]


Delivery-Date: Fri, 16 May 1997 06:23:41 -0700
Return-Path: <agentx-owner>
Received: (from daemon@localhost)
	by fv.com (8.8.5/8.8.5) id GAA23339
	for X-agentx; Fri, 16 May 1997 06:23:41 -0700 (PDT)
Received: from shekel.fv.com (shekel.fv.com [207.67.199.130])
	by fv.com (8.8.5/8.8.5) with ESMTP id GAA23335
	for <agentx-local@zloty.fv.com>; Fri, 16 May 1997 06:23:40 -0700 (PDT)
Received: from gauntlet.fv.com (gauntlet-in.fv.com [10.0.0.2])
	by shekel.fv.com (8.8.5/8.8.5) with ESMTP id GAA13443
	for <agentx@shekel.fv.com>; Fri, 16 May 1997 06:23:40 -0700 (PDT)
Received: (from uucp@localhost)
	by gauntlet.fv.com (8.8.5/8.8.5) id GAA21401
	for <agentx@fv.com>; Fri, 16 May 1997 06:18:19 -0700 (PDT)
Received: from ietf.org(132.151.1.19) by gauntlet.fv.com via smap (3.2)
	id xma021381; Fri, 16 May 97 06:18:03 -0700
Received: from ietf.ietf.org by ietf.org id aa09117; 16 May 97 9:24 EDT
Mime-Version: 1.0
Content-Type: Multipart/Mixed; Boundary="NextPart"
To: IETF-Announce@ietf.org
cc: agentx@fv.com
From: Internet-Drafts@ietf.org
Reply-to: Internet-Drafts@ietf.org
Subject: I-D ACTION:draft-ietf-agentx-mib-00.txt
Date: Fri, 16 May 1997 09:24:55 -0400
Sender: cclark@ietf.org
Message-ID:  <9705160924.aa09117@ietf.org>

--NextPart

 A New Internet-Draft is available from the on-line Internet-Drafts 
 directories. This draft is a work item of the SNMP Agent Extensibility 
 Working Group of the IETF.                                                

       Title     : Definitions of Managed Objects for 
                   Extensible SNMP Agents                                                  
       Author(s) : M. Greene, S. Gudur
       Filename  : draft-ietf-agentx-mib-00.txt
       Pages     : 16
       Date      : 05/15/1997

This memo defines an experimental portion of the Management Information 
Base (MIB) for use with network management protocols in the Internet 
community.  In particular, it describes objects managing SNMP agents that 
use the Agent Extensibility (AgentX) Protocol.              
               
This memo specifies a MIB module in a manner that is both compliant to the 
SNMPv2 SMI, and semantically identical to the peer SNMPv1 definitions.     

Internet-Drafts are available by anonymous FTP.  Login with the username
"anonymous" and a password of your e-mail address.  After logging in,
type "cd internet-drafts" and then
     "get draft-ietf-agentx-mib-00.txt".
A URL for the Internet-Draft is:
ftp://ds.internic.net/internet-drafts/draft-ietf-agentx-mib-00.txt
 
Internet-Drafts directories are located at:	
	                                                
     o  Africa:  ftp.is.co.za                    
	                                                
     o  Europe:  ftp.nordu.net            	
                 ftp.nis.garr.it                 
	                                                
     o  Pacific Rim: munnari.oz.au               
	                                                
     o  US East Coast: ds.internic.net           
	                                                
     o  US West Coast: ftp.isi.edu               
	                                                
Internet-Drafts are also available by mail.	
	                                                
Send a message to:  mailserv@ds.internic.net. In the body type: 
     "FILE /internet-drafts/draft-ietf-agentx-mib-00.txt".
							
NOTE: The mail server at ds.internic.net can return the document in
      MIME-encoded form by using the "mpack" utility.  To use this
      feature, insert the command "ENCODING mime" before the "FILE"
      command.  To decode the response(s), you will need "munpack" or
      a MIME-compliant mail reader.  Different MIME-compliant mail readers
      exhibit different behavior, especially when dealing with
      "multipart" MIME messages (i.e., documents which have been split
      up into multiple messages), so check your local documentation on
      how to manipulate these messages.
							
							

Below is the data which will enable a MIME compliant mail reader 
implementation to automatically retrieve the ASCII version
of the Internet-Draft.

--NextPart
Content-Type: Multipart/Alternative; Boundary="OtherAccess"

--OtherAccess
Content-Type:  Message/External-body;
        access-type="mail-server";
        server="mailserv@ds.internic.net"

Content-Type: text/plain
Content-ID: <19970515111423.I-D@ietf.org>

ENCODING mime
FILE /internet-drafts/draft-ietf-agentx-mib-00.txt

--OtherAccess
Content-Type:   Message/External-body;
        name="draft-ietf-agentx-mib-00.txt";
        site="ds.internic.net";
        access-type="anon-ftp";
        directory="internet-drafts"

Content-Type: text/plain
Content-ID: <19970515111423.I-D@ietf.org>

--OtherAccess--

--NextPart--


Delivery-Date: Fri, 16 May 1997 19:03:32 -0700
Return-Path: <agentx-owner>
Received: (from daemon@localhost)
	by fv.com (8.8.5/8.8.5) id TAA23048
	for X-agentx; Fri, 16 May 1997 19:03:32 -0700 (PDT)
Received: from shekel.fv.com (shekel.fv.com [207.67.199.130])
	by fv.com (8.8.5/8.8.5) with ESMTP id TAA23045
	for <agentx-local@zloty.fv.com>; Fri, 16 May 1997 19:03:31 -0700 (PDT)
Received: from gauntlet.fv.com (gauntlet-in.fv.com [10.0.0.2])
	by shekel.fv.com (8.8.5/8.8.5) with ESMTP id TAA11452
	for <agentx@shekel.fv.com>; Fri, 16 May 1997 19:03:30 -0700 (PDT)
Received: (from uucp@localhost)
	by gauntlet.fv.com (8.8.5/8.8.5) id SAA26169
	for <agentx@fv.com>; Fri, 16 May 1997 18:58:08 -0700 (PDT)
Received: from dresden.bmc.com(198.64.253.250) by gauntlet.fv.com via smap (3.2)
	id xma026161; Fri, 16 May 97 18:57:56 -0700
Received: (from uucp@localhost)
	by dresden.bmc.com (8.8.5/8.8.5) id VAA13838
	for <agentx@fv.com>; Fri, 16 May 1997 21:03:18 -0500 (CDT)
Received: from cherry.bmc.com(172.17.1.25) by dresden.bmc.com via smap (3.2)
	id xma013825; Fri, 16 May 97 21:03:14 -0500
Received: from dorothy.peer.com (dorothy.peer.com [192.146.153.65]) by cherry.bmc.com with ESMTP (8.7.5/8.7.3) id VAA22155 for <agentx@fv.com>; Fri, 16 May 1997 21:03:11 -0500 (CDT)
Received: by dorothy.peer.com
	(1.39.111.2/16.2) id AA061184589 for  ; Fri, 16 May 1997 19:03:09 -0700
From: Smitha Gudur <sgudur@peer.com>
Message-Id: <199705170203.AA061184589@dorothy.peer.com>
Subject: service name for agentx agent
To: agentx@fv.com
Date: Fri, 16 May 1997 19:03:09 PDT
Cc: sgudur@peer.com
X-Mailer: Elm [revision: 111.1]



This is related with support for agentx in /etc/services file.

what is the service name for agentx agent. 

Thanks
smitha 








Delivery-Date: Mon, 19 May 1997 11:45:25 -0700
Return-Path: <agentx-owner>
Received: (from daemon@localhost)
	by fv.com (8.8.5/8.8.5) id LAA20976
	for X-agentx; Mon, 19 May 1997 11:45:25 -0700 (PDT)
Received: from shekel.fv.com (shekel.fv.com [207.67.199.130])
	by fv.com (8.8.5/8.8.5) with ESMTP id LAA20973
	for <agentx-local@zloty.fv.com>; Mon, 19 May 1997 11:45:23 -0700 (PDT)
Received: from gauntlet.fv.com (gauntlet-in.fv.com [10.0.0.2])
	by shekel.fv.com (8.8.5/8.8.5) with ESMTP id LAA15737
	for <agentx@shekel.fv.com>; Mon, 19 May 1997 11:45:19 -0700 (PDT)
Received: (from uucp@localhost)
	by gauntlet.fv.com (8.8.5/8.8.5) id LAA00900
	for <agentx@fv.com>; Mon, 19 May 1997 11:39:53 -0700 (PDT)
Received: from mail11.digital.com(192.208.46.10) by gauntlet.fv.com via smap (3.2)
	id xma000864; Mon, 19 May 97 11:39:30 -0700
Received: from flume.zk3.dec.com by mail11.digital.com (8.7.5/UNX 1.5/1.0/WV)
	id OAA19406; Mon, 19 May 1997 14:35:17 -0400 (EDT)
Received: from bernie.zk3.dec.com by flume.zk3.dec.com; (5.65v3.2/1.1.8.2/16Jan95-0946AM)
	id AA02914; Mon, 19 May 1997 14:35:07 -0400
Received: from localhost by bernie.zk3.dec.com; (5.65/1.1.8.2/22Aug96-1117AM)
	id AA30801; Mon, 19 May 1997 14:31:07 -0400
Message-Id: <9705191831.AA30801@bernie.zk3.dec.com>
To: Smitha Gudur <sgudur@peer.com>
Cc: agentx@fv.com
Subject: Re: service name for agentx agent  
In-Reply-To: Your message of "Fri, 16 May 97 19:03:09 PDT."
             <199705170203.AA061184589@dorothy.peer.com> 
Date: Mon, 19 May 97 14:31:06 -0400
From: Mike Daniele <daniele@zk3.dec.com>
X-Mts: smtp

>This is related with support for agentx in /etc/services file.

>what is the service name for agentx agent. 

Well, the IANA document for reserved ports lists

Keyword         Decimal    Description                     References
-------         -------    -----------                     ----------
...
agentx          705/tcp    AgentX
agentx          705/udp    AgentX
#                          Bob Natale <natale@acec.com>

So the service would be "agentx".

(However, that doesn't mean your unix vendor of choice has 
 updated their /etc/services file...)

Regards,
Mike

