--
--				"@(#)fa.mib 00/03/23"
--
-- Title: Fibre Alliance Fibre Channel Management Framework Integration MIB
--	  Rev 1.5, June 1, 1999.
--
-- Note: This is released for Brocade FOS 2.2
--

FCMGMT-MIB
DEFINITIONS ::= BEGIN 
  IMPORTS 

  --
  -- Note: IpAddress and FcNameId are not used in the rest of the
  --  definition and are commented out so that a MIB compiler will
  --  not flag these as warning.
  --
  --	IpAddress, TimeTicks, experimental 
	TimeTicks, experimental 
		FROM RFC1155-SMI 
	OBJECT-TYPE 
		FROM RFC-1212 
	DisplayString 
		FROM RFC1213-MIB 
	TRAP-TYPE 
		FROM RFC-1215; 
  --	FcNameId ::= OCTET STRING (SIZE(8))
	fcmgmt	OBJECT IDENTIFIER ::= { experimental 94 } 

	-- groups in fcmgmt 

	connSet			OBJECT IDENTIFIER ::= { fcmgmt 1 } 
	trapReg 		OBJECT IDENTIFIER ::= { fcmgmt 2 } 

	revisionNumber OBJECT-TYPE
		SYNTAX DisplayString (SIZE (4))
		ACCESS read-only 
		STATUS mandatory 
		DESCRIPTION
			"This is the revision number for this MIB. The
			format of the revision value is as follows
				(0) = high order major revision number
				(1) = low order major revision number
				(2) = high order minor revision number
				(3) = low order minor revision number
			The value will be stored as an ASCII value. The
			following is the current values.
				(0) = '0'
				(1) = '1'
				(2) = '5'
				(3) = '0'
			This defines a revision of 1.5
			"
		::= { fcmgmt 3 }

	-- the connectivity unit group 

	-- Implementation of the group is mandatory for all systems. 

	uNumber OBJECT-TYPE 
		SYNTAX INTEGER
		ACCESS read-only 
		STATUS mandatory 
		DESCRIPTION 
			"The number of connectivity units present on this
			system. This is used to identify the number of
			boards in a chassis or the number of full boxes
			in a rack." 
		DEFVAL { 1 } 
		::= { connSet 1 }

	systemURL OBJECT-TYPE
		SYNTAX DisplayString
		ACCESS read-only
		STATUS mandatory
		DESCRIPTION
			"The top-level URL of the system. If does not exist
			the value is empty string."
		DEFVAL { "" }
		::= { connSet 2 }

	statusChangeTime OBJECT-TYPE 
		SYNTAX TimeTicks 
		ACCESS read-only 
		STATUS mandatory 
		DESCRIPTION 
			"The sysuptime timestamp in centiseconds at which
			the last status change occurred for any members of
			the set.  This represents a union of change
			information for connUnitStatusChangeTime."
		::= { connSet 3 }

	configurationChangeTime OBJECT-TYPE 
		SYNTAX TimeTicks 
		ACCESS read-only 
		STATUS mandatory 
		DESCRIPTION 
			"The sysuptime timestamp in centiseconds at which
			the last configuration change occurred for any
			members of the set. This represents a union of change
			information for connUnitConfigurationChangeTime."
		::= { connSet 4 }

	connUnitTableChangeTime OBJECT-TYPE
		SYNTAX TimeTicks
		ACCESS read-only 
		STATUS mandatory 
		DESCRIPTION
			"The sysuptime timestamp in centiseconds at which
			the connUnitTable was updated (an entry was either
			added or deleted."
		::= { connSet 5 }

	-- The Connectivity table contains general information on the 
	-- system's units.
	connUnitTable OBJECT-TYPE 
		SYNTAX SEQUENCE OF ConnUnitEntry 
		ACCESS not-accessible 
		STATUS mandatory 
		DESCRIPTION 
			"A list of units under a single SNMP agent. The number 
			of entries is given by the value of uNumber. It is 1 
			for stand-alone system." 
		::= { connSet 6 }

	connUnitEntry OBJECT-TYPE 
		SYNTAX ConnUnitEntry 
		ACCESS not-accessible 
		STATUS mandatory 
		DESCRIPTION 
			"A connectivity unit entry containing objects for a 
			 particular unit." 
		INDEX { connUnitId } 
		::= { connUnitTable 1 } 

		ConnUnitEntry ::= 
			SEQUENCE { 
				connUnitId
					OCTET STRING,
				connUnitGlobalId
					OCTET STRING,
				connUnitType 
					INTEGER, 
				connUnitNumports 
					INTEGER, 
				connUnitState 
					INTEGER, 
				connUnitStatus 
					INTEGER, 
				connUnitProduct 
					DisplayString, 
				connUnitSn 
					DisplayString, 
				connUnitUpTime 
					TimeTicks, 
				connUnitUrl 
					DisplayString, 
				connUnitDomainId 
					OCTET STRING, 
				connUnitProxyMaster 
					INTEGER, 
				connUnitPrincipal 
					INTEGER,
				connUnitNumSensors 
					INTEGER,
				connUnitStatusChangeTime
					TimeTicks,
				connUnitConfigurationChangeTime
					TimeTicks,
				connUnitNumRevs
					INTEGER,
				connUnitNumZones
					INTEGER,
				connUnitModuleId
					OCTET STRING
			} 

		connUnitId OBJECT-TYPE 
			SYNTAX OCTET STRING (SIZE (16))
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"The goal is to create a locally unique Id
				space for all connUnitIds within this proxy
				domain. It is left up to the vendor to
				generate the unique IDs. It is a goal that
				the value is kept constant between boots.
				It is also a goal that the relationship
				be retained between the connUnitId and the
				connUnitGlobalId if the connUnitGlobalId is
				non-zero."
			::= { connUnitEntry 1 } 

		connUnitGlobalId OBJECT-TYPE 
			SYNTAX OCTET STRING (SIZE (16))
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"The goal is to create a globally unique Id
				space for all connUnitGlobalIds. This is a
				set of hex bytes, not ASCII.
				connUnitGlobalId is a
				WWN, including the leading NAA, in any FC-PH
				authorized format.  This requires that you
				have to have an IEEE OUI (vendor id) to assign
				connUnitGlobalId. Once you have supplied the
				NAA and OUI, you as a vendor are completely
				free as to how you assign the rest of the bits,
				as long as you assure they are unique.  There
				is some merit, though not a requirement, that
				the WWN used as connUnitGlobalId be the same
				as that of (one of) the permanently attached
				FC/LAN interface(s). Whether it is or not,
				it must be unique. As an example, if your
				agent runs in a host and the host has an HBA,
				it is quite possible that agent, host, and HBA
				will all be distinct connUnits, so the host
				and agent can not use the WWN of the HBA.
				Another example:
				If your hub has a built-in Ethernet port, it
				might be reasonable for the hub to use its LAN
				address (prefixed with the with appropriate
				NAA) as its connUnitGlobalId. But if the
				Ethernet was a replaceable PCCard, the hub
				should have an independent ID. If the global
				ID is not known then this object is set to
				all zeros. When this value is found by a
				management station, it will indicate that
				information about it should not be trusted
				to be correct.  The following are some
				references for more information.

	   http://standards.ieee.org/regauth/oui/tutorials/fibreformat.html 
	   http://standards.ieee.org/regauth/oui/tutorials/fibrecomp_id.html" 
			::= { connUnitEntry 2 } 

		connUnitType OBJECT-TYPE 
			SYNTAX INTEGER { 
				unknown(1),
				other(2), -- none of the following 
				hub(3), 
				switch(4), 
				gateway(5), 
				converter(6), 
				hba(7),
				proxy-agent(8),
				storage-device(9), -- disk,cd,tape,etc
				host(10),
				storage-subsystem(11), -- raid, library, etc
				module(12),
				swdriver(13)
			} 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"Type of the FC connectivity unit." 
			::= { connUnitEntry 3 } 


		connUnitNumports OBJECT-TYPE 
			SYNTAX INTEGER 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"Number of physical FC ports in the unit 
				(internal/embedded, external)." 
			::= { connUnitEntry 4 } 

		connUnitState OBJECT-TYPE 
			SYNTAX INTEGER {
				unknown(1),
				online(2),
				offline(3)
			}
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"Overall state of the connectivity unit."
			::= { connUnitEntry 5 } 

		connUnitStatus OBJECT-TYPE 
			SYNTAX INTEGER { 
				unknown(1),
				unused(2), 
				ok(3), 
				warning(4), -- needs attention 
				failed(5) 
			} 
			ACCESS read-only 
			STATUS mandatory 

			DESCRIPTION 
				"Overall status of the connectivity unit." 
			::= { connUnitEntry 6 } 

		connUnitProduct OBJECT-TYPE 
			SYNTAX DisplayString (SIZE (0..79)) 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"The connectivity unit vendor's product
				model name." 
			::= { connUnitEntry 7 } 

		connUnitSn OBJECT-TYPE 
			SYNTAX DisplayString (SIZE (0..79)) 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"The serial number for this unit. A
				permanent unique identifier defined by
				the vendor." 
			::= { connUnitEntry 8 } 

		connUnitUpTime OBJECT-TYPE 
			SYNTAX TimeTicks 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"The number of centiseconds since the 
				last unit initialization." 
			::= { connUnitEntry 9 } 

		connUnitUrl OBJECT-TYPE 
			SYNTAX DisplayString 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"URL to launch management application, 
				if applicable. Otherwise empty string. 
				In a standalone unit, this would be the 
				same as the top-level URL." 
			::= { connUnitEntry 10 } 

		connUnitDomainId OBJECT-TYPE 
			SYNTAX OCTET STRING (SIZE(3)) 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"24 bit ID, right justified, unique within 
				the Fabric address domain. If this value 
				is not applicable, return all bits set to one."
			::= { connUnitEntry 11 } 

		connUnitProxyMaster OBJECT-TYPE 
			SYNTAX INTEGER { 
				no(1), 
				yes(2) 
			} 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"This is a yes if this is the proxy master 
				unit for a set of managed units. For example, 
				this could be the only unit with a management 
				card in it for a set of units. If this is a
				standalone unit, then this is set to 'yes'."
			::= { connUnitEntry 12 } 

		connUnitPrincipal OBJECT-TYPE 
			SYNTAX INTEGER { 
				unknown(1),
				no(2), 
				yes(3) 
			} 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"Whether the unit is the principal unit 
				within the fabric domain. If this value 
				is not applicable, return unknown."
			::= { connUnitEntry 13 } 

		connUnitNumSensors OBJECT-TYPE 
			SYNTAX INTEGER 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"Number of sensors in the unit." 
			::= { connUnitEntry 14 } 
		
		connUnitStatusChangeTime OBJECT-TYPE 
			SYNTAX TimeTicks 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"The sysuptime timestamp in centiseconds 
				at which  the last status change occurred."
			::= { connUnitEntry 15 } 

		connUnitConfigurationChangeTime OBJECT-TYPE 
			SYNTAX TimeTicks 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"The sysuptime timestamp in centiseconds 
				at which the last configuration change occurred."
			::= { connUnitEntry 16 } 

		connUnitNumRevs OBJECT-TYPE 
			SYNTAX INTEGER 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"The number of revisions in the revision 
				table." 
			DEFVAL { 1 } 
			::= { connUnitEntry 17 }

		connUnitNumZones OBJECT-TYPE 
			SYNTAX INTEGER 
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"Number of zones defined in the zone table."
			::= { connUnitEntry 18 } 

		connUnitModuleId OBJECT-TYPE 
			SYNTAX OCTET STRING (SIZE(16))
			ACCESS read-only 
			STATUS mandatory 
			DESCRIPTION 
				"This is a unique id that does not need to
				be persistent between boots. It is used
				to group a set of modules together into
				a single connUnit. The intended use would
				be to create a connUnit with a type of
				module and then set it's moduleid to its
				connUnitId. All other connUnits that are
				part of the module will have the same
				module id as the container. This should
				be 16 zeros if it is not used."
			::= { connUnitEntry 19 } 

    -- related traps
	connUnitStatusChange TRAP-TYPE 
		ENTERPRISE fcmgmt 
		VARIABLES { connUnitStatusChangeTime } 
		DESCRIPTION 
			"The overall status of the connectivity unit has 
			 changed." 
		::= 1 
END