HPIMA-STATS-MIB DEFINITIONS ::= BEGIN

--      Copyright 2007 Hewlett-Packard Development Company, L.P.
--      Hewlett-Packard Company shall not be liable for technical or
--      editorial errors or omissions contained herein. The information in
--      this document is provided "as is" without warranty of any kind and
--      is subject to change without notice. The warranties for HP products
--      are set forth in the express limited warranty statements
--      accompanying such products. Nothing herein should be construed as
--      constituting an additional warranty.
--
--      Confidential computer software. Valid license from HP required for
--      possession, use or copying. Consistent with FAR 12.211 and 12.212,
--      Commercial Computer Software, Computer Software Documentation, and
--      Technical Data for Commercial Items are licensed to the U.S.
--      Government under vendor's standard commercial license.
--
-- Internal statistics intended for use by HP employees.  Retrieval and
-- interpretation of these OIDs is not supported.
--

    IMPORTS
        enterprises   FROM RFC1155-SMI
        OBJECT-TYPE   FROM RFC-1212
        DisplayString FROM RFC1213-MIB;

-- It is unlikely to have real enterprises.42 agents on an Integrity Server.

    hpimaStatistics   OBJECT IDENTIFIER ::= { enterprises 42 }
    hpimaScalars      OBJECT IDENTIFIER ::= { hpimaStatistics 1 }
    hpimaOIDs         OBJECT IDENTIFIER ::= { hpimaStatistics 2 }
    hpimaCredits      OBJECT IDENTIFIER ::= { hpimaStatistics 3 }

-- -------------------------------- Scalars ------------------------------

hpimaStatus OBJECT-TYPE
    SYNTAX      INTEGER {
            stopped(1),
	    disconnected(2),
            stale(3),
            alive(4),
            collecting(5)
    }
    ACCESS      read-only
    STATUS      current
    DESCRIPTION "Overall status of the HP Insight Manager Agents.
    
         Data is gathered by a collection of subagents that maintain
	 contact with the hpimaX process.  This OID describes their 
	 aggregate ability to respond to SNMP transactions:

	 stopped - At least one subagent is not running.

	 disconnected - At least one subagent signalled a disconnect.

	 stale - All subagents are running but at least one has lost contact.

	 alive - All subagents are running and in current contact.
	 
	 collecting - All subagents are running and in current contact, and
	 hpimaX is collecting statistics from them.  This state is mostly
	 similar to 'alive'.

	 Any state below 'alive' will suppress all cpq* OIDs.  Details
	 can be seen in /var/log/hp/hpima."

    ::= { hpimaScalars 1 }

hpimaMnemonicCount OBJECT-TYPE
    SYNTAX      INTEGER
    ACCESS      read-only
    STATUS      current
    DESCRIPTION
	"The maximum number of unique OID base mnemonics that could ever be
	 returned by the HP Insight Manager Agents.   This includes optional 
	 OIDs (ie, cellular information on non-cellular systems).  It only 
	 accounts for the names of columnar objects, not every instance in 
	 a table."
    ::= { hpimaScalars 2 }

hpimaOIDsReset OBJECT-TYPE
    SYNTAX      INTEGER
    ACCESS      read-write
    STATUS      current
    DESCRIPTION
	"Writing any value to this OID will reset the GET/SET statistics 
	 and query each running subagent for init_info status.  This must 
	 be done at least once after agents have had a chance to stabilize 
	 following a start or restart (60 seconds should be long enough).
	 
	 A read from this variable always returns zero."
    ::= { hpimaScalars 3 }

hpimaCreditsEnable OBJECT-TYPE
    SYNTAX      INTEGER
    ACCESS      read-write
    STATUS      current
    DESCRIPTION
	"Reading from this OID always returns zero."
    ::= { hpimaScalars 4 }

-- -------------------------------- OID Stats ------------------------------

OIDsTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF OIDsEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
	"Define the table of statistics for each OID realized by the HP Insight Management Agents."
    ::= { hpimaOIDs 1 }

oIDsEntry OBJECT-TYPE
    SYNTAX      OIDsEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
	"A row containing a set of Boolean states for a particular OID."
    INDEX   { OIDsIndex }
    ::= { OIDsTable 1 }

OIDsEntry ::= SEQUENCE {
	OIDsIndex	INTEGER,
	OIDstateStr	DisplayString
}

OIDsIndex OBJECT-TYPE
    SYNTAX  INTEGER
    ACCESS  not-accessible
    STATUS  current
    DESCRIPTION
	"A monotonically increasing number."
    ::= { oIDsEntry 1 }

hpimaOIDstate OBJECT-TYPE
    SYNTAX  DisplayString
    ACCESS  read-only
    STATUS  current
    DESCRIPTION
       "The statistics must be reset at least once (see hpimaOIDsReset)
	and may be reset as needed to reflect changes in subagent status.

	There is one string for every OID realized by the HP Insight
	Management Agents.  Some of the string content is always present,
	some is optional depending on the hardware and drivers in the
	system.  A full string is of the form
	 
	Mnemonic(regfile) AA BB cc dd ...

	Mnmenonic is the OID (ie, cpqHoCommonPollFreq)
	regfile   is the registry file under /var/opt/hp/hpima/registry
	 
	The following two-character Boolean flags are capitalized if true
	(AA versus aa).   If there are no flags for a given OID, it was
	never initialized by any subagent (or the subagent came online
	after the last hpimaOIDsReset).

	EN	Enabled ('optional' OIDs can be disabled)
	GA	At least one Get/GetNext has been attempted on this OID
	GS	At least one Get/GetNext has succeeded
	GF	At least one Get/GetNext has failed
	SA	At least one Set has been attempted
	SS	At least one Set has succeeded
	SF	At least one Set has failed
	NA	At least one access failed because no subagent was running

	Only writeable OIDs can display SA/SS/SF.  All flags are a cumulative
	result of operations since the last hpimaOIDsReset write operation."

    ::= { oIDsEntry 2 }

-- -------------------------------- Credits ------------------------------

CreditsTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF CreditsEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
	"Define the table of contributors to the HP Insight Management Agents."
    ::= { hpimaCredits 1 }

creditsEntry OBJECT-TYPE
    SYNTAX      CreditsEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
	"A row containing a contributor name and title.  The rows are
	 organized in chronological order."
    INDEX   { creditsIndex }
    ::= { CreditsTable 1 }

CreditsEntry ::= SEQUENCE {
	creditsIndex	INTEGER,
	player		DisplayString
}

creditsIndex OBJECT-TYPE
    SYNTAX  INTEGER
    ACCESS  not-accessible
    STATUS  current
    DESCRIPTION
	"A monotonically increasing number."
    ::= { creditsEntry 1 }

hpimaWhoWhat OBJECT-TYPE
    SYNTAX  DisplayString
    ACCESS  read-only
    STATUS  current
    DESCRIPTION
	"Who has done what in the lifecyle of the product."
    ::= { creditsEntry 2 }

END
