home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 3 / rfc1696.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  52.8 KB  |  1,740 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                          J. Barnes
  8. Request for Comments: 1696                                Xylogics, Inc.
  9. Category: Standards Track                                       L. Brown
  10.                                                                 Motorola
  11.                                                               R. Royston
  12.                                                        US Robotics, Inc.
  13.                                                            S. Waldbusser
  14.                                               Carnegie Mellon University
  15.                                                              August 1994
  16.  
  17.  
  18.           Modem Management Information Base (MIB) using SMIv2
  19.  
  20. Status of this Memo
  21.  
  22.    This document specifies an Internet standards track protocol for the
  23.    Internet community, and requests discussion and suggestions for
  24.    improvements.  Please refer to the current edition of the "Internet
  25.    Official Protocol Standards" (STD 1) for the standardization state
  26.    and status of this protocol.  Distribution of this memo is unlimited.
  27.  
  28. Table of Contents
  29.  
  30.    1 Introduction .................................................    1
  31.    2 The SNMPv2 Network Management Framework ......................    2
  32.    2.1 Object Definitions .........................................    2
  33.    3 Definitions ..................................................    2
  34.    4 Acknowledgements .............................................   30
  35.    5. Security Considerations .....................................   30
  36.    6. Authors' Addresses ..........................................   31
  37.  
  38. 1.  Introduction
  39.  
  40.    This memo defines a portion of the Management Information Base (MIB)
  41.    for use with network management protocols in the Internet community.
  42.    In particular, it describes managed objects used for managing dial-up
  43.    modems and similar dial-up devices.  This MIB module provides a set
  44.    of objects that are the minimum necessary to provide the ability to
  45.    monitor and control those devices, and is consistent with the SNMP
  46.    framework and existing SNMP standards.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Barnes, Brown, Royston & Waldbusser                             [Page 1]
  59.  
  60. RFC 1696                       Modem MIB                     August 1994
  61.  
  62.  
  63. 2.  The SNMPv2 Network Management Framework
  64.  
  65.    The SNMPv2 Network Management Framework consists of four major
  66.    components.  They are:
  67.  
  68.       o RFC 1442 which defines the SMI, the mechanisms used for
  69.         describing and naming objects for the purpose of management.
  70.  
  71.       o STD 17, RFC 1213 defines MIB-II, the core set of managed objects
  72.         for the Internet suite of protocols.
  73.  
  74.       o RFC 1445 which defines the administrative and other
  75.         architectural aspects of the framework.
  76.  
  77.       o RFC 1448 which defines the protocol used for network access to
  78.         managed objects.
  79.  
  80.    The Framework permits new objects to be defined for the purpose of
  81.    experimentation and evaluation.
  82.  
  83. 2.1.  Object Definitions
  84.  
  85.    Managed objects are accessed via a virtual information store, termed
  86.    the Management Information Base or MIB.  Objects in the MIB are
  87.    defined using the subset of Abstract Syntax Notation One (ASN.1)
  88.    defined in the SMI.  In particular, each object object type is named
  89.    by an OBJECT IDENTIFIER, an administratively assigned name.  The
  90.    object type together with an object instance serves to uniquely
  91.    identify a specific instantiation of the object.  For human
  92.    convenience, we often use a textual string, termed the descriptor, to
  93.    refer to the object type.
  94.  
  95. 3.  Definitions
  96.  
  97. Modem-MIB DEFINITIONS ::= BEGIN
  98.  
  99.  
  100. IMPORTS
  101.     MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY,
  102.     Counter32, Integer32 FROM SNMPv2-SMI
  103.     DisplayString FROM SNMPv2-TC
  104.     MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF
  105.     mib-2 FROM RFC1213-MIB;
  106.  
  107.  
  108. mdmMIB MODULE-IDENTITY
  109.     LAST-UPDATED "9406120000Z"
  110.     ORGANIZATION "IETF Modem Management Working Group"
  111.  
  112.  
  113.  
  114. Barnes, Brown, Royston & Waldbusser                             [Page 2]
  115.  
  116. RFC 1696                       Modem MIB                     August 1994
  117.  
  118.  
  119.     CONTACT-INFO
  120.             "        Steven Waldbusser
  121.              Postal: Carnegie Mellon University
  122.                      5000 Forbes Ave
  123.                      Pittsburgh, PA, 15213
  124.                      US
  125.  
  126.                 Tel: +1 412 268 6628
  127.                 Fax: +1 412 268 4987
  128.              E-mail: waldbusser@cmu.edu"
  129.     DESCRIPTION
  130.             "The MIB module for management of dial-up modems."
  131.     ::= { mdmMIB 1 }
  132.  
  133. mdmMib OBJECT IDENTIFIER ::= { mib-2 38 }
  134.  
  135. mdmMIBObjects OBJECT IDENTIFIER ::= { mdmMIB 1 }
  136.  
  137.  
  138. -- conformance information
  139.  
  140. mdmConformance OBJECT IDENTIFIER ::= { mdmMIB 2 }
  141.  
  142. mdmCompliances OBJECT IDENTIFIER ::= { mdmConformance 1 }
  143. mdmGroups      OBJECT IDENTIFIER ::= { mdmConformance 2 }
  144.  
  145. -- units of conformance
  146.  
  147. mdmIDGroup    OBJECT-GROUP
  148.     OBJECTS   { mdmIDManufacturerOID, mdmIDProductDetails }
  149.     STATUS    current
  150.     DESCRIPTION
  151.             "A collection of objects that identify the manufacturer and
  152.             model information for a modem."
  153.     ::= { mdmGroups 1 }
  154.  
  155. mdmLineInterfaceGroup    OBJECT-GROUP
  156.     OBJECTS { mdmLineCarrierLossTime,
  157.         mdmLineState, mdmLineCapabilitiesID,
  158.         mdmLineCapabilitiesEnableRequested,
  159.         mdmLineCapabilitiesEnableGranted }
  160.     STATUS  current
  161.     DESCRIPTION
  162.             "A collection of objects that describe the configuration and
  163.             state of the modem's line interface."
  164.     ::= { mdmGroups 2 }
  165.  
  166. mdmDTEInterfaceGroup    OBJECT-GROUP
  167.  
  168.  
  169.  
  170. Barnes, Brown, Royston & Waldbusser                             [Page 3]
  171.  
  172. RFC 1696                       Modem MIB                     August 1994
  173.  
  174.  
  175.     OBJECTS { mdmDTEActionDTROnToOff, mdmDTEActionDTROffToOn,
  176.                 mdmDTESyncTimingSource, mdmDTESyncAsyncMode,
  177.                 mdmDTEInactivityTimeout }
  178.     STATUS      current
  179.     DESCRIPTION
  180.             "A collection of objects that describe the configuration and
  181.             state of the modem's DTE interface."
  182.     ::= { mdmGroups 3 }
  183.  
  184. mdmCallControlGroup    OBJECT-GROUP
  185.     OBJECTS { mdmCCRingsBeforeAnswer,
  186.         mdmCCCallSetUpFailTimer, mdmCCResultCodeEnable,
  187.         mdmCCEscapeAction, mdmCCCallDuration,
  188.         mdmCCConnectionFailReason, mdmCCStoredDialString }
  189.     STATUS  current
  190.     DESCRIPTION
  191.             "A collection of objects that describe the configuration of
  192.             call control capabilities on the modem and the status of
  193.             calls placed with this modem."
  194.     ::= { mdmGroups 4 }
  195.  
  196. mdmErrorControlGroup   OBJECT-GROUP
  197.     OBJECTS { mdmECErrorControlUsed }
  198.     STATUS  current
  199.     DESCRIPTION
  200.             "A collection of objects that describe the configuration and
  201.             state of error control on a modem."
  202.     ::= { mdmGroups 5 }
  203.  
  204. mdmDataCompressionGroup   OBJECT-GROUP
  205.     OBJECTS { mdmDCCompressionTypeUsed }
  206.     STATUS  current
  207.     DESCRIPTION
  208.             "A collection of objects that describe the configuration and
  209.             state of data compression on a modem."
  210.     ::= { mdmGroups 6 }
  211.  
  212. mdmSignalConvertorGroup   OBJECT-GROUP
  213. OBJECTS { mdmSCCurrentLineReceiveRate, mdmSCCurrentLineTransmitRate,
  214.           mdmSCInitialLineReceiveRate, mdmSCInitialLineTransmitRate,
  215.           mdmSCModulationSchemeUsed }
  216.     STATUS  current
  217.     DESCRIPTION
  218.             "A collection of objects that describe the configuration and
  219.             state of error control on a modem."
  220.     ::= { mdmGroups 7 }
  221.  
  222. mdmStatisticsGroup  OBJECT-GROUP
  223.  
  224.  
  225.  
  226. Barnes, Brown, Royston & Waldbusser                             [Page 4]
  227.  
  228. RFC 1696                       Modem MIB                     August 1994
  229.  
  230.  
  231.     OBJECTS { mdmStatsRingNoAnswers,
  232.         mdmStatsIncomingConnectionFailures,
  233.         mdmStatsIncomingConnectionCompletions,
  234.         mdmStatsFailedDialAttempts,
  235.         mdmStatsOutgoingConnectionFailures,
  236.         mdmStatsOutgoingConnectionCompletions,
  237.         mdmStatsRetrains,
  238.         mdmStats2400OrLessConnections, mdmStats2400To14400Connections,
  239.         mdmStatsGreaterThan14400Connections,
  240.         mdmStatsErrorControlledConnections,
  241.         mdmStatsCompressedConnections,
  242.         mdmStatsCompressionEfficiency,
  243.         mdmStatsSentOctets, mdmStatsReceivedOctets,
  244.         mdmStatsSentDataFrames, mdmStatsReceivedDataFrames,
  245.         mdmStatsResentFrames, mdmStatsErrorFrames }
  246.     STATUS  current
  247.     DESCRIPTION
  248.             "A collection of objects that describe the state of calls on
  249.             this modem."
  250.     ::= { mdmGroups 8 }
  251.  
  252. mdmNumber OBJECT-TYPE
  253.     SYNTAX  Integer32
  254.     MAX-ACCESS  read-only
  255.     STATUS  current
  256.     DESCRIPTION
  257.             "The number of modem rows in the modem table.  This value
  258.             defines the maximum value of the mdmIndex object."
  259.     ::= { mdmMIBObjects 1 }
  260.  
  261. -- The modem ID table.
  262.  
  263. mdmIDTable OBJECT-TYPE
  264.     SYNTAX      SEQUENCE OF MdmIDEntry
  265.     MAX-ACCESS  not-accessible
  266.     STATUS      current
  267.     DESCRIPTION
  268.             "The base table for the modems managed by this MIB.  The
  269.             mdmLineTable, mdmDTEInterfaceTable, mdmCallControlTable, and
  270.             mdmStatsTable all augment the rows defined in this table."
  271.     ::= { mdmMIBObjects 2 }
  272.  
  273. mdmIDEntry OBJECT-TYPE
  274.     SYNTAX      MdmIDEntry
  275.     MAX-ACCESS  not-accessible
  276.     STATUS      current
  277.     DESCRIPTION
  278.             "Entries in this table are created only by the agent. One
  279.  
  280.  
  281.  
  282. Barnes, Brown, Royston & Waldbusser                             [Page 5]
  283.  
  284. RFC 1696                       Modem MIB                     August 1994
  285.  
  286.  
  287.             entry exists for each modem managed by the agent."
  288.     INDEX       { mdmIndex }
  289.     ::= { mdmIDTable 1 }
  290.  
  291. MdmIDEntry ::= SEQUENCE {
  292.     mdmIndex                Integer32,
  293.     mdmIDManufacturerOID    OBJECT IDENTIFIER,
  294.     mdmIDProductDetails     DisplayString
  295. }
  296.  
  297. mdmIndex OBJECT-TYPE
  298.     SYNTAX      Integer32 (1..65535)
  299.     MAX-ACCESS  not-accessible
  300.     STATUS      current
  301.     DESCRIPTION
  302.             "A unique number for each modem that ranges from 1 to
  303.             mdmNumber.  The value must remain constant at least from one
  304.             re-initialization of the network management agent to the
  305.             next."
  306.     ::= { mdmIDEntry 1 }
  307.  
  308. mdmIDManufacturerOID OBJECT-TYPE
  309.     SYNTAX      OBJECT IDENTIFIER
  310.     MAX-ACCESS  read-only
  311.     STATUS      current
  312.     DESCRIPTION
  313.             "This value is intended to identify the manufacturer, model,
  314.             and version of this modem.  This may be used to identify the
  315.             existance of enterprise-specific functions and behaviours."
  316.     REFERENCE
  317.             "V.58 attribute manufacturerID subfield ManufacturerOI"
  318.     ::= { mdmIDEntry 2 }
  319.  
  320. mdmIDProductDetails OBJECT-TYPE
  321.     SYNTAX      DisplayString (SIZE (0..79))
  322.     MAX-ACCESS  read-only
  323.     STATUS      current
  324.     DESCRIPTION
  325.             "A textual description of this device, including the
  326.             manufacturer's name, modem model name, hardware revision,
  327.             firmware revision, and optionally, its serial number.  The
  328.             exact format of this description is defined by the vendor.
  329.             This description may only contain characters from the NVT
  330.             ASCII character set."
  331.     REFERENCE
  332.             "V.58 attribute manufacturerID subfield productDetails"
  333.     ::= { mdmIDEntry 3 }
  334.  
  335.  
  336.  
  337.  
  338. Barnes, Brown, Royston & Waldbusser                             [Page 6]
  339.  
  340. RFC 1696                       Modem MIB                     August 1994
  341.  
  342.  
  343. -- The modem Line Interface Table
  344.  
  345. mdmLineTable OBJECT-TYPE
  346.     SYNTAX      SEQUENCE OF MdmLineEntry
  347.     MAX-ACCESS  not-accessible
  348.     STATUS      current
  349.     DESCRIPTION
  350.             "The modem Line Table augments the modem ID table."
  351.     ::= { mdmMIBObjects 3 }
  352.  
  353. mdmLineEntry OBJECT-TYPE
  354.     SYNTAX      MdmLineEntry
  355.     MAX-ACCESS  not-accessible
  356.     STATUS      current
  357.     DESCRIPTION
  358.             "Entries in this table are created only by the agent. One
  359.             entry exists for each modem managed by the agent."
  360.     AUGMENTS    { mdmIDEntry }
  361.     ::= { mdmLineTable 1 }
  362.  
  363. MdmLineEntry ::= SEQUENCE {
  364.     mdmLineCarrierLossTime          Integer32,
  365.     mdmLineState                    INTEGER
  366. }
  367.  
  368. mdmLineCarrierLossTime OBJECT-TYPE
  369.     SYNTAX      Integer32 (1..255)
  370.     MAX-ACCESS  read-write
  371.     STATUS      current
  372.     DESCRIPTION
  373.             "Duration in 10ths of a second the modem waits after loss of
  374.             carrier before hanging up.  If this value is set to `255',
  375.             the modem will not hang up upon loss of carrier.  This
  376.             allows the modem to distinguish between a momentary lapse in
  377.             line quality and a true disconnect and can be useful to tune
  378.             the tolerance of the modem to lines of poor quality."
  379.     REFERENCE "V.58 lineSignalFailDisconnectTimer"
  380.     ::= { mdmLineEntry 1 }
  381.  
  382. mdmLineState OBJECT-TYPE
  383.     SYNTAX      INTEGER {
  384.                     unknown(1),
  385.                     onHook(2),
  386.                     offHook(3),  -- and not connected
  387.                     connected(4),
  388.                     busiedOut(5),
  389.                     reset(6)
  390.                 }
  391.  
  392.  
  393.  
  394. Barnes, Brown, Royston & Waldbusser                             [Page 7]
  395.  
  396. RFC 1696                       Modem MIB                     August 1994
  397.  
  398.  
  399.     MAX-ACCESS  read-write
  400.     STATUS      current
  401.     DESCRIPTION
  402.             "Allows the inspection and alteration of the state of the
  403.             modem.  Management commands may change the state to `on-
  404.             hook', `busied-out', or `reset' from any state.  No other
  405.             alterations are permitted from the management protocol.
  406.             When this object is set to reset, the modem shall be reset
  407.             and the value will change to the modem's new, implementation
  408.             dependent state."
  409.     ::= { mdmLineEntry 2 }
  410.  
  411. mdmLineCapabilitiesTable OBJECT-TYPE
  412.     SYNTAX      SEQUENCE OF MdmLineCapabilitiesEntry
  413.     MAX-ACCESS  not-accessible
  414.     STATUS      current
  415.     DESCRIPTION
  416.             "A list of protocol capabilities for this modem."
  417.     ::= { mdmMIBObjects 4 }
  418.  
  419. mdmLineCapabilitiesEntry OBJECT-TYPE
  420.     SYNTAX      MdmLineCapabilitiesEntry
  421.     MAX-ACCESS  not-accessible
  422.     STATUS      current
  423.     DESCRIPTION
  424.             "A listing of the protocol(s) that this modem is capable of.
  425.             Entries in this table are created only by the agent.  One
  426.             entry exists for each protocol that the modem is capable of,
  427.             regardless of whether that protocol is enabled or not.
  428.  
  429.             This table is useful for providing an inventory of the
  430.             capabilities on a modem, and allowing the manager to enable
  431.             or disable capabilities from the menu of available
  432.             possibilities.  Row creation is not required to enable or
  433.             disable capabilities."
  434.     INDEX       { mdmIndex, mdmLineCapabilitiesIndex }
  435.     ::= { mdmLineCapabilitiesTable 1 }
  436.  
  437. MdmLineCapabilitiesEntry ::= SEQUENCE {
  438.     mdmLineCapabilitiesIndex            Integer32,
  439.     mdmLineCapabilitiesID               OBJECT IDENTIFIER,
  440.     mdmLineCapabilitiesEnableRequested  INTEGER,
  441.     mdmLineCapabilitiesEnableGranted    INTEGER
  442. }
  443.  
  444. mdmLineCapabilitiesIndex OBJECT-TYPE
  445.     SYNTAX      Integer32
  446.     MAX-ACCESS  not-accessible
  447.  
  448.  
  449.  
  450. Barnes, Brown, Royston & Waldbusser                             [Page 8]
  451.  
  452. RFC 1696                       Modem MIB                     August 1994
  453.  
  454.  
  455.     STATUS      current
  456.     DESCRIPTION
  457.             "A unique index for this capabilities entry."
  458.     ::= { mdmLineCapabilitiesEntry 1 }
  459.  
  460. mdmLineCapabilitiesID OBJECT-TYPE
  461.     SYNTAX      OBJECT IDENTIFIER
  462.     MAX-ACCESS  read-only
  463.     STATUS      current
  464.     DESCRIPTION
  465.             "An identifier for this capability.  Standard protocol
  466.             capabilities will have identifiers registered in this
  467.             document or other companion standards documents.
  468.             Proprietary protocol capabilities will be registered by
  469.             their respective organization.  All capabilities, standard
  470.             or vendor-specific, shall be registered in this table."
  471.     ::= { mdmLineCapabilitiesEntry 2 }
  472.  
  473. mdmLineCapabilitiesEnableRequested OBJECT-TYPE
  474.     SYNTAX      INTEGER {
  475.                     disabled(1),
  476.                     optional(2),
  477.                     preferred(3)
  478.                 }
  479.     MAX-ACCESS  read-write
  480.     STATUS      current
  481.     DESCRIPTION
  482.             "The requested configuration of this capability.  If this
  483.             value is 'disabled(1)', this is a request to disable this
  484.             protocol.  If this value is 'preferred(3)', this is a
  485.             request to enable this protocol, and to prefer it in any
  486.             negotiation over other appropriate protocols that have a
  487.             value of 'optional(2)'."
  488.     DEFVAL      { preferred }
  489.     ::= { mdmLineCapabilitiesEntry 3 }
  490.  
  491. mdmLineCapabilitiesEnableGranted OBJECT-TYPE
  492.     SYNTAX      INTEGER {
  493.                     disabled(1),
  494.                     optional(2),
  495.                     preferred(3)
  496.                 }
  497.     MAX-ACCESS  read-only
  498.     STATUS      current
  499.     DESCRIPTION
  500.             "The actual configuration of this capability.  The agent
  501.             shall attempt to set this as close as possible to the
  502.             associated mdmLineCapabilitiesEnableRequested value.  The
  503.  
  504.  
  505.  
  506. Barnes, Brown, Royston & Waldbusser                             [Page 9]
  507.  
  508. RFC 1696                       Modem MIB                     August 1994
  509.  
  510.  
  511.             agent shall make this determination in an implementation-
  512.             specific manner that may take into account the configuration
  513.             of other capabilities or other considerations.  The modem
  514.             will choose in an implementation-specific manner between
  515.             multiple mutually-exclusive capabilities that each have the
  516.             same (non-disabled) value.  However, the modem must prefer
  517.             all capabilities with a value of 'preferred(3)' over all
  518.             capabilities with a value of 'optional(2)'.
  519.  
  520.             In other words, if there are one or more mutually-exclusive
  521.             capabilities (e.g. V.32 and V.32bis) that are set to
  522.             `preferred', the agent must choose one in an
  523.             implementation-specific manner.  Otherwise, if there are one
  524.             or more mutually-exclusive capabilities that are set to
  525.             `optional', the agent must choose one in an implementation-
  526.             specific manner."
  527.     ::= { mdmLineCapabilitiesEntry 4 }
  528.  
  529. mdmLineCapabilities   OBJECT IDENTIFIER ::= { mdmMIBObjects 5 }
  530.  
  531. mdmLineCapabilitiesV21 OBJECT-IDENTITY
  532.     STATUS  current
  533.     DESCRIPTION
  534.             "ITU V.21"
  535.     ::= { mdmLineCapabilities 1 }
  536.  
  537. mdmLineCapabilitiesV22 OBJECT-IDENTITY
  538.     STATUS  current
  539.     DESCRIPTION
  540.             "ITU V.22"
  541.     ::= { mdmLineCapabilities 2 }
  542.  
  543. mdmLineCapabilitiesV22bis OBJECT-IDENTITY
  544.     STATUS  current
  545.     DESCRIPTION
  546.             "ITU V.22bis"
  547.     ::= { mdmLineCapabilities 3 }
  548.  
  549. mdmLineCapabilitiesV23CC OBJECT-IDENTITY
  550.     STATUS  current
  551.     DESCRIPTION
  552.             "ITU V.23CC"
  553.     ::= { mdmLineCapabilities 4 }
  554.  
  555. mdmLineCapabilitiesV23SC OBJECT-IDENTITY
  556.     STATUS  current
  557.     DESCRIPTION
  558.             "ITU V.23SC"
  559.  
  560.  
  561.  
  562. Barnes, Brown, Royston & Waldbusser                            [Page 10]
  563.  
  564. RFC 1696                       Modem MIB                     August 1994
  565.  
  566.  
  567.     ::= { mdmLineCapabilities 5 }
  568.  
  569. mdmLineCapabilitiesV25bis OBJECT-IDENTITY
  570.     STATUS  current
  571.     DESCRIPTION
  572.             "ITU V.25bis"
  573.     ::= { mdmLineCapabilities 6 }
  574.  
  575. mdmLineCapabilitiesV26bis OBJECT-IDENTITY
  576.     STATUS  current
  577.     DESCRIPTION
  578.             "ITU V.26bis"
  579.     ::= { mdmLineCapabilities 7 }
  580.  
  581. mdmLineCapabilitiesV26ter OBJECT-IDENTITY
  582.     STATUS  current
  583.     DESCRIPTION
  584.             "ITU V.26ter"
  585.     ::= { mdmLineCapabilities 8 }
  586.  
  587. mdmLineCapabilitiesV27ter OBJECT-IDENTITY
  588.     STATUS  current
  589.     DESCRIPTION
  590.             "ITU V.27ter"
  591.     ::= { mdmLineCapabilities 9 }
  592.  
  593. mdmLineCapabilitiesV32 OBJECT-IDENTITY
  594.     STATUS  current
  595.     DESCRIPTION
  596.             "ITU V.32"
  597.     ::= { mdmLineCapabilities 10 }
  598.  
  599. mdmLineCapabilitiesV32bis OBJECT-IDENTITY
  600.     STATUS  current
  601.     DESCRIPTION
  602.             "ITU V.32bis"
  603.     ::= { mdmLineCapabilities 11 }
  604.  
  605. mdmLineCapabilitiesV32terbo OBJECT-IDENTITY
  606.     STATUS  current
  607.     DESCRIPTION
  608.             "ITU V.32terbo"
  609.     ::= { mdmLineCapabilities 12 }
  610.  
  611. mdmLineCapabilitiesVFC OBJECT-IDENTITY
  612.     STATUS  current
  613.     DESCRIPTION
  614.             "ITU V.FC"
  615.  
  616.  
  617.  
  618. Barnes, Brown, Royston & Waldbusser                            [Page 11]
  619.  
  620. RFC 1696                       Modem MIB                     August 1994
  621.  
  622.  
  623.     ::= { mdmLineCapabilities 13 }
  624.  
  625. mdmLineCapabilitiesV34 OBJECT-IDENTITY
  626.     STATUS  current
  627.     DESCRIPTION
  628.             "ITU V.34"
  629.     ::= { mdmLineCapabilities 14 }
  630.  
  631. mdmLineCapabilitiesV42 OBJECT-IDENTITY
  632.     STATUS  current
  633.     DESCRIPTION
  634.             "ITU V.42"
  635.     ::= { mdmLineCapabilities 15 }
  636.  
  637. mdmLineCapabilitiesV42bis OBJECT-IDENTITY
  638.     STATUS  current
  639.     DESCRIPTION
  640.             "ITU V.42bis"
  641.     ::= { mdmLineCapabilities 16 }
  642.  
  643. mdmLineCapabilitiesMNP1 OBJECT-IDENTITY
  644.     STATUS  current
  645.     DESCRIPTION
  646.             "MNP1"
  647.     ::= { mdmLineCapabilities 17 }
  648.  
  649. mdmLineCapabilitiesMNP2 OBJECT-IDENTITY
  650.     STATUS  current
  651.     DESCRIPTION
  652.             "MNP2"
  653.     ::= { mdmLineCapabilities 18 }
  654.  
  655. mdmLineCapabilitiesMNP3 OBJECT-IDENTITY
  656.     STATUS  current
  657.     DESCRIPTION
  658.             "MNP3"
  659.     ::= { mdmLineCapabilities 19 }
  660.  
  661. mdmLineCapabilitiesMNP4 OBJECT-IDENTITY
  662.     STATUS  current
  663.     DESCRIPTION
  664.             "MNP4"
  665.     ::= { mdmLineCapabilities 20 }
  666.  
  667. mdmLineCapabilitiesMNP5 OBJECT-IDENTITY
  668.     STATUS  current
  669.     DESCRIPTION
  670.             "MNP5"
  671.  
  672.  
  673.  
  674. Barnes, Brown, Royston & Waldbusser                            [Page 12]
  675.  
  676. RFC 1696                       Modem MIB                     August 1994
  677.  
  678.  
  679.     ::= { mdmLineCapabilities 21 }
  680.  
  681. mdmLineCapabilitiesMNP6 OBJECT-IDENTITY
  682.     STATUS  current
  683.     DESCRIPTION
  684.             "MNP6"
  685.     ::= { mdmLineCapabilities 22 }
  686.  
  687. mdmLineCapabilitiesMNP7 OBJECT-IDENTITY
  688.     STATUS  current
  689.     DESCRIPTION
  690.             "MNP7"
  691.     ::= { mdmLineCapabilities 23 }
  692.  
  693. mdmLineCapabilitiesMNP8 OBJECT-IDENTITY
  694.     STATUS  current
  695.     DESCRIPTION
  696.             "MNP8"
  697.     ::= { mdmLineCapabilities 24 }
  698.  
  699. mdmLineCapabilitiesMNP9 OBJECT-IDENTITY
  700.     STATUS  current
  701.     DESCRIPTION
  702.             "MNP9"
  703.     ::= { mdmLineCapabilities 25 }
  704.  
  705. mdmLineCapabilitiesMNP10 OBJECT-IDENTITY
  706.     STATUS  current
  707.     DESCRIPTION
  708.             "MNP10"
  709.     ::= { mdmLineCapabilities 26 }
  710.  
  711. mdmLineCapabilitiesV29 OBJECT-IDENTITY
  712.     STATUS  current
  713.     DESCRIPTION
  714.             "ITU V.29"
  715.     ::= { mdmLineCapabilities 27 }
  716.  
  717. mdmLineCapabilitiesV33 OBJECT-IDENTITY
  718.     STATUS  current
  719.     DESCRIPTION
  720.             "ITU V.33"
  721.     ::= { mdmLineCapabilities 28 }
  722.  
  723. mdmLineCapabilitiesBell208 OBJECT-IDENTITY
  724.     STATUS  current
  725.     DESCRIPTION
  726.             "Bell 208"
  727.  
  728.  
  729.  
  730. Barnes, Brown, Royston & Waldbusser                            [Page 13]
  731.  
  732. RFC 1696                       Modem MIB                     August 1994
  733.  
  734.  
  735.     ::= { mdmLineCapabilities 29 }
  736.  
  737.  
  738. -- DTE Interface Table
  739.  
  740. mdmDTEInterfaceTable OBJECT-TYPE
  741.     SYNTAX      SEQUENCE OF MdmDTEInterfaceEntry
  742.     MAX-ACCESS  not-accessible
  743.     STATUS      current
  744.     DESCRIPTION
  745.             "The modem DTE Interface Table augments the modem ID table."
  746.     ::= { mdmMIBObjects 6 }
  747.  
  748. mdmDTEInterfaceEntry OBJECT-TYPE
  749.     SYNTAX      MdmDTEInterfaceEntry
  750.     MAX-ACCESS  not-accessible
  751.     STATUS      current
  752.     DESCRIPTION
  753.             "Entries in this table are created only by the agent. One
  754.             entry exists for each modem managed by the agent."
  755.     AUGMENTS    { mdmIDEntry }
  756.     ::= { mdmDTEInterfaceTable 1 }
  757.  
  758. MdmDTEInterfaceEntry ::= SEQUENCE {
  759.     mdmDTEActionDTROnToOff      INTEGER,
  760.     mdmDTEActionDTROffToOn      INTEGER,
  761.     mdmDTESyncTimingSource      INTEGER,
  762.     mdmDTESyncAsyncMode         INTEGER,
  763.     mdmDTEInactivityTimeout     Integer32
  764. }
  765.  
  766. mdmDTEActionDTROnToOff OBJECT-TYPE
  767.     SYNTAX      INTEGER {
  768.                     ignore(1),
  769.                     escapeToCommandMode(2),
  770.                     disconnectCall(3),
  771.                     resetModem(4)
  772.                 }
  773.     MAX-ACCESS  read-write
  774.     STATUS      current
  775.     DESCRIPTION
  776.             "Defines the action the modem will take when DTR drops.
  777.  
  778.             If the value is set to ignore(1), the modem takes no action
  779.             when DTR drops.  Typically, mdmDTEActionDTROffToOn would
  780.             also be set to ignore(1) if this object is set to ignore(1).
  781.  
  782.             If the value is escapeToCommandMode(2), the modem remains
  783.  
  784.  
  785.  
  786. Barnes, Brown, Royston & Waldbusser                            [Page 14]
  787.  
  788. RFC 1696                       Modem MIB                     August 1994
  789.  
  790.  
  791.             connected and enters command mode.  If the value is
  792.             disconnectCall(3), the current call (if any) is terminated
  793.             and the modem will not auto-answer while DTR is off.  If the
  794.             value is resetModem(4), the current call (if any) is
  795.             terminated and the modem is reset."
  796.     DEFVAL      { disconnectCall }
  797.     ::= { mdmDTEInterfaceEntry 1 }
  798.  
  799. mdmDTEActionDTROffToOn OBJECT-TYPE
  800.     SYNTAX      INTEGER {
  801.                     ignore(1),
  802.                     enableDial(2),
  803.                     autoAnswerEnable(3),
  804.                     establishConnection(4)
  805.                 }
  806.     MAX-ACCESS  read-write
  807.     STATUS      current
  808.     DESCRIPTION
  809.             "Defines the action the modem will take when DTR is raised.
  810.  
  811.             If the value is set to ignore(1), the modem takes no action
  812.             when DTR is raised.  Typically, mdmDTEActionDTROnToOff would
  813.             also be set to ignore(1) if this object is set to ignore(1).
  814.  
  815.             If the value is set to enableDial(2), the modem prepares to
  816.             dial an outgoing call.  If the value is set to
  817.             autoAnswerEnable(3), the modem will be configured to answer
  818.             any incoming call.  If the value is set to
  819.             establishConnection(4), the modem dials an implementation
  820.             specific number.
  821.  
  822.             Immediately after any reset or power-on of the modem, if the
  823.             DTR is high, the action specified here will be executed."
  824.     DEFVAL      { autoAnswerEnable }
  825.     ::= { mdmDTEInterfaceEntry 2 }
  826.  
  827. mdmDTESyncTimingSource OBJECT-TYPE
  828.     SYNTAX      INTEGER {
  829.                     internal(1),
  830.                     external(2),
  831.                     loopback(3),
  832.                     network(4)
  833.                 }
  834.     MAX-ACCESS  read-write
  835.     STATUS      current
  836.     DESCRIPTION
  837.             "The clock source for synchronous transmissions.  If set to
  838.             internal(1), the modem is the clock source and sends the
  839.  
  840.  
  841.  
  842. Barnes, Brown, Royston & Waldbusser                            [Page 15]
  843.  
  844. RFC 1696                       Modem MIB                     August 1994
  845.  
  846.  
  847.             clock signals to the DTE.  If set to external(2), the
  848.             transmit clock signals are provided by the DTE.  If
  849.             loopback(3), the modem receiver clock is used for the
  850.             transmit clock.  If network(4), the clock signals are
  851.             supplied by the DCE interface.
  852.  
  853.             If the modem is not in synchronous mode, setting this object
  854.             will have no effect on the current operations of the modem."
  855.     REFERENCE   "V.58 transmitClockSource"
  856.     DEFVAL      { internal }
  857.     ::= { mdmDTEInterfaceEntry 3 }
  858.  
  859. mdmDTESyncAsyncMode OBJECT-TYPE
  860.     SYNTAX      INTEGER {
  861.                     async(1),
  862.                     sync(2),
  863.                     syncAfterDial(3)
  864.                 }
  865.     MAX-ACCESS  read-write
  866.     STATUS      current
  867.     DESCRIPTION
  868.             "The operational mode of the modem.  If the value is
  869.             syncAfterDial(3), the modem will accept commands in
  870.             asynchronous mode and change to synchronous mode to pass
  871.             data after a dial sequence has been executed."
  872.     DEFVAL      { async }
  873.     ::= { mdmDTEInterfaceEntry 4 }
  874.  
  875. mdmDTEInactivityTimeout OBJECT-TYPE
  876.     SYNTAX      Integer32 (0..65535)
  877.     MAX-ACCESS  read-write
  878.     STATUS      current
  879.     DESCRIPTION
  880.             "The amount of idle time in minutes that the modem will wait
  881.             before disconnecting a connection.  When a call is connected
  882.             and no data is transferred (continuous marking condition) on
  883.             both circuits 103 and 104 for the specified time, the DCE
  884.             disconnects the call. If the value is 0, no idle disconnect
  885.             will occur.  This function applies to asynchronous dial
  886.             operations only and is intended for administrative control
  887.             over idle connections."
  888.     REFERENCE   "V.58 inactivityTimerSelect"
  889.     DEFVAL { 0 }
  890.     ::= { mdmDTEInterfaceEntry 5 }
  891.  
  892.  
  893. -- The Call Control Table
  894.  
  895.  
  896.  
  897.  
  898. Barnes, Brown, Royston & Waldbusser                            [Page 16]
  899.  
  900. RFC 1696                       Modem MIB                     August 1994
  901.  
  902.  
  903. mdmCallControlTable OBJECT-TYPE
  904.     SYNTAX      SEQUENCE OF MdmCallControlEntry
  905.     MAX-ACCESS  not-accessible
  906.     STATUS      current
  907.     DESCRIPTION
  908.             "The modem Call Control Table augments the modem ID table."
  909.     ::= { mdmMIBObjects 7 }
  910.  
  911. mdmCallControlEntry OBJECT-TYPE
  912.     SYNTAX      MdmCallControlEntry
  913.     MAX-ACCESS  not-accessible
  914.     STATUS      current
  915.     DESCRIPTION
  916.             "Entries in this table are created only by the agent. One
  917.             entry exists for each modem managed by the agent."
  918.     AUGMENTS    { mdmIDEntry }
  919.     ::= { mdmCallControlTable 1 }
  920.  
  921. MdmCallControlEntry ::= SEQUENCE {
  922.     mdmCCRingsBeforeAnswer      Integer32,
  923.     mdmCCCallSetUpFailTimer     Integer32,
  924.     mdmCCResultCodeEnable       INTEGER,
  925.     mdmCCEscapeAction           INTEGER,
  926.     mdmCCCallDuration           Integer32,
  927.     mdmCCConnectionFailReason   INTEGER
  928. }
  929.  
  930. mdmCCRingsBeforeAnswer OBJECT-TYPE
  931.     SYNTAX      Integer32
  932.     MAX-ACCESS  read-write
  933.     STATUS      current
  934.     DESCRIPTION
  935.             "Determines which ring the modem will wait to answer the
  936.             phone on.  If this value is `0', the modem will not go
  937.             offhook and answer a call when a ring signal is detected."
  938.     REFERENCE   "V.58 ringsBeforeAnswer"
  939.     DEFVAL      { 1 }
  940.     ::= { mdmCallControlEntry 1 }
  941.  
  942. mdmCCCallSetUpFailTimer OBJECT-TYPE
  943.     SYNTAX      Integer32 (0..255)
  944.     MAX-ACCESS  read-write
  945.     STATUS      current
  946.     DESCRIPTION
  947.             "This parameter specifies the amount of time, in seconds,
  948.             that the modem shall allow between either answering a call
  949.             (automatically or manually) or completion of dialing, and
  950.             establishment of a connection with the remote modem. If no
  951.  
  952.  
  953.  
  954. Barnes, Brown, Royston & Waldbusser                            [Page 17]
  955.  
  956. RFC 1696                       Modem MIB                     August 1994
  957.  
  958.  
  959.             connection is established during this time, the modem
  960.             disconnects from the line and returns a result code
  961.             indicating the cause of the disconnection. In TIA-602, this
  962.             is controlled by the value in the S7 register."
  963.     REFERENCE   "V.58 callSetUpFailTimer"
  964.     DEFVAL      { 30 }
  965.     ::= { mdmCallControlEntry 2 }
  966.  
  967. mdmCCResultCodeEnable OBJECT-TYPE
  968.     SYNTAX      INTEGER {
  969.                     disabled(1),
  970.                     numericEnabled(2),
  971.                     verboseEnabled(3)
  972.                 }
  973.     MAX-ACCESS  read-write
  974.     STATUS      current
  975.     DESCRIPTION
  976.             "When disabled, the DCE shall issue no 'result codes' of any
  977.             kind to the DTE either in response to unsolicited events
  978.             (eg. ring signal), or commands. In TIA-602, this is
  979.             controlled by the ATQ command.  When numericEnabled, the DCE
  980.             shall issue result codes in numeric form.  When
  981.             verboseEnabled, the DCE shall issue result codes in a
  982.             verbose, textual form."
  983.     REFERENCE   "V.58 responseModeSelect"
  984.     DEFVAL      { verboseEnabled }
  985.     ::= { mdmCallControlEntry 3 }
  986.  
  987. mdmCCEscapeAction OBJECT-TYPE
  988.     SYNTAX      INTEGER {
  989.                     ignoreEscape(1),
  990.                     hangUp(2),
  991.                     enterCommandMode(3)
  992.                 }
  993.     MAX-ACCESS  read-write
  994.     STATUS      current
  995.     DESCRIPTION
  996.             "The modem's action upon successfully recognizing the
  997.             'escape to command mode' character sequence."
  998.     DEFVAL { ignoreEscape }
  999.     ::= { mdmCallControlEntry 4 }
  1000.  
  1001. -- Call status portion of the call control table
  1002.  
  1003. mdmCCCallDuration OBJECT-TYPE
  1004.     SYNTAX      Integer32
  1005.     MAX-ACCESS  read-only
  1006.     STATUS      current
  1007.  
  1008.  
  1009.  
  1010. Barnes, Brown, Royston & Waldbusser                            [Page 18]
  1011.  
  1012. RFC 1696                       Modem MIB                     August 1994
  1013.  
  1014.  
  1015.     DESCRIPTION
  1016.             "Present or last completed connection time in seconds. If
  1017.             there have been no previous connections, this value should
  1018.             be -1."
  1019.     ::= { mdmCallControlEntry 5 }
  1020.  
  1021.  
  1022. mdmCCConnectionFailReason OBJECT-TYPE
  1023.     SYNTAX      INTEGER {
  1024.                 -- General
  1025.                         unknown(1),
  1026.                         other(2),
  1027.                         managementCommand(3),
  1028.                         inactivityTimeout(4),
  1029.                         mnpIncompatibility(5),
  1030.                         protocolError(6),
  1031.                 -- DCE
  1032.                         powerLoss(10),
  1033.                         equipmentFailure(11),
  1034.                 -- DTE Interface
  1035.                         dtrDrop(20),
  1036.                 -- Line Interface
  1037.                         noDialTone(30),
  1038.                         lineBusy(31),
  1039.                         noAnswer(32),
  1040.                         voiceDetected(33),
  1041.                 -- Signal Converter
  1042.                         carrierLost(40),
  1043.                         trainingFailed(41),
  1044.                         faxDetected(42)
  1045.         }
  1046.     MAX-ACCESS  read-only
  1047.     STATUS      current
  1048.     DESCRIPTION
  1049.  
  1050.             "Indicates the reason that the last connection or attempt
  1051.             failed. The meaning of each reason code is explained below.
  1052.  
  1053.                unknown:
  1054.             This code means the failure reason is unknown or
  1055.             there has been no previous call.
  1056.  
  1057.                other:
  1058.             This code used when no other code is applicable.
  1059.             Additional vendor information may be available
  1060.             elsewhere.
  1061.  
  1062.                managementCommand:
  1063.  
  1064.  
  1065.  
  1066. Barnes, Brown, Royston & Waldbusser                            [Page 19]
  1067.  
  1068. RFC 1696                       Modem MIB                     August 1994
  1069.  
  1070.  
  1071.             A management command terminated the call.  These
  1072.             commands include escaping to command mode, initiating
  1073.             dialing, restoring lines, and disconnecting.
  1074.  
  1075.                inactivityTimeout:
  1076.             The call was terminated because it was inactive for
  1077.             at the minimum duration specified.
  1078.  
  1079.                mnpIncompatibility:
  1080.             The modems are unable to resolve MNP protocol
  1081.             differences.
  1082.  
  1083.                protocolError:
  1084.             An error occured in one of protocol in use.  Further
  1085.             information is required to determine in which
  1086.             protocol the error occurred, and the exact nature of
  1087.             the error.
  1088.  
  1089.                powerLoss:
  1090.             The modem lost power and disconnected the call.
  1091.  
  1092.                equipmentFailure:
  1093.             The modem equipment failed.
  1094.  
  1095.                dtrDrop:
  1096.             DTR has been turned off while the modem is to
  1097.             disconnect on DTR drop. (Ref: V.58 cct108TurnedOff)
  1098.  
  1099.                noDialTone:
  1100.             If the modem is to monitor for call progress tones,
  1101.             but the modem has failed to detect dial tone while
  1102.             attempting to dial a number.
  1103.  
  1104.                lineBusy:
  1105.             Busy signal is detected while busy signal detection
  1106.             is enabled, or while the 'W' or '@' dial modifier is
  1107.             used. (Ref: V.58 engagedTone)
  1108.  
  1109.                noAnswer:
  1110.             The call was not answered.
  1111.  
  1112.                voiceDetected:
  1113.             A voice was detected on the call.
  1114.  
  1115.                carrierLost:
  1116.             Indicates that the modem has disconnected due to
  1117.             detection of loss of carrier.  In TIA-602, the S10
  1118.             register determines the time that loss of carrier
  1119.  
  1120.  
  1121.  
  1122. Barnes, Brown, Royston & Waldbusser                            [Page 20]
  1123.  
  1124. RFC 1696                       Modem MIB                     August 1994
  1125.  
  1126.  
  1127.             must be detected before the modem disconnects.
  1128.  
  1129.                trainingFailed:
  1130.             Indicates that the modems did not successfully train
  1131.             and reach data mode on the previous connection.
  1132.  
  1133.                faxDetected:
  1134.             A fax was detected on the call."
  1135.     REFERENCE   "V.58 callCleared"
  1136.     ::= { mdmCallControlEntry 6 }
  1137.  
  1138. -- The Stored Dial String table
  1139.  
  1140. mdmCCStoredDialStringTable OBJECT-TYPE
  1141.     SYNTAX      SEQUENCE OF MdmCCStoredDialStringEntry
  1142.     MAX-ACCESS  not-accessible
  1143.     STATUS      current
  1144.     DESCRIPTION
  1145.             "The table of stored dial strings."
  1146.     REFERENCE   "V.58 telephoneNumbers"
  1147.     ::= { mdmMIBObjects 8 }
  1148.  
  1149. mdmCCStoredDialStringEntry OBJECT-TYPE
  1150.     SYNTAX      MdmCCStoredDialStringEntry
  1151.     MAX-ACCESS  not-accessible
  1152.     STATUS      current
  1153.     DESCRIPTION
  1154.             "A stored dial string."
  1155.     INDEX  { mdmIndex, mdmCCStoredDialStringIndex }
  1156.     ::= { mdmCCStoredDialStringTable 1 }
  1157.  
  1158. MdmCCStoredDialStringEntry ::= SEQUENCE {
  1159.     mdmCCStoredDialStringIndex     Integer32,
  1160.     mdmCCStoredDialString          DisplayString
  1161. }
  1162.  
  1163. mdmCCStoredDialStringIndex OBJECT-TYPE
  1164.     SYNTAX      Integer32 (0..65535)
  1165.     MAX-ACCESS  not-accessible
  1166.     STATUS      current
  1167.     DESCRIPTION
  1168.             "The unique index of a particular dial string."
  1169.     ::= { mdmCCStoredDialStringEntry 1 }
  1170.  
  1171. mdmCCStoredDialString OBJECT-TYPE
  1172.     SYNTAX      DisplayString (SIZE(0..64))
  1173.     MAX-ACCESS  read-write
  1174.     STATUS      current
  1175.  
  1176.  
  1177.  
  1178. Barnes, Brown, Royston & Waldbusser                            [Page 21]
  1179.  
  1180. RFC 1696                       Modem MIB                     August 1994
  1181.  
  1182.  
  1183.     DESCRIPTION
  1184.             "A dial string stored in the modem."
  1185.     ::= { mdmCCStoredDialStringEntry 2 }
  1186.  
  1187. -- The modem Error Correcting Group
  1188.  
  1189. mdmECTable OBJECT-TYPE
  1190.     SYNTAX      SEQUENCE OF MdmECEntry
  1191.     MAX-ACCESS  not-accessible
  1192.     STATUS      current
  1193.     DESCRIPTION
  1194.             "The modem error correcting table augments the modem ID
  1195.             table."
  1196.     ::= { mdmMIBObjects 9 }
  1197.  
  1198. mdmECEntry OBJECT-TYPE
  1199.     SYNTAX      MdmECEntry
  1200.     MAX-ACCESS  not-accessible
  1201.     STATUS      current
  1202.     DESCRIPTION
  1203.             "Entries in this table are created only by the agent. One
  1204.             entry exists for each modem managed by the agent."
  1205.     AUGMENTS    { mdmIDEntry }
  1206.     ::= { mdmECTable 1 }
  1207.  
  1208. MdmECEntry ::= SEQUENCE {
  1209.     mdmECErrorControlUsed           OBJECT IDENTIFIER
  1210. }
  1211.  
  1212. mdmECErrorControlUsed OBJECT-TYPE
  1213.     SYNTAX      OBJECT IDENTIFIER
  1214.     MAX-ACCESS  read-only
  1215.     STATUS      current
  1216.     DESCRIPTION
  1217.             "Indicates the error control method used during the current
  1218.             or previous call.  This shall be one of the values for error
  1219.             control protocols registered in the capabilities table for
  1220.             this modem.  If no error control protocol is in use, this
  1221.             object shall have the value '{0 0}'."
  1222.     REFERENCE   "V.58 errorControlActive"
  1223.     ::= { mdmECEntry 1 }
  1224.  
  1225. -- The modem Data Compression Group
  1226.  
  1227. mdmDCTable OBJECT-TYPE
  1228.     SYNTAX      SEQUENCE OF MdmDCEntry
  1229.     MAX-ACCESS  not-accessible
  1230.     STATUS      current
  1231.  
  1232.  
  1233.  
  1234. Barnes, Brown, Royston & Waldbusser                            [Page 22]
  1235.  
  1236. RFC 1696                       Modem MIB                     August 1994
  1237.  
  1238.  
  1239.     DESCRIPTION
  1240.             "The modem data compression table augments the modem ID
  1241.             table."
  1242.     ::= { mdmMIBObjects 10 }
  1243.  
  1244. mdmDCEntry OBJECT-TYPE
  1245.     SYNTAX      MdmDCEntry
  1246.     MAX-ACCESS  not-accessible
  1247.     STATUS      current
  1248.     DESCRIPTION
  1249.             "Entries in this table are created only by the agent. One
  1250.             entry exists for each modem managed by the agent."
  1251.     AUGMENTS    { mdmIDEntry }
  1252.     ::= { mdmDCTable 1 }
  1253.  
  1254. MdmDCEntry ::= SEQUENCE {
  1255.     mdmDCCompressionTypeUsed        OBJECT IDENTIFIER
  1256. }
  1257.  
  1258. mdmDCCompressionTypeUsed OBJECT-TYPE
  1259.     SYNTAX      OBJECT IDENTIFIER
  1260.     MAX-ACCESS  read-only
  1261.     STATUS      current
  1262.     DESCRIPTION
  1263.             "Indicates the data compression method used during the
  1264.             current or previous call.  This shall be one of the values
  1265.             for compression protocols registered in the capabilities
  1266.             table for this modem.  If no compression protocol is in use,
  1267.             this object shall have the value '{0 0}'."
  1268.     ::= { mdmDCEntry 1 }
  1269.  
  1270. -- The modem Signal Convertor Group
  1271.  
  1272. mdmSCTable OBJECT-TYPE
  1273.     SYNTAX      SEQUENCE OF MdmSCEntry
  1274.     MAX-ACCESS  not-accessible
  1275.     STATUS      current
  1276.     DESCRIPTION
  1277.             "The modem signal convertor table augments the modem ID
  1278.             table."
  1279.     ::= { mdmMIBObjects 11 }
  1280.  
  1281. mdmSCEntry OBJECT-TYPE
  1282.     SYNTAX      MdmSCEntry
  1283.     MAX-ACCESS  not-accessible
  1284.     STATUS      current
  1285.     DESCRIPTION
  1286.             "Entries in this table are created only by the agent. One
  1287.  
  1288.  
  1289.  
  1290. Barnes, Brown, Royston & Waldbusser                            [Page 23]
  1291.  
  1292. RFC 1696                       Modem MIB                     August 1994
  1293.  
  1294.  
  1295.             entry exists for each modem managed by the agent."
  1296.     AUGMENTS    { mdmIDEntry }
  1297.     ::= { mdmSCTable 1 }
  1298.  
  1299. MdmSCEntry ::= SEQUENCE {
  1300.     mdmSCCurrentLineTransmitRate        Integer32,
  1301.     mdmSCCurrentLineReceiveRate         Integer32,
  1302.     mdmSCInitialLineTransmitRate        Integer32,
  1303.     mdmSCInitialLineReceiveRate         Integer32,
  1304.     mdmSCModulationSchemeUsed           OBJECT IDENTIFIER
  1305. }
  1306.  
  1307. mdmSCCurrentLineTransmitRate OBJECT-TYPE
  1308.     SYNTAX      Integer32
  1309.     MAX-ACCESS  read-only
  1310.     STATUS      current
  1311.     DESCRIPTION
  1312.             "The current link transmit rate of a connection, or the last
  1313.             link transmit rate of the last connection in bits per
  1314.             second."
  1315.     REFERENCE   "V.58 transmissionSignallingRateActive"
  1316.     ::= { mdmSCEntry 1 }
  1317.  
  1318. mdmSCCurrentLineReceiveRate OBJECT-TYPE
  1319.     SYNTAX      Integer32
  1320.     MAX-ACCESS  read-only
  1321.     STATUS      current
  1322.     DESCRIPTION
  1323.             "The current link receive rate of a connection, or the last
  1324.             link receive rate of the last connection in bits per
  1325.             second."
  1326.     REFERENCE   "V.58 transmissionSignallingRateActive"
  1327.     ::= { mdmSCEntry 2 }
  1328.  
  1329. mdmSCInitialLineTransmitRate OBJECT-TYPE
  1330.     SYNTAX      Integer32
  1331.     MAX-ACCESS  read-only
  1332.     STATUS      current
  1333.     DESCRIPTION
  1334.             "The initial link transmit rate of the current connection,
  1335.             or the initial link transmit rate of the last connection in
  1336.             bits per second."
  1337.     ::= { mdmSCEntry 3 }
  1338.  
  1339. mdmSCInitialLineReceiveRate OBJECT-TYPE
  1340.     SYNTAX      Integer32
  1341.     MAX-ACCESS  read-only
  1342.     STATUS      current
  1343.  
  1344.  
  1345.  
  1346. Barnes, Brown, Royston & Waldbusser                            [Page 24]
  1347.  
  1348. RFC 1696                       Modem MIB                     August 1994
  1349.  
  1350.  
  1351.     DESCRIPTION
  1352.             "The initial link receive rate of the current connection, or
  1353.             the initial link receive rate of the last connection in bits
  1354.             per second."
  1355.     ::= { mdmSCEntry 4 }
  1356.  
  1357. mdmSCModulationSchemeUsed OBJECT-TYPE
  1358.     SYNTAX      OBJECT IDENTIFIER
  1359.     MAX-ACCESS  read-only
  1360.     STATUS      current
  1361.     DESCRIPTION
  1362.             "The modulation scheme of the current or previous call.
  1363.             This shall be one of the values for modulation protocols
  1364.             registered in the capabilities table for this modem."
  1365.     REFERENCE   "V.58 gstnModulationSchemeActive"
  1366.     ::= { mdmSCEntry 5 }
  1367.  
  1368. -- The Modem Statistics Table
  1369.  
  1370. mdmStatsTable OBJECT-TYPE
  1371.     SYNTAX      SEQUENCE OF MdmStatsEntry
  1372.     MAX-ACCESS  not-accessible
  1373.     STATUS      current
  1374.     DESCRIPTION
  1375.             "The modem statistics Table augments the modem ID table."
  1376.     ::= { mdmMIBObjects 12 }
  1377.  
  1378. mdmStatsEntry OBJECT-TYPE
  1379.     SYNTAX      MdmStatsEntry
  1380.     MAX-ACCESS  not-accessible
  1381.     STATUS      current
  1382.     DESCRIPTION
  1383.             "Entries in this table are created only by the agent. One
  1384.             entry exists for each modem managed by the agent."
  1385.     AUGMENTS    { mdmIDEntry }
  1386.     ::= { mdmStatsTable 1 }
  1387.  
  1388. MdmStatsEntry ::= SEQUENCE {
  1389.     mdmStatsRingNoAnswers                   Counter32,
  1390.     mdmStatsIncomingConnectionFailures      Counter32,
  1391.     mdmStatsIncomingConnectionCompletions   Counter32,
  1392.     mdmStatsFailedDialAttempts              Counter32,
  1393.     mdmStatsOutgoingConnectionFailures      Counter32,
  1394.     mdmStatsOutgoingConnectionCompletions   Counter32,
  1395.     mdmStatsRetrains                        Counter32,
  1396.     mdmStats2400OrLessConnections           Counter32,
  1397.     mdmStats2400To14400Connections          Counter32,
  1398.     mdmStatsGreaterThan14400Connections     Counter32,
  1399.  
  1400.  
  1401.  
  1402. Barnes, Brown, Royston & Waldbusser                            [Page 25]
  1403.  
  1404. RFC 1696                       Modem MIB                     August 1994
  1405.  
  1406.  
  1407.     mdmStatsErrorControlledConnections      Counter32,
  1408.     mdmStatsCompressedConnections           Counter32,
  1409.     mdmStatsCompressionEfficiency           Integer32,
  1410.     mdmStatsSentOctets                      Counter32,
  1411.     mdmStatsReceivedOctets                  Counter32,
  1412.     mdmStatsSentDataFrames                  Counter32,
  1413.     mdmStatsReceivedDataFrames              Counter32,
  1414.     mdmStatsResentFrames                    Counter32,
  1415.     mdmStatsErrorFrames                     Counter32
  1416. }
  1417.  
  1418. mdmStatsRingNoAnswers OBJECT-TYPE
  1419.     SYNTAX      Counter32
  1420.     MAX-ACCESS  read-only
  1421.     STATUS      current
  1422.     DESCRIPTION
  1423.             "The number of events in which ringing was detected but the
  1424.             call was not answered."
  1425.     ::= { mdmStatsEntry 1 }
  1426.  
  1427. mdmStatsIncomingConnectionFailures OBJECT-TYPE
  1428.     SYNTAX      Counter32
  1429.     MAX-ACCESS  read-only
  1430.     STATUS      current
  1431.     DESCRIPTION
  1432.             "The number of incoming connection requests that this modem
  1433.             answered in which it could not train with the other DCE."
  1434.     ::= { mdmStatsEntry 2 }
  1435.  
  1436. mdmStatsIncomingConnectionCompletions OBJECT-TYPE
  1437.     SYNTAX      Counter32
  1438.     MAX-ACCESS  read-only
  1439.     STATUS      current
  1440.     DESCRIPTION
  1441.             "The number of incoming connection requests that this modem
  1442.             answered and successfully trained with the other DCE."
  1443.     ::= { mdmStatsEntry 3 }
  1444.  
  1445. mdmStatsFailedDialAttempts OBJECT-TYPE
  1446.         SYNTAX          Counter32
  1447.         MAX-ACCESS  read-only
  1448.         STATUS          current
  1449.         DESCRIPTION
  1450.                 "The number of call attempts that failed because the modem
  1451.         didn't go off hook, or there was no dialtone."
  1452.         ::= { mdmStatsEntry 4 }
  1453.  
  1454. mdmStatsOutgoingConnectionFailures OBJECT-TYPE
  1455.  
  1456.  
  1457.  
  1458. Barnes, Brown, Royston & Waldbusser                            [Page 26]
  1459.  
  1460. RFC 1696                       Modem MIB                     August 1994
  1461.  
  1462.  
  1463.     SYNTAX      Counter32
  1464.     MAX-ACCESS  read-only
  1465.     STATUS      current
  1466.     DESCRIPTION
  1467.             "The number of outgoing calls from this modem which
  1468.             sucessfully went off hook and dialed, in which it could not
  1469.             train with the other DCE."
  1470.     ::= { mdmStatsEntry 5 }
  1471.  
  1472. mdmStatsOutgoingConnectionCompletions OBJECT-TYPE
  1473.     SYNTAX      Counter32
  1474.     MAX-ACCESS  read-only
  1475.     STATUS      current
  1476.     DESCRIPTION
  1477.             "The number of outgoing calls from this modem which resulted
  1478.             in successfully training with the other DCE."
  1479.     ::= { mdmStatsEntry 6 }
  1480.  
  1481. mdmStatsRetrains OBJECT-TYPE
  1482.     SYNTAX      Counter32
  1483.     MAX-ACCESS  read-only
  1484.     STATUS      current
  1485.     DESCRIPTION
  1486.             "The number of retrains experienced on connections on this
  1487.             line."
  1488.     ::= { mdmStatsEntry 7 }
  1489.  
  1490.  
  1491. -- Utilization counters
  1492.  
  1493. mdmStats2400OrLessConnections OBJECT-TYPE
  1494.     SYNTAX      Counter32
  1495.     MAX-ACCESS  read-only
  1496.     STATUS      current
  1497.     DESCRIPTION
  1498.             "The number of connections initially established at a
  1499.             modulation speed of 2400 bits per second or less."
  1500.     ::= { mdmStatsEntry 8 }
  1501.  
  1502.  
  1503. mdmStats2400To14400Connections OBJECT-TYPE
  1504.     SYNTAX      Counter32
  1505.     MAX-ACCESS  read-only
  1506.     STATUS      current
  1507.     DESCRIPTION
  1508.             "The number of connections initially established at a
  1509.             modulation speed of greater than 2400 bits per second and
  1510.             less than 14400 bits per second."
  1511.  
  1512.  
  1513.  
  1514. Barnes, Brown, Royston & Waldbusser                            [Page 27]
  1515.  
  1516. RFC 1696                       Modem MIB                     August 1994
  1517.  
  1518.  
  1519.     ::= { mdmStatsEntry 9 }
  1520.  
  1521. mdmStatsGreaterThan14400Connections OBJECT-TYPE
  1522.     SYNTAX      Counter32
  1523.     MAX-ACCESS  read-only
  1524.     STATUS      current
  1525.     DESCRIPTION
  1526.             "The number of connections initially established at a
  1527.             modulation speed of greater than 14400 bits per second."
  1528.     ::= { mdmStatsEntry 10 }
  1529.  
  1530. mdmStatsErrorControlledConnections OBJECT-TYPE
  1531.     SYNTAX      Counter32
  1532.     MAX-ACCESS  read-only
  1533.     STATUS      current
  1534.     DESCRIPTION
  1535.             "The number of established connections using an error
  1536.             control protocol."
  1537.     ::= { mdmStatsEntry 11 }
  1538.  
  1539. mdmStatsCompressedConnections OBJECT-TYPE
  1540.     SYNTAX      Counter32
  1541.     MAX-ACCESS  read-only
  1542.     STATUS      current
  1543.     DESCRIPTION
  1544.             "The number of established connections using a compression
  1545.             protocol."
  1546.     ::= { mdmStatsEntry 12 }
  1547.  
  1548. mdmStatsCompressionEfficiency OBJECT-TYPE
  1549.     SYNTAX      Integer32 (0..65535)
  1550.     MAX-ACCESS  read-only
  1551.     STATUS      current
  1552.     DESCRIPTION
  1553.             "The number of bytes transferred into the compression
  1554.             encoder divided by the number of bytes transferred out of
  1555.             the encoder, multiplied by 100 for either the current or
  1556.             last call.  If a data compression protocol is not in use,
  1557.             this value shall be `100'."
  1558.     REFERENCE   "V.58 compressionEfficiency"
  1559.     ::= { mdmStatsEntry 13 }
  1560.  
  1561. mdmStatsSentOctets OBJECT-TYPE
  1562.     SYNTAX      Counter32
  1563.     MAX-ACCESS  read-only
  1564.     STATUS      current
  1565.     DESCRIPTION
  1566.             "The number of octets presented to the modem by the DTE."
  1567.  
  1568.  
  1569.  
  1570. Barnes, Brown, Royston & Waldbusser                            [Page 28]
  1571.  
  1572. RFC 1696                       Modem MIB                     August 1994
  1573.  
  1574.  
  1575.     ::= { mdmStatsEntry 14 }
  1576.  
  1577. mdmStatsReceivedOctets OBJECT-TYPE
  1578.     SYNTAX      Counter32
  1579.     MAX-ACCESS  read-only
  1580.     STATUS      current
  1581.     DESCRIPTION
  1582.             "The number of octets presented to the DTE by the modem."
  1583.     ::= { mdmStatsEntry 15 }
  1584.  
  1585. mdmStatsSentDataFrames OBJECT-TYPE
  1586.     SYNTAX      Counter32
  1587.     MAX-ACCESS  read-only
  1588.     STATUS      current
  1589.     DESCRIPTION
  1590.             "The number of data frames sent on the line interface.  If
  1591.             there is no frame-oriented protocol in use on the line
  1592.             interface, this counter shall not increment."
  1593.     ::= { mdmStatsEntry 16 }
  1594.  
  1595. mdmStatsReceivedDataFrames OBJECT-TYPE
  1596.     SYNTAX      Counter32
  1597.     MAX-ACCESS  read-only
  1598.     STATUS      current
  1599.     DESCRIPTION
  1600.             "The number of data frames received on the line interface.
  1601.             If there is no frame-oriented protocol in use on the line
  1602.             interface, this counter shall not increment."
  1603.     ::= { mdmStatsEntry 17 }
  1604.  
  1605. mdmStatsResentFrames OBJECT-TYPE
  1606.     SYNTAX      Counter32
  1607.     MAX-ACCESS  read-only
  1608.     STATUS      current
  1609.     DESCRIPTION
  1610.             "The number of times this modem retransmits frames on the
  1611.             line interface.  If there is no frame-oriented protocol in
  1612.             use on the line interface, this counter shall not
  1613.             increment."
  1614.     ::= { mdmStatsEntry 18 }
  1615.  
  1616. mdmStatsErrorFrames OBJECT-TYPE
  1617.     SYNTAX      Counter32
  1618.     MAX-ACCESS  read-only
  1619.     STATUS      current
  1620.     DESCRIPTION
  1621.             "The number of block errors received on the link.  If there
  1622.             is no frame-oriented protocol in use on the line interface,
  1623.  
  1624.  
  1625.  
  1626. Barnes, Brown, Royston & Waldbusser                            [Page 29]
  1627.  
  1628. RFC 1696                       Modem MIB                     August 1994
  1629.  
  1630.  
  1631.             this counter shall not increment."
  1632.     ::= { mdmStatsEntry 19 }
  1633.  
  1634.  
  1635. -- compliance statements
  1636.  
  1637. mdmCompliance MODULE-COMPLIANCE
  1638.     STATUS  current
  1639.     DESCRIPTION
  1640.             "The compliance statement for SNMPv2 entities which
  1641.             implement the modem MIB."
  1642.  
  1643.     MODULE  -- this module
  1644.         MANDATORY-GROUPS { mdmIDGroup, mdmLineInterfaceGroup,
  1645.                 mdmDTEInterfaceGroup, mdmCallControlGroup,
  1646.                 mdmSignalConvertorGroup, mdmStatisticsGroup }
  1647.  
  1648.         GROUP   mdmErrorControlGroup
  1649.         DESCRIPTION
  1650.             "This group is mandatory only for those modems that
  1651.             implement an error correction protocol."
  1652.  
  1653.         GROUP mdmDataCompressionGroup
  1654.         DESCRIPTION
  1655.             "This group is mandatory only for those modems that
  1656.             implement a data compression protocol."
  1657.     ::= { mdmCompliances 1 }
  1658.  
  1659.  
  1660. END
  1661.  
  1662. 4.  Acknowledgements
  1663.  
  1664.    This document was produced by the Modem Management Working group.
  1665.  
  1666.    In addition, the authors gratefully acknowledge the comments of Tom
  1667.    Holodnik and Mark S. Lewis.
  1668.  
  1669. 5.  Security Considerations
  1670.  
  1671.    Security issues are not discussed in this memo.
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682. Barnes, Brown, Royston & Waldbusser                            [Page 30]
  1683.  
  1684. RFC 1696                       Modem MIB                     August 1994
  1685.  
  1686.  
  1687. 6.  Authors' Addresses
  1688.  
  1689.    Jim Barnes
  1690.    Xylogics, Inc.
  1691.    53 Third Avenue
  1692.    Burlington, MA  01803
  1693.    USA
  1694.  
  1695.    Phone: 617-272-8140
  1696.    Fax: 617-272-2618
  1697.    EMail: barnes@xylogics.com
  1698.  
  1699.  
  1700.    Les Brown
  1701.    Motorola
  1702.  
  1703.    Phone: 416-507-7200
  1704.    EMail: brown_l@msm.cdx.mot.com
  1705.  
  1706.  
  1707.    Rick Royston
  1708.    US Robotics, Inc.
  1709.    8100 N. McCormick Boulevard
  1710.    Skokie, IL  60076-2999
  1711.    USA
  1712.  
  1713.    Phone: 708-933-5430
  1714.    Fax: 708-982-1348
  1715.    EMail: rroyston@usr.com
  1716.  
  1717.  
  1718.    Steven Waldbusser
  1719.    Carnegie Mellon University
  1720.    Computing and Communications
  1721.    Cyert Hall 130
  1722.    5000 Forbes Avenue
  1723.    Pittsburgh, PA  15213-3890
  1724.    USA
  1725.  
  1726.    Phone: 412-268-6628
  1727.    Fax: 412-268-4987
  1728.    EMail: swol@andrew.cmu.edu
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738. Barnes, Brown, Royston & Waldbusser                            [Page 31]
  1739.  
  1740.