home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_j_p / draft-ietf-madman-mail-monitor-mib-03.txt < prev    next >
Text File  |  1997-09-02  |  51KB  |  1,885 lines
  1.  
  2.  
  3. Network Working Group                                          Ned Freed
  4. Internet Draft               <draft-ietf-madman-mail-monitor-mib-03.txt>
  5.  
  6.  
  7.  
  8.                           Mail Monitoring MIB
  9.  
  10.                                March 1997
  11.  
  12.  
  13.  
  14.  
  15.                           Status of this Memo
  16.  
  17. This document is an Internet-Draft.  Internet-Drafts are working
  18. documents of the Internet Engineering Task Force (IETF), its areas, and
  19. its working groups. Note that other groups may also distribute working
  20. documents as Internet-Drafts.
  21.  
  22. Internet-Drafts are draft documents valid for a maximum of six months.
  23. Internet-Drafts may be updated, replaced, or obsoleted by other
  24. documents at any time.  It is not appropriate to use Internet-Drafts as
  25. reference material or to cite them other than as a ``working draft'' or
  26. ``work in progress.''
  27.  
  28. To learn the current status of any Internet-Draft, please check the
  29. 1id-abstracts.txt listing contained in the Internet-Drafts Shadow
  30. Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe),
  31. ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim).
  32.  
  33.  
  34. 1.  Introduction
  35.  
  36. This memo defines a portion of the Management Information Base (MIB) for
  37. use with network management protocols in the Internet community.
  38. Specifically, this memo extends the basic Network Services Monitoring
  39. MIB [8] to allow monitoring of Message Transfer Agents (MTAs). It may
  40. also be used to monitor MTA components within gateways.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59. Internet Draft            Mail Monitoring MIB                 March 1997
  60.  
  61.  
  62. 2.  Table of Contents
  63.  
  64. 1 Introduction ....................................................    1
  65. 2 Table of Contents ...............................................    2
  66. 3 The SNMPv2 Network Management Framework .........................    2
  67. 3.1 Object Definitions ............................................    2
  68. 4 Message Flow Model ..............................................    3
  69. 5 MTA Objects .....................................................    4
  70. 6 Definitions .....................................................    4
  71. 7 Changes made since RFC 1566 .....................................   30
  72. 8 Acknowledgements ................................................   31
  73. 9 References ......................................................   31
  74. 10 Security Considerations ........................................   32
  75. 11 Author and Chair Addresses .....................................   32
  76.  
  77.  
  78. 3.  The SNMPv2 Network Management Framework
  79.  
  80. The SNMPv2 Network Management Framework consists of seven major
  81. components. They are:
  82.  
  83. o    RFC 1902 [1] which defines the SMI, the mechanisms used for
  84.      describing and naming objects for the purpose of management.
  85.  
  86. o    RFC 1903 [2] defines textual conventions for SNMPv2.
  87.  
  88. o    RFC 1904 [3] defines conformance statements for SNMPv2.
  89.  
  90. o    RFC 1905 [4] defines  transport mappings for SNMPv2.
  91.  
  92. o    RFC 1906 [5] defines the protocol operations used for network
  93.      access to managed objects.
  94.  
  95. o    RFC 1907 [6] defines the Management Information Base for SNMPv2.
  96.  
  97. o    RFC 1908 [7] specifies coexistance between SNMP and SNMPv2.
  98.  
  99. The Framework permits new objects to be defined for the purpose of
  100. experimentation and evaluation.
  101.  
  102.  
  103. 3.1.  Object Definitions
  104.  
  105. Managed objects are accessed via a virtual information store, termed the
  106. Management Information Base or MIB. Objects in the MIB are defined using
  107.  
  108.  
  109.  
  110.  
  111.  
  112. Expires September 1997                                          [Page 2]
  113.  
  114.  
  115.  
  116.  
  117.  
  118. Internet Draft            Mail Monitoring MIB                 March 1997
  119.  
  120.  
  121. the subset of Abstract Syntax Notation One (ASN.1) defined in the SMI.
  122. In particular, each object type is named by an OBJECT IDENTIFIER, an
  123. administratively assigned name. The object type together with an object
  124. instance serves to uniquely identify a specific instantiation of the
  125. object.  For human convenience, we often use a textual string, termed
  126. the descriptor, to refer to the object type.
  127.  
  128.  
  129. 4.  Message Flow Model
  130.  
  131. A general model of message flow inside an MTA has to be presented before
  132. a MIB can be described. Generally speaking, message flow is modelled as
  133. occuring in four steps:
  134.  
  135.  (1)   Messages are received by the MTA from User Agents, Message
  136.        Stores, other MTAs, and gateways.
  137.  
  138.  (2)   The "next hop" for the each message is determined. This is simply
  139.        the destination the message is to be transmitted to; it may or
  140.        may not be the final destination of the message. Multiple "next
  141.        hops" may exist for a single message (as a result of either
  142.        having multiple recipients or distribution list expansion); this
  143.        may make it necessary to duplicate messages.
  144.  
  145.  (3)   If necessary messages are converted into the format that's
  146.        appropriate for the next hop. Conversion operations may be
  147.        successful or unsuccessful.
  148.  
  149.  (4)   Messages are transmitted to the appropriate destination, which
  150.        may be a User Agent, Message Store, another MTA, or gateway.
  151.  
  152. Storage of messages in the MTA occurs at some point during this process.
  153. However, it is important to note that storage may occur at different and
  154. possibly even multiple points during this process. For example, some
  155. MTAs expand messages into multiple copies as they are received. In this
  156. case (1), (2), and (3) may all occur prior to storage. Other MTAs store
  157. messages precisely as they are received and perform all expansions and
  158. conversions during retransmission processing. So here only (1) occurs
  159. prior to storage.  This leads to situations where, in general, a
  160. measurement of messages received may not equal a measurement of messages
  161. in store, or a measurement of messages stored may not equal a
  162. measurement of messages retransmitted, or both.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171. Expires September 1997                                          [Page 3]
  172.  
  173.  
  174.  
  175.  
  176.  
  177. Internet Draft            Mail Monitoring MIB                 March 1997
  178.  
  179.  
  180. 5.  MTA Objects
  181.  
  182. If there are one or more MTAs on the host, the following MIB may be used
  183. to monitor them. Any number of the MTAs on a single host or group of
  184. hosts may be monitored. Each MTA is dealt with as a separate network
  185. service and has its own applTable entry in the Network Services
  186. Monitoring MIB.
  187.  
  188. The MIB described in this document covers only the portion which is
  189. specific to the monitoring of MTAs. The network service related part of
  190. the MIB is covered in a separate document [8].
  191.  
  192. This MIB defines four tables. The first of these contains per-MTA
  193. information that isn't specific to any particular part of MTA. The
  194. second breaks each MTA down into a collection of separate components
  195. called groups. Groups are described in detail in the comments embedded
  196. in the MIB below. The third table provides a means of correlating
  197. associations tracked by the network services MIB with specific groups
  198. within different MTAs. Finally, the fourth table provides a means of
  199. tracking any errors encountered during the operation of the MTA. The
  200. first two tables must be implemented to conform with this MIB; the last
  201. two are optional.
  202.  
  203.  
  204. 6.  Definitions
  205.  
  206. MTA-MIB DEFINITIONS ::= BEGIN
  207.  
  208. IMPORTS
  209.     OBJECT-TYPE, Counter32, Gauge32, MODULE-IDENTITY
  210.       FROM SNMPv2-SMI
  211.     DisplayString, TimeInterval
  212.       FROM SNMPv2-TC
  213.     MODULE-COMPLIANCE, OBJECT-GROUP
  214.       FROM SNMPv2-CONF
  215.     mib-2
  216.       FROM RFC1213-MIB
  217.     applIndex, URLString
  218.       FROM NETWORK-SERVICES-MIB
  219.  
  220. -- Textual conventions
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230. Expires September 1997                                          [Page 4]
  231.  
  232.  
  233.  
  234.  
  235.  
  236. Internet Draft            Mail Monitoring MIB                 March 1997
  237.  
  238.  
  239. mta MODULE-IDENTITY
  240.     LAST-UPDATED "9703020000Z"
  241.     ORGANIZATION "IETF Mail and Directory Management Working Group"
  242.     CONTACT-INFO
  243.       "        Ned Freed
  244.  
  245.        Postal: Innosoft International, Inc.
  246.                1050 East Garvey Avenue South
  247.                West Covina, CA 91790
  248.                US
  249.  
  250.        Tel: +1 818 919 3600
  251.        Fax: +1 818 919 3614
  252.  
  253.        E-Mail: ned@innosoft.com"
  254.     DESCRIPTION
  255.       "The MIB module describing Message Transfer Agents (MTAs)"
  256.     ::= {mib-2 28}
  257.  
  258. mtaTable OBJECT-TYPE
  259.     SYNTAX SEQUENCE OF MtaEntry
  260.     MAX-ACCESS not-accessible
  261.     STATUS current
  262.     DESCRIPTION
  263.       "The table holding information specific to an MTA."
  264.     ::= {mta 1}
  265.  
  266. mtaStatusCode OBJECT-TYPE
  267.     SYNTAX INTEGER (4000000..5999999)
  268.     MAX-ACCESS not-accessible
  269.     STATUS current
  270.     DESCRIPTION
  271.       "An index capable of representing an Enhanced Mail System
  272.        Status Code.  Enhanced Mail System Status Codes are
  273.        defined in RFC 1893 [14].  These codes have the form
  274.  
  275.            class.subject.detail
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289. Expires September 1997                                          [Page 5]
  290.  
  291.  
  292.  
  293.  
  294.  
  295. Internet Draft            Mail Monitoring MIB                 March 1997
  296.  
  297.  
  298.        Here 'class' is either 2, 4, or 5 and both 'subject' and
  299.        'detail'  are integers in the range 0..999. Given a status
  300.        code the corresponding index value is defined to be
  301.        ((class * 1000) + subject) * 1000 + detail.  Both SMTP
  302.        error response codes and X.400 reason and diagnostic codes
  303.        can be mapped into these codes, resulting in a namespace
  304.        capable of describing most error conditions a mail system
  305.        encounters in a generic yet detailed way."
  306.  
  307. mtaEntry OBJECT-TYPE
  308.     SYNTAX MtaEntry
  309.     MAX-ACCESS not-accessible
  310.     STATUS current
  311.     DESCRIPTION
  312.       "The entry associated with each MTA."
  313.     INDEX {applIndex}
  314.     ::= {mtaTable 1}
  315.  
  316. MtaEntry ::= SEQUENCE {
  317.     mtaReceivedMessages
  318.       Counter32,
  319.     mtaStoredMessages
  320.       Gauge32,
  321.     mtaTransmittedMessages
  322.       Counter32,
  323.     mtaReceivedVolume
  324.       Counter32,
  325.     mtaStoredVolume
  326.       Gauge32,
  327.     mtaTransmittedVolume
  328.       Counter32,
  329.     mtaReceivedRecipients
  330.       Counter32,
  331.     mtaStoredRecipients
  332.       Gauge32,
  333.     mtaTransmittedRecipients
  334.       Counter32,
  335.     mtaSuccessfulConvertedMessages
  336.       Counter32,
  337.     mtaFailedConvertedMessages
  338.       Counter32,
  339.     mtaLoopsDetected
  340.       Counter32,
  341. }
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348. Expires September 1997                                          [Page 6]
  349.  
  350.  
  351.  
  352.  
  353.  
  354. Internet Draft            Mail Monitoring MIB                 March 1997
  355.  
  356.  
  357. mtaReceivedMessages OBJECT-TYPE
  358.     SYNTAX Counter32
  359.     MAX-ACCESS read-only
  360.     STATUS current
  361.     DESCRIPTION
  362.       "The number of messages received since MTA initialization.
  363.        This includes messages transmitted to this MTA from other
  364.        MTAs as well as messages that have been submitted to the
  365.        MTA directly by end-users or applications."
  366.     ::= {mtaEntry 1}
  367.  
  368. mtaStoredMessages OBJECT-TYPE
  369.     SYNTAX Gauge32
  370.     MAX-ACCESS read-only
  371.     STATUS current
  372.     DESCRIPTION
  373.       "The total number of messages currently stored in the MTA.
  374.        This includes messages that are awaiting transmission to
  375.        some other MTA or are waiting for delivery to an end-user
  376.        or application."
  377.     ::= {mtaEntry 2}
  378.  
  379. mtaTransmittedMessages OBJECT-TYPE
  380.     SYNTAX Counter32
  381.     MAX-ACCESS read-only
  382.     STATUS current
  383.     DESCRIPTION
  384.       "The number of messages transmitted since MTA initialization.
  385.        This includes messages that were transmitted to some other
  386.        MTA or are waiting for delivery to an end-user or
  387.        application."
  388.     ::= {mtaEntry 3}
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407. Expires September 1997                                          [Page 7]
  408.  
  409.  
  410.  
  411.  
  412.  
  413. Internet Draft            Mail Monitoring MIB                 March 1997
  414.  
  415.  
  416. mtaReceivedVolume OBJECT-TYPE
  417.     SYNTAX Counter32
  418.     UNITS "K-octets"
  419.     MAX-ACCESS read-only
  420.     STATUS current
  421.     DESCRIPTION
  422.       "The total volume of messages received since MTA
  423.        initialization, measured in kilo-octets.  This volume should
  424.        include all transferred data that is logically above the mail
  425.        transport protocol level.  For example, an SMTP-based MTA
  426.        should use the number of kilo-octets in the message header
  427.        and body, while an X.400-based MTA should use the number of
  428.        kilo-octets of P2 data.  This includes messages transmitted
  429.        to this MTA from other MTAs as well as messages that have
  430.        been submitted to the MTA directly by end-users or
  431.        applications."
  432.     ::= {mtaEntry 4}
  433.  
  434. mtaStoredVolume OBJECT-TYPE
  435.     SYNTAX Gauge32
  436.     UNITS "K-octets"
  437.     MAX-ACCESS read-only
  438.     STATUS current
  439.     DESCRIPTION
  440.       "The total volume of messages currently stored in the MTA,
  441.        measured in kilo-octets.  This volume should include all
  442.        stored data that is logically above the mail transport
  443.        protocol level.  For example, an SMTP-based MTA should
  444.        use the number of kilo-octets in the message header and
  445.        body, while an X.400-based MTA would use the number of
  446.        kilo-octets of P2 data.  This includes messages that are
  447.        awaiting transmission to some other MTA or are waiting
  448.        for delivery to an end-user or application."
  449.     ::= {mtaEntry 5}
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. Expires September 1997                                          [Page 8]
  467.  
  468.  
  469.  
  470.  
  471.  
  472. Internet Draft            Mail Monitoring MIB                 March 1997
  473.  
  474.  
  475. mtaTransmittedVolume OBJECT-TYPE
  476.     SYNTAX Counter32
  477.     UNITS "K-octets"
  478.     MAX-ACCESS read-only
  479.     STATUS current
  480.     DESCRIPTION
  481.       "The total volume of messages transmitted since MTA
  482.        initialization, measured in kilo-octets.  This volume should
  483.        include all transferred data that is logically above the mail
  484.        transport protocol level.  For example, an SMTP-based MTA
  485.        should use the number of kilo-octets in the message header
  486.        and body, while an X.400-based MTA should use the number of
  487.        kilo-octets of P2 data.  This includes messages that were
  488.        transmitted to some other MTA or are waiting for delivery
  489.        to an end-user or application."
  490.     ::= {mtaEntry 6}
  491.  
  492. mtaReceivedRecipients OBJECT-TYPE
  493.     SYNTAX Counter32
  494.     MAX-ACCESS read-only
  495.     STATUS current
  496.     DESCRIPTION
  497.       "The total number of recipients specified in all messages
  498.        received since MTA initialization.  Recipients this MTA
  499.        has no responsibility for, i.e. inactive envelope
  500.        recipients or ones referred to in message headers,
  501.        should not be counted even if information about such
  502.        recipients is available.  This includes messages
  503.        transmitted to this MTA from other MTAs as well as
  504.        messages that have been submitted to the MTA directly
  505.        by end-users or applications."
  506.     ::= {mtaEntry 7}
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525. Expires September 1997                                          [Page 9]
  526.  
  527.  
  528.  
  529.  
  530.  
  531. Internet Draft            Mail Monitoring MIB                 March 1997
  532.  
  533.  
  534. mtaStoredRecipients OBJECT-TYPE
  535.     SYNTAX Gauge32
  536.     MAX-ACCESS read-only
  537.     STATUS current
  538.     DESCRIPTION
  539.       "The total number of recipients specified in all messages
  540.        currently stored in the MTA.  Recipients this MTA has no
  541.        responsibility for, i.e. inactive envelope recipients or
  542.        ones referred to in message headers, should not be
  543.        counted.  This includes messages that are awaiting
  544.        transmission to some other MTA or are waiting for
  545.        delivery to an end-user or application."
  546.     ::= {mtaEntry 8}
  547.  
  548. mtaTransmittedRecipients OBJECT-TYPE
  549.     SYNTAX Counter32
  550.     MAX-ACCESS read-only
  551.     STATUS current
  552.     DESCRIPTION
  553.       "The total number of recipients specified in all messages
  554.        transmitted since MTA initialization.  Recipients this
  555.        MTA had no responsibility for, i.e. inactive envelope
  556.        recipients or ones referred to in message headers,
  557.        should not be counted.  This includes messages that were
  558.        transmitted to some other MTA or are waiting for
  559.        delivery to an end-user or application."
  560.     ::= {mtaEntry 9}
  561.  
  562. mtaSuccessfulConvertedMessages OBJECT-TYPE
  563.     SYNTAX Counter32
  564.     MAX-ACCESS read-only
  565.     STATUS current
  566.     DESCRIPTION
  567.       "The number of messages that have been successfully
  568.        converted from one form to another since MTA
  569.        initialization."
  570.     ::= {mtaEntry 10}
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584. Expires September 1997                                         [Page 10]
  585.  
  586.  
  587.  
  588.  
  589.  
  590. Internet Draft            Mail Monitoring MIB                 March 1997
  591.  
  592.  
  593. mtaFailedConvertedMessages OBJECT-TYPE
  594.     SYNTAX Counter32
  595.     MAX-ACCESS read-only
  596.     STATUS current
  597.     DESCRIPTION
  598.       "The number of messages for which an unsuccessful
  599.        attempt was made to convert them from one form to
  600.        another since MTA initialization."
  601.     ::= {mtaEntry 11}
  602.  
  603. mtaLoopsDetected OBJECT-TYPE
  604.     SYNTAX Counter32
  605.     MAX-ACCESS read-only
  606.     STATUS current
  607.     DESCRIPTION
  608.       "A message loop is defined as a situation where the MTA
  609.        decides that a given message will never be delivered to
  610.        one or more recipients and instead will continue to
  611.        loop endlessly through one or more MTAs.  This variable
  612.        counts the number of times the MTA has detected such a
  613.        situation since MTA initialization. Note that the
  614.        mechanism MTAs use to detect loops (e.g. trace field
  615.        counting, count of references to this MTA in a trace
  616.        field, examination of DNS or other directory information,
  617.        etc.), the level at which loops are detected (e.g. per
  618.        message, per recipient, per directory entry, etc.), and
  619.        the handling of a loop once it is detected (e.g. looping
  620.        messages are held, looping messages are bounced or sent
  621.        to the postmaster, messages that the MTA knows will loop
  622.        won't be accepted, etc.) vary widely from one MTA to the
  623.        next and cannot be inferred from this variable."
  624.     ::= {mtaEntry 12}
  625.  
  626. -- MTAs typically group inbound reception, queue storage, and
  627. -- outbound transmission in some way, rather than accounting for
  628. -- such operations only across the MTA as a whole. In the most
  629. -- extreme case separate information will be maintained for each
  630. -- different entity that receives messages and for each entity
  631. -- the MTA stores messages for and delivers messages to.  Other
  632. -- MTAs may elect to treat all reception equally, all queue
  633. -- storage equally, all deliveries equally, or some combination
  634. -- of this. Overlapped groupings are also possible, where an MTA
  635. -- decomposes its traffic in different ways for different
  636. -- purposes.
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643. Expires September 1997                                         [Page 11]
  644.  
  645.  
  646.  
  647.  
  648.  
  649. Internet Draft            Mail Monitoring MIB                 March 1997
  650.  
  651.  
  652. -- In any case, a grouping abstraction is an extremely useful for
  653. -- breaking down the activities of an MTA. For purposes of
  654. -- labelling this will be called a "group" in this MIB.
  655.  
  656. -- Each group contains all the variables needed to monitor all
  657. -- aspects of an MTA's operation.  However, the fact that all
  658. -- groups contain all possible variables does not imply that all
  659. -- groups must use all possible variables. For example, a single
  660. -- group might be used to monitor only one kind of event (inbound
  661. -- processing, outbound processing, or storage). In this sort of
  662. -- configuration all unused counters would be inaccessible; e.g.,
  663. -- returning either a noSuchName error (for an SNMPv1 get), or a
  664. -- noSuchInstance exception (for an SNMPv2 get).
  665.  
  666. -- Groups can be created at any time after MTA initialization. Once
  667. -- a group is created it should not be deleted or its mtaGroupIndex
  668. -- changed unless the MTA is reinitialized.
  669.  
  670. -- Groups are not necessarily mutually exclusive. A given event may
  671. -- be recorded by more than one group, a message may be seen as
  672. -- stored by more than one group, and so on.  Groups should be all
  673. -- inclusive, however: if groups are implemented all aspects of an
  674. -- MTA's operation should be registered in at least one group. This
  675. -- freedom lets implementors use different sets of groups to
  676. -- provide differents "views" of an MTA.
  677.  
  678. -- The possibility of overlap between groups means that summing
  679. -- variables across groups may not produce values equal to those in
  680. -- the mtaTable. mtaTable should always provide accurate information
  681. -- about the MTA as a whole.
  682.  
  683. -- The term "channel" is often used in MTA implementations; channels
  684. -- are usually, but not always, equivalent to a group. However,
  685. -- this MIB does not use the term "channel" because there is no
  686. -- requirement that an MTA supporting this MIB has to map its
  687. -- "channel" abstraction one-to-one onto the MIB's group abstration.
  688.  
  689. -- An MTA may create a group or group of groups at any time. Once
  690. -- created, however, an MTA cannot delete an entry for a group from
  691. -- the group table.  Deletation is only allowed when the MTA is
  692. -- reinitialized, and is not required even then.  This restriction
  693. -- is imposed so that monitoring agents can rely on group
  694. -- assignments being consistent across multiple query operations.
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702. Expires September 1997                                         [Page 12]
  703.  
  704.  
  705.  
  706.  
  707.  
  708. Internet Draft            Mail Monitoring MIB                 March 1997
  709.  
  710.  
  711. -- Groups may be laid out so as to form a hierarchical arrangement,
  712. -- with some groups acting as subgroups for other groups.
  713. -- Alternately, disjoint groups of groups may be used to provide
  714. -- different sorts of "snapshots" of MTA operation.  The
  715. -- mtaGroupHierarchy variable provides an indication of how each
  716. -- group fits into the overall arrangement being used.
  717.  
  718. mtaGroupTable OBJECT-TYPE
  719.     SYNTAX SEQUENCE OF MtaGroupEntry
  720.     MAX-ACCESS not-accessible
  721.     STATUS current
  722.     DESCRIPTION
  723.       "The table holding information specific to each MTA group."
  724.     ::= {mta 2}
  725.  
  726. mtaGroupEntry OBJECT-TYPE
  727.     SYNTAX MtaGroupEntry
  728.     MAX-ACCESS not-accessible
  729.     STATUS current
  730.     DESCRIPTION
  731.       "The entry associated with each MTA group."
  732.     INDEX {applIndex, mtaGroupIndex}
  733.     ::= {mtaGroupTable 1}
  734.  
  735. MtaGroupEntry ::= SEQUENCE {
  736.     mtaGroupIndex
  737.         INTEGER,
  738.     mtaGroupReceivedMessages
  739.         Counter32,
  740.     mtaGroupRejectedMessages
  741.         Counter32,
  742.     mtaGroupStoredMessages
  743.         Gauge32,
  744.     mtaGroupTransmittedMessages
  745.         Counter32,
  746.     mtaGroupReceivedVolume
  747.         Counter32,
  748.     mtaGroupStoredVolume
  749.         Gauge32,
  750.     mtaGroupTransmittedVolume
  751.         Counter32,
  752.     mtaGroupReceivedRecipients
  753.         Counter32,
  754.     mtaGroupStoredRecipients
  755.         Gauge32,
  756.  
  757.  
  758.  
  759.  
  760.  
  761. Expires September 1997                                         [Page 13]
  762.  
  763.  
  764.  
  765.  
  766.  
  767. Internet Draft            Mail Monitoring MIB                 March 1997
  768.  
  769.  
  770.     mtaGroupTransmittedRecipients
  771.         Counter32,
  772.     mtaGroupOldestMessageStored
  773.         TimeInterval,
  774.     mtaGroupInboundAssociations
  775.         Gauge32,
  776.     mtaGroupOutboundAssociations
  777.         Gauge32,
  778.     mtaGroupAccumulatedInboundAssociations
  779.         Counter32,
  780.     mtaGroupAccumulatedOutboundAssociations
  781.         Counter32,
  782.     mtaGroupLastInboundActivity
  783.         TimeInterval,
  784.     mtaGroupLastOutboundActivity
  785.         TimeInterval,
  786.     mtaGroupLastOutboundAssociationAttempt
  787.         TimeInterval,
  788.     mtaGroupRejectedInboundAssociations
  789.         Counter32,
  790.     mtaGroupFailedOutboundAssociations
  791.         Counter32,
  792.     mtaGroupInboundRejectionReason
  793.         DisplayString,
  794.     mtaGroupOutboundConnectFailureReason
  795.         DisplayString,
  796.     mtaGroupScheduledRetry
  797.         TimeInterval,
  798.     mtaGroupMailProtocol
  799.         OBJECT IDENTIFIER,
  800.     mtaGroupName
  801.         DisplayString,
  802.     mtaGroupSuccessfulConvertedMessages
  803.         Counter32,
  804.     mtaGroupFailedConvertedMessages
  805.         Counter32,
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820. Expires September 1997                                         [Page 14]
  821.  
  822.  
  823.  
  824.  
  825.  
  826. Internet Draft            Mail Monitoring MIB                 March 1997
  827.  
  828.  
  829.     mtaGroupDescription
  830.         DisplayString,
  831.     mtaGroupURL
  832.         URLString,
  833.     mtaGroupCreationTime
  834.         TimeInterval,
  835.     mtaGroupHierarchy
  836.         INTEGER,
  837.     mtaGroupOldestMessageId
  838.         DisplayString,
  839.     mtaGroupLoopsDetected
  840.         Counter32
  841. }
  842.  
  843. mtaGroupIndex OBJECT-TYPE
  844.     SYNTAX INTEGER (1..2147483647)
  845.     MAX-ACCESS not-accessible
  846.     STATUS current
  847.     DESCRIPTION
  848.       "The index associated with a group for a given MTA."
  849.     ::= {mtaGroupEntry 1}
  850.  
  851. mtaGroupReceivedMessages OBJECT-TYPE
  852.     SYNTAX Counter32
  853.     MAX-ACCESS read-only
  854.     STATUS current
  855.     DESCRIPTION
  856.       "The number of messages received to this group since
  857.        group creation."
  858.     ::= {mtaGroupEntry 2}
  859.  
  860. mtaGroupRejectedMessages OBJECT-TYPE
  861.     SYNTAX Counter32
  862.     MAX-ACCESS read-only
  863.     STATUS current
  864.     DESCRIPTION
  865.       "The number of messages rejected by this group since
  866.        group creation."
  867.     ::= {mtaGroupEntry 3}
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879. Expires September 1997                                         [Page 15]
  880.  
  881.  
  882.  
  883.  
  884.  
  885. Internet Draft            Mail Monitoring MIB                 March 1997
  886.  
  887.  
  888. mtaGroupStoredMessages OBJECT-TYPE
  889.     SYNTAX Gauge32
  890.     MAX-ACCESS read-only
  891.     STATUS current
  892.     DESCRIPTION
  893.       "The total number of messages currently stored in this
  894.        group's queue."
  895.     ::= {mtaGroupEntry 4}
  896.  
  897. mtaGroupTransmittedMessages OBJECT-TYPE
  898.     SYNTAX Counter32
  899.     MAX-ACCESS read-only
  900.     STATUS current
  901.     DESCRIPTION
  902.       "The number of messages transmitted by this group since
  903.        group creation."
  904.     ::= {mtaGroupEntry 5}
  905.  
  906. mtaGroupReceivedVolume OBJECT-TYPE
  907.     SYNTAX Counter32
  908.     UNITS "K-octets"
  909.     MAX-ACCESS read-only
  910.     STATUS current
  911.     DESCRIPTION
  912.       "The total volume of messages received to this group since
  913.        group creation, measured in kilo-octets.  This volume
  914.        should include all transferred data that is logically above
  915.        the mail transport protocol level.  For example, an
  916.        SMTP-based MTA should use the number of kilo-octets in the
  917.        message header and body, while an X.400-based MTA should use
  918.        the number of kilo-octets of P2 data."
  919.     ::= {mtaGroupEntry 6}
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938. Expires September 1997                                         [Page 16]
  939.  
  940.  
  941.  
  942.  
  943.  
  944. Internet Draft            Mail Monitoring MIB                 March 1997
  945.  
  946.  
  947. mtaGroupStoredVolume OBJECT-TYPE
  948.     SYNTAX Gauge32
  949.     UNITS "K-octets"
  950.     MAX-ACCESS read-only
  951.     STATUS current
  952.     DESCRIPTION
  953.       "The total volume of messages currently stored in this
  954.        group's queue, measured in kilo-octets.  This volume should
  955.        include all stored data that is logically above the mail
  956.        transport protocol level.  For example, an SMTP-based
  957.        MTA should use the number of kilo-octets in the message
  958.        header and body, while an X.400-based MTA would use the
  959.        number of kilo-octets of P2 data."
  960.     ::= {mtaGroupEntry 7}
  961.  
  962. mtaGroupTransmittedVolume OBJECT-TYPE
  963.     SYNTAX Counter32
  964.     UNITS "K-octets"
  965.     MAX-ACCESS read-only
  966.     STATUS current
  967.     DESCRIPTION
  968.       "The total volume of messages transmitted by this group
  969.        since group creation, measured in kilo-octets.  This
  970.        volume should include all transferred data that is logically
  971.        above the mail transport protocol level.  For example, an
  972.        SMTP-based MTA should use the number of kilo-octets in the
  973.        message header and body, while an X.400-based MTA should use
  974.        the number of kilo-octets of P2 data."
  975.     ::= {mtaGroupEntry 8}
  976.  
  977. mtaGroupReceivedRecipients OBJECT-TYPE
  978.     SYNTAX Counter32
  979.     MAX-ACCESS read-only
  980.     STATUS current
  981.     DESCRIPTION
  982.       "The total number of recipients specified in all messages
  983.        received to this group since group creation.
  984.        Recipients this MTA has no responsibility for should not
  985.        be counted."
  986.     ::= {mtaGroupEntry 9}
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997. Expires September 1997                                         [Page 17]
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003. Internet Draft            Mail Monitoring MIB                 March 1997
  1004.  
  1005.  
  1006. mtaGroupStoredRecipients OBJECT-TYPE
  1007.     SYNTAX Gauge32
  1008.     MAX-ACCESS read-only
  1009.     STATUS current
  1010.     DESCRIPTION
  1011.       "The total number of recipients specified in all messages
  1012.        currently stored in this group's queue.  Recipients this
  1013.        MTA has no responsibility for should not be counted."
  1014.     ::= {mtaGroupEntry 10}
  1015.  
  1016. mtaGroupTransmittedRecipients OBJECT-TYPE
  1017.     SYNTAX Counter32
  1018.     MAX-ACCESS read-only
  1019.     STATUS current
  1020.     DESCRIPTION
  1021.       "The total number of recipients specified in all messages
  1022.        transmitted by this group since group creation.
  1023.        Recipients this MTA had no responsibility for should not
  1024.        be counted."
  1025.     ::= {mtaGroupEntry 11}
  1026.  
  1027. mtaGroupOldestMessageStored OBJECT-TYPE
  1028.     SYNTAX TimeInterval
  1029.     MAX-ACCESS read-only
  1030.     STATUS current
  1031.     DESCRIPTION
  1032.       "Time since the oldest message in this group's queue was
  1033.        placed in the queue."
  1034.     ::= {mtaGroupEntry 12}
  1035.  
  1036. mtaGroupInboundAssociations OBJECT-TYPE
  1037.     SYNTAX Gauge32
  1038.     MAX-ACCESS read-only
  1039.     STATUS current
  1040.     DESCRIPTION
  1041.       "The number of current associations to the group, where the
  1042.        group is the responder."
  1043.     ::= {mtaGroupEntry 13}
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056. Expires September 1997                                         [Page 18]
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062. Internet Draft            Mail Monitoring MIB                 March 1997
  1063.  
  1064.  
  1065. mtaGroupOutboundAssociations OBJECT-TYPE
  1066.     SYNTAX Gauge32
  1067.     MAX-ACCESS read-only
  1068.     STATUS current
  1069.     DESCRIPTION
  1070.       "The number of current associations to the group, where the
  1071.       group is the initiator."
  1072.     ::= {mtaGroupEntry 14}
  1073.  
  1074. mtaGroupAccumulatedInboundAssociations OBJECT-TYPE
  1075.     SYNTAX Counter32
  1076.     MAX-ACCESS read-only
  1077.     STATUS current
  1078.     DESCRIPTION
  1079.       "The total number of associations to the group since
  1080.       group creation, where the MTA was the responder."
  1081.     ::= {mtaGroupEntry 15}
  1082.  
  1083. mtaGroupAccumulatedOutboundAssociations OBJECT-TYPE
  1084.     SYNTAX Counter32
  1085.     MAX-ACCESS read-only
  1086.     STATUS current
  1087.     DESCRIPTION
  1088.       "The total number of associations from the group since
  1089.        group creation, where the MTA was the initiator."
  1090.     ::= {mtaGroupEntry 16}
  1091.  
  1092. mtaGroupLastInboundActivity OBJECT-TYPE
  1093.     SYNTAX TimeInterval
  1094.     MAX-ACCESS read-only
  1095.     STATUS current
  1096.     DESCRIPTION
  1097.       "Time since the last time that this group had an active
  1098.       inbound association for purposes of message reception."
  1099.     ::= {mtaGroupEntry 17}
  1100.  
  1101. mtaGroupLastOutboundActivity OBJECT-TYPE
  1102.     SYNTAX TimeInterval
  1103.     MAX-ACCESS read-only
  1104.     STATUS current
  1105.     DESCRIPTION
  1106.       "Time since the last time that this group had a
  1107.        successful outbound association for purposes of
  1108.        message delivery."
  1109.     ::= {mtaGroupEntry 18}
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115. Expires September 1997                                         [Page 19]
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121. Internet Draft            Mail Monitoring MIB                 March 1997
  1122.  
  1123.  
  1124. mtaGroupLastOutboundAssociationAttempt OBJECT-TYPE
  1125.     SYNTAX TimeInterval
  1126.     MAX-ACCESS read-only
  1127.     STATUS current
  1128.     DESCRIPTION
  1129.       "Time since the last time that this group attempted
  1130.        to make an outbound association for purposes of
  1131.        message delivery."
  1132.     ::= {mtaGroupEntry 34}
  1133.  
  1134. mtaGroupRejectedInboundAssociations OBJECT-TYPE
  1135.     SYNTAX Counter32
  1136.     MAX-ACCESS read-only
  1137.     STATUS current
  1138.     DESCRIPTION
  1139.       "The total number of inbound associations the group has
  1140.       rejected, since group creation.  Rejected associations
  1141.       are not counted in the accumulated association totals."
  1142.     ::= {mtaGroupEntry 19}
  1143.  
  1144. mtaGroupFailedOutboundAssociations OBJECT-TYPE
  1145.     SYNTAX Counter32
  1146.     MAX-ACCESS read-only
  1147.     STATUS current
  1148.     DESCRIPTION
  1149.       "The total number associations where the group was the
  1150.       initiator and association establishment has failed,
  1151.       since group creation.  Failed associations are
  1152.       not counted in the accumulated association totals."
  1153.     ::= {mtaGroupEntry 20}
  1154.  
  1155. mtaGroupInboundRejectionReason OBJECT-TYPE
  1156.     SYNTAX DisplayString
  1157.     MAX-ACCESS read-only
  1158.     STATUS current
  1159.     DESCRIPTION
  1160.       "The failure reason, if any, for the last association this
  1161.       group refused to respond to. An empty string indicates that
  1162.       the last attempt was successful.  If no association attempt
  1163.       has been made since the MTA was initialized the value
  1164.       should be 'never'."
  1165.     ::= {mtaGroupEntry 21}
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174. Expires September 1997                                         [Page 20]
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180. Internet Draft            Mail Monitoring MIB                 March 1997
  1181.  
  1182.  
  1183. mtaGroupOutboundConnectFailureReason OBJECT-TYPE
  1184.     SYNTAX DisplayString
  1185.     MAX-ACCESS read-only
  1186.     STATUS current
  1187.     DESCRIPTION
  1188.       "The failure reason, if any, for the last association attempt
  1189.       this group initiated. An empty string indicates that the last
  1190.       attempt was successful.  If no association attempt has been
  1191.       made since the MTA was initialized the value should be
  1192.       'never'."
  1193.     ::= {mtaGroupEntry 22}
  1194.  
  1195. mtaGroupScheduledRetry OBJECT-TYPE
  1196.     SYNTAX TimeInterval
  1197.     MAX-ACCESS read-only
  1198.     STATUS current
  1199.     DESCRIPTION
  1200.       "The time when this group is scheduled to next attempt to
  1201.        make an association."
  1202.     ::= {mtaGroupEntry 23}
  1203.  
  1204. mtaGroupMailProtocol OBJECT-TYPE
  1205.     SYNTAX OBJECT IDENTIFIER
  1206.     MAX-ACCESS read-only
  1207.     STATUS current
  1208.     DESCRIPTION
  1209.       "An identification of the protocol being used by this group.
  1210.       For an group employing OSI protocols, this will be the
  1211.       Application Context.  For Internet applications, the IANA
  1212.       maintains a registry of the OIDs which correspond to well-known
  1213.       message transfer protocols.  If the application protocol is
  1214.       not listed in the registry, an OID value of the form
  1215.       {applTCPProtoID port} or {applUDProtoID port} are used for
  1216.       TCP-based and UDP-based protocols, respectively.  In either
  1217.       case 'port' corresponds to the primary port number being
  1218.       used by the group.  applTCPProtoID and applUDPProtoID are
  1219.       defined in [8]."
  1220.     ::= {mtaGroupEntry 24}
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233. Expires September 1997                                         [Page 21]
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239. Internet Draft            Mail Monitoring MIB                 March 1997
  1240.  
  1241.  
  1242. mtaGroupName OBJECT-TYPE
  1243.     SYNTAX DisplayString
  1244.     MAX-ACCESS read-only
  1245.     STATUS current
  1246.     DESCRIPTION
  1247.       "A descriptive name for the group. If this group connects to
  1248.        a single remote MTA this should be the name of that MTA. If
  1249.        this in turn is an Internet MTA this should be the domain
  1250.        name.  For an OSI MTA it should be the string encoded
  1251.        distinguished name of the managed object using the format
  1252.        defined in RFC 1779 [9]. For X.400(1984) MTAs which do not
  1253.        have a Distinguished Name, the RFC 1327 [12] syntax
  1254.        'mta in globalid' should be used."
  1255.     ::= {mtaGroupEntry 25}
  1256.  
  1257. mtaGroupSuccessfulConvertedMessages OBJECT-TYPE
  1258.     SYNTAX Counter32
  1259.     MAX-ACCESS read-only
  1260.     STATUS current
  1261.     DESCRIPTION
  1262.       "The number of messages that have been successfully
  1263.        converted from one form to another in this group
  1264.        since group creation."
  1265.     ::= {mtaGroupEntry 26}
  1266.  
  1267. mtaGroupFailedConvertedMessages OBJECT-TYPE
  1268.     SYNTAX Counter32
  1269.     MAX-ACCESS read-only
  1270.     STATUS current
  1271.     DESCRIPTION
  1272.       "The number of messages for which an unsuccessful
  1273.        attempt was made to convert them from one form to
  1274.        another in this group since group creation."
  1275.     ::= {mtaGroupEntry 27}
  1276.  
  1277. mtaGroupDescription OBJECT-TYPE
  1278.     SYNTAX DisplayString
  1279.     MAX-ACCESS read-only
  1280.     STATUS current
  1281.     DESCRIPTION
  1282.       "A description of the group's purpose.  This information is
  1283.        intended to identify the group in a status display."
  1284.     ::= {mtaGroupEntry 28}
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292. Expires September 1997                                         [Page 22]
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298. Internet Draft            Mail Monitoring MIB                 March 1997
  1299.  
  1300.  
  1301. mtaGroupURL OBJECT-TYPE
  1302.     SYNTAX URLString
  1303.     MAX-ACCESS read-only
  1304.     STATUS current
  1305.     DESCRIPTION
  1306.       "A URL pointing to a description of the group.  This
  1307.        information is intended to identify and briefly describe
  1308.        the group in a status display."
  1309.     ::= {mtaEntry 29}
  1310.  
  1311. mtaGroupCreationTime OBJECT-TYPE
  1312.     SYNTAX TimeInterval
  1313.     MAX-ACCESS read-only
  1314.     STATUS current
  1315.     DESCRIPTION
  1316.       "Time since this group was first created."
  1317.     ::= {mtaGroupEntry 30}
  1318.  
  1319. mtaGroupHierarchy OBJECT-TYPE
  1320.     SYNTAX INTEGER (-2147483648..2147483647)
  1321.     MAX-ACCESS not-accessible
  1322.     STATUS current
  1323.     DESCRIPTION
  1324.       "Describes how this group fits into the hierarchy. A
  1325.        positive value is interpreted as an mtaGroupIndex
  1326.        value for some other group whose variables include
  1327.        those of this group (and usually others). A negative
  1328.        value is interpreted as a group collection code: Groups
  1329.        with common negative hierarchy values comprise one
  1330.        particular breakdown of MTA activity as a whole. A
  1331.        zero value means that this MIB implementation doesn't
  1332.        implement hierarchy indicators and thus the overall
  1333.        group hierarchy cannot be determined."
  1334.     ::= {mtaGroupEntry 31}
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351. Expires September 1997                                         [Page 23]
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357. Internet Draft            Mail Monitoring MIB                 March 1997
  1358.  
  1359.  
  1360. mtaGroupOldestMessageId OBJECT-TYPE
  1361.     SYNTAX DisplayString
  1362.     MAX-ACCESS read-only
  1363.     STATUS current
  1364.     DESCRIPTION
  1365.       "Message ID of the oldest message in the group's queue.
  1366.        Whenever possible this should be in the form of an
  1367.        RFC 822 [13] msg-id; X.400 may convert X.400 message
  1368.        identifiers to this form by following the rules laid
  1369.        out in RFC1327 [12]."
  1370.     ::= {mtaGroupEntry 32}
  1371.  
  1372. mtaGroupLoopsDetected OBJECT-TYPE
  1373.     SYNTAX Counter32
  1374.     MAX-ACCESS read-only
  1375.     STATUS current
  1376.     DESCRIPTION
  1377.       "A message loop is defined as a situation where the MTA
  1378.        decides that a given message will never be delivered to
  1379.        one or more recipients and instead will continue to
  1380.        loop endlessly through one or more MTAs.  This variable
  1381.        counts the number of times the MTA has detected such a
  1382.        situation in conjunction with something associated with
  1383.        this group since group creation.  Note that the
  1384.        mechanism MTAs use to detect loops (e.g. trace field
  1385.        counting, count of references to this MTA in a trace
  1386.        field, examination of DNS or other directory information,
  1387.        etc.), the level at which loops are detected (e.g. per
  1388.        message, per recipient, per directory entry, etc.), and
  1389.        the handling of a loop once it is detected (e.g. looping
  1390.        messages are held, looping messages are bounced or sent
  1391.        to the postmaster, messages that the MTA knows will loop
  1392.        won't be accepted, etc.) vary widely from one MTA to the
  1393.        next and cannot be inferred from this variable."
  1394.     ::= {mtaGroupEntry 33}
  1395.  
  1396. -- The mtaGroupAssociationTable provides a means of correlating
  1397. -- entries in the network services association table with the
  1398. -- MTA group responsible for the association.
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410. Expires September 1997                                         [Page 24]
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416. Internet Draft            Mail Monitoring MIB                 March 1997
  1417.  
  1418.  
  1419. mtaGroupAssociationTable OBJECT-TYPE
  1420.     SYNTAX SEQUENCE OF MtaGroupAssociationEntry
  1421.     MAX-ACCESS not-accessible
  1422.     STATUS current
  1423.     DESCRIPTION
  1424.       "The table holding information regarding the associations
  1425.        for each MTA group."
  1426.     ::= {mta 3}
  1427.  
  1428. mtaGroupAssociationEntry OBJECT-TYPE
  1429.     SYNTAX MtaGroupAssociationEntry
  1430.     MAX-ACCESS not-accessible
  1431.     STATUS current
  1432.     DESCRIPTION
  1433.       "The entry holding information regarding the associations
  1434.        for each MTA group."
  1435.     INDEX {applIndex, mtaGroupIndex, mtaGroupAssociationIndex}
  1436.     ::= {mtaGroupAssociationTable 1}
  1437.  
  1438. MtaGroupAssociationEntry ::= SEQUENCE {
  1439.     mtaGroupAssociationIndex
  1440.         INTEGER
  1441. }
  1442.  
  1443. mtaGroupAssociationIndex OBJECT-TYPE
  1444.     SYNTAX INTEGER (1..2147483647)
  1445.     MAX-ACCESS read-only
  1446.     STATUS current
  1447.     DESCRIPTION
  1448.       "Reference into association table to allow correlation of
  1449.        this group's active associations with the association table."
  1450.     ::= {mtaGroupAssociationEntry 1}
  1451.  
  1452. -- The mtaGroupErrorTable gives each group a way of tallying
  1453. -- the specific errors it has encountered.  The mechanism
  1454. -- defined here uses RFC 1893 [14] status codes to identify
  1455. -- various specific errors. There are also classes for generic
  1456. -- errors of various sorts, and the entire mechanism is also
  1457. -- extensible, in that new error codes can be defined at any
  1458. -- time.
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469. Expires September 1997                                         [Page 25]
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475. Internet Draft            Mail Monitoring MIB                 March 1997
  1476.  
  1477.  
  1478. mtaGroupErrorTable OBJECT-TYPE
  1479.     SYNTAX SEQUENCE OF MtaGroupErrorEntry
  1480.     MAX-ACCESS not-accessible
  1481.     STATUS current
  1482.     DESCRIPTION
  1483.       "The table holding information regarding accumulated errors
  1484.        for each MTA group."
  1485.     ::= {mta 4}
  1486.  
  1487. mtaGroupErrorEntry OBJECT-TYPE
  1488.     SYNTAX MtaGroupErrorEntry
  1489.     MAX-ACCESS not-accessible
  1490.     STATUS current
  1491.     DESCRIPTION
  1492.       "The entry holding information regarding accumulated
  1493.        errors for each MTA group."
  1494.     INDEX {applIndex, mtaGroupIndex, mtaStatusCode}
  1495.     ::= {mtaGroupErrorTable 1}
  1496.  
  1497. MtaGroupErrorEntry ::= SEQUENCE {
  1498.     mtaGroupInboundErrorCount
  1499.         Counter32,
  1500.     mtaGroupInternalErrorCount
  1501.         Counter32,
  1502.     mtaGroupOutboundErrorCount
  1503.         Counter32
  1504. }
  1505.  
  1506. mtaGroupInboundErrorCount OBJECT-TYPE
  1507.     SYNTAX Counter32
  1508.     MAX-ACCESS read-only
  1509.     STATUS current
  1510.     DESCRIPTION
  1511.       "Count of the number of errors of a given type that have
  1512.        been accumulated in assocation with a particular group
  1513.        while processing incoming messages. In the case of SMTP
  1514.        these will typically be errors reporting by an SMTP
  1515.        server to the remote client; in the case of X.400
  1516.        these will typically be errors encountered while
  1517.        processing an incoming message."
  1518.     ::= {mtaGroupErrorEntry 1}
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528. Expires September 1997                                         [Page 26]
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534. Internet Draft            Mail Monitoring MIB                 March 1997
  1535.  
  1536.  
  1537. mtaGroupInternalErrorCount OBJECT-TYPE
  1538.     SYNTAX Counter32
  1539.     MAX-ACCESS read-only
  1540.     STATUS current
  1541.     DESCRIPTION
  1542.       "Count of the number of errors of a given type that have
  1543.        been accumulated in assocation with a particular group
  1544.        during internal MTA processing."
  1545.     ::= {mtaGroupErrorEntry 2}
  1546.  
  1547. mtaGroupOutboundErrorCount OBJECT-TYPE
  1548.     SYNTAX Counter32
  1549.     MAX-ACCESS read-only
  1550.     STATUS current
  1551.     DESCRIPTION
  1552.       "Count of the number of errors of a given type that have
  1553.        been accumulated in assocation with a particular group's
  1554.        outbound connection activities. In the case of an SMTP
  1555.        client these will typically be errors reported while
  1556.        attempting to contact or while communicating with the
  1557.        remote SMTP server. In the case of X.400 these will
  1558.        typically be errors encountered while constructing
  1559.        or attempting to deliver an outgoing message."
  1560.     ::= {mtaGroupErrorEntry 3}
  1561.  
  1562. -- Conformance information
  1563.  
  1564. mtaConformance OBJECT IDENTIFIER ::= {mta 4}
  1565.  
  1566. mtaGroups      OBJECT IDENTIFIER ::= {mtaConformance 1}
  1567. mtaCompliances OBJECT IDENTIFIER ::= {mtaConformance 2}
  1568.  
  1569. -- Compliance statements
  1570.  
  1571. mtaCompliance MODULE-COMPLIANCE
  1572.     STATUS current
  1573.     DESCRIPTION
  1574.       "The compliance statement for SNMPv2 entities which
  1575.        implement the Mail Monitoring MIB for basic
  1576.        monitoring of MTAs."
  1577.     MODULE  -- this module
  1578.       MANDATORY-GROUPS {mtaGroup}
  1579.     ::= {mtaCompliances 1}
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587. Expires September 1997                                         [Page 27]
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593. Internet Draft            Mail Monitoring MIB                 March 1997
  1594.  
  1595.  
  1596. mtaAssocCompliance MODULE-COMPLIANCE
  1597.     STATUS current
  1598.     DESCRIPTION
  1599.       "The compliance statement for SNMPv2 entities which
  1600.        implement the Mail Monitoring MIB for monitoring of
  1601.        MTAs and their associations."
  1602.     MODULE  -- this module
  1603.       MANDATORY-GROUPS {mtaGroup, mtaAssocGroup}
  1604.     ::= {mtaCompliances 2}
  1605.  
  1606. mtaErrorCompliance MODULE-COMPLIANCE
  1607.     STATUS current
  1608.     DESCRIPTION
  1609.       "The compliance statement for SNMPv2 entities which
  1610.        implement the Mail Monitoring MIB for monitoring of
  1611.        MTAs and detailed errors."
  1612.     MODULE  -- this module
  1613.       MANDATORY-GROUPS {mtaGroup, mtaErrorGroup}
  1614.     ::= {mtaCompliances 2}
  1615.  
  1616. mtaFullCompliance MODULE-COMPLIANCE
  1617.     STATUS current
  1618.     DESCRIPTION
  1619.       "The compliance statement for SNMPv2 entities which
  1620.        implement the full Mail Monitoring MIB for monitoring
  1621.        of MTAs, associations, and detailed errors."
  1622.     MODULE  -- this module
  1623.       MANDATORY-GROUPS {mtaGroup, mtaAssocGroup, mtaErrorGroup}
  1624.     ::= {mtaCompliances 2}
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646. Expires September 1997                                         [Page 28]
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652. Internet Draft            Mail Monitoring MIB                 March 1997
  1653.  
  1654.  
  1655. -- Units of conformance
  1656.  
  1657. mtaGroup OBJECT-GROUP
  1658.     OBJECTS {
  1659.       mtaReceivedMessages, mtaStoredMessages,
  1660.       mtaTransmittedMessages, mtaReceivedVolume, mtaStoredVolume,
  1661.       mtaTransmittedVolume, mtaReceivedRecipients,
  1662.       mtaStoredRecipients, mtaTransmittedRecipients,
  1663.       mtaSuccessfulConvertedMessages, mtaFailedConvertedMessages,
  1664.       mtaGroupReceivedMessages, mtaGroupRejectedMessages,
  1665.       mtaGroupStoredMessages, mtaGroupTransmittedMessages,
  1666.       mtaGroupReceivedVolume, mtaGroupStoredVolume,
  1667.       mtaGroupTransmittedVolume, mtaGroupReceivedRecipients,
  1668.       mtaGroupStoredRecipients, mtaGroupTransmittedRecipients,
  1669.       mtaGroupOldestMessageStored, mtaGroupInboundAssociations,
  1670.       mtaGroupOutboundAssociations, mtaLoopsDetected,
  1671.       mtaGroupAccumulatedInboundAssociations,
  1672.       mtaGroupAccumulatedOutboundAssociations,
  1673.       mtaGroupLastInboundActivity, mtaGroupLastOutboundActivity,
  1674.       mtaGroupLastOutboundAssociationAttempt,
  1675.       mtaGroupRejectedInboundAssociations,
  1676.       mtaGroupFailedOutboundAssociations,
  1677.       mtaGroupInboundRejectionReason,
  1678.       mtaGroupOutboundConnectFailureReason,
  1679.       mtaGroupScheduledRetry, mtaGroupMailProtocol, mtaGroupName,
  1680.       mtaGroupSuccessfulConvertedMessages,
  1681.       mtaGroupFailedConvertedMessages, mtaGroupDescription,
  1682.       mtaGroupURL, mtaGroupCreationTime, mtaGroupHierarchy,
  1683.       mtaGroupOldestMessageId, mtaGroupLoopsDetected}
  1684.     STATUS current
  1685.     DESCRIPTION
  1686.       "A collection of objects providing basic monitoring of MTAs."
  1687.     ::= {mtaGroups 1}
  1688.  
  1689. mtaAssocGroup OBJECT-GROUP
  1690.     OBJECTS {
  1691.       mtaGroupAssociationIndex}
  1692.     STATUS current
  1693.     DESCRIPTION
  1694.       "A collection of objects providing monitoring of MTA
  1695.        associations."
  1696.     ::= {mtaGroups 2}
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705. Expires September 1997                                         [Page 29]
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711. Internet Draft            Mail Monitoring MIB                 March 1997
  1712.  
  1713.  
  1714. mtaErrorGroup OBJECT-GROUP
  1715.     OBJECTS {
  1716.       mtaGroupInboundErrorCount, mtaGroupInternalErrorCount,
  1717.       mtaGroupOutboundErrorCount}
  1718.     STATUS current
  1719.     DESCRIPTION
  1720.       "A collection of objects providing monitoring of
  1721.        detailed MTA errors."
  1722.     ::= {mtaGroups 3}
  1723.  
  1724. END
  1725.  
  1726.  
  1727. 7.  Changes made since RFC 1566
  1728.  
  1729. The only changes made to this document since it was issued as RFC 1566
  1730. [11] are the following:
  1731.  
  1732.  (1)   A number of DESCRIPTION fields have been reworded, hopefully
  1733.        making them clearer.
  1734.  
  1735.  (2)   mtaGroupDescription and mtaGroupURL fields have been added.
  1736.        These fields are intended to identify and describe the MTA and
  1737.        the various MTA groups.
  1738.  
  1739.  (3)   The time since the last outbound association attempt is now
  1740.        distinct from the time since the last successfuol outbound
  1741.        association attempt.
  1742.  
  1743.  (4)   Conversion operation counters have been added.
  1744.  
  1745.  (5)   A mechanism to explicitly describe group hierarchies has been
  1746.        added.
  1747.  
  1748.  (6)   A mechanism to count specific sorts of errors has been added.
  1749.  
  1750.  (7)   A field for the ID of the oldest message in a group's queue has
  1751.        been added.
  1752.  
  1753.  (8)   Per-MTA and per-group message loop counters have been added.
  1754.  
  1755.  (9)   A new table has been added to keep track of any errors an MTA
  1756.        encounters.
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764. Expires September 1997                                         [Page 30]
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770. Internet Draft            Mail Monitoring MIB                 March 1997
  1771.  
  1772.  
  1773. 8.  Acknowledgements
  1774.  
  1775. This document is a work product of the Mail and Directory Management
  1776. (MADMAN) Working Group of the IETF. It is based on an earlier MIB
  1777. designed by S. Kille, T. Lenggenhager, D. Partain, and W. Yeong. The
  1778. Electronic Mail Association's TSC committee was instrumental in
  1779. providing feedback on and suggesting enhancements to RFC 1566 [11] that
  1780. have led to the present document.
  1781.  
  1782.  
  1783. 9.  References
  1784.  
  1785. [1]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Structure
  1786.      of Management Information for Version 2 of the Simple Network
  1787.      Management Protocol (SNMPv2)", RFC 1902, January 1996.
  1788.  
  1789. [2]  Case, J., McCloghrie, K., Rose, M., Waldbusser, S., "Textual
  1790.      Conventions for Version 2 of the Simple Network Management Protocol
  1791.      (SNMPv2)", RFC 1903, January 1996.
  1792.  
  1793. [3]  Case, J., McCloghrie, K., Rose, M., Waldbusser, S., "Conformance
  1794.      Statements for Version 2 of the Simple Network Management Protocol
  1795.      (SNMPv2)", RFC 1904, January 1996.
  1796.  
  1797. [4]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Protocol
  1798.      Operations for Version 2 of the Simple Network Management Protocol
  1799.      (SNMPv2)", RFC 1905, January 1996.
  1800.  
  1801. [5]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Transport
  1802.      Mappings for Version 2 of the Simple Network Management Protocol
  1803.      (SNMPv2)", RFC 1906, January 1996.
  1804.  
  1805. [6]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Management
  1806.      Information Base for Version 2 of the Simple Network Management
  1807.      Protocol (SNMPv2)", RFC 1907, January 1996.
  1808.  
  1809. [7]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S.,
  1810.      "Coexistence between Version 1 and Version 2 of the Internet-
  1811.      standard Network Management Framework", RFC 1908, January 1996.
  1812.  
  1813. [8]  Freed, N., Kille, S., "The Network Services Monitoring MIB",
  1814.      Internet Draft, March 1997.
  1815.  
  1816. [9]  Kille, S., "A String Representation of Distinguished Names", RFC
  1817.      1779, March 1995.
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823. Expires September 1997                                         [Page 31]
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829. Internet Draft            Mail Monitoring MIB                 March 1997
  1830.  
  1831.  
  1832. [10] Berners-Lee, T., Masinter, L., McCahill, M., iform Resource
  1833.      Locators (URL)", RFC 1738, December 1994.
  1834.  
  1835. [11] Freed, N., Kille, S., "Mail Monitoring MIB", RFC 1566, January
  1836.      1994.
  1837.  
  1838. [12] Kille, S., "Mapping between X.400(1988) / ISO 10021 and RFC 822",
  1839.      RFC 1327, May 1992.
  1840.  
  1841. [13] Crocker, D., "Standard for the Format of ARPA Internet Text
  1842.      Message", RFC 822, August 1982.
  1843.  
  1844. [14] Vaudreuil, G., "Enhanced Mail System Status Codes", RFC 1893, Octel
  1845.      Network Services, January 1996.
  1846.  
  1847.  
  1848. 10.  Security Considerations
  1849.  
  1850. Security issues are not discussed in this memo.
  1851.  
  1852.  
  1853. 11.  Author and Chair Addresses
  1854.  
  1855.      Ned Freed
  1856.      Innosoft International, Inc.
  1857.      1050 East Garvey Avenue South
  1858.      West Covina, CA 91790
  1859.      USA
  1860.       tel: +1 818 919 3600
  1861.       fax: +1 818 919 3614
  1862.       email: ned@innosoft.com
  1863.  
  1864.      Steve Kille, MADMAN WG Chair
  1865.      ISODE Consortium
  1866.      The Dome, The Square
  1867.      Richmond TW9 1DT
  1868.      UK
  1869.        tel: +44 181 332 9091
  1870.        email: S.Kille@isode.com
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882. Expires September 1997                                         [Page 32]
  1883.  
  1884.  
  1885.