Internet DRAFT - draft-forbes-ibswitchmib

draft-forbes-ibswitchmib




                                                              B. Forbes
   Internet Draft                                              D. Chung
   Document: draft-forbes-ibswitchmib-00.txt                    Brocade
                                                         Communications
   Expires: December 31, 2001                             July 11, 2001
    
    
                      Definitions of Managed Objects 
                   for the Switch in InfiniBand Standard 
                     <draft-forbes-ibswitchmib-00.txt> 
    
Status of this Memo 
    
   This document is an Internet-Draft and is in full conformance with 
   all provisions of Section 10 of RFC2026.  Internet-Drafts are 
   working documents of the Internet Engineering Task Force (IETF), its 
   areas, and its working groups.  Note that other groups may also 
   distribute working documents as Internet-Drafts. 
    
   Internet-Drafts are draft documents valid for a maximum of six 
   months and may be updated, replaced, or obsoleted by other documents 
   at any time.  It is inappropriate to use Internet-Drafts as 
   reference   material or to cite them other than as ``work in 
   progress.'' 
    
   The list of current Internet-Drafts can be accessed at 
   http://www.ietf.org/ietf/1id-abstracts.txt. 
    
   The list of Internet-Draft Shadow Directories can be accessed at 
   http://www.ietf.org/shadow.html. 
    
    
Abstract 
    
   This memo defines an extension to the Management Information Base 
   (MIB) for use with network management protocols in TCP/IP-based 
   internets.  In particular, it defines the objects for managing the 
   operations of the Switch portion of the InfiniBand Standards. 
    
Copyright Notice 
    
   Copyright (C) The Internet Society (2001).  All Rights Reserved. 
    
    
    
    
    
    
    
    
    
    
    
    
   Forbes                                                       Page 1    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   Table of Contents 
    
   1. The SNMP Management Framework...................................3 
   2. Overview........................................................4 
   2.1. Management View of a Switch...................................4 
   2.2. MAP-Specific Object Section...................................5 
   2.3. SAN-based Object Section......................................5 
   2.3. SAN-based SNMP Trap Section...................................6 
   3. Object Descriptions.............................................7 
   3.1. gswMisc Group.................................................7 
   3.2. gswSystem Group...............................................7 
   3.3. gswFabric Group..............................................13 
   3.4. gswModule Group..............................................14 
   3.5. gswPort Group................................................15 
   3.6. gswPortPerfGroup.............................................19 
   3.7. gswNs Group..................................................21 
   3.8. gswEvent Group...............................................22 
   3.10. gswEndDevice Group..........................................22 
   3.11. gswTrunk Group..............................................22 
   3.12. gswAgtCfg Group.............................................23 
   3.13. Traps Group.................................................24 
   -- Misc. Group....................................................28 
   -- System Group...................................................29 
   -- Fabric Group...................................................42 
   -- Port Group.....................................................45 
   -- Port Performance Group.........................................51 
   -- Name Service group.............................................55 
   -- Event Group....................................................56 
   -- EndDevice Group................................................57 
   -- SNMP Agent Configuration.......................................58 
   -- Traps Group....................................................59 
   5. Security Considerations........................................61 
   6. Intellectual Property..........................................61 
   7. Acknowledgements...............................................61 
   8. References.....................................................61 
   8.1. RFCs.........................................................61 
   8.2. InfiniBand References........................................63 
   9. Authors' Addresses.............................................63 
   10. Full Copyright Statement......................................63 
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                 Page 2    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
1. The SNMP Management Framework 
    
   The SNMP Management Framework presently consists of five major 
   components: 
    
      o   An overall architecture, described in RFC 2571. 
    
      o   Mechanisms for describing and naming objects and events for 
          the purpose of management.  The first version of this Struc- 
          ture of Management Information (SMI) is called SMIv1 and 
          described in RFC 1155, RFC 1212 and RFC 1215.  The 
          second version, called SMIv2, is described in RFC 2578, 
          RFC 2579 and RFC 2580. 
    
      o   Message protocols for transferring management information. 
          The first version of the SNMP message protocol is called 
          SNMPv1 and described in RFC 1157.  A second version of the 
          SNMP message protocol, which is not an Internet standards 
          track protocol, is called SNMPv2c and described in RFC 1901 
          and RFC 1906.  The third version of the message protocol 
          is called SNMPv3 and described in RFC 1906, RFC 2572 
          and RFC 2574. 
    
      o   Protocol operations for accessing management information. The 
          first set of protocol operations and associated PDU formats 
          is described in RFC 1157.  A second set of protocol opera- 
          tions and associated PDU formats is described in RFC 1905. 
    
      o   A set of fundamental applications described in RFC 2573 
          and the view-based access control mechanism described in RFC 
          2575. 
    
    
   A more detailed introduction to the current SNMP Management 
   Framework can be found in RFC 2570. 
    
   Managed objects are accessed via a virtual information store, termed 
   the Management Information Base or MIB.  Objects in the MIB are 
   defined using the mechanisms defined in the SMI. 
    
   This memo specifies a MIB module that is compliant to the SMIv2.  A 
   MIB conforming to the SMIv1 can be produced through the appropriate 
   translations.  The resulting translated MIB must be semantically 
   equivalent, except where objects or events are omitted because no 
   translation is possible (use of Counter64).  Some machine readable 
   information in SMIv2 will be converted into textual descriptions in 
   SMIv1 during the translation process.  However, this loss of 
   machine-readable information is not considered to change the 
   semantics of the MIB. 
    
    
   Forbes             Expires December 31, 2001                 Page 3    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 
   "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in 
   this document are to be interpreted as described in [RFC2119]. 
    
    
2. Overview 
    
   InfiniBand is designed to support block I/O, inter-processor 
   communications, and data communications traffic simultaneously.  An 
   InfiniBand Subnet can be part of a Server Area Network or a Storage 
   Area Network, either of which can be referred to as a _SAN_. 
    
   An InfiniBand subnet is an entity that interconnects InfiniBand 
   ports on end nodes.  It provides transport and forwarding functions 
   allowing ports to communicate with one another over the links that 
   connect them.  All but the smallest subnets will contain one or more 
   Switches to forward packets from link to link.  A Switch can have 
   from one to 255 ports, each connected to a different link. 
    
   This memo shall define objects related to an InfiniBand Switch and 
   its ports.  It is based on Version 1.0 of the InfiniBand 
   specification [1]. 
    
    
2.1. Management View of a Switch 
    
   The InfiniBand Switch MIB is derived from MIBs used to manage Fibre 
   Channel fabrics.  It is felt that Fibre Channel has enough 
   similarities with InfiniBand that it is valuable to incorporate 
   industry and vendor experience from the former to manage the latter. 
    
   One significant difference between Fibre Channel and InfiniBand 
   switches is that implementations of the former began with stand-
   alone products including chassis, environmental monitoring, etc. and 
   only later evolved to imbedded implementations.  In contrast, 
   InfiniBand is expected to deliver both stand-alone products and 
   embedded implementations from the start.  Consequently, there may be 
   ancillary Switch MIB data such as sensor tables that imbedded 
   switches elect not to implement. 
    
   Unlike its Fibre Channel predecessor, the Switch MIB is designed to 
   support management of an entire subnet.  It does this by supporting 
   multiple switch elements within one MIB, and by providing structures 
   to describe the physical connectivity of the switches. 
    
   The Switch MIB is structured to eventually incorporate multiple 
   interconnect technologies that are likely to coexist within a 
   customer site, such as Fibre Channel and storage over IP.  This 
   represents an opportunity for site-wide interconnect management in 
   an integrated manner.  This memo only includes definitions of 
   InfiniBand and Fibre Channel data at this time. 
    
    
   Forbes             Expires December 31, 2001                 Page 4    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
   All InfiniBand nodes including Switches are managed by means of 
   Attributes, which are data structures that can be set and read over 
   any InfiniBand link connected to that node.  Management Attributes 
   are defined in detail in Volume 1 of the Version 1.0 InfiniBand 
   specification [1].  Many of the objects defined in this memo are 
   based on those Attributes. 
    
   The Switch MIB is organized into three sections.  The first section 
   contains MAP-specific objects.  The second section contains SAN-
   based objects.  The third section contains SAN-based SNMP trap 
   registration and SNMP trap definitions. 
    
   Figure 1 is an overview of how SAN-based objects are organized 
   through an inventory table.  The figure does not contain all the 
   tables and variables for IBSWITCH.  However, it shows an exemplary 
   relationship between the inventory table, non-protocol-specific 
   tables such as the sensor table, and protocol-based tables such as 
   the InfiniBand-specific port table. 
    
    
    
   <insert Figure 1 here> 
    
    
    
2.2. MAP-Specific Object Section 
    
   The MAP-specific object section contains MIB information that is 
   neither non-subnet based, or usage or usefulness of the information 
   in SAN setting is questionable.  For example, the Switch MIB 
   contains MIB version information.  It is possible to present Switch 
   MIB version for all switches in the SAN.  However, usefulness of the 
   information is questionable since the type of information available 
   is only dependent on the local MIB version. 
    
2.3. SAN-based Object Section 
    
   The SAN-base object section contains information for all switches in 
   a SAN through the use of unique indexing for these objects.  In 
   order to accomplish this, the Switch MIB uses one level of 
   indirection.  At the top of the section, a table that contains 
   switch names and corresponding unique IDs is defined.  This table is 
   referred as an inventory table.  On all subsequent tables, the first 
   index to be used is identical to the unique ID.  For example, the 
   first table contains gswname.1 and gswid.1 that return "IB switch 0" 
   and "GUID0.IB" respectively.  A subsequent switch sensor table may 
   contain sensorDesc.GUID0.IB.1, which indicates first sensor 
   description on switch "IB switch 0", and a query to the object 
   returns "Temp 1: 25C". 
    
   Certain sections of the MIB are dependent on the underlying fabric 
   protocol.  For example, port-related tables might contain different 
    
   Forbes             Expires December 31, 2001                 Page 5    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
   types of errors for Fibre Channel versus InfiniBand.  Therefore the 
   inventory table also contains information regarding protocol types 
   handled by the interconnect element to flag which protocol-dependent 
   tables are relevant. 
    
2.3. SAN-based SNMP Trap Section 
    
   SNMP traps are typically implemented as a switch-specific feature.  
   When the feature is extended to SAN-based paradigm, it is important 
   to provide the ability to suppress traps being sent.  For example, 
   SNMP management application "A" may be only be interested in traps 
   from subnet "A" and SNMP management application "B" may only be 
   interested in traps from subnet "B".  Since there are many different 
   cases of such occasions, the MIB must provide ways to manage 
   different scenarios properly. 
    
   Therefore, switch list information is also tied to each SNMP trap 
   address configuration to figure out the proper IP address to send 
   the traps to. 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                 Page 6    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
3. Object Descriptions 
    
   The following sections describe MIB groups, variables, tables, and 
   traps. 
    
3.1. gswMisc Group 
    
   The GSW MISC group contains MAP-specific objects. 
    
   gswMIBVersion - RO 
   The object indicates the current version of the Switch MIB. 
    
   gswMIBCurrentDate - RO 
   The object indicates the current date on the platform running the 
   SNMP agent that is responding to the MIB query, displayed in textual 
   format. 
    
3.2. gswSystem Group 
    
   The GSW SYSTEM group contains subnet-based objects for switches. 
    
   gswNumOfSwitch - RO 
   The object indicates the number of switches represented in 
   gswInventoryTable. 
    
   gswInventoryTable 
   This is a table that contains entries of switches in a SAN.  A SAN 
   may consist of InfiniBand subnets, Fibre Channel subnets, 
   InfiniBand-InfiniBand routers, and InfiniBand-Fibre Channel edge 
   routers. 
    
   gswInventoryType _ RO 
   This object is one of two indices used by gswInventoryTable.  This 
   index denotes the type of interconnect element. 
      o   Fibre Channel Switch (1) 
      o   InfiniBand Switch (2) 
      o   InfiniBand Router (3) 
      o   InfiniBand-Fibre Channel Edge Router (4) 
      o   iSCSI-based IP Switch (5) 
      o   InfiniBand-iSCSI Edge Router (6) 
      o   Fibre Channel-iSCSI Edge Router (7) 
    
   gswInventoryId - RO 
   The object is an index used by gswInventoryTable.  If the 
   gswInventoryType is Fibre Channel switch type, the gswInventoryId 
   refers to the Worldwide Name (WWN) of the switch.  If the 
   gswInventoryType is InfiniBand switch, InfiniBand Router or 
   InfiniBand-Fibre Channel Edge Router, the gswInventoryId refers to 
   the Globally Unique ID (GUID) of the interconnect element.  Since 
   the index corresponds to either the WWN or GUID assigned to each 
   interconnect element, it is unique but may not be contiguous. 
    
   Forbes             Expires December 31, 2001                 Page 7    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswSwitchName - RW 
   The object is the name of the interconnect element that corresponds 
   to the combination of gswTypeIndex and gswIdIndex. 
    
   gswSwitchGlobalId - RO 
   The object is the unique global ID assigned to the switch expressed 
   in array of 16 octets.  It is the combination of GUID or WWN and the 
   type of an interconnect element. 
    
   gswSwitchEIP _ RO 
   This object identifies the Ethernet IP address of the switch. 
    
   gswSwitchIIP _ RO 
   This object identifies the in-band IP address of the switch. 
    
   gswSwitchIGW _ RO 
   This object identifies the in-band gateway IP address of the switch. 
    
   gswSwitchSANName _ RW 
   The object is the name of the SAN the interconnect element resides 
   in. 
    
   gswSwitchFabricName _ RW 
   The object is the name of the Fibre Channel fabric or the InfiniBand 
   subnet the interconnect element resides in. 
    
   gswSwitchComTable 
   It is a table that contains common information on entries of 
   switches in a SAN.  A SAN may consist of InfiniBand subnets, Fibre 
   Channel fabrics, InfiniBand-InfiniBand routers, and InfiniBand-Fibre 
   Channel edge routers. 
    
   gswSwitchSwitchId - RO 
   The object is the unique global ID assigned to the switch expressed 
   in array of 16 octets.  It is the combination of GUID or WWN and 
   type of an interconnect element. 
    
   gswSwitchMaxPortNum _ RO 
   This object indicates the number of maximum ports available on the 
   switch. 
    
   gswSensorsNum - RO 
   The object indicates the number of sensors inside the switch. 
    
   gswCurrentDate - RO 
   The object is the current date and time of the switch, in 
   displayable textual format. 
    
   gswBootDate - RO 
   The object is the date and time when the switch last booted, in 
   displayable textual format. 
    
   Forbes             Expires December 31, 2001                 Page 8    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswFWLastUpdated - RO 
   The object indicates the date when the firmware was last updated, in 
   displayable textual format. 
    
   gswFlashLastUpdated - RO 
   The object indicates the date when the FLASH was last updated, in 
   displayable textual format. 
    
   gswBootPromLastUpdated - RO 
   The object indicates the date when the boot PROM was last updated, 
   in displayable textual format. 
    
   gswFirmwareVersion - RO 
   The object indicates the current version of the firmware. 
    
   gswHWRevision _ RO 
   The object indicates the current revision of the hardware. 
    
   gswOperStatus - RO 
   The object indicates the current operational status of the switch. 
   The states are as follow: 
      o   Online (1) means the switch is accessible by an external  
          port. 
      o   Offline (2) means the switch is not accessible. 
      o   Testing (3) means the switch is in a built-in test mode and  
          is not accessible by an external port. 
      o   Faulty (4) means the switch is not operational. 
    
   gswAdmStatus - RW 
   The object indicates the desired administrative status of the 
   switch.  A management station may place the switch in a desired 
   state by setting this object accordingly.  The states are as 
   follows: 
      o   Online (1) means set the switch to be accessible by an  
          external port. 
      o   Offline (2) means set the switch to be inaccessible. 
      o   Testing (3) means set the switch to run the built-in test. 
      o   Faulty (4) means set the switch to a 'soft' faulty condition. 
      o   Reboot (5) means set the switch to reboot in 1 second. 
      o   Fastboot (6) means set the switch to fastboot in 1 second.   
   Fastboot would cause the switch to boot but skip over the POST.  
   When the switch is in a faulty state, only three states can be set: 
   Faulty, Reboot, and Fastboot. 
    
   gswSsn - RW 
   The object is the soft serial number of the switch. 
    
   gswBeaconOperStatus - RO 
   The object is the current operational status of the switch beacon.  
   When beaconing is on the switch indicates, in an implementation-
   dependent manner, that it needs attention. 
    
   Forbes             Expires December 31, 2001                 Page 9    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswBeaconAdmStatus - RW 
   The object is the desired status of the switch beacon.  When the 
   beacon is set to on the switch indicates, in an implementation-
   dependent manner, that it needs attention.  When the beacon is set 
   to off, switch indicators will be in their normal state. 
    
   gswDiagResult - RO 
   The object indicates the result of the power-on self test (POST) 
   diagnostics.  A result of 1 indicates that the switch is OK.  Any 
   other result needs to be examined based on switch type. 
    
   gswEventTrapLevel _ RW 
   This object specifies the trap level in conjunction with an event's 
   severity level.  When an event occurs and if the severity is at or 
   below the value specified, an SNMP trap is generated. 
    
   gswEventNumEntries _ RO 
   This object specifies the number of events logged in the event log. 
    
   gswPortComTable 
   It is a table that contains common fields for entries of ports on a 
   switching platform. 
    
   gswPortComEntry - RO 
   An entry of the common switch port information table. 
    
   gswPortComSwitchId - RO 
   The object is the unique global ID assigned to the switch expressed 
   in array of 16 octets.  It is the combination of GUID or WWN and type 
   of an interconnect element. 
    
   gswPortComNum - RO 
   This object indicates the physical port number. 
    
   gswPortComType - RO 
   This object indicates the bit mask of native Protocol supported by 
   the port.  The bits have the following definition: 
        0x00000000 - unknown 
        0x00000001 - FC 
        0x00000002 - IB 
    
   gswPortComName - RO 
   This object indicates the assigned port name. 
    
   gswLicenseTable 
   This table contains license information for the switch.  The 
   definition will be added in this document once it becomes available. 
    
   gswChassisTable 
   This table contains chassis information of the switch.  To support 
   modular or bladed Switch implementations, gswChassisSwitchId is 
    
   Forbes             Expires December 31, 2001                Page 10    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
   defined to denote which switch chassis the blade or module belongs 
   to, if any. 
    
   gswSensorTable        
   The table contains sensor entries. 
    
   gswSensorSwitchId _ RO 
   The object is one of two indexes used by gswSensorTable.  This 
   object corresponds to gswGlobalSwitchId. 
    
   gswSensorIndex - RO   
   This object is one of two indexes used by gswSensorTable.  It 
   identifies the sensor. 
    
   gswSensorType - RO 
   This object identifies the sensor type. 
    
   gswSensorStatus - RO 
   The object indicates the current status of the sensor. 
    
   gswSensorValue - RO 
   The object indicates the current value (reading) of the sensor.  The 
   value, -2147483648, represents an unknown quantity.  It also means 
   that the sensor does not have the capability to measure the actual 
   value. 
    
   gswSensorInfo - RO    
   The object is the additional displayable information on the sensor.  
   It contains the sensor type and number in textual format.  For 
   example, 'Temp 3', 'Fan 6'. 
    
   gswIBNodeTable 
   This table contains node information pertaining to the 
   NodeDescription and NodeInfo attributes within the Subnet Management 
   Agent.  Therefore, this table only applies to InfiniBand node types 
   as indicated by gswInventoryType in gswInventoryTable. 
    
   gswIBNodeSwitchId - RO 
   The object is the index used by gswIBNodeTable.  This object 
   corresponds to gswGlobalSwitchId. 
    
   gswIBNodeString _ RO 
   The object is a UNICODE string to describe the node in text format 
    
   gswIBBaseVersion _ RO 
   The object is the supported Management Datagram (MAD) Base Version.  
   It indicates that this node supports up to and including this 
   version. 
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 11    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswIBClassVersion _ RO 
   The object is the supported Subnet Management Class (SMP) version.  
   It indicates that this node supports up to and including this 
   version. 
    
   gswIBNodeType _ RO 
      1: Channel Adapter 
      2: Switch 
      3: Router 
      0, 4 - 255: Reserved 
    
   gswIBNumPorts - RO 
   The object indicates the number of physical ports on this node.  Its 
   maximum value is 255. 
    
   gswIBNodeGUID - RO 
   The object is the Globally Unique ID (GUID) of the switch.  All 
   ports on the same node shall report the same Node GUID.  It provides 
   a means to uniquely identify a node within a subnet and determine 
   co-location of ports. 
    
   gswIBPortGUID - RO 
   The object is the GUID of this port itself.  One port within a node 
   can return the NodeGUID as its PortGUID if the port is an integral 
   part of the node and is not field-replaceable. 
    
   gswIBDeviceID - RO 
   The object is the Device ID information as assigned by the device 
   manufacturer. 
    
   gswIBRevision _ RO 
   The object is the device revision assigned by the manufacturer. 
    
   gswIBVendorID - RO 
   The object indicates the Device vendor, per IEEE. 
    
   gswIBSwTable 
   This table contains switch information pertaining to the SwitchInfo 
   attribute within Subnet Management Agent.  Therefore, this table 
   only applies to InfiniBand node types as indicated by 
   gswInventoryType in gswInventoryTable. 
    
   gswIBSwSwitchId - RO 
   The object is one of two indexes used by gswIBSwTable.  This object 
   corresponds to gswGlobalSwitchId. 
    
   gswIBSwitchBadMKeyCounter _ RO 
   This object returns the number of Management Key (M_Key) violations 
   for the switch. 
    
    
    
   Forbes             Expires December 31, 2001                Page 12    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswIBSwitchBadBKeyCounter _ RO 
   This object returns the number of Baseboard Management Key (B_Key) 
   violations for the switch. 
    
   gswIBSwitchChangeReason _ RO 
   This object is mainly defined to support switch change traps.  
   Reasons are: 
      o   Unknown   (1) 
      o   Bad M_Key (2) 
      o   Bad B_Key (3) 
    
   gswFCSwTable 
   This table contains switch information pertaining to Fibre Channel 
   switches.  Therefore, this table only applies to Fibre Channel node 
   types as indicated by gswInventoryType in gswInventoryTable. 
    
   gswFCSwSwitchId - RO 
   The object is one of two indexes used by gswFCSwTable.  This object 
   corresponds to gswGlobalSwitchId. 
    
   gswFCDomainId - RW 
   The object indicates the domain ID of the Fibre Channel switch. 
    
   gswFCPrincipalSwitch - RO 
   The object indicates if the Fibre Channel switch is the principal 
   switch of the fabric or not. 
    
    
   gswFCNumNbs - RO 
   The object indicates the number of immediate Fibre Channel neighbor 
   switches connected. 
    
   gswFCNsLocalNumEntry - RO 
   The object indicates the number of local devices in Name Server 
   table. 
    
   gswFCSwitchTrunkable - RW 
   The object indicates if the Fibre Channel switch supports trunking, 
   i.e. the ability to distribute traffic among parallel links. 
    
3.3. gswFabric Group 
    
   The GSW FABRIC group contains information regarding the topology of 
   a SAN. 
    
   gswTopoComTable 
   The table contains information regarding how switches in the SAN are 
   connected. 
    
    
    
    
   Forbes             Expires December 31, 2001                Page 13    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswTopoComSwitchId - RO 
   The object is one of two indexes used by gswTopoComTable.  This 
   object corresponds to gswGlobalSwitchId. 
    
   gswTopoComPortIndex _ RO 
   This object is one of two indexes used by gswTopoComTable.  This 
   object corresponds to the port number the link is connected to. 
    
   gswTopoComNbSwitchId - RO 
   This object is the ID of the switch connected at the end of the port 
   indicated by gswTopoComSwitchId and gswTopoComPortIndex.  It 
   corresponds to gswSwitchGlobalId. 
    
   gswTopoComNbSwitchPort _ RO 
   This object is the port of the switch connected at the end of the 
   port indicated by gswTopoComSwitchId and gswTopoComPortIndex. 
    
   gswTopoComSwitchStatus _ RO 
   The object is defined mainly for trap support.  The object can be 
   set to switch-added (2), switch-deleted (3), link-added(4), or link-
   deleted(5) for a topology change trap.  Query of the object returns 
   no-change (1). 
    
   gswIBTopoTable 
   The table contains information specific to InfiniBand topologies.  
   The table is mostly implemented to support traps. 
    
   gswIBTopoSwitchId - RO 
   The object is the index used by gswIBTopoTable.  This object 
   corresponds to gswGlobalSwitchId. 
    
   gswIBTopoChangeReason _ RO 
   This object is defined mainly for topology change trap support.  The 
   object can be set to: 
      o   Unknown (0) 
      o   Addition/removal of port (1) 
      o   Addition/removal of node (2) 
      o   Addition/removal of host (3) 
      o   Addition/removal of Subnet Manager (4) 
      o   Subnet Manager Failover (5) 
      o   Addition/removal of Controller (6) 
      o   Addition/removal of IO Unit (7) 
    
   gswNbFCTable 
   This table only applies to Fibre Channel Switch type indicated by 
   gswTypeIndex in gswInventoryTable.  gswGlobalSwitchId is used as an 
   index. 
    
3.4. gswModule Group 
    
   This group is currently empty. 
    
   Forbes             Expires December 31, 2001                Page 14    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
3.5. gswPort Group 
    
   The GSW PORT group contains information regarding individual ports. 
    
   gswIBPortTable 
   The object is a table that contains, in one entry for each switch 
   port, configuration and service parameters of the port.  This table 
   mainly represents information contained in the PortInfo attribute 
   within the Subnet Management Agent.  Therefore, this table only 
   applies to InfiniBand node types as indicated by gswInventoryType in 
   gswInventoryTable. 
    
   gswIBPortSwitchId _ RO 
   The object is one of two indexes used by gswIBPortTable.  This 
   object corresponds to gswGlobalSwitchId. 
    
   gswIBPortIndex - RO 
   The object is one of two indexes used by gswIBPortTable.  The object 
   identifies the physical port number. 
    
   gswIBGidPrefix _ RO 
   The object is the Global ID (GID) prefix for this port. 
    
   gswIBLID _ RO 
   The object is the base Local ID (LID) of this port. 
    
    
   gswIBMasterSMLID _ RO 
   The object is the base LID of the master Subnet Manager (SM) that is 
   managing this port. 
    
   gswIBCapabilityMask _ RO 
   The object indicates the supported capabilities of this node.  A bit 
   is set to 1 for affirmation of supported capability. 
      0: Reserved, shall be zero 
      1: IsSM 
      2: IsNoticeSupported 
      3: IsTrapSupported 
      4: IsResetSupported 
      5: IsAutomaticMigrationSupported 
      6: IsSLMappingSupported 
      7: IsMKeyNVRAM (supports M_Key in NVRAM) 
      8: IsPKeyNVRAM (supports P_Key in NVRAM) 
      9: IsLEDInfoSupported 
      10: IsSMdisabled 
      11 - 15: Reserved, shall be zero 
      16: IsConnectionManagementSupported 
      17: IsSNMPTunnelingSupported 
      18: Reserved, shall be zero 
      19: IsDeviceManagementSupported 
      20: IsVendorClassSupported 
    
   Forbes             Expires December 31, 2001                Page 15    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
      21 - 31: Reserved, shall be zero 
    
   gswIBDiagCode _ RO 
   The object indicates the InfiniBand Diagnostic code. 
    
   gswIBLinkWidthEnabled _ RO 
   The object indicates the enabled link width, as follows: 
      0: No State Change (NOP) 
      1: 1x 
      2: 4x 
      3: 1x or 4x 
      8: 12x 
      9: 1x or 12x 
      10: 4x or 12x 
      11: 1x, 4x or 12x 
      4 - 7, 12 - 254: Reserved (Ignored) 
      255: Set to LinkWidthSupported value. 
   When writing this field, only legal transitions are valid.  See 
   Volume 2 of the 1.0 InfiniBand specification [1]. 
    
   gswIBLinkWidthSupported _ RO 
   The object indicates the supported link width, as follows: 
      1: 1x 
      3: 1x or 4x 
      11: 1x, 4x or 12x 
      0, 2, 4-10, 12-255: Reserved 
    
   gswIBLinkWidthActive _ RO 
   The object is the currently active link width, as follows: 
      1: 1x 
      2: 4x 
      8: 12x 
      0, 3, 4-7, 9-255: Reserved 
    
   gswIBLinkSpeedSupported _ RO 
   The object indicates the supported link speed, as follows: 
      1: 2.5Gbps 
      0, 2 - 15: reserved 
    
   gswIBPortState _ RO 
   The object indicates the port state.  Enumerated as: 
      0: No State Change (NOP) 
      1: Down (includes failed links) 
      2: Initialize 
      3: Armed 
      4: Active 
      5: 15: Reserved - ignored 
    
   gswIBPortPhysicalState _ RO 
   The object indicates the port physical state.  Enumerated as: 
      0: No state change 
      1: Sleep 
    
   Forbes             Expires December 31, 2001                Page 16    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
      2: Polling 
      3: Disabled 
      4: PortConfigurationTraining 
      5: LinkUp 
      6: LinkErrorRecovery0 
      7 - 15: Reserved - ignored 
    
   gswIBLinkDownDefaultState _ RO 
   The object indicates the link down default state.  Enumerated as: 
      0: No state change 
      1: Sleep 
      2: Polling 
      3 - 15: Reserved - ignored 
    
   gswIBLMC _ RO 
   The object is the LID mask for multipath support. 
    
   gswIBLinkSpeedActive _ RO 
   The object indicates the currently active link speed, as follows: 
      1: 2.5Gbps 
      0, 2 - 15: reserved 
    
   gswIBLinkSpeedEnabled _ RO 
   The object indicates the enabled link speed, as follows: 
      0: No State Change (NOP) 
      1: 2.5 Gbps 
      2 - 14: Reserved (Ignored) 
      15: Set to LinkSpeedSupported value 
   When writing this field, only legal transitions are valid.  See 
   Volume 2 of the 1.0 InfiniBand specification [1]. 
    
   gswIBNeighborMTU _ RO 
   The object indicates the active maximum MTU enabled on this port for 
   transmit: 
      1: 256 
      2: 512 
      3: 1024 
      4: 2048 
      5: 4096 
      0, 6 - 15: reserved 
    
   gswIBVLCap _ RO 
   The object indicates the Virtual Lanes (VLs) supported on this port, 
   as follows: 
      1: VL0 
      2: VL0, VL1 
      3: VL0 - VL3 
      4: VL0 - VL7 
      5: VL0 - VL14 
      0, 6 - 15: reserved 
    
    
    
   Forbes             Expires December 31, 2001                Page 17    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswIBMTUCap _ RO 
   The object is the Maximum Transmission Unit (MTU) supported by this 
   port. 
      1: 256 
      2: 512 
      3: 1024 
      4: 2048 
      5: 4096 
      0, 6 - 15: reserved 
    
   gswIBOperationalVLs _ RO 
   The object indicates the Virtual Lanes (VLs) operational on this 
   port, as follows: 
      0: No change 
      1: VL0 
      2: VL0, VL1 
      3: VL0 - VL3 
      4: VL0 - VL7 
      5: VL0 - VL14 
      6 - 15: reserved 
    
   gswIBMKeyViolations _ RO 
   The object counts the number of SMP packets that have been received 
   at this port that have had invalid M_Keys, since power-on or reset.  
   Increments until count reaches all 1s and then must be set back to 
   zero to re-enable incrementing. 
    
    
   gswIBPKeyViolations _ RO 
   The object counts the number of packets that have been received at 
   this port that have had invalid P_Keys, since power-on or reset.  
   Increments until count reaches all 1s and then must be set back to 
   zero to re-enable incrementing. 
    
   gswIBQKeyViolations _ RO 
   The object counts the number of packets that have been received at 
   this port that have had invalid Q_Keys, since power-on or reset. 
   Increments until count reaches all 1s and then must be set back to 
   zero to re-enable incrementing. 
    
   gswIBLocalPhyErrors _ RO 
   The object is the threshold value.  When the count of marginal link 
   errors exceeds this threshold, the local link integrity error shall 
   be detected. 
    
   gswIBOverrunErrors _ RO 
   The object is the threshold value.  When the count of buffer 
   overruns over consecutive flow control update periods exceeds this 
   threshold, the excessive buffer overrun error shall be detected. 
    
    
    
   Forbes             Expires December 31, 2001                Page 18    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswIBPortChangeReason - RO 
   The object is mainly implemented to support traps.  The object 
   denotes the reason for trap generation.  Reasons are: 
      o   Unknown (1) 
      o   Link integrity error (2) 
      o   Excessive buffer overrun error (3) 
      o   Flow control timeout (4) 
      o   Bad P_Key (5) 
    
   gswFCPort Table 
   This table contains information regarding individual FIBRE CHANNEL 
   ports. Therefore, this table only applies to Fibre Channel Switches 
   as indicated by gswTypeIndex in gswInventoryTable.  The table 
   mirrors the Fibre Channel MIB, extended by the additional index 
   gswGlobalSwitchId. 
    
3.6. gswPortPerfGroup 
    
   This group contains information regarding port performance counters. 
    
   gswBlmPerfALPAMntTable, gswBlmPerfEEMntTable, gswBlmFltMntTable:  
   These tables only apply to Fibre Channel Switches as indicated by 
   gswTypeIndex in gswInventoryTable.  They mirror implementation of 
   these tables in Fibre Channel except that gswGlobalSwitchId is added 
   as an index. 
    
   gswIBPortPerfTable 
   The table contains information pertaining to the PortCounters 
   attribute within the Performance Management Agent.  Therefore, this 
   table only applies to InfiniBand node types as indicated by 
   gswInventoryType in gswInventoryTable. 
    
   gswIBPortPerfSwitchId _ RO 
   The object is one of two indexes used by gswIBPortPerfTable.  This 
   object corresponds to swGlobalSwitchId. 
    
   gswIBPortPerfIndex - RO 
   The object is one of two indexes used by gswIBPortPerfTable.  The 
   object identifies the physical port number. 
    
   gswIBSymbolErrorCounter _ RO 
   The object indicates total number of symbol errors detected on one 
   or more lanes. 
    
   gswIBLinkErrorRecoveryCounter _ RO 
   The object indicates total number of times the Port Training state 
   machine has successfully completed the link error recovery process. 
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 19    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswIBLinkDownedCounter _ RO 
   The object indicates total number of times the Port Training state 
   machine has failed the link error recovery process and downed the 
   link. 
    
   gswIBPortRcvErrors _ RO 
   The object indicates total number of packets containing an error 
   that were received on the port.  These errors include: 
      o   Local physical errors (ICRC, VCRC, FCCRC, and all physical 
          errors that cause entry into the BAD PACKET or BAD PACKET  
          DISCARD states of the packet receiver state machine) 
      o   Malformed data packet errors (LVer, length, VL) 
      o   Malformed link packet errors (operand, length, VL) 
      o   Packets discarded due to buffer overrun 
    
   gswIBPortRcvRemotePhysicalErrors _ RO 
   The object indicates total number of packets marked with the EBP 
   delimiter received on the port. 
    
   gswIBPortRcvSwitchRelayErrors _ RO 
   The object indicates total number of packets received on the port 
   that were discarded because they could not be forwarded by the 
   switch relay. Reasons for this include: 
      o   DLID mapping 
      o   VL mapping 
      o   Looping (output port = input port) 
    
   gswIBPortXmitDiscards _ RO 
   The object indicates total number of outbound packets discarded by 
   the port because the port is down or congested. Reasons for this 
   include: 
      o   Output port is in the inactive state 
      o   Packet length exceeded neighbor MTU 
      o   Switch lifetime limit exceeded 
      o   Switch Head of Queue (HOQ) limit exceeded 
    
   gswIBPortXmitConstraintErrors _ RO 
   The object indicates total number of packets not transmitted from 
   the port for the following reasons: 
      o   FilterRawOutbound is true and packet is raw 
      o   PartitionEnforcementOutbound is true and packet fails  
          partition key check, IP version check, or transport header  
          version check 
    
   gswIBPortRcvConstraintErrors _ RO 
   The object indicates total number of packets received on the port 
   that are discarded for the following reasons: 
      o   FilterRawInbound is true and packet is raw 
      o   PartitionEnforcementInbound is true and packet fails  
          partition key check, IP version check, or transport header  
          version check 
    
   Forbes             Expires December 31, 2001                Page 20    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswIBLocalLinkIntegrityErrors _ RO 
   The object indicates the number of times that the frequency of 
   packets containing local physical errors exceeded local_phy_errors. 
    
   gswIBExcessiveBufferOverrunErrors _ RO 
   The object indicates the number of times that overrun errors 
   consecutive flow control update periods occurred with at least one 
   overrun error in each period. 
    
   gswIBVL15Dropped _ RO 
   The object indicates the number of incoming VL15 packets dropped due 
   to resource limitations on the port. 
    
   gswIBPortXmitData _ RO 
   The object indicates total number of data octets, divided by 4, 
   transmitted on all VLs from the port.  This includes all octets 
   between (and not including) the start of packet delimiter and VCRC.  
   It excludes all link packets. 
    
   gswIBPortRcvData _ RO 
   The object indicates total number of data octets, divided by 4, 
   received on all VLs on the port.  This includes all octets between 
   (and not including) the start of packet delimiter and VCRC.  It 
   excludes all link packets. 
    
   gswIBPortXmitPkts _ RO 
   The object indicates total number of packets, excluding link 
   packets, transmitted on all VLs from the port. 
    
   gswIBPortRcvPkts _ RO 
   The object indicates total number of packets, including packets 
   containing errors and excluding link packets, received from all VLs 
   on the port. 
    
3.7. gswNs Group 
    
   The GSW NS group contains Name Server and Directory Server 
   information. 
    
   gswNsLocalFCTable 
   The table contains list of local Name Server entries for Fibre 
   Channel switches.  Therefore, this table only applies to Fibre 
   Channel Switch type indicated by gswTypeIndex in gswInventoryTable.  
   The table mirrors the implementation of swNsLocalTable in Fibre 
   Channel, except gswGlobalSwitchId is added as an index. 
    
   gswNsLocalIBTable 
   The table contains list of local naming entries for InfiniBand 
   interconnect elements.  Therefore, this table applies to InfiniBand 
   node types as indicated by gswTypeIndex in gswInventoryTable.  Name 
   Service related issues for InfiniBand have not been finalized yet.  
    
   Forbes             Expires December 31, 2001                Page 21    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
   This table is to be filled appropriately, as the definition becomes 
   concrete. 
    
   gswNsLIBSwitchId _ RO 
   The object is one of two indexes used by gswNsLocalIBTable.  This 
   object corresponds to gswGlobalSwitchId. 
    
   gswNsLIBEntryIndex - RO 
   The object is one of two indexes used by gswNsLocalIBTable.  It 
   identifies the Name Server database entry. 
    
3.8. gswEvent Group 
    
   The GSW EVENT group contains switch event information. 
    
   gswEventTable  
   The object is the table of event entries. 
    
   gswEventSwitchId _ RO 
   The object is one of two indexes used by gswEventTable.  It 
   corresponds to gswGlobalSwitchId. 
    
   gswEventIndex - RO 
   The object is one of two indexes used by gswEventTable.  It 
   identifies the event entry. 
    
   gswEventTimeInfo - RO  
   This object identifies the date and time when this event occurred, 
   in textual format. 
    
   gswEventLevel - RO 
   This object identifies the severity level of this event entry. 
    
   gswEventRepeatCount - RO 
   This object identifies how many times this particular event has 
   occurred. 
    
   gswEventDescr - RO 
   This object identifies the textual description of the event. 
    
3.10. gswEndDevice Group 
   This group contains information related to end devices.  InfiniBand    
   end device support has not been finalized and the group is to be 
   appropriately filled, as the plan becomes concrete. 
    
   gswFCEndDeviceRlsTable 
   This table contains information pertaining to LESB block information 
   of attached devices.  (FC ONLY-- add IB version?) 
    
3.11. gswTrunk Group 
    
   This group contains information regarding trunking features. 
    
   Forbes             Expires December 31, 2001                Page 22    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   GswSwitchTrunkableTable 
   GswTrunkTable 
   gswTrunkGrpTable 
   These tables only apply to Fibre Channel Switches as indicated by 
   gswTypeIndex in gswInventoryTable.  The gswTrunkTable and 
   gswTrunkGrpTable mirror implementation of these tables in Fibre 
   Channel except that gswGlobalSwitchId is added as an index.  
   GswSwitchTrunkableTable is an expansion of the Fibre Channel scalar 
   object swSwitchTrunkable.  gswGlobalSwitchId is added as an index. 
    
3.12. gswAgtCfg Group 
    
   gswAgtCmtyTable 
   This object is a table that contains, in one entry for each 
   Community, the access control and parameters of the Community. 
    
   gswAgtCmtySwitchId _ RO 
   The object is one of two indexes used by gswAgtCmtyTable.  It 
   corresponds to gswGlobalSwitchId. 
    
   gswAgtCmtyIdx - RO    
   The object is one of two indexes used by gswAgtCmtyTable.  It 
   identifies the SNMPv1 Community entry. 
    
   gswAgtCmtyStr - RW 
   This is a Community string supported by the agent.  If a new value 
   is set successfully, it takes effect immediately. 
    
   gswAgtTrapRcp - RW 
   This is the trap recipient associated with the Community.  If a new 
   value is set successfully, it takes effect immediately. 
    
   gswAgtTrapGroupTable 
   This table defines the list of the group of switches from where SNMP 
   traps should be forward to the trap recipient. 
    
   gswAgtTGSwitchId _ RO 
   The object is one of three indexes used by gswAgtTrapGroupTable.  It 
   corresponds to gswGlobalSwitchId. 
    
   gswAgtTGCmtyIdx - RO  
   The object is one of three indexes used by gswAgtTrapGroupTable.  It 
   corresponds to SwAgtCmtyIdx. 
    
   gswAgtTGSwitchIdx _ RO 
   This object is one of three indexes used by gswAgtTrapGroupTable.  
   It corresponds to index of switches from which the traps should be 
   forwarded to the trap recipient listed. 
    
    
    
    
   Forbes             Expires December 31, 2001                Page 23    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   gswAgtTGSwitchName _ RW 
   This object is the name of switch from which the traps should be 
   forwarded to the trap recipient.  A name may be deleted by writing 
   NULL string in the field.  A name can be added by writing a valid 
   switch name using gswAgtTGSwitchIdx of 1. 
    
3.13. Traps Group 
    
   gswTopoComTrap 
   The trap reports changes to common topology change.  The event 
   includes addition or removal of switches.  The trap includes the 
   following objects: 
      o   gswTopoComSwitchId 
      o   gswTopoComNbSwitchId 
      o   gswTopoComSwitchStatus 
    
   gswIBTopoTrap 
   The trap reports changes to topology change.  The event includes 
   addition or removal of physical devices and SM fail-over.  The trap 
   includes the following objects: 
      o   gswIBTopoSwitchId 
      o   gswIBTopoChangeReason 
    
   gswFCPortTrap 
   The trap reports changes to Fibre Channel port state. 
    
   gswIBPortTrap 
   This trap reports InfiniBand-specific events.  The event includes 
   link integrity error, excessive buffer overrun error, flow control 
   timeout, and bad P_Key.  The trap includes the following objects: 
      o   gswIBPortSwitchId 
      o   gswIBPortIndex 
      o   gswIBPortChangeReason 
    
   gswIBSwitchTrap 
   This trap reports InfiniBand-specific events.  The event includes 
   bad M_Key and bad B_Key.  The trap includes the following objects: 
      o   gswSwSwitchId  
      o   gswSwitchChangeReason 
    
   gswEventTrap 
   The trap reports events being logged. 
    
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 24    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   4. Object Definitions 
    
    
   IBSWITCH-MIB DEFINITIONS ::= BEGIN 
     IMPORTS 
        enterprises, NetworkAddress 
             FROM RFC1155-SMI 
        OBJECT-TYPE 
             FROM RFC1212 
        TRAP-TYPE 
             FROM RFC-1215; 
    
     -- additional textual conventions 
    
     -- DisplayString: comment out the next line if your MIB compiler  
     -- complains that it is already defined. 
        DisplayString    ::= OCTET STRING -- displayable octets (ASCII) 
    
        GswType     ::= INTEGER { 
             fcSwitch           (1), 
             ibSwitch           (2), 
             ibRouter           (3), 
             ib2fcEdgeRouter    (4), 
             iSCSIBasedIPSwitch (5), 
             ib2iSCSEdgeRouter  (6), 
             fc2iSCSIEdgeRouter (7) 
             } 
    
        GswLocalId       ::= OCTET STRING (SIZE(8)) 
    
        GswGlobalId      ::= OCTET STRING (SIZE(16)) 
    
        GswOlsName       ::= OCTET STRING (SIZE(256)) 
    
        GswFwVersion     ::= OCTET STRING (SIZE(0..24)) 
             -- example: 
             -- v1.0.1 
    
        GswDate          ::= OCTET STRING (SIZE(0..64)) 
             -- example: 
             -- Wed Mar 21 17:07:17 2001 
    
    
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 25    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
        GswSwitchStatus     ::=INTEGER { 
             online           (1),     -- switch is accessible by an  
                                       -- external port. 
             offline          (2),     -- switch is not accessible. 
             testing          (3),     -- switch is in a built-in test  
                                       -- mode and is not accessible by  
                                       -- an external port. 
             faulty           (4),     -- switch is not operational. 
             reboot           (5),     -- set the switch to reboot in 1  
                                       -- second. 
             fastboot         (6)      -- set the switch to fastboot in  
                                       -- 1 second. 
                                       -- Fastboot would cause the  
                                       -- switch to boot but skip over  
                                       -- the POST. When the switch is 
                                       -- in faulty state, only three  
                                       -- states can be set: 
                                       -- faulty, reboot, and fastboot. 
             } 
    
        GswOnOff     ::= INTEGER { on (1), off (2) } 
    
        GswSensorTypeDef ::= INTEGER { 
             temperature          (1), 
             fan                  (2), 
             power-supply         (3) 
        } 
    
        GswSensorStatusDef ::= INTEGER { 
             unknown              (1), 
             faulty               (2), 
             below-min            (3), 
             nominal              (4), 
             above-max            (5), 
             absent               (6) 
        } 
    
        GswIBNodeType      ::= INTEGER { 
             channelAdapter       (1), 
             switch               (2), 
             router               (3) 
        } 
    
        GswIBGUID         ::= OCTET STRING (SIZE(8)) 
        GswIBGID          ::= OCTET STRING (SIZE(8)) 
        GswIBLID          ::= OCTET STRING (SIZE(2)) 
        GswIBLinkWidth     ::= INTEGER { 
             nop                  (1), 
             lw1x                 (2), 
             lw4x                 (3), 
             lw1x-4x              (4), 
    
   Forbes             Expires December 31, 2001                Page 26    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
             lw12x                (9), 
             lw1x-12x             (10), 
             lw4x-12x             (11), 
             lw1x-4x-12x          (12) 
        } 
        GswIBLinkSpeed     ::= INTEGER { 
             ls2-5gbps            (1) 
        } 
        GswIBPortState     ::= INTEGER { 
             nop                  (1), 
             down                 (2), 
             initialize           (3), 
             armed                (4), 
             actived              (5) 
        } 
        GswIBPortPhysState ::= INTEGER { 
             nop                  (1), 
             sleep                (2), 
             polling              (3), 
             disabled             (4), 
             portconftrain        (5), 
             linkup               (6), 
             linkerrorrec0        (7) 
        } 
        GswIBMTU           ::= INTEGER { 
             mtu256               (1), 
             mtu512               (2), 
             mtu1024              (3), 
             mtu2048              (4), 
             mtu4096              (5) 
        } 
        GswIBVL            ::= INTEGER { 
             vl0                  (1), 
             vl0vl1               (2), 
             vl0vl3               (3), 
             vl0vl7               (4), 
             vl0vl14              (5) 
        } 
    
        GswEventSeverity   ::= INTEGER { 
             none                 (0), 
             critical             (1), 
             error                (2), 
             warning              (3), 
             informational        (4), 
             debug                (5) 
        } 
    
   -- 64 bit counter definition 
        GswCounter64  ::= OCTET STRING (SIZE(16)) 
    
    
    
   Forbes             Expires December 31, 2001                Page 27    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     -- Product Lines or Generic Product information 
     xrt               OBJECT IDENTIFIER ::= { experimental } 
    
     commDev           OBJECT IDENTIFIER ::= { xrt 2 } 
     genericSwitch     OBJECT IDENTIFIER ::= { commDev 2 } 
    
     gsw               OBJECT IDENTIFIER ::= { genericSwitch 1 } 
     ib1k              OBJECT IDENTIFIER ::= { genericSwitch 2 } 
    
     -- various groups 
     gswMisc           OBJECT IDENTIFIER ::= { gsw 1 } 
     gswSystem         OBJECT IDENTIFIER ::= { gsw 2 } 
    
     gswFabric         OBJECT IDENTIFIER ::= { gsw 5 } 
     gswModule         OBJECT IDENTIFIER ::= { gsw 6 } 
    
     gswPort           OBJECT IDENTIFIER ::= { gsw 10 } 
     gswPortPerf       OBJECT IDENTIFIER ::= { gsw 11 } 
    
     gswNs             OBJECT IDENTIFIER ::= { gsw 13 } 
    
     gswEvent          OBJECT IDENTIFIER ::= { gsw 15 } 
    
     gswEndDevice      OBJECT IDENTIFIER ::= { gsw 21 } 
    
     gswAgtCfg         OBJECT IDENTIFIER ::= { gsw 25 } 
    
     -- 
     -- Misc. Group 
     -- 
     gswMIBVersion      OBJECT-TYPE 
        SYNTAX          DisplayString (SIZE (4)) 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "MIB version in textual format. 
             example: 
                  version 1.0 is represented as 0100 
                  version 1.1 is represented as 0101" 
     ::= { gswMisc 1 } 
    
     gswMIBCurrentDate  OBJECT-TYPE 
        SYNTAX          GswDate 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The current date information of the location  
             of the MIB in displayable textual format." 
     ::= { gswMisc 2 } 
     -- 
     -- End of Misc. Group 
     -- 
    
    
   Forbes             Expires December 31, 2001                Page 28    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     -- 
    -- System Group 
     -- 
     gswNumOfSwitch     OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the number of switches 
             represented in gswInventoryTable." 
     ::= { gswSystem 1 } 
    
     gswInventoryTable  OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswInventoryEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "It is a table that contains entries of  
             switches in a SAN.  A SAN may consist of IB subnets,  
             FC fabrics, IB-IB routers, and IB-FC edge routers." 
     ::= { gswSystem 2 } 
    
     gswInventoryEntry  OBJECT-TYPE 
        SYNTAX          GswInventoryEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the switch information." 
        INDEX          { gswInventoryType, gswInventoryId } 
     ::= { gswInventoryTable 1 } 
    
     GswInventoryEntry ::= SEQUENCE { 
        gswInventoryType           GswType, 
        gswInventoryId             GswLocalId, 
        gswSwitchName              GswOlsName, 
        gswSwitchGlobalId          GswGlobalId, 
        gswSwitchEIP               NetworkAddress, 
        gswSwitchIIP               NetworkAddress, 
        gswSwitchIGW               NetworkAddress, 
        gswSwitchSANName           GswOlsName, 
        gswSwitchFabricName        GswOlsName 
     } 
    
     gswInventoryType   OBJECT-TYPE 
        SYNTAX          GswType 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object is one of two indices used by 
             gswInventoryTable. This index denotes the type of 
             interconnect element." 
     ::= { gswInventoryEntry 1 } 
    
    
    
    
   Forbes             Expires December 31, 2001                Page 29    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswInventoryId     OBJECT-TYPE 
        SYNTAX          GswLocalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is an index used by  
             gswInventoryTable.  If the gswInventoryType is FC switch  
             type, the gswInventotyId refers to WWN of the switch.  If  
             the gswInventoryType is IB switch, IB Router or IB-FC Edge  
             Router, the gswInventoryId refers to GUID of the  
             interconnect element.  Since the index corresponds to 
             either WWN or GUID assigned to each interconnect element, 
             it is unique but may not be contiguous." 
     ::= { gswInventoryEntry 2 } 
    
     gswSwitchName      OBJECT-TYPE 
        SYNTAX          GswOlsName 
        ACCESS          read-write 
        STATUS          mandatory 
        DESCRIPTION     "The object is the name of the interconnect  
             element that corresponds to the combination of  
             gswTypeIndex and gswIdIndex." 
     ::= { gswInventoryEntry 7 } 
    
     gswSwitchGlobalId  OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the unique global ID assigned to  
             the switch expressed in array of 16 octets.  It is the  
             combination of GUID or WWN and type of an interconnect  
             element." 
     ::= { gswInventoryEntry 8 } 
    
     gswSwitchEIP       OBJECT-TYPE 
        SYNTAX          NetworkAddress 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies the ethernet IP 
             address of the switch." 
     ::= { gswInventoryEntry 9 } 
    
     gswSwitchIIP       OBJECT-TYPE 
        SYNTAX          NetworkAddress 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies the in-band IP 
             address of the switch." 
     ::= { gswInventoryEntry 10 } 
    
    
    
    
   Forbes             Expires December 31, 2001                Page 30    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswSwitchIGW       OBJECT-TYPE 
        SYNTAX          NetworkAddress 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies the in-band gateway IP 
             address of the switch." 
     ::= { gswInventoryEntry 11 } 
    
     gswSwitchSANName   OBJECT-TYPE 
        SYNTAX          GswOlsName 
        ACCESS          read-write 
        STATUS          mandatory 
        DESCRIPTION     "The object is the name of the SAN the  
             interconnect element resides in." 
     ::= { gswInventoryEntry 12 } 
    
     gswSwitchFabricName OBJECT-TYPE 
        SYNTAX          GswOlsName 
        ACCESS          read-write 
        STATUS          mandatory 
        DESCRIPTION     "The object is the name of the FC fabric or IB  
             subnet the interconnect element resides in." 
     ::= { gswInventoryEntry 13 } 
    
     gswSwitchComTable  OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswSwitchComEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "It is a table that contains common fields for 
             entries of switches in a SAN. SAN may consist of IB  
             subnets, FC fabrics, IB-IB routers, and IB-FC edge  
             routers." 
     ::= { gswSystem 3 } 
    
     gswSwitchComEntry  OBJECT-TYPE 
        SYNTAX          GswSwitchComEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the common switch information." 
        INDEX          { gswSwitchSwitchId } 
     ::= { gswSwitchComTable 1 } 
    
     GswSwitchComEntry ::= SEQUENCE { 
        gswSwitchSwitchId          GswGlobalId, 
        gswSwitchMaxPortNum        INTEGER, 
        gswSensorsNum              INTEGER, 
        gswCurrentDate             GswDate, 
        gswBootDate                GswDate, 
        gswFWLastUpdated           GswDate, 
        gswFlashLastUpdated        GswDate, 
        gswBootPromLastUpdated     GswDate, 
    
   Forbes             Expires December 31, 2001                Page 31    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
        gswFirmwareVersion         GswFwVersion, 
        gswHWRevision              DisplayString (SIZE (0..32)), 
        gswOperStatus              GswSwitchStatus, 
        gswAdmStatus               GswSwitchStatus, 
        gswSsn                     DisplayString (SIZE (0..128)), 
        gswBeaconOperStatus        GswOnOff, 
        gswBeaconAdmStatus         GswOnOff, 
        gswDiagResult              INTEGER, 
        gswEventTrapLevel          GswEventSeverity, 
        gswEventNumEntries         INTEGER 
     } 
    
     gswSwitchSwitchId  OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the unique global ID assigned to  
             the switch expressed in array of 16 octets.  It is the  
             combination of GUID or WWN and type of an interconnect  
             element." 
     ::= { gswSwitchComEntry 1 } 
    
     gswSwitchMaxPortNum OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object indicates the maximum number of  
             ports available on the switch." 
     ::= { gswSwitchComEntry 2 } 
    
     gswSensorsNum      OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the number of sensors 
             inside the switch." 
     ::= { gswSwitchComEntry 3 } 
    
     gswCurrentDate     OBJECT-TYPE 
        SYNTAX          GswDate 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The current date information of the switch in 
             displayable textual format." 
     ::= { gswSwitchComEntry 10 } 
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 32    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswBootDate        OBJECT-TYPE 
        SYNTAX          GswDate 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the date and time when the  
             switch last booted, in displayable textual format." 
     ::= { gswSwitchComEntry 11 } 
    
     gswFWLastUpdated   OBJECT-TYPE 
        SYNTAX          GswDate 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the date when the  
             firmware was last updated, in displayable textual format." 
     ::= { gswSwitchComEntry 12 } 
    
     gswFlashLastUpdated OBJECT-TYPE 
        SYNTAX          GswDate 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the date when the FLASH  
             was last updated, in displayable textual format." 
     ::= { gswSwitchComEntry 13 } 
    
     gswBootPromLastUpdated OBJECT-TYPE 
        SYNTAX          GswDate 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the date when the boot  
             PROM was last updated, in displayable textual format." 
     ::= { gswSwitchComEntry 14 } 
    
     gswFirmwareVersion OBJECT-TYPE 
        SYNTAX          GswFwVersion 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the current version of  
             the firmware." 
     ::= { gswSwitchComEntry 20 } 
    
   gswHWRevision        OBJECT-TYPE 
        SYNTAX          DisplayString(SIZE (0..32)) 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the current revision of  
             the hardware." 
     ::= { gswSwitchComEntry 21 } 
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 33    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswOperStatus      OBJECT-TYPE 
        SYNTAX          GswSwitchStatus 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the current operational  
             status of the switch." 
     ::= { gswSwitchComEntry 22 } 
    
     gswAdmStatus       OBJECT-TYPE 
        SYNTAX          GswSwitchStatus 
        ACCESS          read-write 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the desired  
             administrative status of the switch.  A management station  
             may place the switch in a desired state by setting this  
             object accordingly." 
     ::= { gswSwitchComEntry 23 } 
    
     gswSsn             OBJECT-TYPE 
        SYNTAX          DisplayString (SIZE (0..128)) 
        ACCESS          read-write 
        STATUS          mandatory 
        DESCRIPTION     "The object is the soft serial number of the  
             switch." 
     ::= { gswSwitchComEntry 26 } 
    
     gswBeaconOperStatus OBJECT-TYPE 
        SYNTAX          GswOnOff 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the current operational status  
             of the switch beacon.  When the beacon is on, the switch  
             will give an indication that it needs attention." 
     ::= { gswSwitchComEntry 30 } 
    
     gswBeaconAdmStatus OBJECT-TYPE 
        SYNTAX          GswOnOff 
        ACCESS          read-write 
        STATUS          mandatory 
        DESCRIPTION     "The object is the desired status of the switch  
             beacon.  When the beacon is on, the switch will give an  
             indication that it needs attention." 
     ::= { gswSwitchComEntry 31 } 
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 34    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswDiagResult      OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the result of the  
             power-on self test (POST) diagnostics.  Result of 1  
             indicate that the switch is OK.  Any other result needs to  
             be examined based on switch type." 
     ::= { gswSwitchComEntry 40 } 
    
     gswEventTrapLevel  OBJECT-TYPE 
        SYNTAX          GswEventSeverity 
        ACCESS          read-write 
        STATUS          mandatory 
        DESCRIPTION     "This object specifies the gswEventTrap level  
             in conjunction with an event's severity level.  When an  
             event occurs and if its severity level is at or below the  
             value specified by this object instance, the agent will  
             send the associated gswEventTrap to configured  
             recipients." 
     ::= { gswSwitchComEntry 41 } 
     
     gswEventNumEntries OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The number of entries in the Event Table." 
     ::= { gswSwitchComEntry 42 } 
    
     gswPortComTable    OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswPortComEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "It is a table that contains common fields for 
             entries of ports on a switching platform." 
     ::= { gswSystem 4 } 
    
     gswPortComEntry    OBJECT-TYPE 
        SYNTAX          GswPortComEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the common switch port  
             information." 
        INDEX           { gswPortComSwitchId, gswPortComNum } 
     ::= { gswPortComTable 1 } 
    
     GswPortComEntry  ::= SEQUENCE { 
        gswPortComSwitchId      GswGlobalId, 
        gswPortComNum           INTEGER, 
        gswPortComType          INTEGER, 
        gswPortComName          GswOlsName 
    
   Forbes             Expires December 31, 2001                Page 35    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
     } 
    
     gswPortComSwitchId OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the unique global ID assigned to  
             the switch expressed in array of 16 octets. It is the  
             combination of GUID or WWN and type of an interconnect  
             element." 
     ::= { gswPortComEntry 1 } 
    
     gswPortComNum      OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object indicates the physical port  
             number." 
     ::= { gswPortComEntry 2 } 
    
     gswPortComType     OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object indicates the bit mask of native  
             Protocol supported by the port.  The bits have the  
             following definition: 
                  0x00000000 - unknown 
                  0x00000001 - FC 
                  0x00000002 - IB" 
     ::= { gswPortComEntry 3 } 
    
     gswPortComName     OBJECT-TYPE 
        SYNTAX          GswOlsName 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object indicates the assigned port name." 
     ::= { gswPortComEntry 4 } 
    
    
     -- operating environment sensors  
     --     (temperature, fan, power supply...) 
    
     gswSensorTable     OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswSensorEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "The table of sensor entries." 
     ::= { gswSystem 10 } 
    
    
    
    
   Forbes             Expires December 31, 2001                Page 36    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswSensorEntry     OBJECT-TYPE 
        SYNTAX          GswSensorEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the sensor information." 
        INDEX          { gswSensorSwitchId, gswSensorIndex } 
     ::= { gswSensorTable 1 } 
    
     GswSensorEntry     ::= SEQUENCE { 
        gswSensorSwitchId       GswGlobalId, 
        gswSensorIndex          INTEGER, 
        gswSensorType           GswSensorTypeDef, 
        gswSensorStatus         GswSensorStatusDef, 
        gswSensorValue          INTEGER, 
        gswSensorInfo           DisplayString (SIZE(0..255)) 
     } 
    
     gswSensorSwitchId  OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is one of two indexes used by 
             gswSensorTable. This object corresponds to  
             gswGlobal itchId." 
     ::= { gswSensorEntry 1 } 
    
     gswSensorIndex     OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies the sensor." 
     ::= { gswSensorEntry 2 } 
    
     gswSensorType      OBJECT-TYPE 
        SYNTAX          GswSensorTypeDef 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies the sensor type." 
     ::= { gswSensorEntry 3 } 
    
     gswSensorStatus    OBJECT-TYPE 
        SYNTAX          GswSensorStatusDef 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The current status of the sensor." 
     ::= { gswSensorEntry 4 } 
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 37    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswSensorValue     OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The current value (reading) of the sensor. 
             The value, -2147483648, represents an unknown quantity. 
             It also means that the sensor does not have the capability  
             to measure the actual value." 
     ::= { gswSensorEntry 5 } 
    
     gswSensorInfo      OBJECT-TYPE 
        SYNTAX          DisplayString (SIZE(0..255)) 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "Additional displayable information on the  
             sensor.  It contains the sensor type and number 
             in textual format.  For example, 'Temp 3', 'Fan 6'." 
     ::= { gswSensorEntry 6 } 
    
     gswIBNodeTable     OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswIBNodeEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "This table contains node information  
             pertaining to NodeDescription and NodeInfo within the  
             Subnet Management Agent.  Therefore, this table only  
             applies to IB Switch, IB Router, and IB-FC Edge Router  
             type indicated by gswInventoryType in gswInventoryTable." 
     ::= { gswSystem 20 } 
    
     gswIBNodeEntry     OBJECT-TYPE 
        SYNTAX          GswIBNodeEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the IB node information." 
        INDEX          { gswIBNodeSwitchId } 
     ::= { gswIBNodeTable 1 } 
    
     SwIBNodeEntry  ::= SEQUENCE { 
        gswIBNodeSwitchId        GswGlobalId, 
        gswIBNodeString          DisplayString (SIZE(0..64)), 
        gswIBBaseVersion         INTEGER, 
        gswIBClassVersion        INTEGER, 
        gswIBNodeType            GswIBNodeType, 
        gswIBNumPorts            INTEGER, 
        gswIBNodeGUID            GswIBGUID, 
        gswIBPortGUID            GswIBGUID, 
        gswIBDeviceID            INTEGER, 
        gswIBRevision            INTEGER, 
        gswIBVendorID            INTEGER 
     } 
    
   Forbes             Expires December 31, 2001                Page 38    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBNodeSwitchId  OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the index used by  
             gswIBNodeTable.  This object corresponds to  
             gswGlobalSwitchId." 
     ::= { gswIBNodeEntry 1 } 
    
     gswIBNodeString    OBJECT-TYPE 
        SYNTAX          DisplayString (SIZE(0..64)) 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is a UNICODE string to describe 
             node in text format." 
     ::= { gswIBNodeEntry 2 } 
    
     gswIBBaseVersion   OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the supported MAD Base Version. 
             It indicates that this node supports up to and including 
             this version." 
     ::= { gswIBNodeEntry 3 } 
    
     gswIBClassVersion  OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the supported Subnet Management  
             Class (SMP) Version.  It indicates that this node supports  
             up to and including this version." 
     ::= { gswIBNodeEntry 4 } 
    
     gswIBNodeType      OBJECT-TYPE 
        SYNTAX          GswIBNodeType 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is node type." 
     ::= { gswIBNodeEntry 5 } 
    
     gswIBNumPorts      OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the number of physical 
             ports on this node." 
     ::= { gswIBNodeEntry 6 } 
    
    
    
   Forbes             Expires December 31, 2001                Page 39    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBNodeGUID      OBJECT-TYPE 
        SYNTAX          GswIBGUID 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the GUID of the switch.  All  
             ports on the same node shall report the same Node-GUID.   
             It provides a means to uniquely identify a node within a 
             subnet and determine co-location of ports." 
     ::= { gswIBNodeEntry 7 } 
    
     gswIBPortGUID      OBJECT-TYPE 
        SYNTAX          GswIBGUID 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the GUID of this port itself.  
             One port within a node can return the NodeGUID as its  
             PortGUID if the port is an integral part of the node and 
             is not field-replaceable." 
     ::= { gswIBNodeEntry 8 } 
    
     gswIBDeviceID      OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the Device ID information as 
             assigned by device manufacturer." 
     ::= { gswIBNodeEntry 9 } 
    
     gswIBRevision      OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the device resvision assigned by 
             device manufacturer." 
     ::= { gswIBNodeEntry 10 } 
    
     gswIBVendorID      OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the Device vendor, per  
             IEEE." 
     ::= { gswIBNodeEntry 11 } 
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 40    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBSwTable       OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswIBSwEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "This table contains switch information  
             pertaining to switchInfo within Subnet Management Agent.   
             Therefore, this table only applies to IB Switch, 
             IB Router, and IB-FC Edge Router type indicated by  
             gswInventoryType in gswInventoryTable." 
     ::= { gswSystem 25 } 
    
     gswIBSwEntry       OBJECT-TYPE 
        SYNTAX          GswIBSwEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the IB node information." 
        INDEX          { gswIBSwSwitchId } 
     ::= { gswIBSwTable 1 } 
    
     GswIBSwEntry     ::= SEQUENCE { 
        gswIBSwSwitchId            GswGlobalId,      
        gswIBBadMKeyCounter        INTEGER, 
        gswIBBadBKeyCounter        INTEGER, 
        gswIBSwitchChangeReason    INTEGER 
     } 
    
     gswIBSwSwitchId    OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the index used by gswIBSwTable. 
             This object corresponds to gswGlobalSwitchId." 
     ::= { gswIBSwEntry 1 } 
    
     gswIBBadMKeyCounter OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     " This object returns the number of M_Key 
             violations for the switch." 
     ::= { gswIBSwEntry 6 } 
    
     gswIBBadBKeyCounter OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     " This object returns the number of 
             M_Key violations for the switch." 
     ::= { gswIBSwEntry 7 } 
    
    
    
   Forbes             Expires December 31, 2001                Page 41    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBSwitchChangeReason OBJECT-TYPE 
        SYNTAX          INTEGER { 
                            unknown          (1), 
                            badMKey          (2), 
                            badBKey          (3) 
                        }      
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object is mainly defined to support  
             switch change traps." 
     ::= { gswIBSwEntry 8 } 
    
     -- 
     -- End of System Group 
     -- 
    
     -- 
     -- Fabric Group 
     -- 
    
     gswTopoComTable    OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswTopoComEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "The table contains information regarding how 
             switches in the SAN are connected." 
     ::= { gswFabric 1 } 
    
     gswTopoComEntry    OBJECT-TYPE 
        SYNTAX          GswTopoComEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the common topology information." 
        INDEX          { gswTopoComSwitchId, gswTopoComPortIndex } 
     ::= { gswTopoComTable 1 } 
    
     GswTopoComEntry     ::= SEQUENCE { 
        gswTopoComSwitchId            GswGlobalId, 
        gswTopoComPortIndex           INTEGER, 
        gswTopoComNbSwitchId          INTEGER, 
        gswTopoComNbSwitchPort        INTEGER, 
        gswTopoComSwitchStatus        INTEGER 
     } 
    
     gswTopoComSwitchId OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is one of the two indexes used by  
             gswTopoComTable.  This object corresponds to  
             gswGlobalSwitchId." 
    
   Forbes             Expires December 31, 2001                Page 42    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
     ::= { gswTopoComEntry 1 } 
    
     gswTopoComPortIndex OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object is one of two indexes used by 
             gswTopoComTable.  This object corresponds to the 
             port number where the link it connected to." 
     ::= { gswTopoComEntry 2 } 
    
     gswTopoComNbSwitchId OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object is the ID of the switch connected  
             at the end of the port indicated by gswSTSwitchId and  
             gswSTPortIndex.  It represents the gswSwitchGlobalId." 
     ::= { gswTopoComEntry 3 } 
    
     gswTopoComNbSwitchPort OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     " This object is the port of the switch  
             connected at the end of the port indicated by  
             gswTopoComSwitchId and gswTopoComPortIndex ." 
     ::= { gswTopoComEntry 4 } 
    
     gswTopoComSwitchStatus OBJECT-TYPE 
        SYNTAX         INTEGER { 
                       no-change      (1), 
                       switch-added   (2), 
                       switch-deleted (3), 
                       link-added     (4), 
                       link-deleted   (5) 
                       } 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is defined mainly for trap support. 
             The object can be set added (2) or deleted (3) 
             for a topology change trap. Query of the object returns 
             no-change (1)." 
     ::= { gswTopoComEntry 5 } 
    
     gswIBTopoTable     OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswIBTopoEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "The table contains IB-specific topology  
             information." 
     ::= { gswFabric 5 } 
    
   Forbes             Expires December 31, 2001                Page 43    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBTopoEntry     OBJECT-TYPE 
        SYNTAX          GswIBTopoEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the IB topology information." 
        INDEX          { gswIBTopoSwitchId } 
     ::= { gswIBTopoTable 1 } 
    
     GswIBTopoEntry  ::= SEQUENCE { 
        gswIBTopoSwitchId         GswGlobalId, 
        gswIBTopoChangeReason     INTEGER 
     } 
    
     gswIBTopoSwitchId  OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the index used by  
             gswIBTopoTable.  This object corresponds to  
             gswGlobalSwitchId." 
     ::= { gswIBTopoEntry 1 } 
    
     gswIBTopoChangeReason  OBJECT-TYPE 
        SYNTAX          INTEGER { 
                            unknown                (1), 
                            add-remove-port        (2), 
                            add-remove-node        (3), 
                            add-remove-host        (4), 
                            add-remove-SM          (5), 
                            failover-SM            (6), 
                            add-remove-controller  (7), 
                            add-remove-iou         (8) 
                        } 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object is defined mainly for topology  
             change trap support." 
     ::= { gswIBTopoEntry 2 } 
    
     -- 
     -- End of Fabric Group 
     --  
    
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 44    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     -- 
     -- Port Group 
     -- 
    
     gswIBPortTable     OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswIBPortEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "The object is a table that contains, one entry 
             for each switch port, configuration and service parameters 
             of the port. This table mainly represents information 
             contained in portInfo within Subnet Management Agent. 
             Therefore, this table only applies to IB Switch, 
             IB Router, and IB-FC Edge Router type indicated by 
             gswInventoryType in gswInventoryTable." 
     ::= { gswPort 5 } 
    
     gswIBPortEntry     OBJECT-TYPE 
        SYNTAX          GswIBPortEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the IB port information." 
        INDEX          { gswIBPortSwitchId, gswIBPortIndex } 
     ::= { gswIBPortTable 1 } 
    
     GswIBPortEntry      ::= SEQUENCE { 
        gswIBPortSwitchId              GswGlobalId, 
        gswIBPortIndex                 INTEGER, 
        gswIBGidPrefix                 GswIBGID, 
        gswIBLID                       GswIBLID, 
        gswIBMasterSMLID               GswIBLID, 
        gswIBCapabilityMask            INTEGER, 
        gswIBDiagCode                  INTEGER, 
        gswIBLinkWidthEnabled          GswIBLinkWidth, 
        gswIBLinkWidthSupported        GswIBLinkWidth, 
        gswIBLinkWidthActive           GswIBLinkWidth, 
        gswIBLinkSpeedSupported        GswIBLinkSpeed, 
        gswIBPortState                 GswIBPortState, 
        gswIBPortPhysicalState         GswIBPortPhysState, 
        gswIBLinkDownDefaultState      INTEGER, 
        gswIBLMC                       INTEGER, 
        gswIBLinkSpeedActive           GswIBLinkSpeed, 
        gswIBLinkSpeedEnabled          GswIBLinkSpeed, 
        gswIBNeighborMTU               GswIBMTU, 
        gswIBVLCap                     GswIBVL, 
        gswIBMTUCap                    GswIBMTU, 
        gswIBOperationalVLs            GswIBVL, 
        gswIBMKeyViolations            INTEGER, 
        gswIBPKeyViolations            INTEGER, 
        gswIBQKeyViolations            INTEGER, 
        gswIBLocalPhyErrors            INTEGER, 
    
   Forbes             Expires December 31, 2001                Page 45    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
        gswIBOverrunErrors             INTEGER, 
        gswIBPortChangeReason          INTEGER 
     } 
    
     gswIBPortSwitchId  OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is one of the two indexes used by  
             gswIBPortTable.  This object corresponds to  
             gswGlobalSwitchId." 
     ::= { gswIBPortEntry 1 } 
    
     gswIBPortIndex     OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is one of two indexes used by 
             gswIBPortTable.  The object identifies the physical port  
             number." 
     ::= { gswIBPortEntry 2 } 
    
     gswIBGidPrefix     OBJECT-TYPE 
        SYNTAX          GswIBGID 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the GID prefix for this port." 
     ::= { gswIBPortEntry 6 } 
    
     gswIBLID           OBJECT-TYPE 
        SYNTAX          GswIBLID 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the base LID of this port." 
     ::= { gswIBPortEntry 7 } 
    
     gswIBMasterSMLID   OBJECT-TYPE 
        SYNTAX          GswIBLID 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the base LID of the master SM 
             that is managing this port." 
     ::= { gswIBPortEntry 8 } 
    
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 46    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBCapabilityMask OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the supported  
             capabilities of this node.  A bit set to 1 for affirmation  
             of supported capability. 
                  0: Reserved, shall be zero 
                  1: IsSM 
                  2: IsNoticeSupported 
                  3: IsTrapSupported 
                  4: IsResetSupported 
                  5: IsAutomaticMigrationSupported 
                  6: IsSLMappingSupported 
                  7: IsMKeyNVRAM (supports M_Key in NVRAM) 
                  8: IsPKeyNVRAM (supports P_Key in NVRAM) 
                  9: IsLEDInfoSupported 
                  10: IsSMdisabled 
                  11 - 15: Reserved, shall be zero 
                  16: IsConnectionManagementSupported 
                  17: IsSNMPTunnelingSupported 
                  18: Reserved, shall be zero 
                  19: IsDeviceManagementSupported 
                  20: IsVendorClassSupported 
                  21 - 31: Reserved, shall be zero" 
     ::= { gswIBPortEntry 9 } 
    
     gswIBDiagCode      OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the IB Diagnostic code." 
     ::= { gswIBPortEntry 10 } 
    
     gswIBLinkWidthEnabled OBJECT-TYPE 
        SYNTAX          GswIBLinkWidth 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the enabled link 
             width." 
     ::= { gswIBPortEntry 12 } 
    
     gswIBLinkWidthSupported OBJECT-TYPE 
        SYNTAX          GswIBLinkWidth 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the supported link  
             width." 
     ::= { gswIBPortEntry 13 } 
    
    
    
   Forbes             Expires December 31, 2001                Page 47    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBLinkWidthActive OBJECT-TYPE 
        SYNTAX          GswIBLinkWidth 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the currently active link  
             width." 
     ::= { gswIBPortEntry 14 } 
    
     gswIBLinkSpeedSupported OBJECT-TYPE 
        SYNTAX          GswIBLinkSpeed 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the supported link  
             speed." 
     ::= { gswIBPortEntry 15 } 
    
     swIBPortState      OBJECT-TYPE 
        SYNTAX          SwIBPortState 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the port state." 
     ::= { gswIBPortEntry 16 } 
    
     gswIBPortPhysicalState OBJECT-TYPE 
        SYNTAX          GswIBPortPhysState 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the port physical state." 
     ::= { gswIBPortEntry 17 } 
    
     gswIBLinkDownDefaultState OBJECT-TYPE 
        SYNTAX          INTEGER { 
                            nop     (0), 
                            sleep   (1), 
                            polling (2) 
                        } 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates port down default state." 
     ::= { gswIBPortEntry 18 } 
    
     gswIBLMC           OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the LID mask for multipath  
             support." 
     ::= { gswIBPortEntry 20 } 
    
    
    
    
   Forbes             Expires December 31, 2001                Page 48    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBLinkSpeedActive OBJECT-TYPE 
        SYNTAX          GswIBLinkSpeed 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the currently active link  
             speed." 
     ::= { gswIBPortEntry 21 } 
    
     gswIBLinkSpeedEnabled OBJECT-TYPE 
        SYNTAX          GswIBLinkSpeed 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the enabled link speed." 
     ::= { gswIBPortEntry 22 } 
    
     gswIBNeighborMTU   OBJECT-TYPE 
        SYNTAX          GswIBMTU 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the active maximum MTU 
             enabled on this port for transmit." 
     ::= { gswIBPortEntry 23 } 
    
     gswIBVLCap         OBJECT-TYPE 
        SYNTAX          GswIBVL 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the virtual Lanes  
             supported on this port." 
     ::= { gswIBPortEntry 24 } 
    
     gswIBMTUCap        OBJECT-TYPE 
        SYNTAX          GswIBMTU 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the maximum MTU supported by  
             this port." 
     ::= { gswIBPortEntry 25 } 
    
       gswIBOperationalVLs OBJECT-TYPE 
        SYNTAX          GswIBVL 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the virtual Lanes  
             operational on this port." 
     ::= { gswIBPortEntry 28 } 
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 49    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBMKeyViolations OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object counts the number of SMP packets  
             that have been received at this port that have had 
             invalid M_Keys, since power-on or reset.  Increments 
             till count reaches all 1s and then must be set back 
             to zero to re-enable incrementing." 
     ::= { gswIBPortEntry 29 } 
    
     gswIBPKeyViolations OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object counts the number of packets that 
             have been received at this port that have had 
             invalid P_Keys, since power-on or reset. Increments 
             till count reaches all 1s and then must be set back 
             to zero to re-enable incrementing." 
     ::= { gswIBPortEntry 30 } 
    
     gswIBQKeyViolations OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object counts the number of packets that 
             have been received at this port that have had 
             invalid Q_Keys, since power-on or reset. Increments till 
             count reaches all 1s and then must be set back to 
             zero to re-enable incrementing." 
     ::= { gswIBPortEntry 32 } 
    
     gswIBLocalPhyErrors OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the threshold value. When the 
             count of marginal link errors exceeds this threshold, 
             the local link integrity error shall be detected." 
     ::= { gswIBPortEntry 36 } 
    
     gswIBOverrunErrors OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the threshold value. When 
             the count of buffer overruns over consecutive 
             flow control update periods exceeds this threshold, 
             the excessive buffer overrun error shall be detected." 
     ::= { gswIBPortEntry 37 } 
    
   Forbes             Expires December 31, 2001                Page 50    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBPortChangeReason OBJECT-TYPE 
        SYNTAX          INTEGER { 
                            unknown (0), 
                            link-integrity-error (1), 
                            excessive-buf-overrun (2), 
                            flow-control-timeout (3), 
                            bad-p-key (4) 
                        } 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is mainly implemented to support  
             traps." 
     ::= { gswIBPortEntry 38 } 
    
     -- 
     -- End of Port group 
     -- 
    
    
    
     -- 
     -- Port Performance Group 
     -- 
    
     gswIBPortPerfTable OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswIBPortPerfEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "The table contains information pertaining to 
             portCounters within Performance Management Agent. 
             Therefore, this table only applies to IB Switch, 
             IB Router, and IB-FC Edge Router type indicated 
             by gswInventoryType in gswInventoryTable." 
     ::= { gswPortPerf 5 } 
    
     gswIBPortPerfEntry OBJECT-TYPE 
        SYNTAX          GswIBPortPerfEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the IB port information." 
        INDEX          { gswIBPortPerfSwitchId, gswIBPortPerfIndex } 
     ::= { gswIBPortPerfTable 1 } 
    
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 51    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     GswIBPortPerfEntry          ::= SEQUENCE { 
        gswIBPortPerfSwitchId                 GswGlobalId, 
        gswIBPortPerfIndex                    INTEGER, 
        gswIBSymbolErrorCounter               GswCounter64, 
        gswIBLinkErrorRecoveryCounter         GswCounter64, 
        gswIBLinkDownedCounter                GswCounter64, 
        gswIBPortRcvErrors                    GswCounter64, 
        gswIBPortRcvRemotePhysicalErrors      GswCounter64, 
        gswIBPortRcvSwitchRelayErrors         GswCounter64, 
        gswIBPortXmitDiscards                 GswCounter64, 
        gswIBPortXmitConstraintErrors         GswCounter64, 
        gswIBPortRcvConstraintErrors          GswCounter64, 
        gswIBLocalLinkIntegrityErrors         GswCounter64, 
        gswIBExcessiveBufferOverrunErrors     GswCounter64, 
        gswIBVL15Dropped                      GswCounter64, 
        gswIBPortXmitData                     GswCounter64, 
        gswIBPortRcvData                      GswCounter64, 
        gswIBPortXmitPkts                     GswCounter64, 
        gswIBPortRcvPkts                      GswCounter64 
     } 
    
     gswIBPortPerfSwitchId OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is one of the two indexes used by 
             gswIBPortPerfTable.  This object corresponds to  
             gswGlobalSwitchId." 
     ::= { gswIBPortPerfEntry 1 } 
    
     gswIBPortPerfIndex OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is one of two indexes used by 
             gswIBPortPerfTable.  The object identifies the physical  
             port number." 
     ::= { gswIBPortPerfEntry 2 } 
    
     gswIBSymbolErrorCounter OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of symbol 
             errors detected on one or more lanes." 
     ::= { gswIBPortPerfEntry 3 } 
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 52    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBLinkErrorRecoveryCounter OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of times 
             the Port Training state machine has successfully 
             completed the link error recovery process." 
     ::= { gswIBPortPerfEntry 4 } 
    
     gswIBLinkDownedCounter OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of times 
             the Port Training state machine has failed the link 
             error recovery process and downed the link." 
     ::= { gswIBPortPerfEntry 5 } 
    
     gswIBPortRcvErrors OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of packets 
             containing an error that were received on the port." 
     ::= { gswIBPortPerfEntry 6 } 
    
     gswIBPortRcvRemotePhysicalErrors OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of packets 
             marked with the EBP delimiter received on the port." 
     ::= { gswIBPortPerfEntry 7 } 
    
     gswIBPortRcvSwitchRelayErrors OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of packets 
             received on the port that were discarded because they 
             could not be forwarded by the switch relay." 
     ::= { gswIBPortPerfEntry 8 } 
    
     gswIBPortXmitDiscards OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of outbound 
             packets discarded by the port because the port is down 
             or congested." 
     ::= { gswIBPortPerfEntry 9 } 
    
   Forbes             Expires December 31, 2001                Page 53    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBPortXmitConstraintErrors OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of packets 
             not transmitted from the port." 
     ::= { gswIBPortPerfEntry 10 } 
    
     gswIBPortRcvConstraintErrors OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of packets 
             received on the port that are discarded." 
     ::= { gswIBPortPerfEntry 11 } 
    
     gswIBLocalLinkIntegrityErrors OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the number of times that 
             the frequency of packets containing local physical errors 
             exceeded local_phy_errors." 
     ::= { gswIBPortPerfEntry 12 } 
    
     gswIBExcessiveBufferOverrunErrors OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the number of times that 
             overrun errors consecutive flow control update periods 
             occurred with at least one overrun error in each period." 
     ::= { gswIBPortPerfEntry 13 } 
    
     gswIBVL15Dropped   OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates the number of incoming 
             VL15 packets dropped due to resource limitations on port." 
     ::= { gswIBPortPerfEntry 14 } 
    
    
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 54    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBPortXmitData  OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of data  
             octets, divided by 4, transmitted on all VLs from the  
             port.  This includes all octets between (and not  
             including) the start of packet delimiter and VCRC.  It  
             excludes all link packets." 
     ::= { gswIBPortPerfEntry 15 } 
    
     gswIBPortRcvData   OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of data 
             octets, divided by 4, received on all VLs on the port. 
             This includes all octets between (and not including) 
             the start of packet delimiter and VCRC.  It excludes 
             all link packets." 
     ::= { gswIBPortPerfEntry 16 } 
    
     gswIBPortXmitPkts  OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of packets, 
             excluding link packets, transmitted on all VLs from the  
              port." 
     ::= { gswIBPortPerfEntry 17 } 
    
     gswIBPortRcvPkts   OBJECT-TYPE 
        SYNTAX          GswCounter64 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object indicates total number of packets, 
             including packets containing errors and excluding 
             link packets, received from all VLs on the port." 
     ::= { gswIBPortPerfEntry 18 } 
    
     -- 
     -- End of Port Performance group 
     -- 
    
     -- 
     -- Name Service group 
     -- 
    
     -- 
     -- End of Name Service group 
     -- 
    
   Forbes             Expires December 31, 2001                Page 55    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     -- 
     -- Event Group 
     -- 
    
     -- NOTE 
     -- Logically, gswEventTable is separate from the error log since  
     -- it is essentially a view of the error log within a particular  
     -- time window. 
     -- The value of gswEventIndex shall indicate the event number that  
     -- has occurred since the switch booted.  The value will range  
     -- from 1 through 2147383647 (2^31 - 1). 
     -- 
     
     gswEventTable      OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswEventEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "The table of event entries." 
     ::= { gswEvent 1 } 
     
     gswEventEntry      OBJECT-TYPE 
        SYNTAX          GswEventEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry of the event table." 
        INDEX           { gswEventSwitchId, gswEventIndex } 
     ::= { gswEventTable 1 } 
     
     GswEventEntry ::= SEQUENCE { 
        gswEventSwitchId       GswGlobalId, 
        gswEventIndex          INTEGER, 
        gswEventTimeInfo       DisplayString, 
        gswEventLevel          GswEventSeverity, 
        gswEventRepeatCount    INTEGER, 
        gswEventDescr          DisplayString 
     } 
    
     gswEventSwitchId   OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the index used by gswEventTable. 
             This object corresponds to gswGlobalSwitchId." 
     ::= { gswEventEntry 1 } 
    
     gswEventIndex      OBJECT-TYPE 
        SYNTAX          INTEGER (1..30) 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies the event entry." 
     ::= { gswEventEntry 2 } 
    
   Forbes             Expires December 31, 2001                Page 56    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
     
     gswEventTimeInfo   OBJECT-TYPE 
        SYNTAX          DisplayString 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies the date and time when  
             this event occurred, in textual format." 
     ::= { gswEventEntry 3 } 
     
     gswEventLevel      OBJECT-TYPE 
        SYNTAX          GswEventSeverity 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies the severity level of  
             this event entry." 
     ::= { gswEventEntry 4 } 
     
     gswEventRepeatCount OBJECT-TYPE 
        SYNTAX          INTEGER 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies how many times this  
             particular event has occurred." 
     ::= { gswEventEntry 5 } 
     
     gswEventDescr      OBJECT-TYPE 
        SYNTAX          DisplayString 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies the textual description  
             of the event." 
     ::= { gswEventEntry 6 } 
     
     -- 
     -- End of Event Group 
     -- 
    
     --  
     -- EndDevice Group 
     -- 
    
     --  
     -- End of EndDevice Group 
     -- 
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 57    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     -- 
     -- SNMP Agent Configuration 
     -- 
    
     gswAgtCmtyTable    OBJECT-TYPE 
        SYNTAX          SEQUENCE OF GswAgtCmtyEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "A table that contains, one entry for each  
             Community, the access control and parameters of the  
             Community." 
     ::= { gswAgtCfg 11 } 
    
     gswAgtCmtyEntry    OBJECT-TYPE 
        SYNTAX          GswAgtCmtyEntry 
        ACCESS          not-accessible 
        STATUS          mandatory 
        DESCRIPTION     "An entry containing the Community parameters." 
        INDEX     { gswAgtCmtySwitchId, gswAgtCmtyIdx } 
     ::= { gswAgtCmtyTable 1 } 
    
     GswAgtCmtyEntry ::= SEQUENCE { 
        gswAgtCmtySwitchId     GswGlobalId, 
        gswAgtCmtyIdx          INTEGER (1..6), 
        gswAgtCmtyStr          DisplayString (SIZE (0..16)), 
        gswAgtTrapRcp          NetworkAddress 
     } 
    
     gswAgtCmtySwitchId OBJECT-TYPE 
        SYNTAX          GswGlobalId 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "The object is the index used by  
             gswAgtCmtyTable.  This object corresponds to  
             gswGlobalSwitchId." 
     ::= { gswAgtCmtyEntry 1 } 
    
     gswAgtCmtyIdx      OBJECT-TYPE 
        SYNTAX          INTEGER (1..6) 
        ACCESS          read-only 
        STATUS          mandatory 
        DESCRIPTION     "This object identifies the SNMPv1 Community  
             entry." 
     ::= { gswAgtCmtyEntry 2 } 
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 58    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswAgtCmtyStr      OBJECT-TYPE 
        SYNTAX          DisplayString (SIZE (0..16)) 
        ACCESS          read-write 
        STATUS          mandatory 
        DESCRIPTION     "This is a Community string supported by the  
             agent.  If a new value is set successfully, it takes  
             effect immediately." 
     ::= { gswAgtCmtyEntry 3 } 
    
     gswAgtTrapRcp      OBJECT-TYPE 
        SYNTAX          NetworkAddress 
        ACCESS          read-write 
        STATUS          mandatory 
        DESCRIPTION     "This is the trap recipient associated with the 
             Community. If a new value is set successfully, it takes 
             effect immediately." 
     ::= { gswAgtCmtyEntry 4 } 
    
     -- 
     -- End of SNMP Agent Configuration Group 
     -- 
    
     -- 
     -- Traps Group 
     -- 
    
     gswTopoComTrap         TRAP-TYPE 
        ENTERPRISE          gsw 
        VARIABLES           { gswTopoComSwitchId, 
                              gswTopoComNbSwitchId, 
                              gswTopoComSwitchStatus } 
        DESCRIPTION          "This trap is generated when changes  
             happen in a SAN." 
        ::= 1 
    
     gswIBTopoTrap          TRAP-TYPE 
        ENTERPRISE          gsw 
        VARIABLES           { gswIBTopoSwitchId, 
                              gswIBTopoChangeReason } 
        DESCRIPTION          "This trap is generated when changes  
             happen in an IB subnet." 
        ::= 2 
    
     gswIBPortTrap          TRAP-TYPE 
        ENTERPRISE          gsw 
        VARIABLES           { gswIBPortSwitchId, 
                              gswIBPortIndex, 
                              gswIBPortChangeReason } 
        DESCRIPTION          "This trap is generated when changes  
             happen in IB switch ports." 
        ::= 5 
    
   Forbes             Expires December 31, 2001                Page 59    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
     gswIBSwitchTrap        TRAP-TYPE 
        ENTERPRISE          gsw 
        VARIABLES           { gswIBSwSwitchId, 
                              gswIBSwitchChangeReason } 
        DESCRIPTION          "This trap is generated when changes  
             happen in IB switches." 
        ::= 8 
    
     gswEventTrap       TRAP-TYPE 
        ENTERPRISE      gsw 
        VARIABLES       { gswEventSwitchId, 
                          gswEventIndex, 
                          gswEventTimeInfo, 
                          gswEventLevel, 
                          gswEventRepeatCount, 
                          gswEventDescr } 
        DESCRIPTION     "This trap is generated when an event whose 
             level at or below gswEventTrapLevel occurs." 
        ::= 10  
    
   END 
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 60    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
5. Security Considerations 
    
   There are a number of management objects defined in this MIB that 
   have a MAX-ACCESS clause of read-write.  Such objects may be 
   considered sensitive or vulnerable in some network environments.  
   The support for SET operations in a non-secure environment without 
   proper protection can have a negative effect on network operations. 
    
    
6. Intellectual Property 
    
   The IETF takes no position regarding the validity or scope of any 
   intellectual property or other rights that might be claimed to 
   pertain to the implementation or use of the technology described in 
   this document or the extent to which any license under such rights 
   might or might not be available; neither does it represent that it 
   has made any effort to identify any such rights.  Information on the 
   IETF's procedures with respect to rights in standards-track and 
   standards-related documentation can be found in BCP-11.  Copies of 
   claims of rights made available for publication and any assurances 
   of licenses to be made available, or the result of an attempt made 
   to obtain a general license or permission for the use of such 
   proprietary rights by implementors or users of this specification 
   can be obtained from the IETF Secretariat. 
    
   The IETF invites any interested party to bring to its attention any 
   copyrights, patents or patent applications, or other proprietary 
   rights which may cover technology that may be required to practice 
   this standard.  Please address the information to the IETF Executive 
   Director. 
    
    
7. Acknowledgements 
    
   The editors would like to thank the following individuals for their 
   assistance and constructive comments: 
    
         Ken Dziuba, BCSI              Sanjeev Singh, BCSI 
         Ashish Hanwadikar, BCSI 
    
    
8. References 
    
8.1. RFCs 
    
   [RFC2571]   Harrington, D., Presuhn, R., and B. Wijnen, "An  
               Architecture for Describing SNMP Management Frameworks",  
               RFC 2571, April 1999. 
    
   [RFC1155]   Rose, M., and K. McCloghrie, "Structure and  
               Identification of Management Information for TCP/IP- 
    
   Forbes             Expires December 31, 2001                Page 61    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
               based Internets", STD 16, RFC 1155, May 1990. 
    
   [RFC1212]   Rose, M., and K. McCloghrie, "Concise MIB Definitions",  
               STD 16, RFC 1212, March 1991. 
    
   [RFC1215]   M. Rose, "A Convention for Defining Traps for use with  
               the SNMP", RFC 1215, March 1991. 
    
   [RFC2578]   McCloghrie, K., Perkins, D., Schoenwaelder, J.,  
               Case, J., Rose, M., and S. Waldbusser, "Structure of  
               Management Information Version 2 (SMIv2)", STD 58,  
               RFC 2578, April 1999. 
    
   [RFC2579]   McCloghrie, K., Perkins, D., Schoenwaelder, J.,  
               Case, J., Rose, M., and S. Waldbusser, "Textual  
               Conventions for SMIv2", STD 58, RFC 2579, April 1999. 
    
   [RFC2580]   McCloghrie, K., Perkins, D., Schoenwaelder, J.,  
               Case, J., Rose, M., and S. Waldbusser, "Conformance  
               Statements for SMIv2", STD 58, RFC 2580, April 1999. 
    
   [RFC1157]   Case, J., Fedor, M., Schoffstall, M., and J. Davin,  
               "Simple Network Management Protocol", STD 15, RFC 1157,  
               May 1990. 
    
   [RFC1901]   Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, 
               "Introduction to Community-based SNMPv2", RFC 1901,  
               January 1996. 
    
   [RFC1906]   Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, 
               "Transport Mappings for Version 2 of the Simple Network 
               Management Protocol (SNMPv2)", RFC 1906, January 1996. 
    
   [RFC2572]   Case, J., Harrington D., Presuhn R., and B. Wijnen,  
               "Message Processing and Dispatching for the Simple  
               Network Management Protocol (SNMP)", RFC 2572,  
               April 1999. 
    
   [RFC2574]   Blumenthal, U., and B. Wijnen, "User-based Security  
               Model (USM) for version 3 of the Simple Network  
               Management Protocol (SNMPv3)", RFC 2574, April 1999. 
    
   [RFC1905]   Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, 
               "Protocol Operations for Version 2 of the Simple Network 
               Management Protocol (SNMPv2)", RFC 1905, January 1996. 
    
   [RFC2573]   Levi, D., Meyer, P., and B. Stewart, "SNMPv3  
               Applications", RFC 2573, April 1999. 
    
   [RFC2575]   Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based 
               Access Control Model (VACM) for the Simple Network 
               Management Protocol (SNMP)", RFC 2575, April 1999. 
    
   Forbes             Expires December 31, 2001                Page 62    Internet Draft       InfiniBand Switch MIB            July 11, 2001 
                                    
    
    
   [RFC2570]   Case, J., Mundy, R., Partain, D., and B. Stewart, 
               "Introduction to Version 3 of the Internet-standard  
               Network Management Framework", RFC 2570, April 1999. 
    
8.2. InfiniBand References 
    
   [1]         InfiniBand Trade Association, "InfiniBand Architecture 
   Specification Release 1.0", October 24, 2000 
    
    
9. Authors' Addresses 
    
   Brian Forbes 
   Brocade Communications 
   1745 Technology Drive        Phone:  1-408-501-8796 
   San Jose, CA.  USA           Email:  bforbes@brocade.com 
    
    
10. Full Copyright Statement 
    
   Copyright (C) The Internet Society (1999).  All Rights Reserved. 
    
   This document and translations of it may be copied and furnished to 
   others, and derivative works that comment on or otherwise explain it 
   or assist in its implementation may be prepared, copied, published 
   and distributed, in whole or in part, without restriction of any 
   kind, provided that the above copyright notice and this paragraph 
   are included on all such copies and derivative works.  However, this 
   document itself may not be modified in any way, such as by removing 
   the copyright notice or references to the Internet Society or other 
   Internet organizations, except as needed for the purpose of 
   developing Internet standards in which case the procedures for 
   copyrights defined in the Internet Standards process must be 
   followed, or as required to translate it into languages other than 
   English. 
    
   The limited permissions granted above are perpetual and will not be 
   revoked by the Internet Society or its successors or assigns. 
    
   This document and the information contained herein is provided on an 
   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING 
   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 
   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION 
   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF 
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 
    
    
    
    
    
    
   Forbes             Expires December 31, 2001                Page 63