home *** CD-ROM | disk | FTP | other *** search
/ Internet Access: To the Information Highway / InternetAccessToTheInformationHighway1994.disc1of1.iso / internet / rfc4 / rfc1461.txt < prev    next >
Text File  |  1994-05-29  |  49KB  |  1,180 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                          D. Throop
  8. Request for Comments: 1461                      Data General Corporation
  9.                                                                 May 1993
  10.  
  11.  
  12.       SNMP MIB extension for Multiprotocol Interconnect over X.25
  13.  
  14. Status of this Memo
  15.  
  16.    This RFC specifies an IAB standards track protocol for the Internet
  17.    community, and requests discussion and suggestions for improvements.
  18.    Please refer to the current edition of the "IAB Official Protocol
  19.    Standards" for the standardization state and status of this protocol.
  20.    Distribution of this memo is unlimited.
  21.  
  22. Abstract
  23.  
  24.    This memo defines a portion of the Management Information Base (MIB)
  25.    for use with network management protocols in TCP/IP-based internets.
  26.    In particular, it defines objects for managing Multiprotocol
  27.    Interconnect (including IP) traffic carried over X.25.  The objects
  28.    defined here, along with the objects in the "SNMP MIB extension for
  29.    the Packet Layer of X.25"[8], "SNMP MIB extension for LAPB"[7], and
  30.    the "Definitions of Managed Objects for RS-232-like Hardware Devices"
  31.    [6], combine to allow management of the traffic over an X.25 protocol
  32.    stack.
  33.  
  34. Table of Contents
  35.  
  36.    1. The Network Management Framework .........................    1
  37.    2. Objects ..................................................    2
  38.    2.1 Format of Definitions ...................................    2
  39.    3. Overview .................................................    3
  40.    3.1 Scope ...................................................    3
  41.    3.2 Structure of MIB objects ................................    3
  42.    4. Definitions ..............................................    4
  43.    5. Acknowledgements .........................................   19
  44.    6. References ...............................................   20
  45.    7. Security Considerations ...................................  21
  46.    8. Author's Address .........................................   21
  47.  
  48. 1.  The Network Management Framework
  49.  
  50.    The Internet-standard Network Management Framework consists of three
  51.    components.  These components give the rules for defining objects,
  52.    the definitions of objects, and the protocol for manipulating
  53.    objects.
  54.  
  55.  
  56.  
  57.  
  58. Throop                                                          [Page 1]
  59.  
  60. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  61.  
  62.  
  63.    The network management framework structures objects in an abstract
  64.    information tree. The branches of the tree name objects and the
  65.    leaves of the tree contain the values manipulated to effect
  66.    management. This tree is called the Management Information Base or
  67.    MIB. The concepts of this tree are given in STD 16, RFC 1155, "The
  68.    Structure of Management Information" or SMI [1]. The SMI defines the
  69.    trunk of the tree and the types of objects used when defining the
  70.    leaves. STD 16, RFC 1212, "Towards Concise MIB Definitions" [3],
  71.    defines a more concise description mechanism that preserves all the
  72.    principals of the SMI.
  73.  
  74.    The core MIB definitions for the Internet suite of protocols can be
  75.    found in STD 17, RFC 1213 [4], "Management Information Base for
  76.    Network Management of TCP/IP-based internets".
  77.  
  78.    STD 15, RFC 1157 [2] defines the SNMP protocol itself. The protocol
  79.    defines how to manipulate the objects in a remote MIB.
  80.  
  81.    The tree structure of the MIB allows new objects to be defined for
  82.    the purpose of experimentation and evaluation.
  83.  
  84. 2.  Objects
  85.  
  86.    The definition of an object in the MIB requires an object name and
  87.    type.  Object names and types are defined using the subset of
  88.    Abstract Syntax Notation One (ASN.1) [5] defined in the SMI [1].
  89.    Objects are named using ASN.1 object identifiers, administratively
  90.    assigned names, to specify object types.  The object name, together
  91.    with an optional object instance, uniquely identifies a specific
  92.    instance of an object.  For human convenience, we often use a textual
  93.    string, termed the descriptor, to refer to objects.
  94.  
  95.    Objects also have a syntax that defines the abstract data structure
  96.    corresponding to that object type.  The ASN.1 language [5] provides
  97.    the primitives used for this purpose.  The SMI [1] purposely
  98.    restricts the ASN.1 constructs which may be used for simplicity and
  99.    ease of implementation.
  100.  
  101. 2.1.  Format of Definitions
  102.  
  103.    Section 4 contains the specification of all object types contained in
  104.    this MIB module.  The object types are defined using the conventions
  105.    defined in the SMI, as amended by the extensions specified in
  106.    "Towards Concise MIB Definitions" [3].
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Throop                                                          [Page 2]
  115.  
  116. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  117.  
  118.  
  119. 3.  Overview
  120.  
  121. 3.1.  Scope
  122.  
  123.    Instances of the objects defined below provide management information
  124.    for Multiprotocol Interconnect traffic on X.25 as defined in RFC 1356
  125.    [9].  That RFC describes how X.25 can be used to exchange IP or
  126.    network level protocols. The multiprotocol packets (IP, CLNP, ES-IS,
  127.    or SNAP) are encapsulated in X.25 frames for transmission between
  128.    nodes.  All nodes that implement RFC 1356 must implement this MIB.
  129.  
  130.    The objects in this MIB apply to the software in the node that
  131.    manages X.25 connections and performs the protocol encapsulation.  A
  132.    node in this usage maybe the end node source or destination host for
  133.    the packet, or it may be a router or bridge responsible for
  134.    forwarding the packet.  Since RFC 1356 requires X.25, nodes that
  135.    implement RFC 1356 must also implement the X.25 MIB, RFC 1382.
  136.  
  137.    This MIB only applies to Multiprotocol Interconnect over X.25
  138.    service. It does not apply to other software that may also use X.25
  139.    (for example PAD).  Thus the presence, absence, or operation of such
  140.    software will not directly affect any of these objects.  (However
  141.    connections in use by that software will appear in the X.25 MIB).
  142.  
  143. 3.2.  Structure of MIB objects
  144.  
  145.    The objects of this MIB are organized into three tables:  the
  146.    mioxPleTable, the mioxPeerTable, and the mioxPeerEncTable.  All
  147.    objects in all tables are mandatory for conformance with this MIB.
  148.  
  149.    The mioxPleTable defines information relative to an interface used to
  150.    carry Multiprotocol Interconnect traffic over X.25.  Such interfaces
  151.    are identified by an ifType object in the Internet-standard MIB [4]
  152.    of ddn-x25 or rfc877-x25.  Interfaces of type ddn-x25 have a self
  153.    contained algorithm for translating between IP addresses and X.121
  154.    addresses.  Interfaces of type rfc877-x25 do not have such an
  155.    algorithm.  Note that not all X.25 Interfaces will be used to carry
  156.    Multiprotocol Interconnect traffic. Those interfaces not carrying
  157.    such traffic will not have entries in the mioxPleTable.  The entries
  158.    in the mioxPleTable are only for interfaces that do carry
  159.    Multiprotocol Interconnect traffic over X.25.  Entries in the
  160.    mioxPleTable are indexed by ifIndex to make it easy to find the
  161.    mioxPleTable entry for an interface.
  162.  
  163.    The mioxPeerTable contains information needed to contact an X.25 Peer
  164.    to exchange packets.  This includes information such as the X.121
  165.    address of the peer and a pointer to the X.25 call parameters needed
  166.    to place the call.  The instance identifiers used for the objects in
  167.  
  168.  
  169.  
  170. Throop                                                          [Page 3]
  171.  
  172. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  173.  
  174.  
  175.    this table are independent of any interface or other tables defined
  176.    outside this MIB.  This table contains the ifIndex value of the X.25
  177.    interface to use to call a peer.
  178.  
  179.    The mioxPeerEncTable contains information about the encapsulation
  180.    type used to communicate with a peer.  This table is an extension of
  181.    the mioxPeerTable in its instance identification. Each entry in the
  182.    mioxPeerTable may have zero or more entries in this table.  This
  183.    table will not have any entries that do not have correspondent
  184.    entries in mioxPeerTable.
  185.  
  186. 4.  Definitions
  187.  
  188.  
  189.           MIOX25-MIB DEFINITIONS  ::= BEGIN
  190.  
  191.           IMPORTS
  192.                   Counter,
  193.                   TimeTicks
  194.                           FROM RFC1155-SMI
  195.                   OBJECT-TYPE
  196.                           FROM RFC-1212
  197.                   DisplayString, transmission,
  198.                   ifIndex
  199.                           FROM RFC1213-MIB
  200.                   InstancePointer
  201.                           FROM RFC1316-MIB
  202.                   X121Address
  203.                           FROM RFC1382-MIB
  204.                   PositiveInteger
  205.                           FROM RFC1381-MIB;
  206.  
  207.                           -- IP over X.25 MIB
  208.  
  209.           miox    OBJECT IDENTIFIER ::= { transmission 38 }
  210.  
  211.           mioxPle         OBJECT IDENTIFIER ::= { miox 1 }
  212.           mioxPeer        OBJECT IDENTIFIER ::= { miox 2 }
  213.  
  214.           -- ###########################################################
  215.           --              Ple Table
  216.           -- ###########################################################
  217.  
  218.           -- Systems that implement RFC 1356 must also implement
  219.           -- all objects in this group.
  220.  
  221.           mioxPleTable    OBJECT-TYPE
  222.                   SYNTAX  SEQUENCE OF MioxPleEntry
  223.  
  224.  
  225.  
  226. Throop                                                          [Page 4]
  227.  
  228. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  229.  
  230.  
  231.                   ACCESS  not-accessible
  232.                   STATUS  mandatory
  233.                   DESCRIPTION
  234.                           "This table contains information relative to
  235.                           an interface to an X.25 Packet Level Entity
  236.                           (PLE)."
  237.                   ::= { mioxPle 1   }
  238.  
  239.           mioxPleEntry    OBJECT-TYPE
  240.                   SYNTAX  MioxPleEntry
  241.                   ACCESS  not-accessible
  242.                   STATUS  mandatory
  243.                   DESCRIPTION
  244.                           "These objects manage the encapsulation of
  245.                           other protocols within X.25."
  246.                   INDEX { ifIndex }
  247.                   ::= { mioxPleTable 1 }
  248.  
  249.           MioxPleEntry ::= SEQUENCE {
  250.                   mioxPleMaxCircuits
  251.                           INTEGER,
  252.                   mioxPleRefusedConnections
  253.                           Counter,
  254.                   mioxPleEnAddrToX121LkupFlrs
  255.                           Counter,
  256.                   mioxPleLastFailedEnAddr
  257.                           OCTET STRING,
  258.                   mioxPleEnAddrToX121LkupFlrTime
  259.                           TimeTicks,
  260.                   mioxPleX121ToEnAddrLkupFlrs
  261.                           Counter,
  262.                   mioxPleLastFailedX121Address
  263.                           X121Address,
  264.                   mioxPleX121ToEnAddrLkupFlrTime
  265.                           TimeTicks,
  266.                   mioxPleQbitFailures
  267.                           Counter,
  268.                   mioxPleQbitFailureRemoteAddress
  269.                           X121Address,
  270.                   mioxPleQbitFailureTime
  271.                           TimeTicks,
  272.                   mioxPleMinimumOpenTimer
  273.                           PositiveInteger,
  274.                   mioxPleInactivityTimer
  275.                           PositiveInteger,
  276.                   mioxPleHoldDownTimer
  277.                           PositiveInteger,
  278.                   mioxPleCollisionRetryTimer
  279.  
  280.  
  281.  
  282. Throop                                                          [Page 5]
  283.  
  284. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  285.  
  286.  
  287.                           PositiveInteger,
  288.                   mioxPleDefaultPeerId
  289.                           InstancePointer
  290.                   }
  291.  
  292.           mioxPleMaxCircuits OBJECT-TYPE
  293.                   SYNTAX  INTEGER (0..2147483647)
  294.                   ACCESS  read-write
  295.                   STATUS  mandatory
  296.                   DESCRIPTION
  297.                           "The maximum number of X.25 circuits that
  298.                           can be open at one time for this interface.
  299.                           A value of zero indicates the interface will
  300.                           not allow any additional circuits (as it may
  301.                           soon be shutdown).  A value of 2147483647
  302.                           allows an unlimited number of circuits."
  303.                   ::= { mioxPleEntry 1 }
  304.  
  305.           mioxPleRefusedConnections OBJECT-TYPE
  306.                   SYNTAX  Counter
  307.                   ACCESS  read-only
  308.                   STATUS  mandatory
  309.                   DESCRIPTION
  310.                           "The number of X.25 calls from a remote
  311.                           systems to this system that were cleared by
  312.                           this system.  The interface instance should
  313.                           identify the X.25 interface the call came in
  314.                           on."
  315.                   ::= { mioxPleEntry 2 }
  316.  
  317.           mioxPleEnAddrToX121LkupFlrs OBJECT-TYPE
  318.                   SYNTAX  Counter
  319.                   ACCESS  read-only
  320.                   STATUS  mandatory
  321.                   DESCRIPTION
  322.                           "The number of times a translation from an
  323.                           Encapsulated Address to an X.121 address
  324.                           failed to find a corresponding X.121
  325.                           address.  Encapsulated addresses can be
  326.                           looked up in the mioxPeerTable or translated
  327.                           via an algorithm as for the DDN.  Addresses
  328.                           that are successfully recognized do not
  329.                           increment this counter.  Addresses that are
  330.                           not recognized (reflecting an abnormal
  331.                           packet delivery condition) increment this
  332.                           counter.
  333.  
  334.                           If an address translation fails, it may be
  335.  
  336.  
  337.  
  338. Throop                                                          [Page 6]
  339.  
  340. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  341.  
  342.  
  343.                           difficult to determine which PLE entry
  344.                           should count the failure.  In such cases the
  345.                           first likely entry in this table should be
  346.                           selected.  Agents should record the failure
  347.                           even if they are unsure which PLE should be
  348.                           associated with the failure."
  349.                   ::= { mioxPleEntry 3 }
  350.  
  351.           mioxPleLastFailedEnAddr OBJECT-TYPE
  352.                   SYNTAX  OCTET STRING (SIZE(2..128))
  353.                   ACCESS  read-only
  354.                   STATUS  mandatory
  355.                   DESCRIPTION
  356.                           "The last Encapsulated address that failed
  357.                           to find a corresponding X.121 address and
  358.                           caused mioxPleEnAddrToX121LkupFlrs to be
  359.                           incremented.  The first octet of this object
  360.                           contains the encapsulation type, the
  361.                           remaining octets contain the address of that
  362.                           type that failed.  Thus for an IP address,
  363.                           the length will be five octets, the first
  364.                           octet will contain 204 (hex CC), and the
  365.                           last four octets will contain the IP
  366.                           address.  For a snap encapsulation, the
  367.                           first byte would be 128 (hex 80) and the
  368.                           rest of the octet string would have the snap
  369.                           header."
  370.                   ::= { mioxPleEntry 4 }
  371.  
  372.           mioxPleEnAddrToX121LkupFlrTime OBJECT-TYPE
  373.                   SYNTAX  TimeTicks
  374.                   ACCESS  read-only
  375.                   STATUS  mandatory
  376.                   DESCRIPTION
  377.                           "The most recent value of sysUpTime when the
  378.                           translation from an Encapsulated Address to
  379.                           X.121 address failed to find a corresponding
  380.                           X.121 address."
  381.                   ::= { mioxPleEntry 5 }
  382.  
  383.  
  384.           mioxPleX121ToEnAddrLkupFlrs OBJECT-TYPE
  385.                   SYNTAX  Counter
  386.                   ACCESS  read-only
  387.                   STATUS  mandatory
  388.                   DESCRIPTION
  389.                           "The number of times the translation from an
  390.                           X.121 address to an Encapsulated Address
  391.  
  392.  
  393.  
  394. Throop                                                          [Page 7]
  395.  
  396. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  397.  
  398.  
  399.                           failed to find a corresponding Encapsulated
  400.                           Address.  Addresses successfully recognized
  401.                           by an algorithm do not increment this
  402.                           counter.  This counter reflects the number
  403.                           of times call acceptance encountered the
  404.                           abnormal condition of not recognizing the
  405.                           peer."
  406.                   ::= { mioxPleEntry 6 }
  407.  
  408.           mioxPleLastFailedX121Address OBJECT-TYPE
  409.                   SYNTAX  X121Address
  410.                   ACCESS  read-only
  411.                   STATUS  mandatory
  412.                   DESCRIPTION
  413.                           "The last X.121 address that caused
  414.                           mioxPleX121ToEnAddrLkupFlrs to increase."
  415.                   ::= { mioxPleEntry 7 }
  416.  
  417.           mioxPleX121ToEnAddrLkupFlrTime OBJECT-TYPE
  418.                   SYNTAX  TimeTicks
  419.                   ACCESS  read-only
  420.                   STATUS  mandatory
  421.                   DESCRIPTION
  422.                           "The most recent value of sysUpTime when the
  423.                           translation from an X.121 address to an
  424.                           Encapsulated Address failed to find a
  425.                           corresponding Encapsulated Address."
  426.                   ::= { mioxPleEntry 8 }
  427.  
  428.           mioxPleQbitFailures OBJECT-TYPE
  429.                   SYNTAX  Counter
  430.                   ACCESS  read-only
  431.                   STATUS  mandatory
  432.                   DESCRIPTION
  433.                           "The number of times a connection was closed
  434.                           because of a Q-bit failure."
  435.                   ::= { mioxPleEntry 9 }
  436.  
  437.           mioxPleQbitFailureRemoteAddress OBJECT-TYPE
  438.                   SYNTAX  X121Address
  439.                   ACCESS  read-only
  440.                   STATUS  mandatory
  441.                   DESCRIPTION
  442.                           "The remote address of the most recent
  443.                           (last) connection that was closed because of
  444.                           a Q-bit failure."
  445.                   ::= { mioxPleEntry 10 }
  446.  
  447.  
  448.  
  449.  
  450. Throop                                                          [Page 8]
  451.  
  452. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  453.  
  454.  
  455.           mioxPleQbitFailureTime OBJECT-TYPE
  456.                   SYNTAX  TimeTicks
  457.                   ACCESS  read-only
  458.                   STATUS  mandatory
  459.                   DESCRIPTION
  460.                           "The most recent value of sysUpTime when a
  461.                           connection was closed because of a Q-bit
  462.                           failure.  This will also be the last time
  463.                           that mioxPleQbitFailures was incremented."
  464.                   ::= { mioxPleEntry 11 }
  465.  
  466.           mioxPleMinimumOpenTimer OBJECT-TYPE
  467.                   SYNTAX  PositiveInteger
  468.                   ACCESS  read-write
  469.                   STATUS  mandatory
  470.                   DESCRIPTION
  471.                           "The minimum time in milliseconds this
  472.                           interface will keep a connection open before
  473.                           allowing it to be closed.  A value of zero
  474.                           indicates no timer."
  475.                   DEFVAL { 0 }
  476.                   ::= { mioxPleEntry 12 }
  477.  
  478.           mioxPleInactivityTimer OBJECT-TYPE
  479.                   SYNTAX  PositiveInteger
  480.                   ACCESS  read-write
  481.                   STATUS  mandatory
  482.                   DESCRIPTION
  483.                           "The amount of time time in milliseconds
  484.                           this interface will keep an idle connection
  485.                           open before closing it.  A value of
  486.                           2147483647 indicates no timer."
  487.                   DEFVAL { 10000 }
  488.                   ::= { mioxPleEntry 13 }
  489.  
  490.           mioxPleHoldDownTimer    OBJECT-TYPE
  491.                   SYNTAX  PositiveInteger
  492.                   ACCESS  read-write
  493.                   STATUS  mandatory
  494.                   DESCRIPTION
  495.                           "The hold down timer in milliseconds.  This
  496.                           is the minimum amount of time to wait before
  497.                           trying another call to a host that was
  498.                           previously unsuccessful.  A value of
  499.                           2147483647 indicates the host will not be
  500.                           retried."
  501.                   DEFVAL { 0 }
  502.                   ::= { mioxPleEntry 14 }
  503.  
  504.  
  505.  
  506. Throop                                                          [Page 9]
  507.  
  508. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  509.  
  510.  
  511.           mioxPleCollisionRetryTimer OBJECT-TYPE
  512.                   SYNTAX  PositiveInteger
  513.                   ACCESS  read-write
  514.                   STATUS  mandatory
  515.                   DESCRIPTION
  516.                           "The Collision Retry Timer in milliseconds.
  517.                           The time to delay between call attempts when
  518.                           the maximum number of circuits is exceeded
  519.                           in a call attempt."
  520.                   DEFVAL { 0 }
  521.                   ::= { mioxPleEntry 15 }
  522.  
  523.  
  524.           mioxPleDefaultPeerId OBJECT-TYPE
  525.                   SYNTAX  InstancePointer
  526.                   ACCESS  read-write
  527.                   STATUS  mandatory
  528.                   DESCRIPTION
  529.                           "This identifies the instance of the index
  530.                           in the mioxPeerTable for the default
  531.                           parameters to use with this interface.
  532.  
  533.                           The entry identified by this object may have
  534.                           a zero length Encapsulation address and a
  535.                           zero length X.121 address.
  536.  
  537.                           These default parameters are used with
  538.                           connections to hosts that do not have
  539.                           entries in the mioxPeerTable.  Such
  540.                           connections occur when using ddn-x25 IP-X.25
  541.                           address mapping or when accepting
  542.                           connections from other hosts not in the
  543.                           mioxPeerTable.
  544.  
  545.                           The mioxPeerEncTable entry with the same
  546.                           index as the mioxPeerTable entry specifies
  547.                           the call encapsulation types this PLE will
  548.                           accept for peers not in the mioxPeerTable.
  549.                           If the mioxPeerEncTable doesn't contain any
  550.                           entries, this PLE will not accept calls from
  551.                           entries not in the mioxPeerTable."
  552.                   ::= { mioxPleEntry 16 }
  553.  
  554.  
  555.  
  556.           -- ###########################################################
  557.           --              Peer Table
  558.           -- ###########################################################
  559.  
  560.  
  561.  
  562. Throop                                                         [Page 10]
  563.  
  564. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  565.  
  566.  
  567.           -- Systems that implement RFC 1356 must also implement
  568.           -- all objects in this group.
  569.  
  570.           mioxPeerTable OBJECT-TYPE
  571.                   SYNTAX  SEQUENCE OF MioxPeerEntry
  572.                   ACCESS  not-accessible
  573.                   STATUS  mandatory
  574.                   DESCRIPTION
  575.                           "This table contains information about the
  576.                           possible peers this machine may exchange
  577.                           packets with."
  578.                   ::= { mioxPeer 1 }
  579.  
  580.           mioxPeerEntry OBJECT-TYPE
  581.                   SYNTAX  MioxPeerEntry
  582.                   ACCESS  not-accessible
  583.                   STATUS  mandatory
  584.                   DESCRIPTION
  585.                           "Per peer information."
  586.                   INDEX { mioxPeerIndex   }
  587.                   ::= { mioxPeerTable 1 }
  588.  
  589.  
  590.           MioxPeerEntry ::= SEQUENCE {
  591.                   mioxPeerIndex
  592.                           PositiveInteger,
  593.                   mioxPeerStatus
  594.                           INTEGER,
  595.                   mioxPeerMaxCircuits
  596.                           PositiveInteger,
  597.                   mioxPeerIfIndex
  598.                           PositiveInteger,
  599.                   mioxPeerConnectSeconds
  600.                           Counter,
  601.                   mioxPeerX25CallParamId
  602.                           InstancePointer,
  603.                   mioxPeerEnAddr
  604.                           OCTET STRING,
  605.                   mioxPeerX121Address
  606.                           X121Address,
  607.                   mioxPeerX25CircuitId
  608.                           InstancePointer,
  609.                   mioxPeerDescr
  610.                           DisplayString
  611.                   }
  612.  
  613.           mioxPeerIndex   OBJECT-TYPE
  614.                   SYNTAX  PositiveInteger
  615.  
  616.  
  617.  
  618. Throop                                                         [Page 11]
  619.  
  620. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  621.  
  622.  
  623.                   ACCESS  read-only
  624.                   STATUS  mandatory
  625.                   DESCRIPTION
  626.                           "An index value that distinguished one entry
  627.                           from another.  This index is independent of
  628.                           any other index."
  629.                   ::= { mioxPeerEntry 1 }
  630.  
  631.           -- Systems can claim conformance with this MIB without
  632.           -- implementing sets to mioxPeerStatus with a value of
  633.           -- clearCall or makeCall.
  634.           -- All other defined values must be accepted.
  635.           -- Implementors should realize that allowing these values
  636.           -- provides richer management, and implementations
  637.           -- are encouraged to accept these values.
  638.           mioxPeerStatus OBJECT-TYPE
  639.                   SYNTAX  INTEGER {
  640.                                   valid (1),
  641.                                   createRequest (2),
  642.                                   underCreation (3),
  643.                                   invalid (4),
  644.                                   clearCall (5),
  645.                                   makeCall (6)
  646.                                   }
  647.                   ACCESS  read-write
  648.                   STATUS  mandatory
  649.                   DESCRIPTION
  650.                           "This reports the status of a peer entry.
  651.                           A value of valid indicates a normal entry
  652.                           that is in use by the agent.  A value of
  653.                           underCreation indicates a newly created
  654.                           entry which isn't yet in use because the
  655.                           creating management station is still setting
  656.                           values.
  657.  
  658.                           The value of invalid indicates the entry is
  659.                           no longer in use and the agent is free to
  660.                           delete the entry at any time.  A management
  661.                           station is also free to use an entry in the
  662.                           invalid state.
  663.  
  664.                           Entries are created by setting a value of
  665.                           createRequest.  Only non-existent or invalid
  666.                           entries can be set to createRequest.  Upon
  667.                           receiving a valid createRequest, the agent
  668.                           will create an entry in the underCreation
  669.                           state.  This object can not be set to a
  670.                           value of underCreation directly, entries can
  671.  
  672.  
  673.  
  674. Throop                                                         [Page 12]
  675.  
  676. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  677.  
  678.  
  679.                           only be created by setting a value of
  680.                           createRequest.  Entries that exist in other
  681.                           than the invalid state can not be set to
  682.                           createRequest.
  683.  
  684.                           Entries with a value of underCreation are
  685.                           not used by the system and the management
  686.                           station can change the values of other
  687.                           objects in the table entry.  Management
  688.                           stations should also remember to configure
  689.                           values in the mioxPeerEncTable with the same
  690.                           peer index value as this peer entry.
  691.  
  692.                           An entry in the underCreation state can be
  693.                           set to valid or invalid.  Entries in the
  694.                           underCreation state will stay in that state
  695.                           until 1) the agent times them out, 2) they
  696.                           are set to valid, 3) they are set to
  697.                           invalid.  If an agent notices an entry has
  698.                           been in the underCreation state for an
  699.                           abnormally long time, it may decide the
  700.                           management station has failed and invalidate
  701.                           the entry.  A prudent agent will understand
  702.                           that the management station may need to wait
  703.                           for human input and will allow for that
  704.                           possibility in its determination of this
  705.                           abnormally long period.
  706.  
  707.                           Once a management station has completed all
  708.                           fields of an entry, it will set a value of
  709.                           valid.  This causes the entry to be
  710.                           activated.
  711.  
  712.                           Entries in the valid state may also be set
  713.                           to makeCall or clearCall to make or clear
  714.                           X.25 calls to the peer.  After such a set
  715.                           request the entry will still be in the valid
  716.                           state.  Setting a value of makeCall causes
  717.                           the agent to initiate an X.25 call request
  718.                           to the peer specified by the entry.  Setting
  719.                           a value of clearCall causes the agent to
  720.                           initiate clearing one X.25 call present to
  721.                           the peer.  Each set request will initiate
  722.                           another call or clear request (up to the
  723.                           maximum allowed); this means that management
  724.                           stations that fail to get a response to a
  725.                           set request should query to see if a call
  726.                           was in fact placed or cleared before
  727.  
  728.  
  729.  
  730. Throop                                                         [Page 13]
  731.  
  732. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  733.  
  734.  
  735.                           retrying the request.  Entries not in the
  736.                           valid state can not be set to makeCall or
  737.                           clearCall.
  738.  
  739.                           The values of makeCall and clearCall provide
  740.                           for circuit control on devices which perform
  741.                           Ethernet Bridging using static circuit
  742.                           assignment without address recognition;
  743.                           other devices which dynamically place calls
  744.                           based on destination addresses may reject
  745.                           such requests.
  746.  
  747.                           An agent that (re)creates a new entry
  748.                           because of a set with createRequest, should
  749.                           also (re)create a mioxPeerEncTable entry
  750.                           with a mioxPeerEncIndex of 1, and a
  751.                           mioxPeerEncType of 204 (hex CC)."
  752.                   ::= { mioxPeerEntry 2 }
  753.  
  754.           mioxPeerMaxCircuits OBJECT-TYPE
  755.                   SYNTAX  PositiveInteger
  756.                   ACCESS  read-write
  757.                   STATUS    mandatory
  758.                   DESCRIPTION
  759.                           "The maximum number of X.25 circuits allowed
  760.                           to this peer."
  761.                   DEFVAL { 1 }
  762.                   ::= { mioxPeerEntry 3 }
  763.  
  764.           mioxPeerIfIndex OBJECT-TYPE
  765.                   SYNTAX  PositiveInteger
  766.                   ACCESS  read-write
  767.                   STATUS  mandatory
  768.                   DESCRIPTION
  769.                           "The value of the ifIndex object for the
  770.                           interface to X.25 to use to call the peer."
  771.                   DEFVAL { 1 }
  772.                   ::= { mioxPeerEntry 4 }
  773.  
  774.           mioxPeerConnectSeconds OBJECT-TYPE
  775.                   SYNTAX  Counter
  776.                   ACCESS  read-only
  777.                   STATUS  mandatory
  778.                   DESCRIPTION
  779.                           "The number of seconds a call to this peer
  780.                           was active.  This counter will be
  781.                           incremented by one for every second a
  782.                           connection to a peer was open.  If two calls
  783.  
  784.  
  785.  
  786. Throop                                                         [Page 14]
  787.  
  788. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  789.  
  790.  
  791.                           are open at the same time, one second of
  792.                           elapsed real time will results in two
  793.                           seconds of connect time."
  794.                   ::= { mioxPeerEntry 5 }
  795.  
  796.           mioxPeerX25CallParamId OBJECT-TYPE
  797.                   SYNTAX  InstancePointer
  798.                   ACCESS  read-write
  799.                   STATUS  mandatory
  800.                   DESCRIPTION
  801.                           "The instance of the index object in the
  802.                           x25CallParmTable from RFC 1382 for the X.25
  803.                           call parameters used to communicate with the
  804.                           remote host.  The well known value {0 0}
  805.                           indicates no call parameters specified."
  806.                   DEFVAL { {0 0} }
  807.                   ::= { mioxPeerEntry 6 }
  808.  
  809.           mioxPeerEnAddr  OBJECT-TYPE
  810.                   SYNTAX    OCTET STRING (SIZE (0..128))
  811.                   ACCESS  read-write
  812.                   STATUS  mandatory
  813.                   DESCRIPTION
  814.                           "The Encapsulation address of the remote
  815.                           host mapped by this table entry.  A length
  816.                           of zero indicates the remote IP address is
  817.                           unknown or unspecified for use as a PLE
  818.                           default.
  819.  
  820.                           The first octet of this object contains the
  821.                           encapsulation type, the remaining octets
  822.                           contain an address of that type.  Thus for
  823.                           an IP address, the length will be five
  824.                           octets, the first octet will contain 204
  825.                           (hex CC), and the last four octets will
  826.                           contain the IP address.  For a snap
  827.                           encapsulation, the first byte would be 128
  828.                           (hex 80) and the rest of the octet string
  829.                           would have the snap header."
  830.                   DEFVAL { ''h }
  831.                   ::= { mioxPeerEntry 7 }
  832.  
  833.           mioxPeerX121Address OBJECT-TYPE
  834.                   SYNTAX  X121Address
  835.                   ACCESS  read-write
  836.                   STATUS  mandatory
  837.                   DESCRIPTION
  838.                           "The X.25 address of the remote host mapped
  839.  
  840.  
  841.  
  842. Throop                                                         [Page 15]
  843.  
  844. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  845.  
  846.  
  847.                           by this table entry.  A zero length string
  848.                           indicates the X.25 address is unspecified
  849.                           for use as the PLE default."
  850.                   DEFVAL { ''h }
  851.                   ::= { mioxPeerEntry 8 }
  852.  
  853.           -- Systems can claim conformance to this MIB without
  854.           -- implementing sets to mioxPeerX25CircuitId.
  855.           -- However systems that use PVCs with RFC1356
  856.           -- are encouraged to implement sets.
  857.           mioxPeerX25CircuitId OBJECT-TYPE
  858.                   SYNTAX  InstancePointer
  859.                   ACCESS  read-write
  860.                   STATUS  mandatory
  861.                   DESCRIPTION
  862.                           "This object identifies the instance of the
  863.                           index for the X.25 circuit open to the peer
  864.                           mapped by this table entry.  The well known
  865.                           value {0 0} indicates no connection
  866.                           currently active.  For multiple connections,
  867.                           this identifies the index of a multiplexing
  868.                           table entry for the connections.  This can
  869.                           only be written to configure use of PVCs
  870.                           which means the identified circuit table
  871.                           entry for a write must be a PVC."
  872.                   DEFVAL { {0 0} }
  873.                   ::= { mioxPeerEntry 9 }
  874.  
  875.           mioxPeerDescr   OBJECT-TYPE
  876.                   SYNTAX  DisplayString (SIZE (0..255))
  877.                   ACCESS  read-write
  878.                   STATUS  mandatory
  879.                   DESCRIPTION
  880.                           "This object returns any identification
  881.                           information about the peer.  An agent may
  882.                           supply the comment information found in the
  883.                           configuration file entry for this peer.  A
  884.                           zero length string indicates no information
  885.                           available."
  886.                   DEFVAL { ''h }
  887.                   ::= { mioxPeerEntry 10 }
  888.  
  889.  
  890.  
  891.           -- ###########################################################
  892.           --              Peer Encapsulation Table
  893.           -- ###########################################################
  894.  
  895.  
  896.  
  897.  
  898. Throop                                                         [Page 16]
  899.  
  900. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  901.  
  902.  
  903.           mioxPeerEncTable OBJECT-TYPE
  904.                   SYNTAX  SEQUENCE OF MioxPeerEncEntry
  905.                   ACCESS  not-accessible
  906.                   STATUS  mandatory
  907.                   DESCRIPTION
  908.                           "This table contains the list of
  909.                           encapsulations used to communicate with a
  910.                           peer.  This table has two indexes, the first
  911.                           identifies the peer, the second
  912.                           distinguishes encapsulation types.
  913.  
  914.                           The first index identifies the corresponding
  915.                           entry in the mioxPeerTable.  The second
  916.                           index gives the priority of the different
  917.                           encapsulations.
  918.  
  919.                           The encapsulation types are ordered in
  920.                           priority order.  For calling a peer, the
  921.                           first entry (mioxPeerEncIndex of 1) is tried
  922.                           first.  If the call doesn't succeed because
  923.                           the remote host clears the call due to
  924.                           incompatible call user data, the next entry
  925.                           in the list is tried.  Each entry is tried
  926.                           until the list is exhausted.
  927.  
  928.                           For answering a call, the encapsulation type
  929.                           requested by the peer must be found the list
  930.                           or the call will be refused.  If there are
  931.                           no entries in this table for a peer, all
  932.                           call requests from the peer will be refused.
  933.  
  934.                           Objects in this table can only be set when
  935.                           the mioxPeerStatus object with the same
  936.                           index has a value of underCreation.  When
  937.                           that status object is set to invalid and
  938.                           deleted, the entry in this table with that
  939.                           peer index must also be deleted."
  940.                   ::= { mioxPeer 2 }
  941.  
  942.           mioxPeerEncEntry OBJECT-TYPE
  943.                   SYNTAX  MioxPeerEncEntry
  944.                   ACCESS  not-accessible
  945.                   STATUS  mandatory
  946.                   DESCRIPTION
  947.                           "Per connection information."
  948.                   INDEX { mioxPeerIndex, mioxPeerEncIndex}
  949.                   ::= { mioxPeerEncTable 1 }
  950.  
  951.  
  952.  
  953.  
  954. Throop                                                         [Page 17]
  955.  
  956. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  957.  
  958.  
  959.           MioxPeerEncEntry ::= SEQUENCE {
  960.                   mioxPeerEncIndex
  961.                           PositiveInteger,
  962.                   mioxPeerEncType
  963.                           INTEGER
  964.                   }
  965.  
  966.           mioxPeerEncIndex        OBJECT-TYPE
  967.                   SYNTAX  PositiveInteger
  968.                   ACCESS  read-only
  969.                   STATUS    mandatory
  970.                   DESCRIPTION
  971.                           "The second index in the table which
  972.                           distinguishes different encapsulation
  973.                           types."
  974.                   ::= { mioxPeerEncEntry 1 }
  975.  
  976.           mioxPeerEncType OBJECT-TYPE
  977.                   SYNTAX  INTEGER (0..256)
  978.                   ACCESS  read-write
  979.                   STATUS  mandatory
  980.                   DESCRIPTION
  981.                           "The value of the encapsulation type.  For
  982.                           IP encapsulation this will have a value of
  983.                           204 (hex CC).  For SNAP encapsulated
  984.                           packets, this will have a value of 128 (hex
  985.                           80).  For CLNP, ISO 8473, this will have a
  986.                           value of 129 (hex 81).  For ES-ES, ISO 9542,
  987.                           this will have a value of 130 (hex 82).  A
  988.                           value of 197 (hex C5) identifies the Blacker
  989.                           X.25 encapsulation.  A value of 0,
  990.                           identifies the Null encapsulation.
  991.  
  992.                           This value can only be written when the
  993.                           mioxPeerStatus object with the same
  994.                           mioxPeerIndex has a value of underCreation.
  995.                           Setting this object to a value of 256
  996.                           deletes the entry.  When deleting an entry,
  997.                           all other entries in the mioxPeerEncTable
  998.                           with the same mioxPeerIndex and with an
  999.                           mioxPeerEncIndex higher then the deleted
  1000.                           entry, will all have their mioxPeerEncIndex
  1001.                           values decremented by one."
  1002.                   ::= { mioxPeerEncEntry 2 }
  1003.  
  1004.           -- ###########################################################
  1005.  
  1006.           END
  1007.  
  1008.  
  1009.  
  1010. Throop                                                         [Page 18]
  1011.  
  1012. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  1013.  
  1014.  
  1015. 5.  Acknowledgements
  1016.  
  1017.    This document was produced by the x25mib working group:
  1018.  
  1019.                Fred Baker, ACC
  1020.                Art Berggreen, ACC
  1021.                Frank Bieser
  1022.                Gary Bjerke, Tandem
  1023.                Bill Bowman, HP
  1024.                Christopher Bucci, Datability
  1025.                Charles Carvalho, ACC
  1026.                Jeff Case, University of Tennessee at Knoxville
  1027.                Angela Chen, HP
  1028.                Carson Cheung, BNR
  1029.                Tom Daniel, Spider Systems
  1030.                Chuck Davin, MIT
  1031.                Billy Durham, Honeywell
  1032.                Richard Fox, Synoptics
  1033.                Doug Geller, Data General
  1034.                Herve Goguely, LIR Corp
  1035.                Andy Goldthorpe, British-Telecom
  1036.                Walter D. Guilarte
  1037.                David Gurevich
  1038.                Steve Huston, Consultant
  1039.                Jon Infante, ICL
  1040.                Frank Kastenholz, FTP Software
  1041.                Zbigniew Kielczewski, Eicon
  1042.                Cheryl Krupezak, Georgia Tech
  1043.                Mats Lindstrom, Diab Data AB
  1044.                Andrew Malis, BBN
  1045.                Evan McGinnis, 3Com
  1046.                Gary (G.P.)Mussar, BNR
  1047.                Chandy Nilakantan, 3Com
  1048.                Randy Pafford, Data General
  1049.                Ragnar Paulson, The Software Group Limited
  1050.                Dave Perkins, Synoptics
  1051.                Walter Pinkarschewsky, DEC
  1052.                Karen Quidley, Data General
  1053.                Chris Ranch, Novell
  1054.                Paul S. Rarey, DHL Systems Inc.
  1055.                Jim Roche, Newbridge Research
  1056.                Philippe Roger, LIR Corp.
  1057.                Timon Sloane
  1058.                Mike Shand, DEC
  1059.                Brad Steina, Microcom
  1060.                Bob Stewart, Xyplex
  1061.                Tom Sullivan, Data General
  1062.                Rodney Thayer, Sable Technology Corporation
  1063.  
  1064.  
  1065.  
  1066. Throop                                                         [Page 19]
  1067.  
  1068. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  1069.  
  1070.  
  1071.                Mark Therieau, Microcom
  1072.                Jane Thorn, Data General
  1073.                Dean Throop, Data General
  1074.                Maurice Turcotte, Racal Datacom
  1075.                Mike Zendels, Data General
  1076.  
  1077. 6.  References
  1078.  
  1079.    [1] Rose M., and K. McCloghrie, "Structure and Identification of
  1080.        Management Information for TCP/IP-based internets", STD 16, RFC
  1081.        1155, Performance Systems International, Hughes LAN Systems, May
  1082.        1990.
  1083.  
  1084.    [2] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  1085.        Network Management Protocol", STD 15, RFC 1157, SNMP Research,
  1086.        Performance Systems International, Performance Systems
  1087.        International, MIT Laboratory for Computer Science, May 1990.
  1088.  
  1089.    [3] Rose, M. and K. McCloghrie, Editors, "Towards Concise MIB
  1090.        Definitions", STD 16, RFC 1212, Performance Systems
  1091.        International, Hughes LAN Systems, March 1991.
  1092.  
  1093.    [4] Rose M., Editor, "Management Information Base for Network
  1094.        Management of TCP/IP-based internets", STD 17, RFC 1213.
  1095.        Performance Systems International, March 1991.
  1096.  
  1097.    [5] "Information processing systems - Open Systems Interconnection -
  1098.        Specification of Abstract Syntax Notation One (ASN.1)",
  1099.        International Organization for Standardization.  International
  1100.        Standard 8824, December, 1987.
  1101.  
  1102.    [6] Stewart, B., Editor, "Definitions of Managed Objects for RS-232-
  1103.        like Hardware Devices", RFC 1317, Xyplex, Inc., April 1992.
  1104.  
  1105.    [7] Throop, D., and F. Baker, "SNMP MIB extension for X.25 LAPB", RFC
  1106.        1381, Data General Corporation, Advanced Computer Communications,
  1107.        November 1992.
  1108.  
  1109.    [8] Throop, D., Editor, "SNMP MIB extension for the X.25 Packet
  1110.        Layer", RFC 1382, Data General Corporation, November 1991.
  1111.  
  1112.    [9] Malis, A., Robinson, D., and R. Ullmann "Multiprotocol
  1113.        Interconnect on X.25 and ISDN in the Packet Mode", RFC 1356, BBN
  1114.        Communications, Computervision Systems Integration, Process
  1115.        Software Corporation, August 1992.
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122. Throop                                                         [Page 20]
  1123.  
  1124. RFC 1461        Multiprotocol Interconnect on X.25 MIB          May 1993
  1125.  
  1126.  
  1127. 7.  Security Considerations
  1128.  
  1129.    Security issues are not discussed in this memo.
  1130.  
  1131. 8.  Author's Address
  1132.  
  1133.    Dean D. Throop
  1134.    Data General Corporation
  1135.    62 Alexander Dr.
  1136.    Research Triangle Park, NC 27709
  1137.  
  1138.    Phone: (919) 248-6081
  1139.    EMail: throop@dg-rtp.dg.com
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. Throop                                                         [Page 21]
  1179.  
  1180.