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