CISCO-CIPCSNA-MIB

This is the Management Information Base (MIB) 
        module for objects used to manage the cisco Systems 
        Network Architecture (SNA) support on Cisco Mainframe
        Channel Connection (CMCC) cards, also called the 
        CIP-SNA feature.
        
        ---------------------------------------------------
        | Acronym Definitions:                            |
        | CMCC      =  Cisco Mainframe Channel Connection |
        | CIP      =   Channel Interface Processor        |
        | CTA      =   Channel Transport Architecture     |
        | SNA      =   Systems Network Architecture       |
        | CIP-SNA  =   CNA  =  CSNA  =  SNA Support on    |
        |                               a CMCC card       |
        ---------------------------------------------------
        
        
        This mib consists of the following tables:
        1) CSNA Administration 
        2) CSNA Operational
        3) CSNA Statistics
        4) Max Sessions Administration
        5) Max Sessions Operational
        8) LLC2/CSNA Connection mapping
        
        The following is a set of IBM channel terminology:
        1) The Channel Subsystem is the way a host performs
        I/O.
        2) A Channel Path is the path to the Channel Control
        Unit.  In the Cisco CMCC environment, this is the 
        path of the channel to the physical router, itself.  
        This path is needed because the physical channel may 
        be directed (switched) through a device called 
        an ESCON director.  The path defined from the 
        host to the Control Unit can be different than 
        the path from the Control Unit to the host.  
        For an in-depth definition of how this number 
        is derived, see the cipCardCsnaAdminPath object.
        3) A Sub-Channel and Device are exactly the same
        thing.  The term Sub-Channel was introduced
        for ESCON (IBM's serial fiber optic) channel
        interface.  Previously the term Device was used,
        and it mapped directly to hardware (in most
        situations) via a Parallel Channel Adapter
        (PCA). Another name for PCA is Bus & Tag.  In
        the Cisco CMCC environment, the Sub-Channel is
        controlled by the Channel Systems Network
        Architecture (CSNA) feature. For an
        in-depth definition of how this number is
        derived, see the cipCardCsnaAdminDevice object.
        NOTE:  The terminology of Sub-Channel and
        Sub-Channel Index are two completely different
        entities!  See below for Sub-Channel Index.
        4) An I/O Device is the entity that is addressed by
        the combination of Sub-Channel and Device.  This
        directly maps to the cipCardCsnaAdminTable.
        NOTE:  The Channel Systems Network Architecture 
        (CSNA) feature may have multiple  
        sub-channels/devices defined for its control.
        Also NOTE:  That we have defined an object with
        the name cipCardSubChannelIndex and this object
        is the two hex octet Channel Path values concatenated
        with the second hex (the first octet is not used)
        octet Device value and then converted to an
        INTEGER (Unsigned).
        The exact description is taken from the
        CISCO-CHANNEL-MIB
        cipCardSubChannelIndex     OBJECT-TYPE
            SYNTAX      INTEGER
            MAX-ACCESS  read-only
            STATUS      current
            DESCRIPTION
             This indicates which subchannel is being referenced
              for a particular daughter board on a CMCC card.
              This value is constructed as follows:
                path * 256 + device
              Path and device are the values in
              CipCardClawConfigTable.
            ::= { cipCardSubChannelEntry 1 }
        In this mib, the last two lines change to
         Path and device are the values in the
          cipCardCsnaAdminTable.
        5) XCA Major Nodes.  The XCA major node binds the
        Channel Path (from the hosts perspective)/Sub-
        Channel number (i.e. I/O Device), to a CIP internal
        LAN Adapter of a specific type with a unique SAP
        Number.  That same I/O Device can also be
        bound to the same LAN Adapter of the same
        type with a different SAP, and/or the same I/O
        Device can be bound to any other Adapter and
        any unique SAP on that Adapter.  The binding
        allows the I/O Device to talk to the Adapter.
        The SAP allows multiple connections to the
        same Adapter.
        
        The following is an example of the hardware with
        the above names showing there locations.
        
              |----- Channel Path ------|
                Eg. 150F and 190A       =================
        ==========                         | Router A with |
        | HOST 1 |---     ============     | Control Unit  |
        ==========   |__15| ESCON    |_____| & Virtual     |
                   ____| Director |     | I/O Devices   |
        ==========   |  19============     | via the CSNA  |
        | HOST 2 |---                 -----| feature.      |
        ==========                    |    =================
                                   |
                Eg. 0100,          |
        ==========  Direct Connection |
        | HOST 3 |---------------------
        ==========
        
        
        The following example configuration of a router that
        shows the entities managed by the CIPCSNA MIB.
        
        ------------     ------------
        | HOST 1   |     | HOST 3   |
        | & HOST 2 |     |          |
        ------------     ------------
            ||               ||     Router A
        -----------------------------------------
        | ------------------------------------- |
        | | -----------       ---------       | |
        | | | ESCON 0 |       | PCA 1 |       | |
        | | -----------       ---------       | |
        | |                                   | |
        | | ----------------------            | |
        | | | CSNA Feature       |            | |
        | | | Control Unit F & A |            | |
        | | |   for ESCON 0      |            | |
        | | ----------------------            | |
        | |                                   | |
        | |     CMCC CARD 6                   | |
        | ------------------------------------- |
        |                                       |
        -----------------------------------------
        
        The first table is the Cisco Mainframe Channel Connection
        (CMCC) Channel Systems Network Architecture support (CSNA) 
        Administration table.  Each entry created in this table 
        will create an I/O Device that can be attached to the 
        host (via a host VTAM XCA Major Node command).
        The indices of the table are:
        * The CMCC Card Slot Index
        * The Daughter Board Index
        * The Sub-Channel Index
        NOTE:  In the above discussion, this value is defined
             to be a combination of the Channel Path and
             Device (really the address of an I/O Device).
        The fields included in this table represent:
        * Channel Path
        * Device
        NOTE:  The two fields above are the same values as
             the above Sub-Channel Index.
        * The configured maximum block delay time
        * The configured suggested block delay length
        * The configured maximum block length
        NOTE:  The channel uses data blocks that accumulate
             data before it sends it to the host.
        * The row control variable
        In the example above, three entries would be
        defined.
        The first entry would be:
        - CMCC Card Slot 0
        - CMCC Daughter Board 0
        - Sub-Channel Index of 0x150F00 or 1380096
        - Channel Path of 0x150F or 5391
        - Device of 00
        - rest can be defaulted
        The second entry would be:
        - CMCC Card Slot 0
        - CMCC Daughter Board 0
        - Sub-Channel Index of 0x190A00 or 1640960
        - Channel Path of 0x190A or 6410
        - Device of 00
        - rest can be defaulted
        The third entry would be:
        - CMCC Card Slot 0
        - CMCC Daughter Board 1
        - Sub-Channel Index of 0x010000 or 65536
        - Channel Path of 0x0100 or 256
        - Device of 00
        - rest can be defaulted
        
        The next table is an augmented table to the first table.
        It keeps the operational status of the first table.
        The indices are the same as the first table.
        The fields included in this table represent:
        * The current operational state of a this table entry
        * The current operational maximum block delay time
        * The current operational suggested block delay length
        * The current operational maximum block length
        In the example above, three entries would be
        defined.
        The first entry would be:
        - CMCCC Card Slot 0
        - CMCC Daughter Board 0
        - Sub-Channel Index of 0x150F00 or 1380096
        - rest will be determined by the agent
        The second entry would be:
        - CMCC Card Slot 0
        - CIP Daughter Board 0
        - Sub-Channel Index of 0x190A00 or 1640960
        - rest will be determined by the agent
        The second entry would be:
        - CMCC Card Slot 0
        - CMCC Daughter Board 1
        - Sub-Channel Index of 0x010000 or 65536
        - rest will be determined by the agent
        
        The next table is an augmented table to the first table.
        It keeps the statistics for the Channel Systems Network
        Architecture (CSNA) counters.
        The indices are the same as the first table.
        The fields included in this table represent:
        * Blocks transmitted
        * Blocks received
        * Bytes transmitted
        * Bytes received
        * Blocks transmitted by maximum block delay time
        * Blocks transmitted by the suggested block delay length
        * Blocks transmitted by maximum block length
        In the example above, three entries would be
        defined.
        The first entry would be:
        - CMCC Card Slot 0
        - CMCC Daughter Board 0
        - Sub-Channel Index of 0x150F00 or 1380096
        - rest will be determined by the agent
        The second entry would be:
        - CMCC Card Slot 0
        - CMCC Daughter Board 0
        - Sub-Channel Index of 0x190A00 or 1640960
        - rest will be determined by the agent
        The second entry would be:
        - CMCC Card Slot 0
        - CMCC Daughter Board 1
        - Sub-Channel Index of 0x010000 or 65536
        - rest will be determined by the agent
        
        The next table is maximum sessions Admin table.
        The one entry in this table defines the configured
        maximum sessions supported on the whole CMCC card.
        The one index is:
        * The ifIndex addresses the virtual CMCC interface
        The one field in this table represents:
        * The maximum sessions for this card
        In the example above, the one entry would be defined.
        - ifIndex is created by the agent
        - the maximum sessions would be within the
        range
        
        The next table is the operational maximum sessions table.
        This table is an augmented table to the maximum sessions
        Admin table.  The entries in this table display the 
        current maximum sessions supported on the whole CMCC card. 
        The indices are the same as the maximum sessions Admin
        table.
        The one field in this table represents:
        * The current operational maximum sessions for
        this card
        In the example above, the one entry would be defined.
        - ifIndex is created by the agent
        - the maximum sessions would be within the
        range
        
        The next table is the statistical maximum sessions table.
        This table is an augmented table to the maximum sessions
        Admin table.  The entries in this table displays the 
        current high water maximum sessions supported on the 
        whole CMCC card and the number of allocation errors that 
        have occurred when attempting to increase the number of 
        sessions. The indices are the same as the maximum sessions
        Admin table.
        The one field in this table represents:
        * The current operational maximum sessions for
        this card
        In the example above, the one entry would be defined.
        - ifIndex is created by the agent
        - the highest maximum sessions that has occurred since
        the last re-boot.
        - the number of allocation errors when extending the
        number of sessions.
        
        The last table is the SNA Connection table.  Each entry
        in this table represents a connection from an I/O Device
        (Channel Path/Device) address to a CMCC internal LAN Adapter
        for a single SAP address. Multiple entries in this table
        can represent the same LAN Adapter with the use
        of a different SAP.  The entries in this table are
        created when VTAM on a host creates an XCA Major
        Node definition.  That definition will tell the router
        what I/O Device address are to be bound to which
        CMCC internal LAN Adapter (of a type) and which SAP will be
        used to carry traffic.
        The indices of the table are:
        * The ifIndex that addresses the virtual
        CMCC interface
        * The virtual interface identifying a unique
        CMCC internal MAC Adapter. This definition used is defined
        in the CISCO-SNA-LLC-MIB as llcPortVirtualIndex.
        * The SAP used by this connection.
        NOTE:  The SAP definition used is defined in
              the CISCO-SNA-LLC-MIB.
        The fields included in this table represent:
        * The number of currently active sessions 
        over this connection
        * The slot of the CMCC card.
        * The port on the CMCC card that the Path/Device
        (subchannel is configured.
        * The Channel Path used by this connection
        * The Device used by this connection
        In the example above, the number entries would
        depend upon the VTAM configuration.
        Each entry would be:
        - ifIndex is created by the agent
        - one of the LAN identifiers from one of the entries
        in the CMCC internal LAN table. 
        - one of the adapter identifiers from one the
        entries in the CMCC internal LAN Adapter table.
        - the SAP provided by the XCA Major Node command
        - the number of currently active sessions
        - the slot of the CMCC card.
        - the port on the CMCC card.
        - the Channel Path from one entry in the first table
        - the Device from same entry as the Channel Path
        in the first table

Imported Objects

cipCardEntryIndex, cipCardDtrBrdIndex, cipCardSubChannelIndexCISCO-CHANNEL-MIB
ciscoMgmtCISCO-SMI
llcPortVirtualIndex, llcSapNumberCISCO-SNA-LLC-MIB
ifIndexRFC1213-MIB
MODULE-COMPLIANCE, OBJECT-GROUPSNMPv2-CONF
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Counter32, Counter64, Integer32, Gauge32SNMPv2-SMI
RowStatus, TEXTUAL-CONVENTIONSNMPv2-TC
ciscoCipCsnaMIB .1.3.6.1.4.1.9.9.33
cipCsnaObjects .1.3.6.1.4.1.9.9.33.1
cipCsnaChannel .1.3.6.1.4.1.9.9.33.1.1
cipCardCsnaAdminTable .1.3.6.1.4.1.9.9.33.1.1.1
cipCardCsnaAdminEntry .1.3.6.1.4.1.9.9.33.1.1.1.1
cipCardCsnaAdminPath .1.3.6.1.4.1.9.9.33.1.1.1.1.1
cipCardCsnaAdminDevice .1.3.6.1.4.1.9.9.33.1.1.1.1.2
cipCardCsnaAdminBlockDelayTime .1.3.6.1.4.1.9.9.33.1.1.1.1.3
cipCardCsnaAdminBlockDelayLength .1.3.6.1.4.1.9.9.33.1.1.1.1.4
cipCardCsnaAdminMaxBlockLength .1.3.6.1.4.1.9.9.33.1.1.1.1.5
cipCardCsnaAdminRowStatus .1.3.6.1.4.1.9.9.33.1.1.1.1.6
cipCardCsnaOperTable .1.3.6.1.4.1.9.9.33.1.1.2
cipCardCsnaOperEntry .1.3.6.1.4.1.9.9.33.1.1.2.1
cipCardCsnaOperState .1.3.6.1.4.1.9.9.33.1.1.2.1.1
cipCardCsnaOperSlowDownState .1.3.6.1.4.1.9.9.33.1.1.2.1.2
cipCardCsnaOperBlockDelayTime .1.3.6.1.4.1.9.9.33.1.1.2.1.3
cipCardCsnaOperBlockDelayLength .1.3.6.1.4.1.9.9.33.1.1.2.1.4
cipCardCsnaOperMaxBlockLength .1.3.6.1.4.1.9.9.33.1.1.2.1.5
cipCardCsnaStatsTable .1.3.6.1.4.1.9.9.33.1.1.3
cipCardCsnaStatsEntry .1.3.6.1.4.1.9.9.33.1.1.3.1
cipCardCsnaStatsBlocksTxd .1.3.6.1.4.1.9.9.33.1.1.3.1.1
cipCardCsnaStatsBlocksTxByBlockDelayLength .1.3.6.1.4.1.9.9.33.1.1.3.1.10
cipCardCsnaStatsBytesTxByBlockDelayLength .1.3.6.1.4.1.9.9.33.1.1.3.1.11
cipCardCsnaStatsHCBytesTxByBlockDelayLength .1.3.6.1.4.1.9.9.33.1.1.3.1.12
cipCardCsnaStatsBlocksTxByMaxBlockLength .1.3.6.1.4.1.9.9.33.1.1.3.1.13
cipCardCsnaStatsBytesTxByMaxBlockLength .1.3.6.1.4.1.9.9.33.1.1.3.1.14
cipCardCsnaStatsHCBytesTxByMaxBlockLength .1.3.6.1.4.1.9.9.33.1.1.3.1.15
cipCardCsnaStatsSlowDownsReceived .1.3.6.1.4.1.9.9.33.1.1.3.1.16
cipCardCsnaStatsSlowDownsSent .1.3.6.1.4.1.9.9.33.1.1.3.1.17
cipCardCsnaStatsBlocksRxd .1.3.6.1.4.1.9.9.33.1.1.3.1.2
cipCardCsnaStatsBytesTxd .1.3.6.1.4.1.9.9.33.1.1.3.1.3
cipCardCsnaStatsHCBytesTxd .1.3.6.1.4.1.9.9.33.1.1.3.1.4
cipCardCsnaStatsBytesRxd .1.3.6.1.4.1.9.9.33.1.1.3.1.5
cipCardCsnaStatsHCBytesRxd .1.3.6.1.4.1.9.9.33.1.1.3.1.6
cipCardCsnaStatsBlocksTxByBlockDelayTime .1.3.6.1.4.1.9.9.33.1.1.3.1.7
cipCardCsnaStatsBytesTxByBlockDelayTime .1.3.6.1.4.1.9.9.33.1.1.3.1.8
cipCardCsnaStatsHCBytesTxByBlockDelayTime .1.3.6.1.4.1.9.9.33.1.1.3.1.9
cipSession .1.3.6.1.4.1.9.9.33.1.2
cipCardSessionsAdminTable .1.3.6.1.4.1.9.9.33.1.2.1
cipCardSessionsAdminEntry .1.3.6.1.4.1.9.9.33.1.2.1.1
cipCardAdminMaxLlc2Sessions .1.3.6.1.4.1.9.9.33.1.2.1.1.1
cipCardSessionsOperTable .1.3.6.1.4.1.9.9.33.1.2.2
cipCardSessionsOperEntry .1.3.6.1.4.1.9.9.33.1.2.2.1
cipCardOperMaxLlc2Sessions .1.3.6.1.4.1.9.9.33.1.2.2.1.1
cipCardSessionsStatsTable .1.3.6.1.4.1.9.9.33.1.2.3
cipCardSessionsStatsEntry .1.3.6.1.4.1.9.9.33.1.2.3.1
cipCardStatsHiWaterLlc2Sessions .1.3.6.1.4.1.9.9.33.1.2.3.1.1
cipCardStatsLlc2SessionAllocationErrs .1.3.6.1.4.1.9.9.33.1.2.3.1.2
cipCsnaConnection .1.3.6.1.4.1.9.9.33.1.3
cipCardCsnaConnTable .1.3.6.1.4.1.9.9.33.1.3.1
cipCardCsnaConnEntry .1.3.6.1.4.1.9.9.33.1.3.1.1
cipCardCsnaConnActiveSessions .1.3.6.1.4.1.9.9.33.1.3.1.1.1
cipCardCsnaSlot .1.3.6.1.4.1.9.9.33.1.3.1.1.2
cipCardCsnaPort .1.3.6.1.4.1.9.9.33.1.3.1.1.3
cipCardCsnaConnPath .1.3.6.1.4.1.9.9.33.1.3.1.1.4
cipCardCsnaConnDevice .1.3.6.1.4.1.9.9.33.1.3.1.1.5
cipCsnaNotificationPrefix .1.3.6.1.4.1.9.9.33.2
cipCsnaNotifications .1.3.6.1.4.1.9.9.33.2.0
cipCsnaOpenDuplicateSapFailure .1.3.6.1.4.1.9.9.33.2.0.1
cipCsnaLlc2ConnectionLimitExceeded .1.3.6.1.4.1.9.9.33.2.0.2
ciscoCipCsnaMibConformance .1.3.6.1.4.1.9.9.33.3
ciscoCipCsnaMibCompliances .1.3.6.1.4.1.9.9.33.3.1
ciscoCipCsnaMibGroups .1.3.6.1.4.1.9.9.33.3.2