[Search for users] [Overall Top Noters] [List of all Conferences] [Download this site]

Conference azur::mcc

Title:DECmcc user notes file. Does not replace IPMT.
Notice:Use IPMT for problems. Newsletter location in note 6187
Moderator:TAEC::BEROUD
Created:Mon Aug 21 1989
Last Modified:Wed Jun 04 1997
Last Successful Update:Fri Jun 06 1997
Number of topics:6497
Total number of notes:27359

4370.0. "what does "pruning" mibs really mean?" by COL01::LUNT () Mon Jan 11 1993 12:12

Hi,

	I am trying to understand this whole mib concept. I have the following
mib which I translated with success with the MIB translator Utility, of course
after making some corrections in syntax after hours of reading RFC's and
other MIBs to determine what the errors were. But now that I have succeed in
translating the mib, I don't understand 
what "pruning" is. I believed it would "remove" only those parts of the
mib that are not used. An example to explain this:

In the following mib  the childe entity "alert OBJECT IDENTIFIER ::= { ibmArchitecture 1 }"
is defined.
Then a several "children" ( if this is the correct term?) of the node
alert are defined, ie. "product-Set-ID OBJECT IDENTIFIER ::= { alert 3  } 
These "leaves" are used in the OBJECT-TYPE definitions, ie.
hwProductInstallSpecificInfoTable OBJECT-TYPE
    SYNTAX SEQUENCE OF HwProductEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
        "A table containing information to identify hardware or
        microcode products.  One or more entries in this table
        will be present in a trap."
    ::= { product-Set-ID 1 }
 
And then when the mib is translated the child entity "alert" is pruned. Why?

Another child entity "ibm3172 OBJECT IDENTIFIER ::= { ibmProd 1 }" which has
not children "OBJECT-TYPES" defined is also pruned. This seems to make sense as
this entity has no further children, therefore no use.

Another question is, that many tables have no INDEX, but the MIB translated 
without error. Does this mean access into these tables of values is impossible?
Will MCC be able to read these tables and display the values? What is exactly
the use of the INDEX definition?


Thanks in advance,

Julie Ann





--------------------------------------------------------------------------

MIB TO BE TRANSLATED
--------------------------------------------------------------------------



IbmFaultMgmt-MIB DEFINITIONS ::= BEGIN
 
IMPORTS
       alert
                    FROM IBM-MIB
       Counter
                    FROM RFC1155-SMI
       DisplayString
                    FROM RFC1213-MIB
       OBJECT-TYPE
                    FROM RFC-1212;
 
-- This MIB defines fault management objects to be transported in an IBM
-- enterprise specific trap.  The objects are compatible with IBM SNA
-- Management Services Generic Alert architecture.  References to
-- subvectors and subfields are provided to facilitate mapping to the
-- architecture if desired.  For additional information on IBM SNA
-- Management Services, refer to "IBM SNA Formats" (GA27-3136), and "IBM
-- SNA/Management Services Reference (SC30-3346).
--
-- Traps containing these objects have been designed to enable a
-- management station receiving such a trap to provide a network operator
-- with a notification of the problem or impending problem, the problem
-- type, description and probable cause,  and recommended action for
-- problem resolution.  The design also facilitates the conversion of the
-- trap to an SNA Alert that can be forwarded to a SNA focal point.  It
-- should be noted that much of the fault management data is transported
-- in the form of code points that correspond to strings of text stored
-- at the trap reciever and Alert receiver.
 
-- Groups in Fault Management MIB
 
ibm                           OBJECT IDENTIFIER ::= { enterprises 2 }
 
ibmResearch                   OBJECT IDENTIFIER ::= { ibm 2 }
 
ibmAgents                     OBJECT IDENTIFIER ::= { ibm 3 }
 
ibmArchitecture               OBJECT IDENTIFIER ::= { ibm 5 }
  alert                       OBJECT IDENTIFIER ::= { ibmArchitecture 1 }
 
ibmProd                       OBJECT IDENTIFIER ::= { ibm 6 }
  ibm3172                     OBJECT IDENTIFIER ::= { ibmProd 1 }
  ibm6611                     OBJECT IDENTIFIER ::= { ibmProd 2 }
  netView6000                 OBJECT IDENTIFIER ::= { ibmProd 3 }
  netView6000SubAgent         OBJECT IDENTIFIER ::= { ibmProd 4 }
product-Set-ID        OBJECT IDENTIFIER ::= { alert 3  } -- x10 subvector
supporting-Data-Correl OBJECT IDENTIFIER ::= { alert 7 } -- x48 subvector
generic-Alert-Data    OBJECT IDENTIFIER ::= { alert 11 } -- x92 subvector
probable-Causes       OBJECT IDENTIFIER ::= { alert 12 } -- x93 subvector
user-Causes           OBJECT IDENTIFIER ::= { alert 13 } -- x94 subvector
install-Causes        OBJECT IDENTIFIER ::= { alert 14 } -- x95 subvector
failure-Causes        OBJECT IDENTIFIER ::= { alert 15 } -- x96 subvector
detailed-Data-SV      OBJECT IDENTIFIER ::= { alert 17 } -- x98 subvector
 
 
------------------------------------------------------------------------
-- The product-Set-ID group { alert 3 }  (X'10' MS Common Subvector)
--
-- This group is always present in a trap to describe the product
-- encountering the condition being reported.
--
-----------------------------------------------------------------------
 
 
------------------------------------------------------------------------
-- hwProductInstallSpecificInfoTable (X'11' MS Common Subvector)
------------------------------------------------------------------------
hwProductInstallSpecificInfoTable OBJECT-TYPE
    SYNTAX SEQUENCE OF HwProductEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
        "A table containing information to identify hardware or
        microcode products.  One or more entries in this table
        will be present in a trap."
    ::= { product-Set-ID 1 }
 
hwProductEntry OBJECT-TYPE
    SYNTAX HwProductEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "The information required to identify a single hardware product.
        The index is the product being reported.  The first entry
        identifies the product sending the trap.  A second entry will be
        present in those traps reporting a condition in a product other
        than the trap sender."
    ::= { hwProductInstallSpecificInfoTable 1 }
 
HwProductEntry  ::=
    SEQUENCE  {
       productClassificationHW      INTEGER,
       formatType                   INTEGER,
       machineType                  DisplayString,
       modelNum                     DisplayString,
       plantOfManufacture           DisplayString,
       seqNum                       DisplayString,
       microcodeECLevel             DisplayString,
       hardwareProdCommonName       DisplayString,
       vendorIDhw                   DisplayString
}
productClassificationHW OBJECT-TYPE
    SYNTAX INTEGER {
       hwIBM(1),        -- (X'1') IBM hardware
       hwIBM-NonIBM(3), -- (X'3') IBM or non-IBM hardware
                        -- (not distinguished)
       hwNonIBM(9)     -- (X'9') non-IBM hardware
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "A code identifying the general classification of a product."
    ::= { hwProductEntry 1 }
 
------------------------------------------------------------------------
-- Hardware Product ID (X'00' Product ID Subfield)
------------------------------------------------------------------------
formatType OBJECT-TYPE
    SYNTAX INTEGER {
       form11(17) -- (X'11') prod. instance identified by plant of mfg.
                  -- and sequence # (unique by machine type and model #)
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "A code identifying the format type of a product instance."
    ::= { hwProductEntry 2 }
 
machineType OBJECT-TYPE
    SYNTAX DisplayString (SIZE (4)) -- numeric characters only
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "The machine type."
    ::= { hwProductEntry 3 }
 
modelNum OBJECT-TYPE
    SYNTAX DisplayString (SIZE (3))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Machine model number."
    ::= { hwProductEntry 4 }
 
plantOfManufacture OBJECT-TYPE
    SYNTAX DisplayString (SIZE (2))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Plant of manufacture."
    ::= { hwProductEntry 5 }
 
seqNum OBJECT-TYPE
    SYNTAX DisplayString (SIZE (7))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Sequence number: right justified, with ASCII 0's fill on left."
    ::= { hwProductEntry 6}
 
 
------------------------------------------------------------------------
-- microcodeECLevel (X'0B' Product ID Subfield)
------------------------------------------------------------------------
microcodeECLevel OBJECT-TYPE
    SYNTAX DisplayString (SIZE (0..8))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "The Engineering Change (EC) level of the failing microcode
       component.  This object is included in a trap only when the
       reported problem is most probably caused by a microcode failure.
 
       This object continues to exist in the MIB even at times when it
       is not included in a trap, but a get will result in the object
       being returned with a length of 0."
    ::= { hwProductEntry 7 }
 
------------------------------------------------------------------------
-- hardwareProdCommonName (X'0E' Product ID Subfield)
------------------------------------------------------------------------
hardwareProdCommonName OBJECT-TYPE
    SYNTAX DisplayString (SIZE (1..15))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "The name commonly used to identify the product."
    ::= { hwProductEntry 8 }
 
------------------------------------------------------------------------
-- vendorIDhw (X'0F' Product ID Subfield)
------------------------------------------------------------------------
vendorIDhw OBJECT-TYPE
    SYNTAX DisplayString (SIZE (0..16))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "The name of the product vendor.  This object is included in a
       trap only when the productClassificationHW object is set to
       'hwNonIBM' or 'hwIBM-NonIBM'.
 
       This object continues to exist in the MIB even at times when it
       is not included in a trap, but a get will result in the object
       being returned with a length of 0."
    ::= { hwProductEntry 9 }
 
 
------------------------------------------------------------------------
-- swProductInstallSpecificInfoTable (X'11' MS Common Subvector)
------------------------------------------------------------------------
swProductInstallSpecificInfoTable OBJECT-TYPE
    SYNTAX SEQUENCE OF SwProductEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
        "A table containing information to identify software products.
        This table is present in a trap when the condition being reported
        is in a software product or set of software products."
    ::= { product-Set-ID 2 }
 
swProductEntry OBJECT-TYPE
    SYNTAX SwProductEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "The information required to identify a single software product.
        The index is the instnce of product being identified."
    ::= { swProductInstallSpecificInfoTable 1 }
 
SwProductEntry  ::=
    SEQUENCE  {
        productClassificationSW         INTEGER (0..15),
        commonVerID                     DisplayString (SIZE (0..2)),
        commonRelID                     DisplayString (SIZE (0..2)),
        commonModID                     DisplayString (SIZE (0..2)),
        softwareProdCommonName          DisplayString (SIZE (1..30)),
        softwareProdProgNmbr            DisplayString (SIZE (0..7)),
        vendorIDsw                      DisplayString (SIZE (1..16))
    }
 
productClassificationSW OBJECT-TYPE
    SYNTAX INTEGER {
       swIBM(4),        -- (X'4') IBM software
       swNonIBM(12),    -- (X'C') non-IBM software
       swIBM-NonIBM(14) -- (X'E') IBM or non-IBM software
                        --        (not distinguished)
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "A code identifying the general classification of a product."
    ::= { swProductEntry 1 }
 
------------------------------------------------------------------------
-- Software Product Common Level (X'04' Product ID Subfield)
------------------------------------------------------------------------
commonVerID OBJECT-TYPE
    SYNTAX DisplayString (SIZE (0..2))  -- Numeric characters only
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Common version ID: right justified, with ASCII 0 fill on left."
    ::= { swProductEntry 2 }
 
commonRelID OBJECT-TYPE
    SYNTAX DisplayString (SIZE (0..2))  -- Numeric characters only
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Common release ID: right justified, with ASCII 0 fill on left."
    ::= { swProductEntry 3 }
 
commonModID OBJECT-TYPE
    SYNTAX DisplayString (SIZE (0..2))  -- Numeric characters only
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Common modification ID: right justified, with ASCII 0 fill on
       left."
    ::= { swProductEntry 4 }
 
------------------------------------------------------------------------
-- softwareProdCommonName (X'06' Product ID Subfield)
------------------------------------------------------------------------
softwareProdCommonName OBJECT-TYPE
    SYNTAX DisplayString (SIZE (1..30))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "The name commonly used to identify the product."
    ::= { swProductEntry 5 }
 
------------------------------------------------------------------------
-- softwareProdProgNmbr (X'08' Product ID Subfield)
------------------------------------------------------------------------
softwareProdProgNmbr OBJECT-TYPE
    SYNTAX DisplayString (SIZE (0..7))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "The program product number as assigned by distribution personnel,
       or a substitute value supplied by a user-written software
       program."
    ::= { swProductEntry 6 }
 
------------------------------------------------------------------------
-- vendorIDsw (X'0F' Product ID Subfield)
------------------------------------------------------------------------
vendorIDsw OBJECT-TYPE
    SYNTAX DisplayString (SIZE (0..16))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "The name of the product vendor.  This object is included in a
       trap only when the productClassificationSW object is set to
       'swNonIBM' or 'swIBM-NonIBM'.
 
       This object continues to exist in the MIB even at times when it
       is not included in a trap, but a get will result in the object
       being returned with a length of 0."
    ::= { swProductEntry 7 }
 
 
------------------------------------------------------------------------
-- The supporting-Data-Correl group { alert 7 } (X'48' MS Common Subvector)
-- This group is present in a trap when additional data is available
-- that relates to the problem being reported.
------------------------------------------------------------------------
--
--
------------------------------------------------------------------------
-- detailedDataSD (X'85' Supporting Data Correlation Subfield)
------------------------------------------------------------------------
detailedDataSDTable OBJECT-TYPE
    SYNTAX SEQUENCE OF DetailedDataSDEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of information correlation data."
::= { supporting-Data-Correl 2 }
 
detailedDataSDEntry OBJECT-TYPE
    SYNTAX DetailedDataSDEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "The information required  by the trap receiver to
       correlate/retrieve additional data.  All objects in this entry
       will be provided.  The index is the instance/number of the
       correlator.  Multiple entries will be provided when multiple sets
       of data are available."
::= { detailedDataSDTable 1 }
 
DetailedDataSDEntry  ::=
    SEQUENCE  {
       productIDCodeSD  INTEGER,
       dataIDCodeSD     INTEGER,
       dataEncodingSD   INTEGER,
       dataSD           OCTET STRING
}
 
productIDCodeSD OBJECT-TYPE
    SYNTAX INTEGER {
       displayNone(0),      -- X'00'
       displayFirstHW(41),  -- X'29'
       displaySecondHW(42), -- X'2A'
       displayFirstSW(153), -- X'99'
       displaySecondSW(154) -- X'9A'
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A code indicating what product identification, if any is
        to displayed in conjunction with the data-type and data.
 
            displayNone     - Do not display any product identification
                              data in conjunction with the data-type and
                              data.
 
            displayFirstHW  - display machine type or product common name
                              from the first entry of the machineType
                              or hardwareProdCommonName objects in the
                              hwProductInstallSpecificInfoTable.
 
            displaySecondHW - display machine type or product common name
                              from the second entry of the machineType
                              or hardwareProdCommonName objects in the
                              hwProductInstallSpecificInfoTable.
 
            displayFirstSW  - display software product common name
                              from the first entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable.
 
            displaySecondSW - display software product common name
                              from the second entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable."
    ::= { detailedDataSDEntry 1 }
 
dataIDCodeSD OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A Detailed Data Code Point (Data ID code point)
        (described in IBM document GA27-3136) indicating the type of data
        provided.  The English text associated with each code point or
        its national language equivalent is displayed with the
        correlation data."
   ::= { detailedDataSDEntry 2 }
 
dataEncodingSD OBJECT-TYPE
    SYNTAX INTEGER {
        hex(0),    -- (X'00') encoded/displayed as hexadecimal digits
        binary(1), -- (X'01') encoded as an unsigned integer value, the
                   -- decimal equivalent is displayed
        ascii(17)  -- (X'11') data is to be decoded as ASCII characters
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A code indicating how the accompanying correlation data is
        encoded, and thus how it is to be decoded and displayed."
    ::= { detailedDataSDEntry 3 }
 
dataSD OBJECT-TYPE
    SYNTAX OCTET STRING (SIZE (1..44))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Correlation data encoded as specified by the dataEncodingSD
       object."
    ::= { detailedDataSDEntry 4}
 
------------------------------------------------------------------------
-- The generic-Alert-Data group { alert 11 } (X'92' Alert MS Subvector)
--
-- This group is always provided in a trap to describe the problem being
-- reported.
------------------------------------------------------------------------
flags OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "This object is always set to the value 0.  It may be used
        in the future to further indicate why/when the trap was
        sent."
    ::= { generic-Alert-Data 1 }
 
alertType OBJECT-TYPE
    SYNTAX INTEGER {
       perm(1),  -- (X'01') permanent loss of availability
       temp(2),  -- (X'02') temporary loss of availability
       perf(3),  -- (X'03') performance is below an acceptable level
       pend(17), -- (X'11') impending loss of availability
       unkn(18)  -- (X'12') the severity of the problem is not known
    }
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
       "A code indicating the severity of the condition being reported."
    ::= { generic-Alert-Data 2 }
 
alertDescriptionCode OBJECT-TYPE
    SYNTAX INTEGER  (0..65535)
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "An Alert Description Code Point (described in IBM document
        GA27-3136) denoting the problem being reported."
    ::= { generic-Alert-Data 3 }
 
------------------------------------------------------------------------
-- The probable-Causes group { alert 12 }  (X'93' Alert MS Subvector)
--
-- This group is always present in a trap to provide the probable
-- cause(s) of the condition being reported.
------------------------------------------------------------------------
probableCausesTable OBJECT-TYPE
    SYNTAX SEQUENCE OF ProbableCauseEntry
    ACCESS not-accessible
    STATUS mandatory
    DESCRIPTION
       "A table of probable cause data."
    ::= { probable-Causes 1 }
 
probableCausesEntry OBJECT-TYPE
    SYNTAX ProbableCausesEntry
    ACCESS not-accessible
    STATUS mandatory
    DESCRIPTION
       "An entry of probable cause data.  The index is the
       number/instance of the probable cause."
    ::= { probableCausesTable 1 }
 
ProbableCausesEntry ::=  SEQUENCE { probableCause INTEGER }
 
probableCause OBJECT-TYPE
    SYNTAX INTEGER
    ACCESS read-only
    STATUS mandatory
    DESCRIPTION
        "A Probable Cause Code Point (described in IBM document
        GA27-3136) denoting the probable cause of the reported problem.
        From one to four instances of this object (in order of decreasing
        probability) are provided in a trap."
    ::= { probableCausesEntry 1 }
 
------------------------------------------------------------------------
-- The user-Causes group { alert 13 } (X'94' Alert MS Subvector)
--
-- This group provides data detailing the probable user causes of the
-- problem and the recommended actions to be taken in connection with
-- these causes.  It may also provide additional detailed data to be
-- inserted into the text indexed by the user cause and/or recommended
-- action code points.
--
-- This group is present in a trap if it possible that the problem could
-- have been caused by a user/customer.
------------------------------------------------------------------------
--
--
------------------------------------------------------------------------
-- userCause (X'01' User Causes Subfield)
------------------------------------------------------------------------
userCausesTable OBJECT-TYPE
    SYNTAX SEQUENCE OF UserCausesEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of user cause data."
    ::= { user-Causes 1 }
 
userCausesEntry OBJECT-TYPE
    SYNTAX UserCausesEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "An entry of user cause data.  The index is the number/instance
       of the user cause."
    ::= { userCausesTable 1}
 
UserCausesEntry ::=  SEQUENCE { userCause  INTEGER }
 
userCause OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A User Cause Code Point (described in IBM document GA27-3136)
        denoting the probable user cause of the reported problem.  From
        From 0 to 4 instances of this object (in order of decreasing
        probability) are provided in a trap."
    ::= { userCausesEntry 1}
 
------------------------------------------------------------------------
-- recommendedActionsUC (X'81' Network Alert Common Subfield)
------------------------------------------------------------------------
recommendedActionsUCTable OBJECT-TYPE
    SYNTAX SEQUENCE OF RecommendedActionsUCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of recommended action data."
    ::= { user-Causes 2 }
 
recommendedActionsUCEntry OBJECT-TYPE
    SYNTAX RecommendedActionsUCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "An entry of recommended action data.  The index is the
       number/instance of the recommended action."
    ::= { recommendedActionsUCTable 1}
 
RecommendedActionsUCEntry ::= SEQUENCE { recommendedActionUC INTEGER }
 
recommendedActionUC OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A Recommended Action Code Point (described in IBM document
        GA27-3136) denoting the recommended action to take to resolve the
        problem.  From 0 to 4 instances of this object (in order of
        decreasing probability) are provided in a trap.  If an instance
        of the userCause object is present, at least one instance of this
        object will be present."
    ::= { recommendedActionsUCEntry 1 }
 
------------------------------------------------------------------------
-- detailedDataUC (X'85' Network Alert Common Subfield)
--
-- This subgroup is provided in a trap whenever detailed data is to be
-- inserted into the text indexed by the user cause and/or recommended
-- action code points.
------------------------------------------------------------------------
detailedDataUCTable OBJECT-TYPE
    SYNTAX SEQUENCE OF DetailedDataUCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of data to be inserted into the text indexed by
       the user cause and/or recommended action code points."
::= { user-Causes 3 }
 
detailedDataUCEntry OBJECT-TYPE
    SYNTAX DetailedDataUCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "The information required  to display product identification, data
       type, and detailed data.  The index is the instance/number of the
       detailed data.  The following rules are used for providing
       entries:
 
       * An entry is provided for each instance of the userCause object
         and/or recommendedActionUC object containing a codepoint whose
         third character is 'A' or 'B'.
 
       * Two entries are provided for each instance of the userCause
         object and/or recommendedActionUC object containing a codepoint
         whose third character is 'C'.
 
       * Three entries are provided for each instance of the userCause
         object and/or recommendedActionUC object containing a
         codepoint whose third character is 'D'.
 
       Entries are provided in the order of the occurrance of the code
       points requiring them."
::= { detailedDataUCTable 1 }
 
DetailedDataUCEntry  ::=
    SEQUENCE  {
       productIDCodeUC  INTEGER,
       dataIDCodeUC     INTEGER,
       dataEncodingUC   INTEGER,
       dataUC           OCTET STRING
}
 
productIDCodeUC OBJECT-TYPE
    SYNTAX INTEGER {
       displayNone(0),      -- X'00'
       displayFirstHW(41),  -- X'29'
       displaySecondHW(42), -- X'2A'
       displayFirstSW(153), -- X'99'
       displaySecondSW(154) -- X'9A'
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A code indicating what product identification, if any is
        to displayed in conjunction with the data-type and data.
 
            displayNone     - Do not display any product identification
                              data in conjunction with the data-type and
                              data.
 
            displayFirstHW  - display machine type or product common name
                              from the first entry of the machineType
                              or hardwareProdCommonName objects in the
                              hwProductInstallSpecificInfoTable.
 
            displaySecondHW - display machine type or product common name
                              from the second entry of the machineType
                              or hardwareProdCommonName objects in the
                              hwProductInstallSpecificInfoTable.
 
            displayFirstSW  - display software product common name
                              from the first entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable.
 
            displaySecondSW - display software product common name
                              from the second entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable."
    ::= { detailedDataUCEntry 1 }
 
dataIDCodeUC OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A Detailed Data Code Point (Data ID code point)
        (described in IBM document GA27-3136) indicating the type of data
        provided.  The English text associated with each code point or
        its national language equivalent is displayed with the
        detailed data."
   ::= { detailedDataUCEntry 2 }
 
dataEncodingUC OBJECT-TYPE
    SYNTAX INTEGER {
        hex(0),    -- (X'00') encoded/displayed as hexadecimal digits
        binary(1), -- (X'01') encoded as an unsigned integer value, the
                   -- decimal equivalent is displayed
        ascii(17)  -- (X'11') data is to be decoded as ASCII characters
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A code indicating how the accompanying detailed data is
        encoded, and thus how it is to be decoded and displayed."
    ::= { detailedDataUCEntry 3 }
 
dataUC OBJECT-TYPE
    SYNTAX OCTET STRING (SIZE (1..44))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Detailed data encoded as specified by the dataEncodingUC
       object."
    ::= { detailedDataUCEntry 4}
 
------------------------------------------------------------------------
-- productSetIDIndexUC (X'83' Network Alert Common Subfield)
--
-- This subgroup is provided in a trap whenever product  identification
-- data is to be inserted into the text indexed by the user cause and/or
-- recommended action code points.
------------------------------------------------------------------------
productSetIDIndexUCTable OBJECT-TYPE
    SYNTAX SEQUENCE OF ProductSetIDIndexUCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table a describing how product identification data will be
       inserted into the text indexed by the user cause or recommended
       action code points."
::= { user-Causes 4 }
 
productSetIDIndexUCEntry OBJECT-TYPE
    SYNTAX ProductSetIDIndexUCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "An instance of information required to display product
       identification data.  The index is the instance of the Product Set
       ID Index.  An entry is provided for each instance of the userCause
       object and/or recommendedActionUC  object containing a codepoint
       whose third character is  'E'.  Entries are provided in the order
       of the occurrance of the code points  requiring them."
::= { productSetIDIndexUCTable 1 }
 
ProductSetIDIndexUCEntry ::= SEQUENCE { productSetIDIndexUC INTEGER }
 
 
productSetIDIndexUC OBJECT-TYPE
    SYNTAX INTEGER {
       displayFirstHW(41),  -- X'29'
       displaySecondHW(42), -- X'2A'
       displayFirstSW(153), -- X'99'
       displaySecondSW(154) -- X'9A'
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "This object provides a code indicating how product
        identification data is to be inserted into the text
        indexed by the user cause and/or recommended action code
        points.
 
            displayFirstHW - display machine type or product common name
                             from the first instance of the machineType
                             or hardwareProdCommonName objects.
 
            displaySecondHW - display machine type or product common name
                              from the second instance of the machineType
                              or hardwareProdCommonName objects.
 
            displayFirstSW  - display software product common name
                              from the first entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable.
 
            displaySecondSW - display software product common name
                              from the second entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable."
    ::= { productSetIDIndexUCEntry 1}
 
------------------------------------------------------------------------
-- The install-Causes group { alert 14 } (X'95' Alert MS Subvector)
--
-- This group provides data detailing the probable install causes of the
-- problem and the recommended actions to be taken in connection with
-- these causes.  It may also provide additional detailed data to be
-- inserted into the text indexed by the install cause and/or recommended
-- action code points.
--
-- This group is present in a trap if it possible that the problem could
-- have been caused by an improper installation.
------------------------------------------------------------------------
--
--
------------------------------------------------------------------------
-- installCause (X'01' Install Causes Subfield)
------------------------------------------------------------------------
installCausesTable OBJECT-TYPE
    SYNTAX SEQUENCE OF InstallCausesEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of install cause data."
    ::= { install-Causes 1 }
 
installCausesEntry OBJECT-TYPE
    SYNTAX InstallCausesEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "An entry of install cause data.  The index is the number/instance
       of the install cause."
    ::= { installCausesTable 1}
 
InstallCausesEntry ::=  SEQUENCE { installCause  INTEGER }
 
installCause OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "An Install Cause Code Point (described in IBM document GA27-3136)
        denoting the probable install cause of the reported problem.  From
        From 0 to 4 instances of this object (in order of decreasing
        probability) are provided in a trap."
    ::= { installCausesEntry 1}
 
------------------------------------------------------------------------
-- recommendedActionsIC (X'81' Network Alert Common Subfield)
------------------------------------------------------------------------
recommendedActionsICTable OBJECT-TYPE
    SYNTAX SEQUENCE OF RecommendedActionsICEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of recommended action data."
    ::= { install-Causes 2 }
 
recommendedActionsICEntry OBJECT-TYPE
    SYNTAX RecommendedActionsICEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "An entry of recommended action data.  The index is the
       number/instance of the recommended action."
    ::= { recommendedActionsICTable 1}
 
RecommendedActionsICEntry ::= SEQUENCE { recommendedActionIC INTEGER }
 
recommendedActionIC OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A Recommended Action Code Point (described in IBM document
        GA27-3136) denoting the recommended action to take to resolve the
        problem.  From 0 to 4 instances of this object (in order of
        decreasing probability) are provided in a trap.  If an instance
        of the installCause object is present, at least one instance of this
        object will be present."
    ::= { recommendedActionsICEntry 1 }
 
------------------------------------------------------------------------
-- detailedDataIC (X'85' Network Alert Common Subfield)
--
-- This subgroup is provided in a trap whenever detailed data is to be
-- inserted into the text indexed by the install cause and/or recommended
-- action code points.
------------------------------------------------------------------------
detailedDataICTable OBJECT-TYPE
    SYNTAX SEQUENCE OF DetailedDataICEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of data to be inserted into the text indexed by
       the install cause and/or recommended action code points."
::= { install-Causes 3 }
 
detailedDataICEntry OBJECT-TYPE
    SYNTAX DetailedDataICEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "The information required  to display product identification, data
       type, and detailed data.  The index is the instance/number of the
       detailed data.  The following rules are used for providing
       entries:
 
       * An entry is provided for each instance of the installCause object
         and/or recommendedActionIC object containing a codepoint whose
         third character is 'A' or 'B'.
 
       * Two entries are provided for each instance of the installCause
         object and/or recommendedActionIC object containing a codepoint
         whose third character is 'C'.
 
       * Three entries are provided for each instance of the installCause
         object and/or recommendedActionIC object containing a
         codepoint whose third character is 'D'.
 
       Entries are provided in the order of the occurrance of the code
       points requiring them."
::= { detailedDataICTable 1 }
 
DetailedDataICEntry  ::=
    SEQUENCE  {
       productIDCodeIC  INTEGER,
       dataIDCodeIC     INTEGER,
       dataEncodingIC   INTEGER,
       dataIC           OCTET STRING
}
 
productIDCodeIC OBJECT-TYPE
    SYNTAX INTEGER {
       displayNone(0),      -- X'00'
       displayFirstHW(41),  -- X'29'
       displaySecondHW(42), -- X'2A'
       displayFirstSW(153), -- X'99'
       displaySecondSW(154) -- X'9A'
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A code indicating what product identification, if any is
        to displayed in conjunction with the data-type and data.
 
            displayNone     - Do not display any product identification
                              data in conjunction with the data-type and
                              data.
 
            displayFirstHW  - display machine type or product common name
                              from the first entry of the machineType
                              or hardwareProdCommonName objects in the
                              hwProductInstallSpecificInfoTable.
 
            displaySecondHW - display machine type or product common name
                              from the second entry of the machineType
                              or hardwareProdCommonName objects in the
                              hwProductInstallSpecificInfoTable.
 
            displayFirstSW  - display software product common name
                              from the first entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable.
 
            displaySecondSW - display software product common name
                              from the second entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable."
    ::= { detailedDataICEntry 1 }
 
dataIDCodeIC OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A Detailed Data Code Point (Data ID code point)
        (described in IBM document GA27-3136) indicating the type of data
        provided.  The English text associated with each code point or
        its national language equivalent is displayed with the
        detailed data."
   ::= { detailedDataICEntry 2 }
 
dataEncodingIC OBJECT-TYPE
    SYNTAX INTEGER {
        hex(0),    -- (X'00') encoded/displayed as hexadecimal digits
        binary(1), -- (X'01') encoded as an unsigned integer value, the
                   -- decimal equivalent is displayed
        ascii(17)  -- (X'11') data is to be decoded as ASCII characters
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A code indicating how the accompanying detailed data is
        encoded, and thus how it is to be decoded and displayed."
    ::= { detailedDataICEntry 3 }
 
dataIC OBJECT-TYPE
    SYNTAX OCTET STRING (SIZE (1..44))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Detailed data encoded as specified by the dataEncodingIC
       object."
    ::= { detailedDataICEntry 4}
 
------------------------------------------------------------------------
-- productSetIDIndexIC (X'83' Network Alert Common Subfield)
--
-- This subgroup is provided in a trap whenever product  identification
-- data is to be inserted into the text indexed by the install cause and/or
-- recommended action code points.
------------------------------------------------------------------------
productSetIDIndexICTable OBJECT-TYPE
    SYNTAX SEQUENCE OF ProductSetIDIndexICEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table a describing how product identification data will be
       inserted into the text indexed by the install cause or recommended
       action code points."
::= { install-Causes 4 }
 
productSetIDIndexICEntry OBJECT-TYPE
    SYNTAX ProductSetIDIndexICEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "An instance of information required to display product
       identification data.  The index is the instance of the Product Set
       ID Index.  An entry is provided for each instance of the installCause
       object and/or recommendedActionIC  object containing a codepoint
       whose third character is  'E'.  Entries are provided in the order
       of the occurrance of the code points  requiring them."
::= { productSetIDIndexICTable 1 }
 
ProductSetIDIndexICEntry ::= SEQUENCE { productSetIDIndexIC INTEGER }
 
 
productSetIDIndexIC OBJECT-TYPE
    SYNTAX INTEGER {
       displayFirstHW(41),  -- X'29'
       displaySecondHW(42), -- X'2A'
       displayFirstSW(153), -- X'99'
       displaySecondSW(154) -- X'9A'
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "This object provides a code indicating how product
        identification data is to be inserted into the text
        indexed by the install cause and/or recommended action code
        points.
 
            displayFirstHW - display machine type or product common name
                             from the first instance of the machineType
                             or hardwareProdCommonName objects.
 
            displaySecondHW - display machine type or product common name
                              from the second instance of the machineType
                              or hardwareProdCommonName objects.
 
            displayFirstSW  - display software product common name
                              from the first entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable.
 
            displaySecondSW - display software product common name
                              from the second entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable."
    ::= { productSetIDIndexICEntry 1}
 
------------------------------------------------------------------------
-- The failure-Causes group { alert 15 } (X'96' Alert MS Subvector)
--
-- This group provides data detailing the probable failure causes of the
-- problem and the recommended actions to be taken in connection with
-- these causes.  It may also provide additional detailed data to be
-- inserted into the text indexed by the install cause and/or recommended
-- action code points.
--
-- This group is present in a trap if it possible that the problem could
-- have been caused by the failure of a hardware or software component.
------------------------------------------------------------------------
--
--
------------------------------------------------------------------------
-- failureCause (X'01' Install Causes Subfield)
------------------------------------------------------------------------
failureCausesTable OBJECT-TYPE
    SYNTAX SEQUENCE OF FailureCausesEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of failure cause data."
    ::= { failure-Causes 1 }
 
failureCausesEntry OBJECT-TYPE
    SYNTAX FailureCausesEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "An entry of failure cause data.  The index is the number/instance
       of the failure cause."
    ::= { failureCausesTable 1}
 
FailureCausesEntry ::=  SEQUENCE { failureCause  INTEGER }
 
failureCause OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A Failure Cause Code Point (described in IBM document GA27-3136)
        denoting the probable failure cause of the reported problem.
        From 0 to 4 instances of this object (in order of decreasing
        probability) are provided in a trap."
    ::= { failureCausesEntry 1}
 
------------------------------------------------------------------------
-- recommendedActionsFC (X'81' Network Alert Common Subfield)
------------------------------------------------------------------------
recommendedActionsFCTable OBJECT-TYPE
    SYNTAX SEQUENCE OF RecommendedActionsFCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of recommended action data."
    ::= { failure-Causes 2 }
 
recommendedActionsFCEntry OBJECT-TYPE
    SYNTAX RecommendedActionsFCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "An entry of recommended action data.  The index is the
       number/instance of the recommended action."
    ::= { recommendedActionsFCTable 1}
 
RecommendedActionsFCEntry ::= SEQUENCE { recommendedActionFC INTEGER }
 
recommendedActionFC OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A Recommended Action Code Point (described in IBM document
        GA27-3136) denoting the recommended action to take to resolve the
        problem.  From 0 to 4 instances of this object (in order of
        decreasing probability) are provided in a trap.  If an instance
        of the failureCause object is present, at least one instance of this
        object will be present."
    ::= { recommendedActionsFCEntry 1 }
 
------------------------------------------------------------------------
-- detailedDataFC (X'85' Network Alert Common Subfield)
--
-- This subgroup is provided in a trap whenever detailed data is to be
-- inserted into the text indexed by the failure cause and/or recommended
-- action code points.
------------------------------------------------------------------------
detailedDataFCTable OBJECT-TYPE
    SYNTAX SEQUENCE OF DetailedDataFCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of data to be inserted into the text indexed by
       the failure cause and/or recommended action code points."
::= { failure-Causes 3 }
 
detailedDataFCEntry OBJECT-TYPE
    SYNTAX DetailedDataFCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "The information required  to display product identification, data
       type, and detailed data.  The index is the instance/number of the
       detailed data.  The following rules are used for providing
       entries:
 
       * An entry is provided for each instance of the failureCause object
         and/or recommendedActionFC object containing a codepoint whose
         third character is 'A' or 'B'.
 
       * Two entries are provided for each instance of the failureCause
         object and/or recommendedActionFC object containing a codepoint
         whose third character is 'C'.
 
       * Three entries are provided for each instance of the failureCause
         object and/or recommendedActionFC object containing a
         codepoint whose third character is 'D'.
 
       Entries are provided in the order of the occurrance of the code
       points requiring them."
::= { detailedDataFCTable 1 }
 
DetailedDataFCEntry  ::=
    SEQUENCE  {
       productIDCodeFC  INTEGER,
       dataIDCodeFC     INTEGER,
       dataEncodingFC   INTEGER,
       dataFC           OCTET STRING
}
 
productIDCodeFC OBJECT-TYPE
    SYNTAX INTEGER {
       displayNone(0),      -- X'00'
       displayFirstHW(41),  -- X'29'
       displaySecondHW(42), -- X'2A'
       displayFirstSW(153), -- X'99'
       displaySecondSW(154) -- X'9A'
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A code indicating what product identification, if any is
        to displayed in conjunction with the data-type and data.
 
            displayNone     - Do not display any product identification
                              data in conjunction with the data-type and
                              data.
 
            displayFirstHW  - display machine type or product common name
                              from the first entry of the machineType
                              or hardwareProdCommonName objects in the
                              hwProductInstallSpecificInfoTable.
 
            displaySecondHW - display machine type or product common name
                              from the second entry of the machineType
                              or hardwareProdCommonName objects in the
                              hwProductInstallSpecificInfoTable.
 
            displayFirstSW  - display software product common name
                              from the first entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable.
 
            displaySecondSW - display software product common name
                              from the second entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable."
    ::= { detailedDataFCEntry 1 }
 
dataIDCodeFC OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A Detailed Data Code Point (Data ID code point)
        (described in IBM document GA27-3136) indicating the type of data
        provided.  The English text associated with each code point or
        its national language equivalent is displayed with the
        detailed data."
   ::= { detailedDataFCEntry 2 }
 
dataEncodingFC OBJECT-TYPE
    SYNTAX INTEGER {
        hex(0),    -- (X'00') encoded/displayed as hexadecimal digits
        binary(1), -- (X'01') encoded as an unsigned integer value, the
                   -- decimal equivalent is displayed
        ascii(17)  -- (X'11') data is to be decoded as ASCII characters
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A code indicating how the accompanying detailed data is
        encoded, and thus how it is to be decoded and displayed."
    ::= { detailedDataFCEntry 3 }
 
dataFC OBJECT-TYPE
    SYNTAX OCTET STRING (SIZE (1..44))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Detailed data encoded as specified by the dataEncodingFC
       object."
    ::= { detailedDataFCEntry 4}
 
------------------------------------------------------------------------
-- productSetIDIndexFC (X'83' Network Alert Common Subfield)
--
-- This subgroup is provided in a trap whenever product  identification
-- data is to be inserted into the text indexed by the failure cause and/or
-- recommended action code points.
------------------------------------------------------------------------
productSetIDIndexFCTable OBJECT-TYPE
    SYNTAX SEQUENCE OF ProductSetIDIndexFCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table a describing how product identification data will be
       inserted into the text indexed by the failure cause or recommended
       action code points."
::= { failure-Causes 4 }
 
productSetIDIndexFCEntry OBJECT-TYPE
    SYNTAX ProductSetIDIndexFCEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "An instance of information required to display product
       identification data.  The index is the instance of the Product Set
       ID Index.  An entry is provided for each instance of the failureCause
       object and/or recommendedActionFC  object containing a codepoint
       whose third character is  'E'.  Entries are provided in the order
       of the occurrance of the code points  requiring them."
::= { productSetIDIndexFCTable 1 }
 
ProductSetIDIndexFCEntry ::= SEQUENCE { productSetIDIndexFC INTEGER }
 
 
productSetIDIndexFC OBJECT-TYPE
    SYNTAX INTEGER {
       displayFirstHW(41),  -- X'29'
       displaySecondHW(42), -- X'2A'
       displayFirstSW(153), -- X'99'
       displaySecondSW(154) -- X'9A'
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "This object provides a code indicating how product
        identification data is to be inserted into the text
        indexed by the failure cause and/or recommended action code
        points.
 
            displayFirstHW  - display machine type or product common name
                              from the first instance of the machineType
                              or hardwareProdCommonName objects.
 
            displaySecondHW - display machine type or product common name
                              from the second instance of the machineType
                              or hardwareProdCommonName objects.
 
            displayFirstSW  - display software product common name
                              from the first entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable.
 
            displaySecondSW - display software product common name
                              from the second entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable."
    ::= { productSetIDIndexFCEntry 1}
 
------------------------------------------------------------------------
-- The detailed-Data-SV group { alert 17 }  (X'98' Alert MS Subvector)
--
-- This group is provided in a trap when there is product-specific
-- detailed data to be reported.
------------------------------------------------------------------------
--
------------------------------------------------------------------------
-- detailedDataDD (X'85' Network Alert Common Subfield)
------------------------------------------------------------------------
detailedDataDDTable OBJECT-TYPE
    SYNTAX SEQUENCE OF DetailedDataDDEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "A table of product-specific detailed data."
::= { detailed-Data-SV 1 }
 
detailedDataDDEntry OBJECT-TYPE
    SYNTAX DetailedDataDDEntry
    ACCESS not-accessible
    STATUS optional
    DESCRIPTION
       "The information required  to display product identification, data
       type, and detailed data.  The index is the instance/number of the
       detailed data."
::= { detailedDataDDTable 1 }
 
DetailedDataDDEntry  ::=
    SEQUENCE  {
       productIDCodeDD  INTEGER,
       dataIDCodeDD     INTEGER,
       dataEncodingDD   INTEGER,
       dataDD           OCTET STRING
}
 
productIDCodeDD OBJECT-TYPE
    SYNTAX INTEGER {
       displayNone(0),      -- X'00'
       displayFirstHW(41),  -- X'29'
       displaySecondHW(42), -- X'2A'
       displayFirstSW(153), -- X'99'
       displaySecondSW(154) -- X'9A'
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A code indicating what product identification, if any is
        to displayed in conjunction with the data-type and data.
 
            displayNone     - Do not display any product identification
                              data in conjunction with the data-type and
                              data.
 
            displayFirstHW  - display machine type or product common name
                              from the first entry of the machineType
                              or hardwareProdCommonName objects in the
                              hwProductInstallSpecificInfoTable.
 
            displaySecondHW - display machine type or product common name
                              from the second entry of the machineType
                              or hardwareProdCommonName objects in the
                              hwProductInstallSpecificInfoTable.
 
            displayFirstSW  - display software product common name
                              from the first entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable.
 
            displaySecondSW - display software product common name
                              from the second entry of the
                              softwareProdCommonName object in the
                              swProductInstallSpecificInfoTable."
    ::= { detailedDataDDEntry 1 }
 
dataIDCodeDD OBJECT-TYPE
    SYNTAX INTEGER (0..65535)
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A Detailed Data Code Point (Data ID code point)
        (described in IBM document GA27-3136) indicating the type of data
        provided.  The English text associated with each code point or
        its national language equivalent is displayed with the
        detailed data."
   ::= { detailedDataDDEntry 2 }
 
dataEncodingDD OBJECT-TYPE
    SYNTAX INTEGER {
        hex(0),    -- (X'00') encoded/displayed as hexadecimal digits
        binary(1), -- (X'01') encoded as an unsigned integer value, the
                   -- decimal equivalent is displayed
        ascii(17)  -- (X'11') data is to be decoded as ASCII characters
    }
    ACCESS read-only
    STATUS optional
    DESCRIPTION
        "A code indicating how the accompanying detailed data is
        encoded, and thus how it is to be decoded and displayed."
    ::= { detailedDataDDEntry 3 }
 
dataDD OBJECT-TYPE
    SYNTAX OCTET STRING (SIZE (1..44))
    ACCESS read-only
    STATUS optional
    DESCRIPTION
       "Detailed data encoded as specified by the dataEncodingUC
       object."
    ::= { detailedDataDDEntry 4}
 
END


------------------------------------------------------------------------------
OUTPUT FROM MCC MIB TRANSLATOR UTILITY
------------------------------------------------------------------------------

Welcome to the DECmcc TCP/IP MIB Translator Utility driver procedure T1.3.0

  11-JAN-1993 17:30:27

This procedure operates in a 2 phased manner --
Phase 1 translates a MIB definition into a management specification.
Phase 2 (as an option) translates the management specification into a
  dictionary loadable file and updates the DECmcc data dictionary.

Phase 1 -- Enter name(s) of file(s) to translate

Phase 1 -- (prune option):
  You have the option to PRUNE the entity model tree created by the
    MIB Translator.
  Pruning will cause child entities without attributes to be discarded.

Phase 1 -- (help generation option):


Issuing following command:
  $ MTU = "$ SYS$SYSTEM:MCC_TCPIP_MTU.EXE"

                                   * * *

(Now processing file # 1 out of a list of 1 file(s) ...)

Beginning Phase 1 for file DISK$DATA:<MCC>IBM-ALERT.MIB;

  11-JAN-1993 17:30:37
Now starting to run the MIB Translator ...
This may take approximately 1-5 minutes.
Issuing following command:
  $ MTU DISK$DATA:<MCC>IBM-ALERT.MIB; -p 
Table hwProductInstallSpecificInfoTable does not have any associated index.
Table swProductInstallSpecificInfoTable does not have any associated index.
Table detailedDataSDTable does not have any associated index.
Table probableCausesTable does not have any associated index.
Table userCausesTable does not have any associated index.
Table recommendedActionsUCTable does not have any associated index.
Table detailedDataUCTable does not have any associated index.
Table productSetIDIndexUCTable does not have any associated index.
Table installCausesTable does not have any associated index.
Table recommendedActionsICTable does not have any associated index.
Table detailedDataICTable does not have any associated index.
Table productSetIDIndexICTable does not have any associated index.
Table failureCausesTable does not have any associated index.
Table recommendedActionsFCTable does not have any associated index.
Table detailedDataFCTable does not have any associated index.
Table productSetIDIndexFCTable does not have any associated index.
Table detailedDataDDTable does not have any associated index.
Max levels = 6
Entity Model tree is being pruned.
The following attributeless entities will be removed:
Child entity alert
Child entity product_Set_ID
Child entity supporting_Data_Correl
Child entity probable_Causes
Child entity user_Causes
Child entity install_Causes
Child entity failure_Causes
Child entity detailed_Data_SV
Child entity ibm3172
Child entity ibm6611
Child entity netView6000
Child entity netView6000SubAgent
MIB translation completed successfully.
  11-JAN-1993 17:30:54

Phase 1 for file DISK$DATA:<MCC>IBM-ALERT.MIB; completed.

Phase 2 for file DISK$DATA:<MCC>IBM-ALERT.MIB; not performed.
(MIB definition translated into management specification but
  management specification not translated into dictionary loadable file and
  DECmcc data dictionary not updated)

                                   * * *

  11-JAN-1993 17:30:54

Normal successful completion.
    
T.RTitleUserPersonal
Name
DateLines
4370.1MOLAR::YAHEY::BOSEMon Jan 11 1993 16:16106
>>Another question is, that many tables have no INDEX, but the MIB translated 
>>without error. Does this mean access into these tables of values is impossible?
>>Will MCC be able to read these tables and display the values? What is exactly
>>the use of the INDEX definition?

	Unfortunately, you will not be able to access those tables which
	do not have the INDEX clause. The INDEX clause tells us what object
	the table is indexed by. This information is crucial to DECmcc so 
	that a corresponding identifier attribute can be created for the
	table entity.

	In V1.3 you will have the option to prune or not to prune. The
	following explains how pruning works :


Extracted from V1.2 CSC training slides. (courtesy Dan Carr).

MTU - Pruning


	- Child Entities without attributes are "pruned" to keep
	  depth of tree to a reasonable level.

	$ mtu mcc_common:CHIPCOM_HUB21_MIBDEF.TXT
	Entity Model tree is being pruned.
	The following attribute-less child entities are being removed.
	Child entity projects
	Child entity online
	Child entity chipStats
	Child entity chipTRnet
	$

	
			 snmp
                          | 
			chipcom
                          |
		       chipmib01
                           |
                 ---------------------
                |          |          |
             chipGen      tty      projects
                                      |
 			           online                       
                                      |
                             -----------------
                            |                 |
                         chipHub           chipStats
                                              |
                                          ----------
                                         |          |
			               chipEnet  chipTRnet
                                                    |
                                              chipTokenRingMapTable

	- Without pruning, accessing attributes under the chipEnet child 
	  entity would be cumbersome ...

	  From FCl

	   MCC> show snmp xyz chipcom chipmib01 tty online chipStats chipEnet...

	  From IMPM

		double click snmp entity
		double click chipcom child entity
		double click chipmib01 child entity
		double click tty child entity
		double click online child entity
		double click chipStats child entity
		double click chipEnet child entity




			 snmp
                          | 
			chipcom
                          |                     Pruned entity model
		       chipmib01
                           |
                 ----------------------------------------------
                |          |          |            |           |
             chipGen      tty      chipHub      chipEnet  chipTokenRingMapTable



	Advantages:

		- Depth of tree is reduced by several levels

		- Entities without attributes are removed

	Disadvantages:

		- Vendors management structure is changed, may be
		  confusing



	NOTE:  First Child under Vendor not pruned.  This enables
               multiple mibs from a single vendor to be loaded.

	

4370.2VCSESU::WADEBill Wade, VAXc Systems &amp; Support EngTue Jan 12 1993 10:3636
    
re .1
   >      
   >      
   > Extracted from V1.2 CSC training slides. (courtesy Dan Carr).
   >      
   > MTU - Pruning
   >      
   >      
   >      
   >      	Advantages:
   >      
   >      		- Depth of tree is reduced by several levels
   >      
   >      		- Entities without attributes are removed
   >      
   >      	Disadvantages:
   >      
   >      		- Vendors management structure is changed, may be
   >      		  confusing
   >      
   >    
			- Augmenting the MIB may not be possible if the
			  augmentation requires the existence of entities 
			  that have been pruned.

                          ie. the GIGAswitch MIB requires the existence of
			  entities within the DEC Vendor MIB.  But some of
			  the non-leaf objects were pruned during the loading
			  of the DEC Vendor MIB making it impossible to load
			  the GIGAswitch MIB.  The only way around this problem
			  was to make one loadable MIB file by appending the 
			  two MIBs.  

	Waiting for the fix in the next FT of 1.3.
        
4370.3MOLAR::YAHEY::BOSETue Jan 12 1993 17:075
	I can reconfirm that this has been fixed and will be available
	in the 1.3 field test update kit. 

	Rahul.