mibs/ietf/T11-FC-NAME-SERVER-MIB

   1 T11-FC-NAME-SERVER-MIB DEFINITIONS ::= BEGIN
   2
   3 -- The MIB for management of the Fibre Channel functionality which
   4 -- implements the Name Server function.
   5
   6 IMPORTS
   7     MODULE-IDENTITY,OBJECT-TYPE,
   8     NOTIFICATION-TYPE, Unsigned32,
   9     Counter32, Integer32, mib-2   FROM SNMPv2-SMI         -- [RFC2578]
  10     MODULE-COMPLIANCE, OBJECT-GROUP,
  11     NOTIFICATION-GROUP            FROM SNMPv2-CONF        -- [RFC2580]
  12     SnmpAdminString               FROM SNMP-FRAMEWORK-MIB -- [RFC3411]
  13     TruthValue, TEXTUAL-CONVENTION,
  14     TimeStamp                     FROM SNMPv2-TC          -- [RFC2579]
  15     fcmInstanceIndex, FcPortType,
  16     FcAddressIdOrZero, FcClasses,
  17     FcNameIdOrZero                FROM FC-MGMT-MIB        -- [FC-MGMT]
  18     T11FabricIndex                FROM T11-TC-MIB      -- [FC-FAM-MIB]
  19     t11FamLocalSwitchWwn
  20                       FROM T11-FC-FABRIC-ADDR-MGR-MIB; -- [FC-FAM-MIB]
  21
  22 t11FcNameServerMIB  MODULE-IDENTITY
  23     LAST-UPDATED "200603020000Z"
  24     ORGANIZATION "T11"
  25     CONTACT-INFO
  26             "     Claudio DeSanti
  27                   Cisco Systems, Inc.
  28                   170 West Tasman Drive
  29                   San Jose, CA 95134 USA
  30                   Phone: +1 408 853-9172
  31                   EMail: cds@cisco.com
  32
  33                   Keith McCloghrie
  34                   Cisco Systems, Inc.
  35                   170 West Tasman Drive
  36                   San Jose, CA USA 95134
  37                   Phone: +1 408-526-5260
  38                   EMail: kzm@cisco.com"
  39     DESCRIPTION
  40            "The MIB module for the management of the functionality,
  41            which realizes the FC-GS-4 requirements for Name
  42            Server (NS).
  43
  44            Copyright (C) The Internet Society (2006).  This version of
  45            this MIB module is part of RFC 4438; see the RFC itself for
  46            full legal notices."
  47
  48
  49
  50     REVISION    "200603020000Z"
  51     DESCRIPTION
  52            "Initial version of this MIB module, published as RFC 4438."
  53     ::= { mib-2 135 }
  54
  55 t11NsNotifications    OBJECT IDENTIFIER ::= { t11FcNameServerMIB 0 }
  56 t11NsMIBObjects       OBJECT IDENTIFIER ::= { t11FcNameServerMIB 1 }
  57 t11NsMIBConformance   OBJECT IDENTIFIER ::= { t11FcNameServerMIB 2 }
  58 t11NsStatus           OBJECT IDENTIFIER ::= { t11NsMIBObjects 1 }
  59 t11NsStatistics       OBJECT IDENTIFIER ::= { t11NsMIBObjects 2 }
  60
  61 -- Textual Conventions
  62
  63 T11NsGs4RejectReasonCode ::= TEXTUAL-CONVENTION
  64     STATUS    current
  65     DESCRIPTION
  66         "The FC-GS-4 reject reason code for a request.
  67
  68          none(1)
  69              - no error.
  70          invalidCmdCode(2)
  71              - request contained an invalid command code.
  72          invalidVerLevel(3)
  73              - request contained an invalid version number.
  74          logicalError(4)
  75              - there was a logical error.
  76          invalidIUSize(5)
  77              - the CT_IU (Information Unit) size was invalid.
  78          logicalBusy(6)
  79              - the module is busy.
  80          protocolError(7)
  81              - there was a protocol error.
  82          unableToPerformCmdReq(8)
  83              - the command specified in the req could not be
  84                executed.  The details of exactly what failed
  85                will be in the corresponding reason code
  86                explanation.
  87          cmdNotSupported(9)
  88              - the command is not supported.
  89          serverNotAvailable(10)
  90              - the identified server was not available.
  91          couldNotEstabSession(11)
  92              - a server session could not be established.
  93          vendorError(12)
  94              - a vendor-specific error."
  95     REFERENCE
  96           "ANSI INCITS 387-2004, Fibre Channel - Generic
  97            Services-4 (FC-GS-4), section 4.4.3."
  98
  99
 100
 101     SYNTAX  INTEGER {
 102               none(1),
 103               invalidCmdCode(2),
 104               invalidVerLevel(3),
 105               logicalError(4),
 106               invalidIUSize(5),
 107               logicalBusy(6),
 108               protocolError(7),
 109               unableToPerformCmdReq(8),
 110               cmdNotSupported(9),
 111               serverNotAvailable(10),
 112               couldNotEstabSession(11),
 113               vendorError(12)
 114             }
 115
 116 T11NsRejReasonCodeExpl ::= TEXTUAL-CONVENTION
 117     STATUS    current
 118     DESCRIPTION
 119         "The reject reason code explanation:
 120
 121          noAdditionalExplanation(1)
 122              - no additional explanation.
 123          portIdentifierNotRegistered(2)
 124              - Port Identifier not registered.
 125          portNameNotRegistered(3)
 126              - Port Name not registered.
 127          nodeNameNotRegistered(4)
 128              - Node Name not registered.
 129          classOfServiceNotRegistered(5)
 130              - Class of Service not registered.
 131          nodeIpAddressNotRegistered(6)
 132              - 'IP Address (Node)' value not registered.
 133          ipaNotRegistered(7)
 134              - Initial Process Associator (IPA) not registered.
 135          fc4TypeNotRegistered(8)
 136              - FC-4 TYPEs not registered.
 137          symbolicPortNameNotRegistered(9)
 138              - Symbolic Port Name not registered.
 139          symbolicNodeNameNotRegistered(10)
 140              - Symbolic Node Name not registered.
 141          portTypeNotRegistered(11)
 142              - 'Port Type' not registered.
 143          portIpAddressNotRegistered(12)
 144              - 'IP Address (Port)' value not registered.
 145          fabricPortNameNotRegistered(13)
 146              - Fabric Port Name not registered.
 147          hardAddressNotRegistered(14)
 148              - 'Hard Address' not registered.
 149
 150
 151
 152          fc4DescriptorNotRegistered(15)
 153              - FC-4 Descriptor not registered.
 154          fc4FeaturesNotRegistered(16)
 155              - FC-4 Features not registered.
 156          accessDenied(17)
 157              - Access denied.
 158          unacceptablePortIdentifier(18)
 159              - Unacceptable Port Identifier.
 160          databaseEmpty(19)
 161              - Database is empty.
 162          noObjectRegInSpecifiedScope(20)
 163              - no object has been registered in the specified
 164                scope.
 165          domainIdNotPresent(21)
 166              - Domain ID not present.
 167          portIdNotPresent(22)
 168              - Port number not present.
 169          noDeviceAttached(23)
 170              - No device attached.
 171          authorizationException(24)
 172              - Authorization Exception.
 173          authenticationException(25)
 174              - Authentication Exception.
 175          databaseFull(26)
 176              - Database full."
 177     REFERENCE
 178           "ANSI INCITS 387-2004, Fibre Channel - Generic
 179            Services-4 (FC-GS-4), sections 4.4.4 and 5.2.4"
 180     SYNTAX  INTEGER {
 181               noAdditionalExplanation(1),
 182               portIdentifierNotRegistered(2),
 183               portNameNotRegistered(3),
 184               nodeNameNotRegistered(4),
 185               classOfServiceNotRegistered(5),
 186               nodeIpAddressNotRegistered(6),
 187               ipaNotRegistered(7),
 188               fc4TypeNotRegistered(8),
 189               symbolicPortNameNotRegistered(9),
 190               symbolicNodeNameNotRegistered(10),
 191               portTypeNotRegistered(11),
 192               portIpAddressNotRegistered(12),
 193               fabricPortNameNotRegistered(13),
 194               hardAddressNotRegistered(14),
 195               fc4DescriptorNotRegistered(15),
 196               fc4FeaturesNotRegistered(16),
 197               accessDenied(17),
 198               unacceptablePortIdentifier(18),
 199               databaseEmpty(19),
 200
 201
 202
 203               noObjectRegInSpecifiedScope(20),
 204               domainIdNotPresent(21),
 205               portIdNotPresent(22),
 206               noDeviceAttached(23),
 207               authorizationException(24),
 208               authenticationException(25),
 209               databaseFull(26)
 210            }
 211
 212 --
 213 -- Information about a Name Server Information Subset
 214 --
 215
 216 t11NsInfoSubsetTable OBJECT-TYPE
 217     SYNTAX        SEQUENCE OF T11NsInfoSubsetEntry
 218     MAX-ACCESS    not-accessible
 219     STATUS        current
 220     DESCRIPTION
 221            "This table contains one entry for each Name Server
 222            Information Subset within each Fibre Channel
 223            management instance."
 224     ::= { t11NsStatus 1 }
 225
 226 t11NsInfoSubsetEntry OBJECT-TYPE
 227     SYNTAX        T11NsInfoSubsetEntry
 228     MAX-ACCESS    not-accessible
 229     STATUS        current
 230     DESCRIPTION
 231            "This entry contains information about operations
 232            on a particular Name Server Information Subset
 233            within the Fibre Channel management instance
 234            identified by fcmInstanceIndex."
 235     INDEX { fcmInstanceIndex, t11NsInfoSubsetIndex }
 236     ::= { t11NsInfoSubsetTable 1 }
 237
 238 T11NsInfoSubsetEntry ::= SEQUENCE {
 239     t11NsInfoSubsetIndex                 Unsigned32,
 240     t11NsInfoSubsetSwitchIndex           Unsigned32,
 241     t11NsInfoSubsetTableLastChange       TimeStamp,
 242     t11NsInfoSubsetNumRows               Integer32,
 243     t11NsInfoSubsetTotalRejects          Counter32,
 244     t11NsInfoSubsetRejReqNotfyEnable     TruthValue
 245 }
 246
 247 t11NsInfoSubsetIndex OBJECT-TYPE
 248     SYNTAX        Unsigned32 (1..4294967295)
 249     MAX-ACCESS    not-accessible
 250     STATUS        current
 251
 252
 253
 254     DESCRIPTION
 255            "An arbitrary integer value that uniquely identifies
 256            this Name Server Information Subset amongst all others
 257            within the same Fibre Channel management instance.
 258
 259            It is mandatory to keep this value constant between
 260            restarts of the agent and to make every possible
 261            effort to keep it constant across such restarts."
 262     ::= { t11NsInfoSubsetEntry 1 }
 263
 264 t11NsInfoSubsetSwitchIndex OBJECT-TYPE
 265     SYNTAX        Unsigned32 (0..4294967295)
 266     MAX-ACCESS    read-only
 267     STATUS        current
 268     DESCRIPTION
 269            "The value of this object is zero when operations
 270            upon this Name Server Information Subset do not occur
 271            at a local Fibre Channel switch; otherwise, it is
 272            non-zero and identifies the local switch.
 273
 274            The switch identified by a non-zero value of this
 275            object is the same switch as is identified by the
 276            same value of fcmSwitchIndex."
 277     REFERENCE
 278            "fcmSwitchIndex is defined in the FC-MGMT-MIB module"
 279     ::= { t11NsInfoSubsetEntry 2 }
 280
 281 t11NsInfoSubsetTableLastChange OBJECT-TYPE
 282     SYNTAX        TimeStamp
 283     MAX-ACCESS    read-only
 284     STATUS        current
 285     DESCRIPTION
 286            "The value of sysUpTime at the time of the last update
 287            to any entry in the t11NsRegTable with the same values
 288            of fcmInstanceIndex and t11NsInfoSubsetIndex.  This
 289            includes creation of an entry, deletion of an entry, or
 290            modification of an existing entry.  If no such update
 291            has taken place since the last re-initialization of the
 292            local network management subsystem, then this object
 293            contains a zero value."
 294     ::= { t11NsInfoSubsetEntry 3 }
 295
 296 t11NsInfoSubsetNumRows OBJECT-TYPE
 297     SYNTAX        Integer32 (0..2147483647)
 298     MAX-ACCESS    read-only
 299     STATUS        current
 300     DESCRIPTION
 301            "The number of Nx_Ports currently registered in this
 302
 303
 304
 305            Name Server Information Subset, i.e., the number of
 306            rows in the t11NsRegTable with the same values of
 307            fcmInstanceIndex and t11NsInfoSubsetIndex."
 308     ::= { t11NsInfoSubsetEntry 4 }
 309
 310 t11NsInfoSubsetTotalRejects OBJECT-TYPE
 311     SYNTAX        Counter32
 312     MAX-ACCESS    read-only
 313     STATUS        current
 314     DESCRIPTION
 315            "The total number of (CT_IU) Requests for Name Server
 316            functions that were rejected for inclusion in this
 317            Name Server Information Subset, across all Fabrics
 318            for which it contains information.
 319
 320            This counter has no discontinuities other than those
 321            that all Counter32s have when sysUpTime=0."
 322     ::= { t11NsInfoSubsetEntry 5 }
 323
 324 t11NsInfoSubsetRejReqNotfyEnable OBJECT-TYPE
 325     SYNTAX        TruthValue
 326     MAX-ACCESS    read-write
 327     STATUS        current
 328     DESCRIPTION
 329            "This object indicates whether 't11NsRejectRegNotify'
 330            notifications are generated by rejections of requests
 331            to register information in this Name Server Information
 332            Subset.
 333
 334            If value of this object is 'true', then the
 335            notification is generated when a request is rejected.
 336            If it is 'false', the notification is not generated.
 337
 338            The persistence of values of this object across an
 339            agent reboot is implementation-dependent."
 340     DEFVAL { false }
 341     ::= { t11NsInfoSubsetEntry 6 }
 342
 343 --
 344 -- Registered Port Information
 345 --
 346
 347 t11NsRegTable OBJECT-TYPE
 348     SYNTAX        SEQUENCE OF T11NsRegEntry
 349     MAX-ACCESS    not-accessible
 350     STATUS        current
 351     DESCRIPTION
 352            "This table contains entries for all Nx_Ports registered
 353
 354
 355
 356            in the identified Name Server Information Subsets across
 357            all Fabrics for which such subsets contain information."
 358     ::= { t11NsStatus 2 }
 359
 360 t11NsRegEntry OBJECT-TYPE
 361     SYNTAX T11NsRegEntry
 362     MAX-ACCESS    not-accessible
 363     STATUS        current
 364     DESCRIPTION
 365            "An entry containing information about an Nx_Port
 366            represented by t11NsRegPortIdentifier that is registered
 367            with a Name Server Information Subset (identified by
 368            t11NsInfoSubsetIndex) within the Fibre Channel management
 369            instance (identified by fcmInstanceIndex) on the Fabric
 370            (identified by t11NsRegFabricIndex)."
 371     INDEX { fcmInstanceIndex, t11NsInfoSubsetIndex,
 372             t11NsRegFabricIndex, t11NsRegPortIdentifier }
 373     ::= { t11NsRegTable 1 }
 374
 375 T11NsRegEntry ::= SEQUENCE {
 376     t11NsRegFabricIndex            T11FabricIndex,
 377     t11NsRegPortIdentifier         FcAddressIdOrZero,
 378     t11NsRegPortName               FcNameIdOrZero,
 379     t11NsRegNodeName               FcNameIdOrZero,
 380     t11NsRegClassOfSvc             FcClasses,
 381     t11NsRegNodeIpAddress          OCTET STRING,
 382     t11NsRegProcAssoc              OCTET STRING,
 383     t11NsRegFc4Type                OCTET STRING,
 384     t11NsRegPortType               FcPortType,
 385     t11NsRegPortIpAddress          OCTET STRING,
 386     t11NsRegFabricPortName         FcNameIdOrZero,
 387     t11NsRegHardAddress            FcAddressIdOrZero,
 388     t11NsRegSymbolicPortName       SnmpAdminString,
 389     t11NsRegSymbolicNodeName       SnmpAdminString,
 390     t11NsRegFc4Features            OCTET STRING
 391     }
 392
 393 t11NsRegFabricIndex OBJECT-TYPE
 394     SYNTAX               T11FabricIndex
 395     MAX-ACCESS           not-accessible
 396     STATUS               current
 397     DESCRIPTION
 398            "A unique index value that uniquely identifies a
 399            particular Fabric.
 400
 401            In a Fabric conformant to SW-3, only a single Fabric can
 402            operate within a single physical infrastructure, and thus,
 403            the value of this Fabric Index will always be 1.
 404
 405
 406
 407            However, it is possible that future standards will define
 408            how multiple Fabrics, each with its own management
 409            instrumentation, could operate within one (or more) physical
 410            infrastructures.  To allow for this future possibility, this
 411            index value is used to uniquely identify a particular
 412            Fabric within a physical infrastructure."
 413     ::= { t11NsRegEntry 1 }
 414
 415 t11NsRegPortIdentifier OBJECT-TYPE
 416     SYNTAX               FcAddressIdOrZero
 417     MAX-ACCESS           not-accessible
 418     STATUS               current
 419     DESCRIPTION
 420            "The Fibre Channel Address Identifier of this Nx_Port.
 421            If no Port Identifier has been registered, then the
 422            value of this object is the zero-length string."
 423     ::= { t11NsRegEntry 2 }
 424
 425 t11NsRegPortName OBJECT-TYPE
 426     SYNTAX        FcNameIdOrZero
 427     MAX-ACCESS    read-only
 428     STATUS        current
 429     DESCRIPTION
 430            "The Port_Name (WWN) of this Nx_Port.
 431            If this object has not been registered, then its value
 432            is the zero-length string."
 433     DEFVAL {''H}
 434     ::= { t11NsRegEntry 3 }
 435
 436 t11NsRegNodeName OBJECT-TYPE
 437     SYNTAX        FcNameIdOrZero
 438     MAX-ACCESS    read-only
 439     STATUS        current
 440     DESCRIPTION
 441            "The Node_Name (WWN) of this Nx_Port.
 442            If this object has not been registered, then its value
 443            is the zero-length string."
 444     DEFVAL {''H}
 445     ::= { t11NsRegEntry 4 }
 446
 447 t11NsRegClassOfSvc OBJECT-TYPE
 448     SYNTAX        FcClasses
 449     MAX-ACCESS    read-only
 450     STATUS        current
 451     DESCRIPTION
 452            "The class of service indicator.  This object is an
 453            array of bits that contain a bit map of the classes of
 454            service supported by the associated port.  If a bit in
 455
 456
 457
 458            this object is 1, it indicates that the class of
 459            service is supported by the associated port.  When a
 460            bit is set to 0, it indicates that no class of service
 461            is supported by this Nx_Port.
 462
 463            If this object has not been not registered for a port,
 464            then the instance for that port is not instantiated."
 465     ::= { t11NsRegEntry 5 }
 466
 467 t11NsRegNodeIpAddress OBJECT-TYPE
 468     SYNTAX        OCTET STRING (SIZE (0 | 16))
 469     MAX-ACCESS    read-only
 470     STATUS        current
 471     DESCRIPTION
 472            "The IP address of the node of this Nx_Port, in
 473            network-byte order, either as a 32-bit IPv4 address or
 474            a 128-bit IPv6 address.  For the former, the leftmost 96 bits
 475            (12 bytes) should contain x'00 00 00 00 00 00 00 00 00 00 FF
 476            FF', and the IPv4 address should be present in the rightmost
 477            32 bits.
 478
 479            Note that the value of this object is the IP address value
 480            that is received in the FC-GS-4 message Register IP address
 481            (Node) RIP_NN.  It is not validated against any IP address
 482            format.
 483
 484            If no 'IP address (Node)' has been registered, then the
 485            value of this object is the zero-length string."
 486     REFERENCE
 487           "ANSI INCITS 387-2004, Fibre Channel - Generic
 488            Services-4 (FC-GS-4)"
 489     DEFVAL  { ''H }
 490     ::= { t11NsRegEntry 6 }
 491
 492 t11NsRegProcAssoc OBJECT-TYPE
 493     SYNTAX        OCTET STRING (SIZE (0 | 8))
 494     MAX-ACCESS    read-only
 495     STATUS        current
 496     DESCRIPTION
 497            "The Fibre Channel Initial Process Associator (IPA).
 498
 499            If no 'Initial Process Associator' has been registered,
 500            then the value of this object is the zero-length string."
 501     REFERENCE
 502           "ANSI INCITS 387-2004, Fibre Channel - Generic
 503            Services-4 (FC-GS-4)"
 504     DEFVAL  { ''H }
 505     ::= { t11NsRegEntry 7 }
 506
 507
 508
 509 t11NsRegFc4Type OBJECT-TYPE
 510     SYNTAX        OCTET STRING (SIZE (0 | 32))
 511     MAX-ACCESS    read-only
 512     STATUS        current
 513     DESCRIPTION
 514            "The FC-4 protocol types supported by this Nx_Port.
 515            This is an array of 256 bits.  Each bit in the array
 516            corresponds to a Type value as defined by Fibre Channel
 517            standards and contained in the Type field of the frame
 518            header.  The order of the bits in the 256-bit (32-byte)
 519            value is the same as defined in FC-GS-4, section 5.2.3.8,
 520            and represented in network-byte order.
 521
 522            If no 'FC-4 TYPEs' has been registered, then the
 523            value of this object is the zero-length string."
 524     REFERENCE
 525            "ANSI INCITS 387-2004, Fibre Channel - Generic
 526            Services-4 (FC-GS-4), section 5.2.3.8."
 527     DEFVAL  { ''H }
 528     ::= { t11NsRegEntry 8 }
 529
 530 t11NsRegPortType OBJECT-TYPE
 531     SYNTAX        FcPortType
 532     MAX-ACCESS    read-only
 533     STATUS        current
 534     DESCRIPTION
 535            "The port type of this port.
 536
 537            If no 'Port Type' has been registered, then the value
 538            of this object is unidentified and is represented by
 539            the value 'unknown'."
 540     DEFVAL  { 1 }                -- 'unknown', see [FC-MGMT]
 541     ::= { t11NsRegEntry 9 }
 542
 543 t11NsRegPortIpAddress OBJECT-TYPE
 544     SYNTAX        OCTET STRING (SIZE (0 | 16))
 545     MAX-ACCESS    read-only
 546     STATUS        current
 547     DESCRIPTION
 548            "The value that Fibre Channel calls an 'IP Address (Port)'
 549            that represents the IP address of the associated port.
 550            The value is either in 32-bit IPv4 format or 128-bit IPv6
 551            format, in network-byte order.  When this object contains an
 552            IPv4 address, the leftmost 96 bits (12 bytes) should contain
 553            x'00 00 00 00 00 00 00 00 00 00 FF FF'.  The IPv4 address
 554            should be present in the rightmost 32 bits.
 555
 556            Note that the value of this object is the IP address value
 557
 558
 559
 560            that is received in the FC-GS-4 message Register IP address
 561            (Port) RIPP_ID.  It is not validated against any IP address
 562            format.
 563
 564            If no 'IP address (Port)' has been registered, then the
 565            value of this object is the zero-length string."
 566     REFERENCE
 567            "ANSI INCITS 387-2004, Fibre Channel - Generic
 568            Services-4, (FC-GS-4)"
 569     DEFVAL {''H}
 570     ::= { t11NsRegEntry 10 }
 571
 572 t11NsRegFabricPortName OBJECT-TYPE
 573     SYNTAX        FcNameIdOrZero
 574     MAX-ACCESS    read-only
 575     STATUS        current
 576     DESCRIPTION
 577            "The Fabric Port Name (WWN) of the Fx_Port to which
 578            this Nx_Port is attached.
 579
 580            If no 'Fabric Port Name' has been registered, then the
 581            value of this object is the zero-length string."
 582     DEFVAL {''H}
 583     ::= { t11NsRegEntry 11 }
 584
 585 t11NsRegHardAddress OBJECT-TYPE
 586     SYNTAX        FcAddressIdOrZero
 587     MAX-ACCESS    read-only
 588     STATUS        current
 589     DESCRIPTION
 590            "The format of this object is identical to the format
 591            of Hard Address defined in the Discover Address (ADISC)
 592            Extended Link Service (FC-FS).
 593
 594            Hard Address is the 24-bit NL_Port identifier that
 595            consists of:
 596              - the 8-bit Domain_ID in the most significant byte
 597              - the 8-bit Area_ID in the next most significant
 598                byte
 599              - the 8-bit AL-PA (Arbitrated Loop Physical Address)
 600                which an NL_Port attempts acquire during FC-AL
 601                initialization in the least significant byte.
 602
 603            If the port is not an NL_Port, or if it is an NL_Port
 604            but does not have a hard address, then all bits are
 605            reported as zeros.
 606
 607            If no 'Hard Address' has been registered, then the
 608
 609
 610
 611            value of this object is the zero-length string."
 612     DEFVAL {''H}
 613     ::= { t11NsRegEntry 12 }
 614
 615 t11NsRegSymbolicPortName OBJECT-TYPE
 616     SYNTAX        SnmpAdminString (SIZE (0..255))
 617     MAX-ACCESS    read-only
 618     STATUS        current
 619     DESCRIPTION
 620            "The user-defined name of this port.
 621
 622            If no 'Symbolic Port Name' has been registered, then
 623            the value of this object is the zero-length string."
 624     DEFVAL {''H}
 625     ::= { t11NsRegEntry 13 }
 626
 627 t11NsRegSymbolicNodeName OBJECT-TYPE
 628     SYNTAX        SnmpAdminString (SIZE (0..255))
 629     MAX-ACCESS    read-only
 630     STATUS        current
 631     DESCRIPTION
 632            "The user-defined name of the node of this port.
 633
 634            If no 'Symbolic Node Name' has been registered, then
 635            the value of this object is the zero-length string."
 636     DEFVAL {''H}
 637     ::= { t11NsRegEntry 14 }
 638
 639
 640 t11NsRegFc4Features OBJECT-TYPE
 641     SYNTAX        OCTET STRING (SIZE (0 | 128))
 642     MAX-ACCESS    read-only
 643     STATUS        current
 644     DESCRIPTION
 645            "The FC-4 Features associated with FC-4 Types on this
 646            port encoded as a 128-byte value in network-byte order,
 647            or the zero-length string if no 'FC-4 Features' have been
 648            registered.
 649
 650            Section 5.2.3.15 of FC-GS-4 is the authoritative
 651            definition of the format of the 128-byte value,
 652            i.e., if different, FC-GS-4 takes precedence over the
 653            following description:
 654
 655            The 128-byte value is an array of 4-bit values, one for
 656            each FC-4 Type value, positioned as follows: the 5 most
 657            significant bits of a Type value identify where it appears
 658            within the 128-byte value, specifically, within which word:
 659
 660
 661
 662                  - Word 0 (of the 128-byte value) contains information
 663                    related to Types '00' through '07';
 664                  - Word 1 contains information related to Types
 665                    '08' through 0F';
 666                  - and so forth, up to Word 31, which contains
 667                    information related to Types 'F8' through 'FF'.
 668
 669            The least significant of the eight 4-bit values in each
 670            Word represents an FC-4 Type with 000 as its 3 least
 671            significant bits, and most significant 4-bit value in
 672            each Word represents an FC-4 Type with 111 as its 3 least
 673            significant bits."
 674     REFERENCE
 675            "ANSI INCITS 387-2004, Fibre Channel - Generic
 676            Services-4 (FC-GS-4), section 5.2.3.15."
 677     DEFVAL {''H}
 678     ::= { t11NsRegEntry 15 }
 679
 680
 681 --
 682 -- Registered FC-4 Descriptors
 683 --
 684
 685 t11NsRegFc4DescriptorTable OBJECT-TYPE
 686     SYNTAX        SEQUENCE OF T11NsRegFc4DescriptorEntry
 687     MAX-ACCESS    not-accessible
 688     STATUS        current
 689     DESCRIPTION
 690            "This table contains entries for all FC-4 Descriptors
 691            registered in the identified Name Server Information
 692            Subsets across all Fabrics for which such subsets
 693            contain information."
 694     ::= { t11NsStatus 3 }
 695
 696 t11NsRegFc4DescriptorEntry OBJECT-TYPE
 697     SYNTAX        T11NsRegFc4DescriptorEntry
 698     MAX-ACCESS    not-accessible
 699     STATUS        current
 700     DESCRIPTION
 701            "An entry in the t11NsRegFc4DescriptorTable,
 702            containing information about an FC-4 Descriptor
 703            that is associated with a particular FC-4 Type
 704            value.  The particular FC-4 Descriptor was
 705            registered by an Nx_Port (identified by
 706            t11NsRegPortIdentifier) in a Name Server Information
 707            Subset (identified by t11NsInfoSubsetIndex) within
 708            the Fibre Channel management instance (identified by
 709            fcmInstanceIndex) on the Fabric (identified by
 710
 711
 712
 713            t11NsRegFabricIndex).
 714
 715            If no FC-4 Descriptors have been registered
 716            for a particular port, then there will be no
 717            entries in this table for that port."
 718     INDEX { fcmInstanceIndex, t11NsInfoSubsetIndex,
 719             t11NsRegFabricIndex, t11NsRegPortIdentifier,
 720             t11NsRegFc4TypeValue }
 721     ::= { t11NsRegFc4DescriptorTable 1 }
 722
 723 T11NsRegFc4DescriptorEntry ::= SEQUENCE {
 724     t11NsRegFc4TypeValue           Unsigned32,
 725     t11NsRegFc4Descriptor          OCTET STRING
 726 }
 727
 728 t11NsRegFc4TypeValue OBJECT-TYPE
 729     SYNTAX          Unsigned32 (0..255)
 730     MAX-ACCESS      not-accessible
 731     STATUS          current
 732     DESCRIPTION
 733            "An integer value that identifies an FC-4 Type value
 734            (representing a particular protocol type, as specified
 735            in FC-FS) for which an FC-4 Descriptor has been
 736            registered.
 737
 738            An instance of this object contains a 'Type value'
 739            that corresponds to a '1' bit in the value of the
 740            t11NsRegFc4Type registered for the same port;
 741            this correspondence is as specified in FC-GS-4."
 742     REFERENCE
 743            "ANSI INCITS 387-2004, Fibre Channel - Generic
 744               Services-4 (FC-GS-4), section 5.2.3.8, and
 745            ANSI INCITS 373-2003, Fibre Channel - Framing and
 746               Signaling (FC-FS), section 9.6, Table 29."
 747     ::= { t11NsRegFc4DescriptorEntry 1 }
 748
 749 t11NsRegFc4Descriptor OBJECT-TYPE
 750     SYNTAX        OCTET STRING (SIZE (0..255))
 751     MAX-ACCESS    read-only
 752     STATUS        current
 753     DESCRIPTION
 754            "The FC-4 Descriptor value that has been registered
 755            for the particular port on the particular Fabric, and
 756            for the FC-4 Type represented by the corresponding
 757            value of t11NsRegFc4TypeIndex.
 758
 759            The format of an FC-4 Descriptor is dependent on the
 760            corresponding FC-4 Type value, but is represented in
 761
 762
 763
 764            network-byte order."
 765     REFERENCE
 766            "ANSI INCITS 387-2004, Fibre Channel - Generic
 767            Services-4 (FC-GS-4), section 5.2.5.42"
 768     ::= { t11NsRegFc4DescriptorEntry 2 }
 769
 770
 771 --
 772 -- Name Server per-Fabric Statistics
 773 --
 774
 775 t11NsStatsTable OBJECT-TYPE
 776     SYNTAX        SEQUENCE OF T11NsStatsEntry
 777     MAX-ACCESS    not-accessible
 778     STATUS        current
 779     DESCRIPTION
 780            "This table contains per-Fabric state and statistics
 781            for operations upon the identified Name Server
 782            Information Subsets."
 783     ::= { t11NsStatistics 1 }
 784
 785 t11NsStatsEntry OBJECT-TYPE
 786     SYNTAX        T11NsStatsEntry
 787     MAX-ACCESS    not-accessible
 788     STATUS        current
 789     DESCRIPTION
 790            "An entry in this table contains state and statistics
 791            for operations upon a Name Server Information Subset
 792            (identified by t11NsInfoSubsetIndex) within the Fibre
 793            Channel management instance (identified by
 794            fcmInstanceIndex) on the Fabric (identified by
 795            t11NsRegFabricIndex)."
 796     INDEX { fcmInstanceIndex, t11NsInfoSubsetIndex,
 797             t11NsRegFabricIndex }
 798     ::= { t11NsStatsTable 1 }
 799
 800 T11NsStatsEntry ::=  SEQUENCE {
 801     t11NsInGetReqs                Counter32,
 802     t11NsOutGetReqs               Counter32,
 803     t11NsInRegReqs                Counter32,
 804     t11NsInDeRegReqs              Counter32,
 805     t11NsInRscns                  Counter32,
 806     t11NsOutRscns                 Counter32,
 807     t11NsRejects                  Counter32,
 808     t11NsDatabaseFull             TruthValue
 809  }
 810
 811 t11NsInGetReqs OBJECT-TYPE
 812
 813
 814
 815     SYNTAX        Counter32
 816     MAX-ACCESS    read-only
 817     STATUS        current
 818     DESCRIPTION
 819            "The total number of (CT_IU) Get Requests
 820            received requesting information from this Name
 821            Server Information Subset on this Fabric.
 822
 823            This counter has no discontinuities other than those
 824            that all Counter32s have when sysUpTime=0."
 825     ::= { t11NsStatsEntry 1 }
 826
 827 t11NsOutGetReqs OBJECT-TYPE
 828     SYNTAX        Counter32
 829     MAX-ACCESS    read-only
 830     STATUS        current
 831     DESCRIPTION
 832            "The total number of (CT_IU) Get Requests sent in
 833            order to obtain information needed in this Name Server
 834            Information Subset on this Fabric.
 835
 836            This counter has no discontinuities other than those
 837            that all Counter32s have when sysUpTime=0."
 838     ::= { t11NsStatsEntry 2 }
 839
 840 t11NsInRegReqs OBJECT-TYPE
 841     SYNTAX        Counter32
 842     MAX-ACCESS    read-only
 843     STATUS        current
 844     DESCRIPTION
 845            "The total number of (CT_IU) Registration Requests
 846            received to register information in the Name Server
 847            Information Subset on this Fabric.
 848
 849            This counter has no discontinuities other than those
 850            that all Counter32s have when sysUpTime=0."
 851     ::= { t11NsStatsEntry 3 }
 852
 853 t11NsInDeRegReqs OBJECT-TYPE
 854     SYNTAX        Counter32
 855     MAX-ACCESS    read-only
 856     STATUS        current
 857     DESCRIPTION
 858            "The total number of (CT_IU) De-registration Requests
 859            received to de-register information from this Name Server
 860            Information Subset on this Fabric.
 861
 862            This counter has no discontinuities other than those
 863
 864
 865
 866            that all Counter32s have when sysUpTime=0."
 867     ::= { t11NsStatsEntry 4 }
 868
 869 t11NsInRscns OBJECT-TYPE
 870     SYNTAX        Counter32
 871     MAX-ACCESS    read-only
 872     STATUS        current
 873     DESCRIPTION
 874            "The total number of received RSCNs, indicating
 875            Name Server-related changes relating to this Name
 876            Server Information Subset on this Fabric.
 877
 878            This counter has no discontinuities other than those
 879            that all Counter32s have when sysUpTime=0."
 880     ::= { t11NsStatsEntry 5 }
 881
 882 t11NsOutRscns OBJECT-TYPE
 883     SYNTAX        Counter32
 884     MAX-ACCESS    read-only
 885     STATUS        current
 886     DESCRIPTION
 887            "The total number of transmitted RSCNs, indicating
 888            Name Server-related changes relating to this Name
 889            Server Information Subset on this Fabric.
 890
 891            This counter has no discontinuities other than those
 892            that all Counter32s have when sysUpTime=0."
 893     ::= { t11NsStatsEntry 6 }
 894
 895 t11NsRejects OBJECT-TYPE
 896     SYNTAX        Counter32
 897     MAX-ACCESS    read-only
 898     STATUS        current
 899     DESCRIPTION
 900            "The total number of CT_IU Requests for Name
 901            Server functions on this Name Server Information
 902            Subset on this Fabric that were rejected.
 903
 904            This counter has no discontinuities other than those
 905            that all Counter32s have when sysUpTime=0."
 906     ::= { t11NsStatsEntry 7 }
 907
 908 t11NsDatabaseFull OBJECT-TYPE
 909     SYNTAX        TruthValue
 910     MAX-ACCESS    read-only
 911     STATUS        current
 912     DESCRIPTION
 913            "An indication of whether the database containing this
 914
 915
 916
 917            Name Server Information Subset is full.  This object is
 918            set to 'true' only if the Name Server is unable to allocate
 919            space for a new entry for the corresponding Fabric, and it is
 920            set to 'false' whenever an existing entry is deleted for the
 921            corresponding Fabric."
 922     ::= { t11NsStatsEntry 8 }
 923
 924 --
 925 -- Reject information objects
 926 --
 927
 928 t11NsRejectTable OBJECT-TYPE
 929     SYNTAX        SEQUENCE OF T11NsRejectEntry
 930     MAX-ACCESS    not-accessible
 931     STATUS        current
 932     DESCRIPTION
 933            "This table contains information about the most recent
 934            Name Server Registration Request failures for various
 935            ports on various Fabrics.
 936
 937            If no information is available about the most recent
 938            rejection of a Registration Request on a particular port
 939            on a particular Fabric, then there will no entry in this
 940            table for that port and Fabric.
 941
 942            When a t11NsRejectRegNotify notification is sent for
 943            such a Registration Request failure, the values of the
 944            objects in the relevant entry of this table are updated
 945            immediately prior to generating the notification."
 946     ::= { t11NsStatus 4 }
 947
 948 t11NsRejectEntry OBJECT-TYPE
 949     SYNTAX T11NsRejectEntry
 950     MAX-ACCESS    not-accessible
 951     STATUS        current
 952     DESCRIPTION
 953            "An entry containing information about the most recent
 954            rejection of a request to register information in the Name
 955            Server Information Subset (identified by
 956            t11NsInfoSubsetIndex) within the Fibre Channel management
 957            instance (identified by fcmInstanceIndex) for a particular
 958            port (identified by t11NsRegPortIdentifier) on a particular
 959            Fabric (identified by t11NsRegFabricIndex)."
 960     INDEX { fcmInstanceIndex, t11NsInfoSubsetIndex,
 961             t11NsRegFabricIndex, t11NsRegPortIdentifier }
 962     ::= { t11NsRejectTable 1 }
 963
 964 T11NsRejectEntry ::= SEQUENCE {
 965
 966
 967
 968     t11NsRejectCtCommandString   OCTET STRING,
 969     t11NsRejectReasonCode        T11NsGs4RejectReasonCode,
 970     t11NsRejReasonCodeExp        T11NsRejReasonCodeExpl,
 971     t11NsRejReasonVendorCode     OCTET STRING
 972 }
 973
 974 t11NsRejectCtCommandString OBJECT-TYPE
 975     SYNTAX        OCTET STRING (SIZE (0..255))
 976     MAX-ACCESS    read-only
 977     STATUS        current
 978     DESCRIPTION
 979            "The binary content of the Registration Request,
 980            formatted as an octet string (in network byte
 981            order) containing the CT_IU, as described in
 982            Table 2 of [FC-GS-4] (including the preamble),
 983            which was most recently rejected for the particular
 984            Name Server Information Subset on the particular port
 985            on the particular Fabric.
 986
 987            This object contains the zero-length string
 988            if and when the CT-IU's content is unavailable.
 989
 990            When the length of this object is 255 octets, it
 991            contains the first 255 octets of the CT-IU (in
 992            network-byte order)."
 993     ::= { t11NsRejectEntry 1 }
 994
 995 t11NsRejectReasonCode OBJECT-TYPE
 996     SYNTAX        T11NsGs4RejectReasonCode
 997     MAX-ACCESS    read-only
 998     STATUS        current
 999     DESCRIPTION
1000            "A registration reject reason code.  This object
1001            contains the reason code of the most recent Name
1002            Server Registration Request failure for the
1003            particular port on the particular Fabric."
1004     ::= { t11NsRejectEntry 2 }
1005
1006 t11NsRejReasonCodeExp OBJECT-TYPE
1007     SYNTAX        T11NsRejReasonCodeExpl
1008     MAX-ACCESS    read-only
1009     STATUS        current
1010     DESCRIPTION
1011            "A registration reject reason code explanation.  This
1012            object contains the reason code explanation of the most
1013            recent Name Server Registration Request failure for the
1014            particular port on the particular Fabric."
1015     ::= { t11NsRejectEntry 3 }
1016
1017
1018
1019 t11NsRejReasonVendorCode OBJECT-TYPE
1020     SYNTAX        OCTET STRING (SIZE(1))
1021     MAX-ACCESS    read-only
1022     STATUS        current
1023     DESCRIPTION
1024            "A registration reject vendor-specific code.  This
1025            object contains the vendor-specific code of the most
1026            recent Name Server Registration Request failure for the
1027            particular port on the particular Fabric."
1028     ::= { t11NsRejectEntry 4 }
1029
1030
1031 --
1032 -- Notifications
1033 --
1034
1035 t11NsRejectRegNotify NOTIFICATION-TYPE
1036     OBJECTS   { t11FamLocalSwitchWwn,
1037                 t11NsRegPortName, t11NsRejectCtCommandString,
1038                 t11NsRejectReasonCode, t11NsRejReasonCodeExp,
1039                 t11NsRejReasonVendorCode }
1040     STATUS    current
1041     DESCRIPTION
1042            "This notification is generated whenever a request to
1043            register information in a Name Server Information
1044            Subset (for which the corresponding instance of
1045            t11NsInfoSubsetRejReqNotfyEnable is 'true') is
1046            rejected on a particular Fabric for a particular Nx_Port.
1047
1048            The value of t11FamLocalSwitchWwn indicates the
1049            WWN of the switch that received the request.
1050            (If the WWN is unavailable, the value is set to
1051            the zero-length string.)
1052
1053            The value of t11NsRejectCtCommandString indicates
1054            the rejected request, and the values of
1055            t11NsRejectReasonCode, t11NsRejReasonCodeExp, and
1056            t11NsRejReasonVendorCode indicate the reason for
1057            the rejection.
1058
1059            The value of t11NsRegPortName represents the Port Name
1060            if it is able to be extracted out of the Registration
1061            Request, or otherwise the value as currently registered
1062            on the port."
1063     ::= { t11NsNotifications 1 }
1064
1065 --
1066 -- Conformance
1067
1068
1069
1070 --
1071
1072 t11NsMIBCompliances OBJECT IDENTIFIER ::= {t11NsMIBConformance 1}
1073 t11NsMIBGroups      OBJECT IDENTIFIER ::= {t11NsMIBConformance 2}
1074
1075 t11NsMIBCompliance MODULE-COMPLIANCE
1076     STATUS    current
1077     DESCRIPTION
1078            "The compliance statement for entities that
1079            implement the Fibre Channel Name Server."
1080     MODULE MANDATORY-GROUPS {t11NsDBGroup,
1081                              t11NsNotifyControlGroup,
1082                              t11NsNotifyGroup}
1083
1084       OBJECT t11NsInfoSubsetRejReqNotfyEnable
1085       MIN-ACCESS read-only
1086       DESCRIPTION
1087              "Write access is not required."
1088
1089       GROUP t11NsRequestStatsGroup
1090       DESCRIPTION
1091              "This group is mandatory only for an implementation
1092              that captures statistics related to Name Server
1093              requests."
1094
1095       GROUP t11NsRscnStatsGroup
1096       DESCRIPTION
1097              "This group is mandatory only for an implementation
1098              that captures statistics related to Name
1099              Server-related RSCNs."
1100
1101       GROUP t11NsRejectStatsGroup
1102       DESCRIPTION
1103              "This group is mandatory only for an implementation
1104              that captures statistics related to Name Server
1105              rejects."
1106
1107     ::= { t11NsMIBCompliances 1 }
1108
1109 -- Units of conformance
1110
1111 t11NsDBGroup        OBJECT-GROUP
1112     OBJECTS { t11NsInfoSubsetSwitchIndex,
1113               t11NsInfoSubsetTableLastChange,
1114               t11NsInfoSubsetNumRows,
1115               t11NsRegPortName,
1116               t11NsRegNodeName,
1117               t11NsRegClassOfSvc,
1118
1119
1120
1121               t11NsRegNodeIpAddress,
1122               t11NsRegProcAssoc,
1123               t11NsRegFc4Type,
1124               t11NsRegPortType,
1125               t11NsRegPortIpAddress,
1126               t11NsRegFabricPortName,
1127               t11NsRegHardAddress,
1128               t11NsRegSymbolicPortName,
1129               t11NsRegSymbolicNodeName,
1130               t11NsRegFc4Features,
1131               t11NsRegFc4Descriptor }
1132     STATUS current
1133     DESCRIPTION
1134            "A collection of objects for monitoring the information
1135            registered in a Name Server Information Subset."
1136     ::= { t11NsMIBGroups 1 }
1137
1138 t11NsRequestStatsGroup OBJECT-GROUP
1139     OBJECTS { t11NsInGetReqs,
1140               t11NsOutGetReqs,
1141               t11NsInRegReqs,
1142               t11NsInDeRegReqs,
1143               t11NsDatabaseFull}
1144     STATUS current
1145     DESCRIPTION
1146            "A collection of objects for displaying Name
1147            Server statistics and state for Name Server requests."
1148     ::= { t11NsMIBGroups 2 }
1149
1150 t11NsRscnStatsGroup OBJECT-GROUP
1151     OBJECTS { t11NsInRscns,
1152               t11NsOutRscns }
1153     STATUS current
1154     DESCRIPTION
1155            "A collection of objects for displaying Name
1156            Server statistics for Name Server-related RSCNs."
1157     ::= { t11NsMIBGroups 3 }
1158
1159 t11NsRejectStatsGroup OBJECT-GROUP
1160     OBJECTS { t11NsInfoSubsetTotalRejects,
1161               t11NsRejects }
1162     STATUS current
1163     DESCRIPTION
1164            "A collection of objects for displaying Name
1165            Server statistics for rejects."
1166     ::= { t11NsMIBGroups 4 }
1167
1168 t11NsNotifyControlGroup  OBJECT-GROUP
1169
1170
1171
1172     OBJECTS { t11NsRejectCtCommandString,
1173               t11NsRejectReasonCode,
1174               t11NsRejReasonCodeExp,
1175               t11NsRejReasonVendorCode,
1176               t11NsInfoSubsetRejReqNotfyEnable }
1177     STATUS current
1178     DESCRIPTION
1179            "A collection of notification control and
1180            notification information objects for monitoring
1181            rejections of Name Server registrations."
1182     ::= { t11NsMIBGroups 5 }
1183
1184 t11NsNotifyGroup        NOTIFICATION-GROUP
1185     NOTIFICATIONS {t11NsRejectRegNotify }
1186     STATUS current
1187     DESCRIPTION
1188            "A collection of notifications for monitoring
1189            rejections of Name Server registrations."
1190     ::= { t11NsMIBGroups 6 }
1191
1192 END