CISCO-BSTUN-MIB

All MIBs › CISCO-BSTUN-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2003-02-10

Category: Cisco Devices, SNA and Legacy Protocols, Telephony and VoIP

Description: Manages BSTUN (Block Serial Tunneling) for encapsulating SNA BSC traffic over IP on Cisco routers.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CISCO-BSTUN-MIB?

CISCO-BSTUN-MIB is a Cisco vendor-specific MIB for managing Block Serial Tunneling (BSTUN), a feature that encapsulates legacy SNA BSC (Binary Synchronous Communications) serial traffic over an IP network between Cisco routers. It organizes management into global BSTUN parameters, BSTUN groups, BSTUN ports, and BSTUN routes, exposing configuration such as peer IP address, listener SAP, keepalive interval/limit, protocol type, and local-ack behavior. Its monitoring value is both configuration and fault-oriented: group-level counters for unroutable-transmit and unroutable-receive traffic reveal packets that could not be forwarded due to routing or configuration problems, functioning as a software-level health indicator for the tunneling service. It depends on Cisco's general networking/interface MIB conventions for identifying the underlying serial ports and IP transport, and is scoped entirely within Cisco's private enterprise tree. It is deployed on Cisco routers bridging legacy SNA/BSC serial equipment (such as older mainframe or terminal controllers) across a modern IP WAN.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-BSTUN-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cisco routers used for legacy SNA/BSC serial tunneling over IP

Monitoring Examples

An operator would poll bstunGroupTable/bstunGroupEntry, indexed by bstunGroupIndex, checking bstunGroupUnroutableTransmit and bstunGroupUnroutableReceive counters for unexpected growth, which would indicate BSTUN traffic that cannot reach its peer due to a misconfigured bstunIPAddr or a down IP path. Cross-referencing bstunPeerKeepaliveInterval and bstunPeerKeepaliveLimit against bstunLocalAck settings on the bstunPortTable would help confirm whether a serial-tunnel peer relationship is timing out due to keepalive failures rather than a routing issue, a task that typically begins with a CISCO-BSTUN-MIB download so the relevant objects can be loaded into a MIB browser.

What Can Be Monitored

BSTUN group configuration (protocol type, local ack)
peer keepalive interval/limit
unroutable transmit/receive packet counts
BSTUN port and route configuration

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From IF-MIB

InterfaceIndex
ifIndex	OBJECT-TYPE

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
IpAddress
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE

From SNMPv2-TC

TruthValue

How to Use in IPNetwork Monitor

Example using bstunGroupUnroutableTransmit OID:

Select a Cisco router (legacy SNA/BSC serial tunneling over IP) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type bstunGroupUnroutableTransmit into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. The number of unroutable frames received by this group from the remote partner. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoBstunMIB	1.3.6.1.4.1.9.9.35			The MIB module for Block Serial Tunneling. Overview of BSTUN MIB MIB description The BSTUN MIB provides the configuration and operational information on Cisco's blocked serial tunnelling implementation. The following entities are managed: 1) Global BSTUN information 2) BSTUN groups 3) BSTUN ports 4) BSTUN routes The following example configuration shows how the BSTUN MIB returns BSTUN information, from either CISCO A or CISCO B. HOST == BSC == Cisco A == IP Network == Cisco B == BSC == BSC line line device 1) The BSTUN global entry identifies the IP address by which the router is known to other BSTUN peers, a configurable SAP value on which to listen to LLC2 peers, and keepalive values to maintain a session between TCP/IP peers. 2) The BSTUN group table identifies the BSTUN group number and protocol type that Cisco A and Cisco B use to route BSC traffic over the IP network. The table contains an entry for each BSTUN group defined on the router. (The group number must be the same in Cisco A and Cisco B, for traffic to flow from one router to the other.) 3) The BSTUN port table identifies the serial interface to the BSC line for which the router is doing serial tunnelling. The MIB also identifies the BSTUN group this interface is defined for, and identifies the default routing for unrecognized BSC addresses. There is a port entry for each BSTUN-enabled interface on the router. 4) The BSTUN route table has an entry for each address defined for routing within the BSTUN group, and an entry for the default routing if the 'bstun route all' command is configured. The route entry includes identification of the BSTUN peer, priority, state, and packet and byte counters.
bstunObjects	1.3.6.1.4.1.9.9.35.1
bstunGlobal	1.3.6.1.4.1.9.9.35.1.1
IP bstunIPAddr	1.3.6.1.4.1.9.9.35.1.1.1	IpAddress	read-only	The configured IP address used by the BSTUN component in this router.
I32 bstunLisnSap	1.3.6.1.4.1.9.9.35.1.1.2	Integer32	read-only	The configured Listening SAP address used by the BSTUN component when routed via frame-relay local-ack in this router.
I32 bstunPeerKeepaliveInterval	1.3.6.1.4.1.9.9.35.1.1.3	Integer32	read-only	The time interval between keepalives in this router.
I32 bstunPeerKeepaliveLimit	1.3.6.1.4.1.9.9.35.1.1.4	Integer32	read-only	The number of keepalives which can be missed in a continuous interval before session declared down in this router.
bstunGroups	1.3.6.1.4.1.9.9.35.1.2
bstunGroupTable	1.3.6.1.4.1.9.9.35.1.2.1		not-accessible	A table of entries representing BSTUN groups configured on the router. Each BSTUN-enabled interface is assigned to a BSTUN group, and packets can only travel between BSTUN-enabled interfaces in the same group.
bstunGroupEntry	1.3.6.1.4.1.9.9.35.1.2.1.1		not-accessible	Status and parameter values for a group.
INT bstunGroupIndex	1.3.6.1.4.1.9.9.35.1.2.1.1.1	INTEGER	not-accessible	The configured BSTUN group number. The significance of this number is that it must match the BSTUN group number configured in the router at the other end of the BSTUN tunnel.
INT bstunProtocolType	1.3.6.1.4.1.9.9.35.1.2.1.1.2	INTEGER	read-only	The protocol type for this BSTUN group.
T/F bstunLocalAck	1.3.6.1.4.1.9.9.35.1.2.1.1.3	TruthValue	read-only	Indicates if the BSTUN connection is locally acknowledged. TRUE-> BSTUN connection is locally acknowledged FALSE-> BSTUN connection is not locally acknowledged
C32 bstunGroupUnroutableTransmitEx	1.3.6.1.4.1.9.9.35.1.2.1.1.4	Counter32	read-only	The number of unroutable frames received by this group from the remote partner. They were unroutable because the address was not recognized; that is there is no bstun route command configured for this address. This indicates that the configuration in this router is incompatible with the peer router.
C32 bstunGroupUnroutableReceive	1.3.6.1.4.1.9.9.35.1.2.1.1.5	Counter32	read-only	Count of frames received from a serial interface with an unsupported poll address. Note that there may be several ports configured within this bstun group; a non-zero value in this field indicates that a least one of these ports is receiving frames for which there are no bstun route commands configured. This indicates that the configuration in this router is incompatible with the configuration in at least one of the attached devices.
bstunPorts	1.3.6.1.4.1.9.9.35.1.3
bstunPortTable	1.3.6.1.4.1.9.9.35.1.3.1		not-accessible	A list of BSTUN-enabled interfaces (ports).
bstunPortEntry	1.3.6.1.4.1.9.9.35.1.3.1.1		not-accessible	Status and parameter values for a BSTUN port.
INT bstunPortGroupNumber	1.3.6.1.4.1.9.9.35.1.3.1.1.1	INTEGER	read-only	The group number to which the bstun port belongs. Frames will only be routed to other ports (on this or another router) in the same bstun group. This group should match a bstunGroupIndex in the bstunGroupTable.
INT bstunPortDefaultPeerType	1.3.6.1.4.1.9.9.35.1.3.1.1.2	INTEGER	read-only	The type of identification of the remote default partner. (This is as configured with the 'route all' command.) If ip then the value is in bstunPortDefaultPeerIP; if serial or serialDirect then the value is in bstunPortDefaultPeerSerial.
IP bstunPortDefaultPeerIP	1.3.6.1.4.1.9.9.35.1.3.1.1.3	IpAddress	read-only	The ip address of the remote default BSTUN partner, for unrecognized addresses. 0.0.0.0 if partner address type is not ip.
NUM bstunPortDefaultPeerSerial	1.3.6.1.4.1.9.9.35.1.3.1.1.4	InterfaceIndex	read-only	If bstunRouteType is serial then this is the serial interface index of the point-to-point link to the remote partner; if bstunRouteType is serialDirect then the partner is in the local BSTUN. if bstunRouteType is ip then this field is 0.
bstunRoutes	1.3.6.1.4.1.9.9.35.1.4
bstunRouteTable	1.3.6.1.4.1.9.9.35.1.4.1		not-accessible	A table containing information about specific poll addresses. There is one table entry for each address configured by the BSTUN ROUTE command.
bstunRouteEntry	1.3.6.1.4.1.9.9.35.1.4.1.1		not-accessible	The information regarding a single poll address.
INT bstunRouteGroupIndex	1.3.6.1.4.1.9.9.35.1.4.1.1.1	INTEGER	not-accessible	The index of the BSTUN Group owning this station.
INT bstunRouteStationAddress	1.3.6.1.4.1.9.9.35.1.4.1.1.2	INTEGER	not-accessible	The poll address of the station. 256 indicates the ALL parameter on the STUN ROUTE command, which is the route for all unrecognized addresses.
INT bstunRouteType	1.3.6.1.4.1.9.9.35.1.4.1.1.3	INTEGER	read-only	The type of identification of the remote partner. If ip then the value is in bstunRouteIP; if serial or serialDirect then the value is in bstunRouteSerial; if bip or apip then the value is in bstunRouteIP, bstunRouteBIPLocalPort and bstunRouteBIPForeignPort.
IP bstunRouteIP	1.3.6.1.4.1.9.9.35.1.4.1.1.4	IpAddress	read-only	The ip address of the remote BSTUN partner. 0.0.0.0 if partner address type is not ip.
NUM bstunRouteSerial	1.3.6.1.4.1.9.9.35.1.4.1.1.5	InterfaceIndex	read-only	If bstunRouteType is serial then this is the serial interface index of the point-to-point link to the remote partner; if bstunRouteType is serialDirect then the partner is in the local BSTUN. if bstunRouteType is ip then this field is 0.
INT bstunRoutePriority	1.3.6.1.4.1.9.9.35.1.4.1.1.6	INTEGER	read-only	The priority with which this station's traffic will be routed across the network.
INT bstunRoutePeerState	1.3.6.1.4.1.9.9.35.1.4.1.1.7	INTEGER	read-only	The state of the peer connection through the BSTUN tunnel.
C32 bstunRouteRxPackets	1.3.6.1.4.1.9.9.35.1.4.1.1.8	Counter32	read-only	Count of frames received from the serial interface with this station's address.
C32 bstunRouteTxPackets	1.3.6.1.4.1.9.9.35.1.4.1.1.9	Counter32	read-only	Count of frames transmitted at the serial interface with this station's address.
C32 bstunRouteRxBytes	1.3.6.1.4.1.9.9.35.1.4.1.1.10	Counter32	read-only	Count of bytes received from the serial interface with this station's address.
C32 bstunRouteTxBytes	1.3.6.1.4.1.9.9.35.1.4.1.1.11	Counter32	read-only	Count of bytes transmitted at the serial interface with this station's address.
I32 bstunRouteDLCI	1.3.6.1.4.1.9.9.35.1.4.1.1.12	Integer32	read-only	If bstunRouteType is serialFrameRelay or serialLLC2 then this is the frame relay dlci circuit used for the point-to-point link to the remote partner; if bstunRouteType is ip or serial then this field is 0.
I32 bstunRouteRSAP	1.3.6.1.4.1.9.9.35.1.4.1.1.13	Integer32	read-only	If bstunRouteType is serialLLC2 then this is the llc2 sap value used for the point-to-point link to the remote partner; if bstunRouteType is ip or serial or serialFrameRelay then this field is 0.
I32 bstunLLC2Priority	1.3.6.1.4.1.9.9.35.1.4.1.1.14	Integer32	read-only	If bstunRouteType is serialLLC2 then this is the llc2 priority used for the point-to-point link to the remote partner; if bstunRouteType is ip or serial or serialFrameRelay then this field is 0.
T/F bstunRouteBIPPassive	1.3.6.1.4.1.9.9.35.1.4.1.1.15	TruthValue	read-only	Specifies whether the bip peer will wait for an inbound connection or actively connect to the remote peer.
I32 bstunRouteBIPLocalPort	1.3.6.1.4.1.9.9.35.1.4.1.1.16	Integer32	read-only	If bstunRouteType is bip then this is the local port used when connecting to the remote peer.
I32 bstunRouteBIPForeignPort	1.3.6.1.4.1.9.9.35.1.4.1.1.17	Integer32	read-only	If bstunRouteType is bip then this is the for port used to connect to the remote peer.
BIT bstunRouteBIPDeviceStatus	1.3.6.1.4.1.9.9.35.1.4.1.1.18	Bits	read-only	If bstunRouteType is bip then this indicates the OR bit mask status of the mapped bisync device: if no bits are set, indicates that the bisync device is up and operational. Bit 0, if set, indicates that the bisync device is reporting an operation check error. Bit 2, if set, indicates that the bisync device is reporting a data check error. Bit 3, if set, indicates that the bisync device is reporting an equipment check error. Bit 4, if set, indicates that the bisync device is reporting that intervention is required. Bit 5, if set, indicates that the bisync device is reporting that a command has been rejected. Bit 6, if set, indicates that the bisync device is not responding to polls. Bit 7, if set, indicates that the bisync device is now responding to polls and is operational. Bit 9, if set, indicates that the bisync device is reporting that is no longer busy. Bit 10, if set, indicates that the bisync device is reporting a device unit specify. Bit 11, if set, indicates that the bisync device is reporting a busy condition.
INT bstunRouteAPIPHeaderVersion	1.3.6.1.4.1.9.9.35.1.4.1.1.19	INTEGER	read-only	Specifies the tunneling header format to use for APIP: v0, if set, indicates a 2 byte encapsulation header. The length of the header is included in the size of the sent packet. v1, if set, indicates a 2 byte encapsulation header. The length of the header is excluded from the size of the sent packet. v2, if set, indicates a 4 byte encapsulation header. The length of the header is excluded from the size of the sent packet.
bstunNotificationPrefix	1.3.6.1.4.1.9.9.35.2
bstunNotifications	1.3.6.1.4.1.9.9.35.2.0
NTF bstunPeerStateChangeNotification	1.3.6.1.4.1.9.9.35.2.0.1			This notification indicates that the state of a BSTUN route has transitioned to active (connected) or inactive (dead or closed).
NTF bstunPeerStateChangeNotification2	1.3.6.1.4.1.9.9.35.2.0.2			This notification indicates that the state of a BSTUN route has transitioned to active (connected) or inactive (dead or closed).
NTF bstunCUStatusChangeNotification	1.3.6.1.4.1.9.9.35.2.0.3			This notification is generated when a mapped BIP bisync device state has changed.
bstunMibConformance	1.3.6.1.4.1.9.9.35.3
bstunMibCompliances	1.3.6.1.4.1.9.9.35.3.1
bstunMibCompliance	1.3.6.1.4.1.9.9.35.3.1.1			The compliance statement for BSTUN.
bstunMibComplianceRev1	1.3.6.1.4.1.9.9.35.3.1.2			The compliance statement for all Cisco systems that implement BSTUN functions.
bstunMibComplianceRev2	1.3.6.1.4.1.9.9.35.3.1.3			The compliance statement for all Cisco systems that implement BSTUN functions.
bstunMibComplianceRev3	1.3.6.1.4.1.9.9.35.3.1.4			The compliance statement for all Cisco systems that implement BSTUN functions.
bstunMibGroups	1.3.6.1.4.1.9.9.35.3.2
bstunGlobalGroup	1.3.6.1.4.1.9.9.35.3.2.1			A collection of objects providing global BSTUN information.
bstunGroupGroup	1.3.6.1.4.1.9.9.35.3.2.2			A collection of objects providing information about BSTUN groups .
bstunPortGroup	1.3.6.1.4.1.9.9.35.3.2.3			A collection of objects providing information about BSTUN enabled interfaces.
bstunRouteGroup	1.3.6.1.4.1.9.9.35.3.2.4			A collection of objects providing information about BSTUN defined routes.
bstunGlobalGroupRev1	1.3.6.1.4.1.9.9.35.3.2.5			A collection of objects providing global BSTUN information.
bstunRouteGroupRev1	1.3.6.1.4.1.9.9.35.3.2.6			A collection of objects providing information about BSTUN defined routes.
bstunRouteGroupRev2	1.3.6.1.4.1.9.9.35.3.2.7			A collection of objects providing information about BSTUN defined routes.
bstunNotificationGroup	1.3.6.1.4.1.9.9.35.3.2.8			A collection of notifications.
bstunNotificationGroupRev1	1.3.6.1.4.1.9.9.35.3.2.9			A collection of notifications.
bstunRouteBipGroup	1.3.6.1.4.1.9.9.35.3.2.10			A objects providing information about BSTUN defined routes for BIP protocol.
bstunRoutePortsGroup	1.3.6.1.4.1.9.9.35.3.2.11			A objects providing port number informaton information about BSTUN defined routes for BIP and APIP protocols.
bstunRouteApipGroup	1.3.6.1.4.1.9.9.35.3.2.12			A objects providing information about BSTUN defined routes for APIP protocol.

RFC description

Manages Blocked Serial Tunneling (BSTUN) configuration for tunneling BSC protocol over IP networks.

Start monitoring Cisco routers (legacy SNA/BSC serial tunneling over IP) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-BSTUN-MIB