Network Working Group J. Barnes
Request for Comments: 1696 Xylogics, Inc.
Category: Standards Track L. Brown
Motorola
R. Royston
US Robotics, Inc.
S. Waldbusser
Carnegie Mellon University
August 1994
Modem Management Information Base (MIB) using SMIv2
Status of this Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Table of Contents
1 Introduction ................................................. 1
2 The SNMPv2 Network Management Framework ...................... 2
2.1 Object Definitions ......................................... 2
3 Definitions .................................................. 2
4 Acknowledgements ............................................. 30
5. Security Considerations ..................................... 30
6. Authors' Addresses .......................................... 31
1. Introduction
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community.
In particular, it describes managed objects used for managing dial-up
modems and similar dial-up devices. This MIB module provides a set
of objects that are the minimum necessary to provide the ability to
monitor and control those devices, and is consistent with the SNMP
framework and existing SNMP standards.
Barnes, Brown, Royston & Waldbusser [Page 1]RFC 1696 Modem MIB August 1994
2. The SNMPv2 Network Management Framework
The SNMPv2 Network Management Framework consists of four major
components. They are:
o RFC 1442 which defines the SMI, the mechanisms used for
describing and naming objects for the purpose of management.
o STD 17, RFC 1213 defines MIB-II, the core set of managed objects
for the Internet suite of protocols.
o RFC 1445 which defines the administrative and other
architectural aspects of the framework.
o RFC 1448 which defines the protocol used for network access to
managed objects.
The Framework permits new objects to be defined for the purpose of
experimentation and evaluation.
2.1. Object Definitions
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. Objects in the MIB are
defined using the subset of Abstract Syntax Notation One (ASN.1)
defined in the SMI. In particular, each object object type is named
by an OBJECT IDENTIFIER, an administratively assigned name. The
object type together with an object instance serves to uniquely
identify a specific instantiation of the object. For human
convenience, we often use a textual string, termed the descriptor, to
refer to the object type.
3. Definitions
Modem-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY,
Counter32, Integer32 FROM SNMPv2-SMI
DisplayString FROM SNMPv2-TC
MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF
mib-2 FROM RFC1213-MIB;
mdmMIB MODULE-IDENTITY
LAST-UPDATED "9406120000Z"
ORGANIZATION "IETF Modem Management Working Group"
Barnes, Brown, Royston & Waldbusser [Page 2]RFC 1696 Modem MIB August 1994
CONTACT-INFO
" Steven Waldbusser
Postal: Carnegie Mellon University
5000 Forbes Ave
Pittsburgh, PA, 15213
US
Tel: +1 412 268 6628
Fax: +1 412 268 4987
E-mail: waldbusser@cmu.edu"
DESCRIPTION
"The MIB module for management of dial-up modems."
::= { mdmMIB 1 }
mdmMib OBJECT IDENTIFIER ::= { mib-2 38 }
mdmMIBObjects OBJECT IDENTIFIER ::= { mdmMIB 1 }
-- conformance information
mdmConformance OBJECT IDENTIFIER ::= { mdmMIB 2 }
mdmCompliances OBJECT IDENTIFIER ::= { mdmConformance 1 }
mdmGroups OBJECT IDENTIFIER ::= { mdmConformance 2 }
-- units of conformance
mdmIDGroup OBJECT-GROUP
OBJECTS { mdmIDManufacturerOID, mdmIDProductDetails }
STATUS current
DESCRIPTION
"A collection of objects that identify the manufacturer and
model information for a modem."
::= { mdmGroups 1 }
mdmLineInterfaceGroup OBJECT-GROUP
OBJECTS { mdmLineCarrierLossTime,
mdmLineState, mdmLineCapabilitiesID,
mdmLineCapabilitiesEnableRequested,
mdmLineCapabilitiesEnableGranted }
STATUS current
DESCRIPTION
"A collection of objects that describe the configuration and
state of the modem's line interface."
::= { mdmGroups 2 }
mdmDTEInterfaceGroup OBJECT-GROUP
Barnes, Brown, Royston & Waldbusser [Page 3]RFC 1696 Modem MIB August 1994
OBJECTS { mdmDTEActionDTROnToOff, mdmDTEActionDTROffToOn,
mdmDTESyncTimingSource, mdmDTESyncAsyncMode,
mdmDTEInactivityTimeout }
STATUS current
DESCRIPTION
"A collection of objects that describe the configuration and
state of the modem's DTE interface."
::= { mdmGroups 3 }
mdmCallControlGroup OBJECT-GROUP
OBJECTS { mdmCCRingsBeforeAnswer,
mdmCCCallSetUpFailTimer, mdmCCResultCodeEnable,
mdmCCEscapeAction, mdmCCCallDuration,
mdmCCConnectionFailReason, mdmCCStoredDialString }
STATUS current
DESCRIPTION
"A collection of objects that describe the configuration of
call control capabilities on the modem and the status of
calls placed with this modem."
::= { mdmGroups 4 }
mdmErrorControlGroup OBJECT-GROUP
OBJECTS { mdmECErrorControlUsed }
STATUS current
DESCRIPTION
"A collection of objects that describe the configuration and
state of error control on a modem."
::= { mdmGroups 5 }
mdmDataCompressionGroup OBJECT-GROUP
OBJECTS { mdmDCCompressionTypeUsed }
STATUS current
DESCRIPTION
"A collection of objects that describe the configuration and
state of data compression on a modem."
::= { mdmGroups 6 }
mdmSignalConvertorGroup OBJECT-GROUP
OBJECTS { mdmSCCurrentLineReceiveRate, mdmSCCurrentLineTransmitRate,
mdmSCInitialLineReceiveRate, mdmSCInitialLineTransmitRate,
mdmSCModulationSchemeUsed }
STATUS current
DESCRIPTION
"A collection of objects that describe the configuration and
state of error control on a modem."
::= { mdmGroups 7 }
mdmStatisticsGroup OBJECT-GROUP
Barnes, Brown, Royston & Waldbusser [Page 4]RFC 1696 Modem MIB August 1994
OBJECTS { mdmStatsRingNoAnswers,
mdmStatsIncomingConnectionFailures,
mdmStatsIncomingConnectionCompletions,
mdmStatsFailedDialAttempts,
mdmStatsOutgoingConnectionFailures,
mdmStatsOutgoingConnectionCompletions,
mdmStatsRetrains,
mdmStats2400OrLessConnections, mdmStats2400To14400Connections,
mdmStatsGreaterThan14400Connections,
mdmStatsErrorControlledConnections,
mdmStatsCompressedConnections,
mdmStatsCompressionEfficiency,
mdmStatsSentOctets, mdmStatsReceivedOctets,
mdmStatsSentDataFrames, mdmStatsReceivedDataFrames,
mdmStatsResentFrames, mdmStatsErrorFrames }
STATUS current
DESCRIPTION
"A collection of objects that describe the state of calls on
this modem."
::= { mdmGroups 8 }
mdmNumber OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of modem rows in the modem table. This value
defines the maximum value of the mdmIndex object."
::= { mdmMIBObjects 1 }
-- The modem ID table.
mdmIDTable OBJECT-TYPE
SYNTAX SEQUENCE OF MdmIDEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The base table for the modems managed by this MIB. The
mdmLineTable, mdmDTEInterfaceTable, mdmCallControlTable, and
mdmStatsTable all augment the rows defined in this table."
::= { mdmMIBObjects 2 }
mdmIDEntry OBJECT-TYPE
SYNTAX MdmIDEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries in this table are created only by the agent. One
Barnes, Brown, Royston & Waldbusser [Page 5]RFC 1696 Modem MIB August 1994
entry exists for each modem managed by the agent."
INDEX { mdmIndex }
::= { mdmIDTable 1 }
MdmIDEntry ::= SEQUENCE {
mdmIndex Integer32,
mdmIDManufacturerOID OBJECT IDENTIFIER,
mdmIDProductDetails DisplayString
}
mdmIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique number for each modem that ranges from 1 to
mdmNumber. The value must remain constant at least from one
re-initialization of the network management agent to the
next."
::= { mdmIDEntry 1 }
mdmIDManufacturerOID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This value is intended to identify the manufacturer, model,
and version of this modem. This may be used to identify the
existance of enterprise-specific functions and behaviours."
REFERENCE
"V.58 attribute manufacturerID subfield ManufacturerOI"
::= { mdmIDEntry 2 }
mdmIDProductDetails OBJECT-TYPE
SYNTAX DisplayString (SIZE (0..79))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A textual description of this device, including the
manufacturer's name, modem model name, hardware revision,
firmware revision, and optionally, its serial number. The
exact format of this description is defined by the vendor.
This description may only contain characters from the NVT
ASCII character set."
REFERENCE
"V.58 attribute manufacturerID subfield productDetails"
::= { mdmIDEntry 3 }
Barnes, Brown, Royston & Waldbusser [Page 6]RFC 1696 Modem MIB August 1994
-- The modem Line Interface Table
mdmLineTable OBJECT-TYPE
SYNTAX SEQUENCE OF MdmLineEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The modem Line Table augments the modem ID table."
::= { mdmMIBObjects 3 }
mdmLineEntry OBJECT-TYPE
SYNTAX MdmLineEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries in this table are created only by the agent. One
entry exists for each modem managed by the agent."
AUGMENTS { mdmIDEntry }
::= { mdmLineTable 1 }
MdmLineEntry ::= SEQUENCE {
mdmLineCarrierLossTime Integer32,
mdmLineState INTEGER
}
mdmLineCarrierLossTime OBJECT-TYPE
SYNTAX Integer32 (1..255)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Duration in 10ths of a second the modem waits after loss of
carrier before hanging up. If this value is set to `255',
the modem will not hang up upon loss of carrier. This
allows the modem to distinguish between a momentary lapse in
line quality and a true disconnect and can be useful to tune
the tolerance of the modem to lines of poor quality."
REFERENCE "V.58 lineSignalFailDisconnectTimer"
::= { mdmLineEntry 1 }
mdmLineState OBJECT-TYPE
SYNTAX INTEGER {
unknown(1),
onHook(2),
offHook(3), -- and not connected
connected(4),
busiedOut(5),
reset(6)
}
Barnes, Brown, Royston & Waldbusser [Page 7]RFC 1696 Modem MIB August 1994
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Allows the inspection and alteration of the state of the
modem. Management commands may change the state to `on-
hook', `busied-out', or `reset' from any state. No other
alterations are permitted from the management protocol.
When this object is set to reset, the modem shall be reset
and the value will change to the modem's new, implementation
dependent state."
::= { mdmLineEntry 2 }
mdmLineCapabilitiesTable OBJECT-TYPE
SYNTAX SEQUENCE OF MdmLineCapabilitiesEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A list of protocol capabilities for this modem."
::= { mdmMIBObjects 4 }
mdmLineCapabilitiesEntry OBJECT-TYPE
SYNTAX MdmLineCapabilitiesEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A listing of the protocol(s) that this modem is capable of.
Entries in this table are created only by the agent. One
entry exists for each protocol that the modem is capable of,
regardless of whether that protocol is enabled or not.
This table is useful for providing an inventory of the
capabilities on a modem, and allowing the manager to enable
or disable capabilities from the menu of available
possibilities. Row creation is not required to enable or
disable capabilities."
INDEX { mdmIndex, mdmLineCapabilitiesIndex }
::= { mdmLineCapabilitiesTable 1 }
MdmLineCapabilitiesEntry ::= SEQUENCE {
mdmLineCapabilitiesIndex Integer32,
mdmLineCapabilitiesID OBJECT IDENTIFIER,
mdmLineCapabilitiesEnableRequested INTEGER,
mdmLineCapabilitiesEnableGranted INTEGER
}
mdmLineCapabilitiesIndex OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS not-accessible
Barnes, Brown, Royston & Waldbusser [Page 8]RFC 1696 Modem MIB August 1994
STATUS current
DESCRIPTION
"A unique index for this capabilities entry."
::= { mdmLineCapabilitiesEntry 1 }
mdmLineCapabilitiesID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An identifier for this capability. Standard protocol
capabilities will have identifiers registered in this
document or other companion standards documents.
Proprietary protocol capabilities will be registered by
their respective organization. All capabilities, standard
or vendor-specific, shall be registered in this table."
::= { mdmLineCapabilitiesEntry 2 }
mdmLineCapabilitiesEnableRequested OBJECT-TYPE
SYNTAX INTEGER {
disabled(1),
optional(2),
preferred(3)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The requested configuration of this capability. If this
value is 'disabled(1)', this is a request to disable this
protocol. If this value is 'preferred(3)', this is a
request to enable this protocol, and to prefer it in any
negotiation over other appropriate protocols that have a
value of 'optional(2)'."
DEFVAL { preferred }
::= { mdmLineCapabilitiesEntry 3 }
mdmLineCapabilitiesEnableGranted OBJECT-TYPE
SYNTAX INTEGER {
disabled(1),
optional(2),
preferred(3)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The actual configuration of this capability. The agent
shall attempt to set this as close as possible to the
associated mdmLineCapabilitiesEnableRequested value. The
Barnes, Brown, Royston & Waldbusser [Page 9]RFC 1696 Modem MIB August 1994
agent shall make this determination in an implementation-
specific manner that may take into account the configuration
of other capabilities or other considerations. The modem
will choose in an implementation-specific manner between
multiple mutually-exclusive capabilities that each have the
same (non-disabled) value. However, the modem must prefer
all capabilities with a value of 'preferred(3)' over all
capabilities with a value of 'optional(2)'.
In other words, if there are one or more mutually-exclusive
capabilities (e.g. V.32 and V.32bis) that are set to
`preferred', the agent must choose one in an
implementation-specific manner. Otherwise, if there are one
or more mutually-exclusive capabilities that are set to
`optional', the agent must choose one in an implementation-
specific manner."
::= { mdmLineCapabilitiesEntry 4 }
mdmLineCapabilities OBJECT IDENTIFIER ::= { mdmMIBObjects 5 }
mdmLineCapabilitiesV21 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.21"
::= { mdmLineCapabilities 1 }
mdmLineCapabilitiesV22 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.22"
::= { mdmLineCapabilities 2 }
mdmLineCapabilitiesV22bis OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.22bis"
::= { mdmLineCapabilities 3 }
mdmLineCapabilitiesV23CC OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.23CC"
::= { mdmLineCapabilities 4 }
mdmLineCapabilitiesV23SC OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.23SC"
Barnes, Brown, Royston & Waldbusser [Page 10]RFC 1696 Modem MIB August 1994
::= { mdmLineCapabilities 5 }
mdmLineCapabilitiesV25bis OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.25bis"
::= { mdmLineCapabilities 6 }
mdmLineCapabilitiesV26bis OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.26bis"
::= { mdmLineCapabilities 7 }
mdmLineCapabilitiesV26ter OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.26ter"
::= { mdmLineCapabilities 8 }
mdmLineCapabilitiesV27ter OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.27ter"
::= { mdmLineCapabilities 9 }
mdmLineCapabilitiesV32 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.32"
::= { mdmLineCapabilities 10 }
mdmLineCapabilitiesV32bis OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.32bis"
::= { mdmLineCapabilities 11 }
mdmLineCapabilitiesV32terbo OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.32terbo"
::= { mdmLineCapabilities 12 }
mdmLineCapabilitiesVFC OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.FC"
Barnes, Brown, Royston & Waldbusser [Page 11]RFC 1696 Modem MIB August 1994
::= { mdmLineCapabilities 13 }
mdmLineCapabilitiesV34 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.34"
::= { mdmLineCapabilities 14 }
mdmLineCapabilitiesV42 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.42"
::= { mdmLineCapabilities 15 }
mdmLineCapabilitiesV42bis OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.42bis"
::= { mdmLineCapabilities 16 }
mdmLineCapabilitiesMNP1 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"MNP1"
::= { mdmLineCapabilities 17 }
mdmLineCapabilitiesMNP2 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"MNP2"
::= { mdmLineCapabilities 18 }
mdmLineCapabilitiesMNP3 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"MNP3"
::= { mdmLineCapabilities 19 }
mdmLineCapabilitiesMNP4 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"MNP4"
::= { mdmLineCapabilities 20 }
mdmLineCapabilitiesMNP5 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"MNP5"
Barnes, Brown, Royston & Waldbusser [Page 12]RFC 1696 Modem MIB August 1994
::= { mdmLineCapabilities 21 }
mdmLineCapabilitiesMNP6 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"MNP6"
::= { mdmLineCapabilities 22 }
mdmLineCapabilitiesMNP7 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"MNP7"
::= { mdmLineCapabilities 23 }
mdmLineCapabilitiesMNP8 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"MNP8"
::= { mdmLineCapabilities 24 }
mdmLineCapabilitiesMNP9 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"MNP9"
::= { mdmLineCapabilities 25 }
mdmLineCapabilitiesMNP10 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"MNP10"
::= { mdmLineCapabilities 26 }
mdmLineCapabilitiesV29 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.29"
::= { mdmLineCapabilities 27 }
mdmLineCapabilitiesV33 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"ITU V.33"
::= { mdmLineCapabilities 28 }
mdmLineCapabilitiesBell208 OBJECT-IDENTITY
STATUS current
DESCRIPTION
"Bell 208"
Barnes, Brown, Royston & Waldbusser [Page 13]RFC 1696 Modem MIB August 1994
::= { mdmLineCapabilities 29 }
-- DTE Interface Table
mdmDTEInterfaceTable OBJECT-TYPE
SYNTAX SEQUENCE OF MdmDTEInterfaceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The modem DTE Interface Table augments the modem ID table."
::= { mdmMIBObjects 6 }
mdmDTEInterfaceEntry OBJECT-TYPE
SYNTAX MdmDTEInterfaceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries in this table are created only by the agent. One
entry exists for each modem managed by the agent."
AUGMENTS { mdmIDEntry }
::= { mdmDTEInterfaceTable 1 }
MdmDTEInterfaceEntry ::= SEQUENCE {
mdmDTEActionDTROnToOff INTEGER,
mdmDTEActionDTROffToOn INTEGER,
mdmDTESyncTimingSource INTEGER,
mdmDTESyncAsyncMode INTEGER,
mdmDTEInactivityTimeout Integer32
}
mdmDTEActionDTROnToOff OBJECT-TYPE
SYNTAX INTEGER {
ignore(1),
escapeToCommandMode(2),
disconnectCall(3),
resetModem(4)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Defines the action the modem will take when DTR drops.
If the value is set to ignore(1), the modem takes no action
when DTR drops. Typically, mdmDTEActionDTROffToOn would
also be set to ignore(1) if this object is set to ignore(1).
If the value is escapeToCommandMode(2), the modem remains
Barnes, Brown, Royston & Waldbusser [Page 14]RFC 1696 Modem MIB August 1994
connected and enters command mode. If the value is
disconnectCall(3), the current call (if any) is terminated
and the modem will not auto-answer while DTR is off. If the
value is resetModem(4), the current call (if any) is
terminated and the modem is reset."
DEFVAL { disconnectCall }
::= { mdmDTEInterfaceEntry 1 }
mdmDTEActionDTROffToOn OBJECT-TYPE
SYNTAX INTEGER {
ignore(1),
enableDial(2),
autoAnswerEnable(3),
establishConnection(4)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Defines the action the modem will take when DTR is raised.
If the value is set to ignore(1), the modem takes no action
when DTR is raised. Typically, mdmDTEActionDTROnToOff would
also be set to ignore(1) if this object is set to ignore(1).
If the value is set to enableDial(2), the modem prepares to
dial an outgoing call. If the value is set to
autoAnswerEnable(3), the modem will be configured to answer
any incoming call. If the value is set to
establishConnection(4), the modem dials an implementation
specific number.
Immediately after any reset or power-on of the modem, if the
DTR is high, the action specified here will be executed."
DEFVAL { autoAnswerEnable }
::= { mdmDTEInterfaceEntry 2 }
mdmDTESyncTimingSource OBJECT-TYPE
SYNTAX INTEGER {
internal(1),
external(2),
loopback(3),
network(4)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The clock source for synchronous transmissions. If set to
internal(1), the modem is the clock source and sends the
Barnes, Brown, Royston & Waldbusser [Page 15]RFC 1696 Modem MIB August 1994
clock signals to the DTE. If set to external(2), the
transmit clock signals are provided by the DTE. If
loopback(3), the modem receiver clock is used for the
transmit clock. If network(4), the clock signals are
supplied by the DCE interface.
If the modem is not in synchronous mode, setting this object
will have no effect on the current operations of the modem."
REFERENCE "V.58 transmitClockSource"
DEFVAL { internal }
::= { mdmDTEInterfaceEntry 3 }
mdmDTESyncAsyncMode OBJECT-TYPE
SYNTAX INTEGER {
async(1),
sync(2),
syncAfterDial(3)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The operational mode of the modem. If the value is
syncAfterDial(3), the modem will accept commands in
asynchronous mode and change to synchronous mode to pass
data after a dial sequence has been executed."
DEFVAL { async }
::= { mdmDTEInterfaceEntry 4 }
mdmDTEInactivityTimeout OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The amount of idle time in minutes that the modem will wait
before disconnecting a connection. When a call is connected
and no data is transferred (continuous marking condition) on
both circuits 103 and 104 for the specified time, the DCE
disconnects the call. If the value is 0, no idle disconnect
will occur. This function applies to asynchronous dial
operations only and is intended for administrative control
over idle connections."
REFERENCE "V.58 inactivityTimerSelect"
DEFVAL { 0 }
::= { mdmDTEInterfaceEntry 5 }
-- The Call Control Table
Barnes, Brown, Royston & Waldbusser [Page 16]RFC 1696 Modem MIB August 1994
mdmCallControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF MdmCallControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The modem Call Control Table augments the modem ID table."
::= { mdmMIBObjects 7 }
mdmCallControlEntry OBJECT-TYPE
SYNTAX MdmCallControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries in this table are created only by the agent. One
entry exists for each modem managed by the agent."
AUGMENTS { mdmIDEntry }
::= { mdmCallControlTable 1 }
MdmCallControlEntry ::= SEQUENCE {
mdmCCRingsBeforeAnswer Integer32,
mdmCCCallSetUpFailTimer Integer32,
mdmCCResultCodeEnable INTEGER,
mdmCCEscapeAction INTEGER,
mdmCCCallDuration Integer32,
mdmCCConnectionFailReason INTEGER
}
mdmCCRingsBeforeAnswer OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Determines which ring the modem will wait to answer the
phone on. If this value is `0', the modem will not go
offhook and answer a call when a ring signal is detected."
REFERENCE "V.58 ringsBeforeAnswer"
DEFVAL { 1 }
::= { mdmCallControlEntry 1 }
mdmCCCallSetUpFailTimer OBJECT-TYPE
SYNTAX Integer32 (0..255)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This parameter specifies the amount of time, in seconds,
that the modem shall allow between either answering a call
(automatically or manually) or completion of dialing, and
establishment of a connection with the remote modem. If no
Barnes, Brown, Royston & Waldbusser [Page 17]RFC 1696 Modem MIB August 1994
connection is established during this time, the modem
disconnects from the line and returns a result code
indicating the cause of the disconnection. In TIA-602, this
is controlled by the value in the S7 register."
REFERENCE "V.58 callSetUpFailTimer"
DEFVAL { 30 }
::= { mdmCallControlEntry 2 }
mdmCCResultCodeEnable OBJECT-TYPE
SYNTAX INTEGER {
disabled(1),
numericEnabled(2),
verboseEnabled(3)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"When disabled, the DCE shall issue no 'result codes' of any
kind to the DTE either in response to unsolicited events
(eg. ring signal), or commands. In TIA-602, this is
controlled by the ATQ command. When numericEnabled, the DCE
shall issue result codes in numeric form. When
verboseEnabled, the DCE shall issue result codes in a
verbose, textual form."
REFERENCE "V.58 responseModeSelect"
DEFVAL { verboseEnabled }
::= { mdmCallControlEntry 3 }
mdmCCEscapeAction OBJECT-TYPE
SYNTAX INTEGER {
ignoreEscape(1),
hangUp(2),
enterCommandMode(3)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The modem's action upon successfully recognizing the
'escape to command mode' character sequence."
DEFVAL { ignoreEscape }
::= { mdmCallControlEntry 4 }
-- Call status portion of the call control table
mdmCCCallDuration OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
Barnes, Brown, Royston & Waldbusser [Page 18]RFC 1696 Modem MIB August 1994
DESCRIPTION
"Present or last completed connection time in seconds. If
there have been no previous connections, this value should
be -1."
::= { mdmCallControlEntry 5 }
mdmCCConnectionFailReason OBJECT-TYPE
SYNTAX INTEGER {
-- General
unknown(1),
other(2),
managementCommand(3),
inactivityTimeout(4),
mnpIncompatibility(5),
protocolError(6),
-- DCE
powerLoss(10),
equipmentFailure(11),
-- DTE Interface
dtrDrop(20),
-- Line Interface
noDialTone(30),
lineBusy(31),
noAnswer(32),
voiceDetected(33),
-- Signal Converter
carrierLost(40),
trainingFailed(41),
faxDetected(42)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the reason that the last connection or attempt
failed. The meaning of each reason code is explained below.
unknown:
This code means the failure reason is unknown or
there has been no previous call.
other:
This code used when no other code is applicable.
Additional vendor information may be available
elsewhere.
managementCommand:
Barnes, Brown, Royston & Waldbusser [Page 19]RFC 1696 Modem MIB August 1994
A management command terminated the call. These
commands include escaping to command mode, initiating
dialing, restoring lines, and disconnecting.
inactivityTimeout:
The call was terminated because it was inactive for
at the minimum duration specified.
mnpIncompatibility:
The modems are unable to resolve MNP protocol
differences.
protocolError:
An error occured in one of protocol in use. Further
information is required to determine in which
protocol the error occurred, and the exact nature of
the error.
powerLoss:
The modem lost power and disconnected the call.
equipmentFailure:
The modem equipment failed.
dtrDrop:
DTR has been turned off while the modem is to
disconnect on DTR drop. (Ref: V.58 cct108TurnedOff)
noDialTone:
If the modem is to monitor for call progress tones,
but the modem has failed to detect dial tone while
attempting to dial a number.
lineBusy:
Busy signal is detected while busy signal detection
is enabled, or while the 'W' or '@' dial modifier is
used. (Ref: V.58 engagedTone)
noAnswer:
The call was not answered.
voiceDetected:
A voice was detected on the call.
carrierLost:
Indicates that the modem has disconnected due to
detection of loss of carrier. In TIA-602, the S10
register determines the time that loss of carrier
Barnes, Brown, Royston & Waldbusser [Page 20]RFC 1696 Modem MIB August 1994
must be detected before the modem disconnects.
trainingFailed:
Indicates that the modems did not successfully train
and reach data mode on the previous connection.
faxDetected:
A fax was detected on the call."
REFERENCE "V.58 callCleared"
::= { mdmCallControlEntry 6 }
-- The Stored Dial String table
mdmCCStoredDialStringTable OBJECT-TYPE
SYNTAX SEQUENCE OF MdmCCStoredDialStringEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table of stored dial strings."
REFERENCE "V.58 telephoneNumbers"
::= { mdmMIBObjects 8 }
mdmCCStoredDialStringEntry OBJECT-TYPE
SYNTAX MdmCCStoredDialStringEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A stored dial string."
INDEX { mdmIndex, mdmCCStoredDialStringIndex }
::= { mdmCCStoredDialStringTable 1 }
MdmCCStoredDialStringEntry ::= SEQUENCE {
mdmCCStoredDialStringIndex Integer32,
mdmCCStoredDialString DisplayString
}
mdmCCStoredDialStringIndex OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The unique index of a particular dial string."
::= { mdmCCStoredDialStringEntry 1 }
mdmCCStoredDialString OBJECT-TYPE
SYNTAX DisplayString (SIZE(0..64))
MAX-ACCESS read-write
STATUS current
Barnes, Brown, Royston & Waldbusser [Page 21]RFC 1696 Modem MIB August 1994
DESCRIPTION
"A dial string stored in the modem."
::= { mdmCCStoredDialStringEntry 2 }
-- The modem Error Correcting Group
mdmECTable OBJECT-TYPE
SYNTAX SEQUENCE OF MdmECEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The modem error correcting table augments the modem ID
table."
::= { mdmMIBObjects 9 }
mdmECEntry OBJECT-TYPE
SYNTAX MdmECEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries in this table are created only by the agent. One
entry exists for each modem managed by the agent."
AUGMENTS { mdmIDEntry }
::= { mdmECTable 1 }
MdmECEntry ::= SEQUENCE {
mdmECErrorControlUsed OBJECT IDENTIFIER
}
mdmECErrorControlUsed OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the error control method used during the current
or previous call. This shall be one of the values for error
control protocols registered in the capabilities table for
this modem. If no error control protocol is in use, this
object shall have the value '{0 0}'."
REFERENCE "V.58 errorControlActive"
::= { mdmECEntry 1 }
-- The modem Data Compression Group
mdmDCTable OBJECT-TYPE
SYNTAX SEQUENCE OF MdmDCEntry
MAX-ACCESS not-accessible
STATUS current
Barnes, Brown, Royston & Waldbusser [Page 22]RFC 1696 Modem MIB August 1994
DESCRIPTION
"The modem data compression table augments the modem ID
table."
::= { mdmMIBObjects 10 }
mdmDCEntry OBJECT-TYPE
SYNTAX MdmDCEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries in this table are created only by the agent. One
entry exists for each modem managed by the agent."
AUGMENTS { mdmIDEntry }
::= { mdmDCTable 1 }
MdmDCEntry ::= SEQUENCE {
mdmDCCompressionTypeUsed OBJECT IDENTIFIER
}
mdmDCCompressionTypeUsed OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the data compression method used during the
current or previous call. This shall be one of the values
for compression protocols registered in the capabilities
table for this modem. If no compression protocol is in use,
this object shall have the value '{0 0}'."
::= { mdmDCEntry 1 }
-- The modem Signal Convertor Group
mdmSCTable OBJECT-TYPE
SYNTAX SEQUENCE OF MdmSCEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The modem signal convertor table augments the modem ID
table."
::= { mdmMIBObjects 11 }
mdmSCEntry OBJECT-TYPE
SYNTAX MdmSCEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries in this table are created only by the agent. One
Barnes, Brown, Royston & Waldbusser [Page 23]RFC 1696 Modem MIB August 1994
entry exists for each modem managed by the agent."
AUGMENTS { mdmIDEntry }
::= { mdmSCTable 1 }
MdmSCEntry ::= SEQUENCE {
mdmSCCurrentLineTransmitRate Integer32,
mdmSCCurrentLineReceiveRate Integer32,
mdmSCInitialLineTransmitRate Integer32,
mdmSCInitialLineReceiveRate Integer32,
mdmSCModulationSchemeUsed OBJECT IDENTIFIER
}
mdmSCCurrentLineTransmitRate OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current link transmit rate of a connection, or the last
link transmit rate of the last connection in bits per
second."
REFERENCE "V.58 transmissionSignallingRateActive"
::= { mdmSCEntry 1 }
mdmSCCurrentLineReceiveRate OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current link receive rate of a connection, or the last
link receive rate of the last connection in bits per
second."
REFERENCE "V.58 transmissionSignallingRateActive"
::= { mdmSCEntry 2 }
mdmSCInitialLineTransmitRate OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The initial link transmit rate of the current connection,
or the initial link transmit rate of the last connection in
bits per second."
::= { mdmSCEntry 3 }
mdmSCInitialLineReceiveRate OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
Barnes, Brown, Royston & Waldbusser [Page 24]RFC 1696 Modem MIB August 1994
DESCRIPTION
"The initial link receive rate of the current connection, or
the initial link receive rate of the last connection in bits
per second."
::= { mdmSCEntry 4 }
mdmSCModulationSchemeUsed OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The modulation scheme of the current or previous call.
This shall be one of the values for modulation protocols
registered in the capabilities table for this modem."
REFERENCE "V.58 gstnModulationSchemeActive"
::= { mdmSCEntry 5 }
-- The Modem Statistics Table
mdmStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF MdmStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The modem statistics Table augments the modem ID table."
::= { mdmMIBObjects 12 }
mdmStatsEntry OBJECT-TYPE
SYNTAX MdmStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries in this table are created only by the agent. One
entry exists for each modem managed by the agent."
AUGMENTS { mdmIDEntry }
::= { mdmStatsTable 1 }
MdmStatsEntry ::= SEQUENCE {
mdmStatsRingNoAnswers Counter32,
mdmStatsIncomingConnectionFailures Counter32,
mdmStatsIncomingConnectionCompletions Counter32,
mdmStatsFailedDialAttempts Counter32,
mdmStatsOutgoingConnectionFailures Counter32,
mdmStatsOutgoingConnectionCompletions Counter32,
mdmStatsRetrains Counter32,
mdmStats2400OrLessConnections Counter32,
mdmStats2400To14400Connections Counter32,
mdmStatsGreaterThan14400Connections Counter32,
Barnes, Brown, Royston & Waldbusser [Page 25]RFC 1696 Modem MIB August 1994
mdmStatsErrorControlledConnections Counter32,
mdmStatsCompressedConnections Counter32,
mdmStatsCompressionEfficiency Integer32,
mdmStatsSentOctets Counter32,
mdmStatsReceivedOctets Counter32,
mdmStatsSentDataFrames Counter32,
mdmStatsReceivedDataFrames Counter32,
mdmStatsResentFrames Counter32,
mdmStatsErrorFrames Counter32
}
mdmStatsRingNoAnswers OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of events in which ringing was detected but the
call was not answered."
::= { mdmStatsEntry 1 }
mdmStatsIncomingConnectionFailures OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of incoming connection requests that this modem
answered in which it could not train with the other DCE."
::= { mdmStatsEntry 2 }
mdmStatsIncomingConnectionCompletions OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of incoming connection requests that this modem
answered and successfully trained with the other DCE."
::= { mdmStatsEntry 3 }
mdmStatsFailedDialAttempts OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of call attempts that failed because the modem
didn't go off hook, or there was no dialtone."
::= { mdmStatsEntry 4 }
mdmStatsOutgoingConnectionFailures OBJECT-TYPE
Barnes, Brown, Royston & Waldbusser [Page 26]RFC 1696 Modem MIB August 1994
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of outgoing calls from this modem which
sucessfully went off hook and dialed, in which it could not
train with the other DCE."
::= { mdmStatsEntry 5 }
mdmStatsOutgoingConnectionCompletions OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of outgoing calls from this modem which resulted
in successfully training with the other DCE."
::= { mdmStatsEntry 6 }
mdmStatsRetrains OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of retrains experienced on connections on this
line."
::= { mdmStatsEntry 7 }
-- Utilization counters
mdmStats2400OrLessConnections OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of connections initially established at a
modulation speed of 2400 bits per second or less."
::= { mdmStatsEntry 8 }
mdmStats2400To14400Connections OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of connections initially established at a
modulation speed of greater than 2400 bits per second and
less than 14400 bits per second."
Barnes, Brown, Royston & Waldbusser [Page 27]RFC 1696 Modem MIB August 1994
::= { mdmStatsEntry 9 }
mdmStatsGreaterThan14400Connections OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of connections initially established at a
modulation speed of greater than 14400 bits per second."
::= { mdmStatsEntry 10 }
mdmStatsErrorControlledConnections OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of established connections using an error
control protocol."
::= { mdmStatsEntry 11 }
mdmStatsCompressedConnections OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of established connections using a compression
protocol."
::= { mdmStatsEntry 12 }
mdmStatsCompressionEfficiency OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of bytes transferred into the compression
encoder divided by the number of bytes transferred out of
the encoder, multiplied by 100 for either the current or
last call. If a data compression protocol is not in use,
this value shall be `100'."
REFERENCE "V.58 compressionEfficiency"
::= { mdmStatsEntry 13 }
mdmStatsSentOctets OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of octets presented to the modem by the DTE."
Barnes, Brown, Royston & Waldbusser [Page 28]RFC 1696 Modem MIB August 1994
::= { mdmStatsEntry 14 }
mdmStatsReceivedOctets OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of octets presented to the DTE by the modem."
::= { mdmStatsEntry 15 }
mdmStatsSentDataFrames OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of data frames sent on the line interface. If
there is no frame-oriented protocol in use on the line
interface, this counter shall not increment."
::= { mdmStatsEntry 16 }
mdmStatsReceivedDataFrames OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of data frames received on the line interface.
If there is no frame-oriented protocol in use on the line
interface, this counter shall not increment."
::= { mdmStatsEntry 17 }
mdmStatsResentFrames OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times this modem retransmits frames on the
line interface. If there is no frame-oriented protocol in
use on the line interface, this counter shall not
increment."
::= { mdmStatsEntry 18 }
mdmStatsErrorFrames OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of block errors received on the link. If there
is no frame-oriented protocol in use on the line interface,
Barnes, Brown, Royston & Waldbusser [Page 29]RFC 1696 Modem MIB August 1994
this counter shall not increment."
::= { mdmStatsEntry 19 }
-- compliance statements
mdmCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for SNMPv2 entities which
implement the modem MIB."
MODULE -- this module
MANDATORY-GROUPS { mdmIDGroup, mdmLineInterfaceGroup,
mdmDTEInterfaceGroup, mdmCallControlGroup,
mdmSignalConvertorGroup, mdmStatisticsGroup }
GROUP mdmErrorControlGroup
DESCRIPTION
"This group is mandatory only for those modems that
implement an error correction protocol."
GROUP mdmDataCompressionGroup
DESCRIPTION
"This group is mandatory only for those modems that
implement a data compression protocol."
::= { mdmCompliances 1 }
END
4. Acknowledgements
This document was produced by the Modem Management Working group.
In addition, the authors gratefully acknowledge the comments of Tom
Holodnik and Mark S. Lewis.
5. Security Considerations
Security issues are not discussed in this memo.
Barnes, Brown, Royston & Waldbusser [Page 30]RFC 1696 Modem MIB August 1994
6. Authors' Addresses
Jim Barnes
Xylogics, Inc.
53 Third Avenue
Burlington, MA 01803
USA
Phone: 617-272-8140
Fax: 617-272-2618
EMail: barnes@xylogics.com
Les Brown
Motorola
Phone: 416-507-7200
EMail: brown_l@msm.cdx.mot.com
Rick Royston
US Robotics, Inc.
8100 N. McCormick Boulevard
Skokie, IL 60076-2999
USA
Phone: 708-933-5430
Fax: 708-982-1348
EMail: rroyston@usr.com
Steven Waldbusser
Carnegie Mellon University
Computing and Communications
Cyert Hall 130
5000 Forbes Avenue
Pittsburgh, PA 15213-3890
USA
Phone: 412-268-6628
Fax: 412-268-4987
EMail: swol@andrew.cmu.edu
Barnes, Brown, Royston & Waldbusser [Page 31]
