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