home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_q_t / draft-ietf-snanau-dlurmib-02.txt < prev    next >
Text File  |  1997-05-12  |  37KB  |  1,242 lines
  1.  
  2.  
  3.                      Definitions of Managed Objects
  4.                                 for DLUR
  5.  
  6.                               May 10, 1997
  7.  
  8.  
  9.                          Bob Clouston (editor)
  10.                              Cisco Systems
  11.                            clouston@cisco.com
  12.  
  13.  
  14.  
  15.                            Bob Moore (editor)
  16.                             IBM Corporation
  17.                       remoore@ralvm6.vnet.ibm.com
  18.  
  19.  
  20.  
  21.                    <draft-ietf-snanau-dlurmib-02.txt>
  22.  
  23.  
  24.  
  25.  
  26. 1.  Status of this Memo
  27.  
  28. This document is an Internet-Draft.  Internet-Drafts are working
  29. documents of the Internet Engineering Task Force (IETF), its areas, and
  30. its working groups.  Note that other groups may also distribute working
  31. documents as Internet-Drafts.
  32.  
  33. Internet-Drafts are draft documents valid for a maximum of six months.
  34. Internet-Drafts may be updated, replaced, or obsoleted by other
  35. documents at any time.  It is not appropriate to use Internet-Drafts as
  36. reference material or to cite them other than as a working draft or work
  37. in progress.
  38.  
  39. To learn the current status of any Internet-Draft, please check the
  40. 1id-abstracts.txt listing contained in the Internet-Drafts Shadow
  41. Directories on ds.internic.net, nic.nordu.net, ftp.isi.edu, or
  42. munnari.oz.au.
  43.  
  44. 2.  Introduction
  45.  
  46. This memo defines a portion of the Management Information Base (MIB) for
  47. use with network management protocols in the Internet community.  In
  48. particular, it defines objects for monitoring and controlling network
  49.  
  50.  
  51.  
  52. Expires November 10, 1997                                       [Page 1]
  53.  
  54. Internet Draft              SNANAU DLUR MIB                     May 1997
  55.  
  56.  
  57. devices with DLUR (Dependent LU Requester) capabilities.  This memo
  58. identifies managed objects for the DLUR protocol.
  59.  
  60.  
  61. This memo does not specify a standard for the Internet community.
  62.  
  63. 3.  The SNMP Network Management Framework
  64.  
  65. The SNMP Network Management Framework consists of several components.
  66. For the purpose of this specification, the applicable components of the
  67. Framework are the SMI and related documents [1, 2, 3], which define the
  68. mechanisms used for describing and naming objects for the purpose of
  69. management.
  70.  
  71. The Framework permits new objects to be defined for the purpose of
  72. experimentation and evaluation.
  73.  
  74.  
  75. 4.  Overview
  76.  
  77. This document identifies objects for monitoring the configuration and
  78. active characteristics of devices with DLUR capabilities.  Dependent LU
  79. requester/server (DLUR/S) is an extension to the Advanced Peer-to-Peer
  80. Networking (APPN) architecture that provides dependent LU services in
  81. APPN networks.  See the SNANAU APPN MIB [4] for management of APPN
  82. networks.
  83.  
  84. The base APPN architecture only provided for transport of data between
  85. independent logical units (LUs).  However, customers have an enormous
  86. investment in applications based on dependent LU types. DLUR/S provides
  87. for support of dependent LU sessions in an APPN network.
  88.  
  89. A dependent LU server (DLUS) is an APPN node that provides System
  90. Services Control Point (SSCP) services over an APPN network to remote
  91. secondary dependent LUs by using SSCP-PU (physical unit) and SSCP-LU
  92. sessions whose flows are encapsulated on LU 6.2 session flows between
  93. the DLUS node and the appropriate dependent LU requester (DLUR) node.
  94. The secondary dependent LUs may be local to the DLUR node, or in
  95. adjacent type 2.0 or 2.1 nodes.
  96.  
  97. The LU 6.2 control sessions between a DLUS node and a DLUR node are
  98. referred to as a CPSVRMGR pipe.  CPSVRMGR refers to the mode used for
  99. the sessions.
  100.  
  101. In this document, we describe DLUR managed objects.
  102.  
  103.  
  104.  
  105.  
  106. Expires November 10, 1997                                       [Page 2]
  107.  
  108. Internet Draft              SNANAU DLUR MIB                     May 1997
  109.  
  110.  
  111. The DLUR terms and overall architecture are described in [5].
  112.  
  113. Highlights of the management functions supported by the DLUR MIB module
  114. include the following:
  115.  
  116.  
  117. o    Identifying the node's DLUR capabilities
  118.  
  119. o    Displaying the physical units (PUs) this node is supporting
  120.  
  121. o    Identification of Dependent LU Servers
  122.  
  123. o    Displaying the state of control sessions to Dependent LU Servers.
  124.  
  125.  
  126. This MIB module does not support:
  127.  
  128.  
  129. o    Management of dependent LU servers
  130.  
  131. o    Configuration of DLUR nodes.
  132.  
  133. o    Changing the state of control session to the DLUS
  134.  
  135. o    Displaying the dependent LUs this node is supporting
  136.  
  137. o    Traps.  The APPN MIB contains a trap for Alert conditions that may
  138.      affect DLUR resources.  The value for the affectedObject object
  139.      contained in the alertTrap is determined by the implementation.  It
  140.      may contain a VariablePointer from the DLUR MIB.  The APPN/DLUR
  141.      Alerts are defined in [6].
  142.  
  143.  
  144. 4.1.  DLUR MIB Structure
  145.  
  146. Although DLUR is an extension to APPN, the DLUR MIB relies very little
  147. upon the APPN MIB.  The dlurNodeCpName object in this MIB has the same
  148. value as the appnNodeCpName object in the APPN MIB.  If the dlurPuLsName
  149. object in the MIB has the same value as the appnLsName object in the
  150. APPN MIB, then the two objects are referring to the same link station.
  151.  
  152. The DLUR MIB module contains the following collections of objects:
  153.  
  154.  
  155. o    dlurNodeInfo--objects representing the capabilities and
  156.      architecture options supported by the DLUR implementation, as well
  157.  
  158.  
  159.  
  160. Expires November 10, 1997                                       [Page 3]
  161.  
  162. Internet Draft              SNANAU DLUR MIB                     May 1997
  163.  
  164.  
  165.      as default primary and backup DLUSs.
  166.  
  167. o    dlurPuInfo--objects describing the PUs that this APPN node is
  168.      supporting with DLUR.
  169.  
  170. o    dlurDlusInfo--objects describing the control sessions with DLUSs.
  171.  
  172.  
  173. These are described below in more detail.
  174.  
  175.  
  176. 4.1.1.  dlurNodeInfo group
  177.  
  178. The dlurNodeInfo group consists of the following objects and table:
  179.  
  180. 1) dlurNodeCapabilities group
  181.  
  182. These objects represent the capabilities and options of the DLUR
  183. implementation, such as the release level of the implementation
  184.  
  185. 2) dlurDefaultDefBackupDlusTable
  186.  
  187. This table identifies the list of defined backup DLUSs for all PUs
  188. served by this DLUR, if there is no specific DLUS backup list for the
  189. PU.  The list is in descending order of preference as a backup DLUS.
  190.  
  191.  
  192. 4.1.2.  dlurPuInfo group
  193.  
  194. The dlurPuInfo group consists of the following tables:
  195.  
  196. 1) dlurPuTable
  197.  
  198. This table has an entry for each PU this node is supporting via DLUR,
  199. including the locally known name, the SSCP supplied name (if known), and
  200. the PU status.
  201.  
  202. 2) dlurPuDefBackupDlusTable
  203.  
  204. This table contains the backup DLUS list defined on a PU basis.  The
  205. table has an entry for each specifically defined backup DLUS on each PU.
  206. The first index to the entry is the PU name, which organizes the table
  207. by PU name. The second index is a ranking which further sorts the table
  208. in descending order of preference as a backup DLUS for the PU.
  209.  
  210. If a PU name is not found in this table, the
  211.  
  212.  
  213.  
  214. Expires November 10, 1997                                       [Page 4]
  215.  
  216. Internet Draft              SNANAU DLUR MIB                     May 1997
  217.  
  218.  
  219. dlurDefaultDefBackupDlusNameTable is used as a backup list for that PU.
  220.  
  221.  
  222. 4.1.3.  dlurDlusInfo group
  223.  
  224. This group consists of the following table:
  225.  
  226. 1) dlurDlusTable
  227.  
  228. This table contains information about the control sessions (CPSVRMGR
  229. pipes) with the DLUS, including the control point (CP) name of the DLUS
  230. and the status of the control session.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. Expires November 10, 1997                                       [Page 5]
  269.  
  270. Internet Draft              SNANAU DLUR MIB                     May 1997
  271.  
  272.  
  273. 5.  Definitions
  274.  
  275. APPN-DLUR-MIB DEFINITIONS ::= BEGIN
  276.  
  277. IMPORTS
  278.         DisplayString, TruthValue
  279.                 FROM SNMPv2-TC
  280.  
  281.         OBJECT-TYPE, MODULE-IDENTITY, Unsigned32
  282.                 FROM SNMPv2-SMI
  283.  
  284.         MODULE-COMPLIANCE, OBJECT-GROUP
  285.                 FROM SNMPv2-CONF
  286.  
  287.         snanauMIB
  288.                 FROM SNA-NAU-MIB
  289.  
  290.         SnaControlPointName
  291.                 FROM APPN-MIB;
  292.  
  293. dlurMIB MODULE-IDENTITY
  294.         LAST-UPDATED  "9705101500Z"
  295.         ORGANIZATION  "IETF SNA NAU MIB WG / AIW APPN/HPR MIBs SIG"
  296.         CONTACT-INFO
  297.  
  298.                 "
  299.                         Bob Clouston
  300.                         Cisco Systems
  301.                         7025 Kit Creek Road
  302.                         P.O. Box 14987
  303.                         Research Triangle Park, NC 27709, USA
  304.                         Tel:    1 919 472 2333
  305.                         E-mail: clouston@cisco.com
  306.  
  307.                         Bob Moore
  308.                         IBM Corporation
  309.                         800 Park Offices Drive
  310.                         RHJA/664
  311.                         P.O. Box 12195
  312.                         Research Triangle Park, NC 27709, USA
  313.                         Tel:    1 919 254 4436
  314.                         E-mail: remoore@ralvm6.vnet.ibm.com
  315.                 "
  316.       DESCRIPTION
  317.                 "This is the MIB module for objects used to manage
  318.                 network devices with DLUR capabilities.  This MIB
  319.  
  320.  
  321.  
  322. Expires November 10, 1997                                       [Page 6]
  323.  
  324. Internet Draft              SNANAU DLUR MIB                     May 1997
  325.  
  326.  
  327.                 contains information that is useful for managing an APPN
  328.                 product that implements a DLUR (Dependent Logical Unit
  329.                 Requester).  The DLUR product has a client/server
  330.                 relationship with an APPN product that implements a DLUS
  331.                 (Dependent Logical Unit Server)."
  332.  
  333. ::= { snanauMIB 5 }
  334. -- snanauMIB ::= { mib-2 34 }
  335.  
  336. -- *********************************************************************
  337. -- Textual Convention
  338. -- *********************************************************************
  339. -- SnaControlPointName is imported from the APPN MIB
  340.  
  341. -- *********************************************************************
  342.   dlurObjects OBJECT IDENTIFIER ::= { dlurMIB 1 }
  343. -- *********************************************************************
  344.  
  345.  
  346. dlurNodeInfo OBJECT IDENTIFIER ::= { dlurObjects 1 }
  347. -- *********************************************************************
  348. -- DLUR Capabilities of the node
  349. --
  350. --  This group represents the capabilities and options of the DLUR
  351. --  implementation.
  352. -- *********************************************************************
  353. dlurNodeCapabilities OBJECT IDENTIFIER ::= { dlurNodeInfo 1 }
  354.  
  355. dlurNodeCpName OBJECT-TYPE
  356.       SYNTAX SnaControlPointName
  357.       MAX-ACCESS read-only
  358.       STATUS current
  359.       DESCRIPTION
  360.           "Administratively assigned network name for the APPN node where
  361.           this DLUR implementation resides.  If this object has the same
  362.           value as the appnNodeCpName object in the APPN MIB, then the
  363.           two objects are referring to the same APPN node."
  364.  
  365.       ::= { dlurNodeCapabilities 1 }
  366.  
  367. dlurReleaseLevel OBJECT-TYPE
  368.       SYNTAX DisplayString (SIZE (2))
  369.       MAX-ACCESS read-only
  370.       STATUS current
  371.       DESCRIPTION
  372.           "The DLUR release level of this implementation.  This is the
  373.  
  374.  
  375.  
  376. Expires November 10, 1997                                       [Page 7]
  377.  
  378. Internet Draft              SNANAU DLUR MIB                     May 1997
  379.  
  380.  
  381.           value that is encoded in the DLUR/DLUS Capabilites (CV 51).
  382.           To insure consistent display, this one-byte value is encoded
  383.           here as two displayable characters that are equivalent to a
  384.           hexadecimal display.  For example, if the one-byte value as
  385.           encoded in CV51 is X'01', this object will contain the
  386.           displayable string '01'."
  387.  
  388.       ::= { dlurNodeCapabilities 2 }
  389.  
  390. dlurAnsSupport OBJECT-TYPE
  391.       SYNTAX INTEGER {
  392.                      continueOrStop(1),
  393.                      stopOnly(2)
  394.                      }
  395.       MAX-ACCESS read-only
  396.       STATUS current
  397.       DESCRIPTION
  398.           "Automatic Network Shutdown (ANS) capability of this node.
  399.  
  400.               -  'continueOrStop' indicates that the DLUR implementation
  401.                  supports either ANS value (continue or stop) as
  402.                  specified by the DLUS on ACTPU for each PU.
  403.  
  404.               -  'stopOnly' indicates that the DLUR implementation only
  405.                  supports the ANS value of stop.
  406.  
  407.            ANS = continue means that the DLUR node will keep LU-LU
  408.            sessions active even if SSCP-PU and SSCP-LU control sessions
  409.            are interrupted.
  410.  
  411.            ANS = stop means that LU-LU sessions will be interrupted when
  412.            the SSCP-PU and SSCP-LU sessions are interrupted."
  413.  
  414.       ::= { dlurNodeCapabilities 3 }
  415.  
  416. dlurMultiSubnetSupport OBJECT-TYPE
  417.       SYNTAX TruthValue
  418.       MAX-ACCESS read-only
  419.       STATUS current
  420.       DESCRIPTION
  421.           "Indication of whether this DLUR implementation can support
  422.           CPSVRMGR sessions that cross NetId boundaries."
  423.  
  424.       ::= { dlurNodeCapabilities 4 }
  425.  
  426. dlurDefaultDefPrimDlusName OBJECT-TYPE
  427.  
  428.  
  429.  
  430. Expires November 10, 1997                                       [Page 8]
  431.  
  432. Internet Draft              SNANAU DLUR MIB                     May 1997
  433.  
  434.  
  435.       SYNTAX SnaControlPointName
  436.       MAX-ACCESS read-only
  437.       STATUS current
  438.       DESCRIPTION
  439.           "The SNA name of the defined default primary DLUS for all of
  440.           the PUs served by this DLUR.  This can be overridden for a
  441.           particular PU by a defined primary DLUS for that PU,
  442.           represented by the dlurPuDefPrimDlusName object."
  443.  
  444.       ::= { dlurNodeCapabilities 5 }
  445.  
  446. dlurNetworkNameForwardingSupport OBJECT-TYPE
  447.       SYNTAX TruthValue
  448.       MAX-ACCESS read-only
  449.       STATUS current
  450.       DESCRIPTION
  451.           "Indication of whether this DLUR implementation supports
  452.           forwarding of Network Name control vectors on ACTPUs and
  453.           ACTLUs to DLUR-served PUs and their associated LUs.
  454.  
  455.           This object corresponds to byte 9. bit 3 of cv51."
  456.  
  457.       ::= { dlurNodeCapabilities 6 }
  458.  
  459. dlurNondisDlusDlurSessDeactSup OBJECT-TYPE
  460.       SYNTAX TruthValue
  461.       MAX-ACCESS read-only
  462.       STATUS current
  463.       DESCRIPTION
  464.           "Indication of whether this DLUR implementation supports
  465.           nondisruptive deactivation of its DLUR-DLUS sessions.
  466.           Upon receiving from a DLUS an UNBIND for the CPSVRMGR pipe
  467.           with sense data X'08A0 000B', a DLUR that supports this
  468.           option immediately begins attempting to activate a CPSVRMGR
  469.           pipe with a DLUS other than the one that sent the UNBIND.
  470.  
  471.           This object corresponds to byte 9. bit 4 of cv51."
  472.  
  473.       ::= { dlurNodeCapabilities 7 }
  474.  
  475. -- *********************************************************************
  476. -- DLUR default defined backup DLUS table
  477. -- *********************************************************************
  478.  
  479. dlurDefaultDefBackupDlusTable OBJECT-TYPE
  480.       SYNTAX SEQUENCE OF DlurDefaultDefBackupDlusEntry
  481.  
  482.  
  483.  
  484. Expires November 10, 1997                                       [Page 9]
  485.  
  486. Internet Draft              SNANAU DLUR MIB                     May 1997
  487.  
  488.  
  489.       MAX-ACCESS not-accessible
  490.       STATUS current
  491.       DESCRIPTION
  492.           "This table contains an ordered list of defined backup DLUSs
  493.           for all of the PUs served by this DLUR.  These can be
  494.           overridden for a particular PU by a list of defined backup
  495.           DLUSs for that PU, represented by the
  496.           dlurPuDefBackupDlusNameTable.  Entries in this table are
  497.           ordered from most preferred default backup DLUS to least
  498.           preferred."
  499.  
  500.       ::= { dlurNodeInfo 2 }
  501.  
  502. dlurDefaultDefBackupDlusEntry OBJECT-TYPE
  503.       SYNTAX DlurDefaultDefBackupDlusEntry
  504.       MAX-ACCESS not-accessible
  505.       STATUS current
  506.       DESCRIPTION
  507.           "This table is indexed by an integer-valued index, which
  508.           orders the entries from most preferred default backup DLUS
  509.           to least preferred."
  510.  
  511.       INDEX { dlurDefaultDefBackupDlusIndex }
  512.  
  513.       ::= { dlurDefaultDefBackupDlusTable 1 }
  514.  
  515. DlurDefaultDefBackupDlusEntry ::= SEQUENCE {
  516.       dlurDefaultDefBackupDlusIndex      Unsigned32,
  517.       dlurDefaultDefBackupDlusName       SnaControlPointName
  518.                      }
  519.  
  520. dlurDefaultDefBackupDlusIndex OBJECT-TYPE
  521.       SYNTAX Unsigned32 (1..4294967295)
  522.       MAX-ACCESS not-accessible
  523.       STATUS current
  524.       DESCRIPTION
  525.           "Index for this table.  The index values start at 1,
  526.           which identifies the most preferred default backup DLUS."
  527.  
  528.       ::= { dlurDefaultDefBackupDlusEntry 1 }
  529.  
  530. dlurDefaultDefBackupDlusName OBJECT-TYPE
  531.       SYNTAX SnaControlPointName
  532.       MAX-ACCESS read-only
  533.       STATUS current
  534.       DESCRIPTION
  535.  
  536.  
  537.  
  538. Expires November 10, 1997                                      [Page 10]
  539.  
  540. Internet Draft              SNANAU DLUR MIB                     May 1997
  541.  
  542.  
  543.           "Fully qualified name of a default backup DLUS for PUs served
  544.           by this DLUR."
  545.  
  546.       ::= { dlurDefaultDefBackupDlusEntry 2 }
  547.  
  548. -- *********************************************************************
  549. -- PU Information
  550. --
  551. --  The following table carries information about the PUs that this APPN
  552. --  node is supporting via DLUR.
  553. -- *********************************************************************
  554. dlurPuInfo OBJECT IDENTIFIER ::= { dlurObjects 2 }
  555.  
  556. dlurPuTable OBJECT-TYPE
  557.       SYNTAX SEQUENCE OF DlurPuEntry
  558.       MAX-ACCESS not-accessible
  559.       STATUS current
  560.       DESCRIPTION
  561.           "Information about the PUs supported by this DLUR."
  562.  
  563.       ::= { dlurPuInfo 1 }
  564.  
  565. dlurPuEntry OBJECT-TYPE
  566.       SYNTAX DlurPuEntry
  567.       MAX-ACCESS not-accessible
  568.       STATUS current
  569.       DESCRIPTION
  570.           "Entry in a table of PU information, indexed by PU name."
  571.  
  572.       INDEX { dlurPuName  }
  573.  
  574.       ::= { dlurPuTable 1 }
  575.  
  576. DlurPuEntry ::= SEQUENCE {
  577.       dlurPuName                  DisplayString,
  578.       dlurPuSscpSuppliedName      DisplayString,
  579.       dlurPuStatus                INTEGER,
  580.       dlurPuAnsSupport            INTEGER,
  581.       dlurPuLocation              INTEGER,
  582.       dlurPuLsName                DisplayString,
  583.       dlurPuDlusSessnStatus       INTEGER,
  584.       dlurPuActiveDlusName        DisplayString,
  585.       dlurPuDefPrimDlusName       DisplayString
  586.                      }
  587.  
  588. dlurPuName OBJECT-TYPE
  589.  
  590.  
  591.  
  592. Expires November 10, 1997                                      [Page 11]
  593.  
  594. Internet Draft              SNANAU DLUR MIB                     May 1997
  595.  
  596.  
  597.       SYNTAX DisplayString (SIZE (1..17))
  598.       MAX-ACCESS not-accessible
  599.       STATUS current
  600.       DESCRIPTION
  601.           "Locally administered name of the PU."
  602.  
  603.       ::= { dlurPuEntry 1 }
  604.  
  605.  
  606. dlurPuSscpSuppliedName OBJECT-TYPE
  607.       SYNTAX DisplayString (SIZE (0..17))
  608.       MAX-ACCESS read-only
  609.       STATUS current
  610.       DESCRIPTION
  611.           "The SNA name of the PU.  This value is supplied to a PU by the
  612.           SSCP that activated it.  If a value has not been supplied, a
  613.           zero-length string is returned."
  614.  
  615.       ::= { dlurPuEntry 2 }
  616.  
  617. dlurPuStatus OBJECT-TYPE
  618.       SYNTAX INTEGER {
  619.                       reset(1),
  620.                       pendReqActpuRsp(2),
  621.                       pendActpu(3),
  622.                       pendActpuRsp(4),
  623.                       active(5),
  624.                       pendLinkact(6),
  625.                       pendDactpuRsp(7),
  626.                       pendInop(8),
  627.                       pendInopActpu(9)
  628.                      }
  629.       MAX-ACCESS read-only
  630.       STATUS current
  631.       DESCRIPTION
  632.           "Status of the DLUR-supported PU.  The following values are
  633.           defined:
  634.  
  635.              reset(1)           -  reset
  636.              pendReqActpuRsp(2) -  pending a response from the DLUS
  637.                                    to a Request ACTPU
  638.              pendActpu(3)       -  pending an ACTPU from the DLUS
  639.              pendActpuRsp(4)    -  pending an ACTPU response from the PU
  640.              active(5)          -  active
  641.              pendLinkact(6)     -  pending activation of the link to a
  642.                                    downstream PU
  643.  
  644.  
  645.  
  646. Expires November 10, 1997                                      [Page 12]
  647.  
  648. Internet Draft              SNANAU DLUR MIB                     May 1997
  649.  
  650.  
  651.              pendDactpuRsp(7)   -  pending a DACTPU response from the PU
  652.              pendInop(8)        -  the CPSVRMGR pipe became inoperative
  653.                                    while the DLUR was pending an ACTPU
  654.                                    response from the PU
  655.              pendInopActpu(9)   -  when the DLUR was in the pendInop
  656.                                    state, a CPSVRMGR pipe became active
  657.                                    and a new ACTPU was received over it,
  658.                                    before a response to the previous
  659.                                    ACTPU was received from the PU."
  660.  
  661.       ::= { dlurPuEntry 3 }
  662.  
  663. dlurPuAnsSupport OBJECT-TYPE
  664.       SYNTAX INTEGER {
  665.                      continue(1),
  666.                      stop(2)
  667.                      }
  668.       MAX-ACCESS read-only
  669.       STATUS current
  670.       DESCRIPTION
  671.           "The Automatic Network Shutdown (ANS) support configured for
  672.           this PU.  This value (as configured by the network
  673.           administrator) is sent by DLUS with ACTPU for each PU.
  674.  
  675.               -  'continue' means that the DLUR node will attempt to keep
  676.                  LU-LU sessions active even if SSCP-PU and SSCP-LU
  677.                  control sessions are interrupted.
  678.  
  679.               -  'stop' means that LU-LU sessions will be interrupted
  680.                  when the SSCP-PU and SSCP-LU sessions are interrupted."
  681.  
  682.       ::= { dlurPuEntry 4 }
  683.  
  684. dlurPuLocation OBJECT-TYPE
  685.       SYNTAX INTEGER {
  686.                       internal(1),
  687.                       downstream(2) }
  688.       MAX-ACCESS read-only
  689.       STATUS current
  690.       DESCRIPTION
  691.           "Location of the DLUR-support PU:
  692.               internal(1)   - internal to the APPN node itself (no link)
  693.               downstream(2) - downstream of the APPN node (connected via
  694.                               a link)."
  695.  
  696.       ::= { dlurPuEntry 5 }
  697.  
  698.  
  699.  
  700. Expires November 10, 1997                                      [Page 13]
  701.  
  702. Internet Draft              SNANAU DLUR MIB                     May 1997
  703.  
  704.  
  705. dlurPuLsName OBJECT-TYPE
  706.       SYNTAX DisplayString (SIZE (0..10))
  707.       MAX-ACCESS read-only
  708.       STATUS current
  709.       DESCRIPTION
  710.           "Administratively assigned name of the link station through
  711.           which a downstream PU is connected to this DLUR.  A zero-length
  712.           string is returned for internal PUs.  If this object has the
  713.           same value as the appnLsName object in the APPN MIB, then the
  714.           two are identifying the same link station."
  715.  
  716.       ::= { dlurPuEntry 6 }
  717.  
  718. dlurPuDlusSessnStatus OBJECT-TYPE
  719.       SYNTAX INTEGER {
  720.                       reset(1),
  721.                       pendingActive(2),
  722.                       active(3),
  723.                       pendingInactive(4)
  724.                      }
  725.       MAX-ACCESS read-only
  726.       STATUS current
  727.       DESCRIPTION
  728.           "Status of the control session to the DLUS identified in
  729.           dlurPuActiveDlusName.  This is a combination of the separate
  730.           states for the contention-winner and contention-loser sessions:
  731.  
  732.           reset(1)           - none of the cases below
  733.           pendingActive(2)   - either contention-winner session or
  734.                                contention-loser session is pending active
  735.           active(3)          - contention-winner and contention-loser
  736.                                sessions are both active
  737.           pendingInactive(4) - either contention-winner session or
  738.                                contention-loser session is pending
  739.                                inactive - this test is made AFTER the
  740.                                'pendingActive' test.
  741.  
  742.           The following matrix provides a different representation of
  743.           how the values of this object are related to the individual
  744.           states of the contention-winner and contention-loser sessions:
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754. Expires November 10, 1997                                      [Page 14]
  755.  
  756. Internet Draft              SNANAU DLUR MIB                     May 1997
  757.  
  758.  
  759.                Conwinner
  760.                | pA | pI | A | X = !(pA | pI | A)
  761.           C ++++++++++++++++++++++++++++++++++
  762.           o pA | 2  |  2 | 2 | 2
  763.           n ++++++++++++++++++++++++++++++++++
  764.           l pI | 2  |  4 | 4 | 4
  765.           o ++++++++++++++++++++++++++++++++++
  766.           s A  | 2  |  4 | 3 | 1
  767.           e ++++++++++++++++++++++++++++++++++
  768.           r X  | 2  |  4 | 1 | 1
  769.             ++++++++++++++++++++++++++++++++++
  770.           "
  771.  
  772.       ::= { dlurPuEntry 7 }
  773.  
  774. dlurPuActiveDlusName OBJECT-TYPE
  775.       SYNTAX DisplayString (SIZE (0..17))
  776.       MAX-ACCESS read-only
  777.       STATUS current
  778.       DESCRIPTION
  779.           "The SNA name of the active DLUS for this PU.  If its length
  780.           is not zero, this name follows the SnaControlPointName textual
  781.           convention.  A zero-length string indicates that the PU does
  782.           not currently have an active DLUS."
  783.  
  784.       ::= { dlurPuEntry 8 }
  785.  
  786. dlurPuDefPrimDlusName OBJECT-TYPE
  787.       SYNTAX DisplayString (SIZE (0..17))
  788.       MAX-ACCESS read-only
  789.       STATUS current
  790.       DESCRIPTION
  791.           "The SNA name of the defined primary DLUS for this PU, if one
  792.           has been defined.  If present, this name follows the
  793.           SnaControlPointName textual convention.  A zero-length string
  794.           indicates that no primary DLUS has been defined for this PU, in
  795.           which case the global default represented by the
  796.           dlurDefaultDefPrimDlusName object is used."
  797.  
  798.       ::= { dlurPuEntry 9 }
  799.  
  800. -- *****************************************
  801. -- Defined backup DLUS table for a PU
  802. -- *****************************************
  803.  
  804. dlurPuDefBackupDlusTable OBJECT-TYPE
  805.  
  806.  
  807.  
  808. Expires November 10, 1997                                      [Page 15]
  809.  
  810. Internet Draft              SNANAU DLUR MIB                     May 1997
  811.  
  812.  
  813.       SYNTAX SEQUENCE OF DlurPuDefBackupDlusEntry
  814.       MAX-ACCESS not-accessible
  815.       STATUS current
  816.       DESCRIPTION
  817.           "This table contains an ordered list of defined backup DLUSs
  818.           for those PUs served by this DLUR that have their own defined
  819.           backup DLUSs.  PUs that have no entries in this table use the
  820.           global default backup DLUSs for the DLUR, represented by the
  821.           dlurDefaultDefBackupDlusNameTable.  Entries in this table are
  822.           ordered from most preferred backup DLUS to least preferred for
  823.           each PU."
  824.  
  825.       ::= { dlurPuInfo 2 }
  826.  
  827. dlurPuDefBackupDlusEntry OBJECT-TYPE
  828.       SYNTAX DlurPuDefBackupDlusEntry
  829.       MAX-ACCESS not-accessible
  830.       STATUS current
  831.       DESCRIPTION
  832.           "This table is indexed by PU name and by an integer-valued
  833.           index, which orders the entries from most preferred backup DLUS
  834.           for the PU to least preferred."
  835.  
  836.       INDEX { dlurPuDefBackupDlusPuName,
  837.               dlurPuDefBackupDlusIndex }
  838.  
  839.       ::= { dlurPuDefBackupDlusTable 1 }
  840.  
  841. DlurPuDefBackupDlusEntry ::= SEQUENCE {
  842.       dlurPuDefBackupDlusPuName          DisplayString,
  843.       dlurPuDefBackupDlusIndex           Unsigned32,
  844.       dlurPuDefBackupDlusName            SnaControlPointName
  845.                      }
  846.  
  847. dlurPuDefBackupDlusPuName OBJECT-TYPE
  848.       SYNTAX DisplayString (SIZE (1..17))
  849.       MAX-ACCESS not-accessible
  850.       STATUS current
  851.       DESCRIPTION
  852.           "Locally administered name of the PU.  If this object has the
  853.           same value as the dlurPuName object, then the two are
  854.           identifying the same PU."
  855.  
  856.       ::= { dlurPuDefBackupDlusEntry 1 }
  857.  
  858. dlurPuDefBackupDlusIndex OBJECT-TYPE
  859.  
  860.  
  861.  
  862. Expires November 10, 1997                                      [Page 16]
  863.  
  864. Internet Draft              SNANAU DLUR MIB                     May 1997
  865.  
  866.  
  867.       SYNTAX Unsigned32 (1..4294967295)
  868.       MAX-ACCESS not-accessible
  869.       STATUS current
  870.       DESCRIPTION
  871.           "Secondary index for this table.  The index values start at 1,
  872.           which identifies the most preferred backup DLUS for the PU."
  873.  
  874.       ::= { dlurPuDefBackupDlusEntry 2 }
  875.  
  876. dlurPuDefBackupDlusName OBJECT-TYPE
  877.       SYNTAX SnaControlPointName
  878.       MAX-ACCESS read-only
  879.       STATUS current
  880.       DESCRIPTION
  881.           "Fully qualified name of a backup DLUS for this PU."
  882.  
  883.       ::= { dlurPuDefBackupDlusEntry 3 }
  884.  
  885. -- *********************************************************************
  886. --               DLUS Control Sessions (CPSVRMGR Pipes)
  887. --
  888. --  This table contains information about DLUS control sessions, also
  889. --  known as CPSVRMGR pipes.  Although DLUR uses a pair of CPSVRMGR
  890. --  sessions for communication, for the purpose of status, information
  891. --  about these two sessions is combined to yield a single status for the
  892. --  requester/server connection.
  893. -- *********************************************************************
  894.  
  895. dlurDlusInfo OBJECT IDENTIFIER ::= { dlurObjects 3 }
  896.  
  897. dlurDlusTable OBJECT-TYPE
  898.       SYNTAX SEQUENCE OF DlurDlusEntry
  899.       MAX-ACCESS not-accessible
  900.       STATUS current
  901.       DESCRIPTION
  902.            "Information about DLUS control sessions."
  903.  
  904.       ::= { dlurDlusInfo 1}
  905.  
  906. dlurDlusEntry OBJECT-TYPE
  907.       SYNTAX DlurDlusEntry
  908.       MAX-ACCESS not-accessible
  909.       STATUS current
  910.       DESCRIPTION
  911.            "This entry is indexed by the name of the DLUS."
  912.  
  913.  
  914.  
  915.  
  916. Expires November 10, 1997                                      [Page 17]
  917.  
  918. Internet Draft              SNANAU DLUR MIB                     May 1997
  919.  
  920.  
  921.       INDEX { dlurDlusName }
  922.  
  923.       ::= { dlurDlusTable 1 }
  924.  
  925. DlurDlusEntry ::= SEQUENCE {
  926.       dlurDlusName          SnaControlPointName,
  927.       dlurDlusSessnStatus   INTEGER
  928.                      }
  929.  
  930. dlurDlusName OBJECT-TYPE
  931.       SYNTAX SnaControlPointName
  932.       MAX-ACCESS not-accessible
  933.       STATUS current
  934.       DESCRIPTION
  935.           "The SNA name of a DLUS with which this DLUR currently has a
  936.           CPSVRMGR pipe established."
  937.  
  938.       ::= { dlurDlusEntry 1 }
  939.  
  940. dlurDlusSessnStatus OBJECT-TYPE
  941.       SYNTAX INTEGER {
  942.                       reset(1),
  943.                       pendingActive(2),
  944.                       active(3),
  945.                       pendingInactive(4)
  946.                      }
  947.       MAX-ACCESS read-only
  948.       STATUS current
  949.       DESCRIPTION
  950.           "Status of the CPSVRMGR pipe between the DLUR and this DLUS.
  951.           This is a combination of the separate states for the
  952.           contention-winner and contention-loser sessions:
  953.  
  954.           reset(1)           - none of the cases below
  955.           pendingActive(2)   - either contention-winner session or
  956.                                contention-loser session is pending active
  957.           active(3)          - contention-winner and contention-loser
  958.                                sessions are both active
  959.           pendingInactive(4) - either contention-winner session or
  960.                                contention-loser session is pending
  961.                                inactive - this test is made AFTER the
  962.                                'pendingActive' test.
  963.  
  964.           The following matrix provides a different representation of
  965.           how the values of this object are related to the individual
  966.           states of the contention-winner and contention-loser sessions:
  967.  
  968.  
  969.  
  970. Expires November 10, 1997                                      [Page 18]
  971.  
  972. Internet Draft              SNANAU DLUR MIB                     May 1997
  973.  
  974.  
  975.                Conwinner
  976.                | pA | pI | A | X = !(pA | pI | A)
  977.           C ++++++++++++++++++++++++++++++++++
  978.           o pA | 2  |  2 | 2 | 2
  979.           n ++++++++++++++++++++++++++++++++++
  980.           l pI | 2  |  4 | 4 | 4
  981.           o ++++++++++++++++++++++++++++++++++
  982.           s A  | 2  |  4 | 3 | 1
  983.           e ++++++++++++++++++++++++++++++++++
  984.           r X  | 2  |  4 | 1 | 1
  985.             ++++++++++++++++++++++++++++++++++
  986.           "
  987.  
  988.       ::= { dlurDlusEntry 2 }
  989.  
  990. -- ***************************************************************
  991. -- Conformance information
  992. -- ***************************************************************
  993.  
  994. dlurConformance       OBJECT IDENTIFIER ::= { dlurMIB 2 }
  995.  
  996. dlurCompliances       OBJECT IDENTIFIER ::= { dlurConformance 1 }
  997. dlurGroups            OBJECT IDENTIFIER ::= { dlurConformance 2 }
  998.  
  999. -- Compliance statements
  1000.  
  1001. dlurCompliance MODULE-COMPLIANCE
  1002.       STATUS current
  1003.       DESCRIPTION
  1004.           "The compliance statement for the SNMPv2 entities which
  1005.           implement the DLUR MIB."
  1006.  
  1007.       MODULE -- this module
  1008.  
  1009. --    Unconditionally mandatory groups
  1010.       MANDATORY-GROUPS  { dlurConfGroup }
  1011.  
  1012.       ::= { dlurCompliances 1 }
  1013.  
  1014. -- Units of conformance
  1015. dlurConfGroup OBJECT-GROUP
  1016.       OBJECTS {
  1017.                dlurNodeCpName,
  1018.                dlurReleaseLevel,
  1019.                dlurAnsSupport,
  1020.                dlurMultiSubnetSupport,
  1021.  
  1022.  
  1023.  
  1024. Expires November 10, 1997                                      [Page 19]
  1025.  
  1026. Internet Draft              SNANAU DLUR MIB                     May 1997
  1027.  
  1028.  
  1029.                dlurNetworkNameForwardingSupport,
  1030.                dlurNondisDlusDlurSessDeactSup,
  1031.                dlurDefaultDefPrimDlusName,
  1032.                dlurDefaultDefBackupDlusName,
  1033.                dlurPuSscpSuppliedName,
  1034.                dlurPuStatus,
  1035.                dlurPuAnsSupport,
  1036.                dlurPuLocation,
  1037.                dlurPuLsName,
  1038.                dlurPuDlusSessnStatus,
  1039.                dlurPuActiveDlusName,
  1040.                dlurPuDefPrimDlusName,
  1041.                dlurPuDefBackupDlusName,
  1042.                dlurDlusSessnStatus
  1043.               }
  1044.       STATUS current
  1045.       DESCRIPTION
  1046.           "A collection of objects providing information on an
  1047.           implementation of APPN DLUR."
  1048.  
  1049.       ::= { dlurGroups 1 }
  1050.  
  1051. -- end of conformance statement
  1052.  
  1053. END
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078. Expires November 10, 1997                                      [Page 20]
  1079.  
  1080. Internet Draft              SNANAU DLUR MIB                     May 1997
  1081.  
  1082.  
  1083. 6.  Acknowledgments
  1084.  
  1085. This MIB module is the product of the IETF SNA NAU MIB WG and the AIW
  1086. APPN/HPR MIBs SIG.
  1087.  
  1088.  
  1089. 7.  References
  1090.  
  1091.  
  1092. [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  1093.      Waldbusser, "Structure of Management Information for version 2 of
  1094.      the Simple Network Management Protocol (SNMPv2)", RFC 1902, January
  1095.      1996.
  1096.  
  1097. [2]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  1098.      Waldbusser, "Textual Conventions for Version 2 of the Simple
  1099.      Network Management Protocol (SNMPv2)", RFC 1903, January 1996.
  1100.  
  1101. [3]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  1102.      Waldbusser, "Conformance Statements for Version 2 of the Simple
  1103.      Network Management Protocol (SNMPv2)", RFC 1904, January 1996.
  1104.  
  1105. [4]  Clouston, B., and B. Moore, "Definition of Managed Objects for
  1106.      APPN", Cisco Systems, IBM Corporation, November 1996.
  1107.  
  1108. [5]  IBM, Systems Network Architecture Advanced Peer-to-Peer Networking
  1109.      Dependent LU Requester Architecture Reference, Version 1.2, SV40-
  1110.      1010-01, December 1995,
  1111.  
  1112. [6]  IBM, SNA/MS Formats, GC31-8302-00
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132. Expires November 10, 1997                                      [Page 21]
  1133.  
  1134. Internet Draft              SNANAU DLUR MIB                     May 1997
  1135.  
  1136.  
  1137. 8.  Security Considerations
  1138.  
  1139. In most cases, MIBs are not themselves security risks; if SNMP security
  1140. is operating as intended, the use of a MIB to view information about a
  1141. system, or to change some parameter at the system, is a tool, not a
  1142. threat.
  1143.  
  1144. None of the read-only objects in the DLUR MIB reports a password, user
  1145. data, or anything else that is particularly sensitive.  Some enterprises
  1146. view their network configuration itself, as well as information about
  1147. network usage and performance, as corporate assets; such enterprises may
  1148. wish to restrict SNMP access to most of the objects in the MIB.
  1149.  
  1150. There are no read-write objects in the DLUR MIB.
  1151.  
  1152.  
  1153. 9.  Authors' Addresses
  1154.  
  1155. Bob Clouston
  1156. Cisco Systems
  1157. 7025 Kit Creek Road
  1158. P.O. Box 14987
  1159. Research Triangle Park, NC 27709, USA
  1160.  
  1161. Tel:    1 919 472 2333
  1162. E-mail: clouston@cisco.com
  1163.  
  1164.  
  1165. Bob Moore
  1166. IBM Corporation
  1167. 800 Park Offices Drive
  1168. CNMA/664
  1169. P.O. Box 12195
  1170. Research Triangle Park, NC 27709, USA
  1171.  
  1172. Tel:    1 919 254 4436
  1173. E-mail: remoore@ralvm6.vnet.ibm.com
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186. Expires November 10, 1997                                      [Page 22]
  1187.  
  1188. Internet Draft              SNANAU DLUR MIB                     May 1997
  1189.  
  1190.  
  1191. 10.  Table of Contents
  1192.  
  1193.  
  1194.    1.     Status of this Memo  ....................................  1
  1195.    2.     Introduction  ...........................................  1
  1196.    3.     The SNMP Network Management Framework  ..................  2
  1197.    4.     Overview  ...............................................  2
  1198.    4.1      DLUR MIB structure ....................................  3
  1199.    5.     Definitions  ............................................  6
  1200.    6.     Acknowledgments  ........................................  21
  1201.    7.     References  .............................................  21
  1202.    8.     Security Considerations  ................................  22
  1203.    9.     Author's Addresses  .....................................  22
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240. Expires November 10, 1997                                      [Page 23]
  1241.  
  1242.