CISCO-ATM-SIG-DIAG-MIB

All MIBs › CISCO-ATM-SIG-DIAG-MIB

Organization: Cisco Systems, Inc.

Last Updated: 1997-07-28

Category: ATM

Description: Monitors ATM signaling diagnostics and call setup failure statistics on Cisco ATM interfaces.

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-ATM-SIG-DIAG-MIB?

CISCO-ATM-SIG-DIAG-MIB is a Cisco module in the ATM networking technology area that facilitates diagnosis of ATM signaling failures, i.e. failed connection setup attempts on ATM interfaces. It exposes configuration objects for defining filter criteria (such as calling/called ATM addresses, service category, and interface) and retains records describing connection setup failures that match those filters. This is squarely a fault/diagnostics MIB used for monitoring the operational health of ATM signaling on a device: it lets an operator track call/connection setup failure rates and causes, which is critical for spotting signaling instability, addressing errors, or interoperability problems between ATM switches. It relies on the standard ATM signaling protocol concepts and likely complements the base ATM-MIB and Cisco's ATM interface MIBs for interface and address representation. It is deployed on Cisco ATM switches and ATM-capable routers used in carrier or enterprise ATM networks where call setup reliability needs active troubleshooting. Engineers can download the CISCO-ATM-SIG-DIAG-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-ATM-SIG-DIAG-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 ATM switches
Cisco routers with ATM interfaces

Monitoring Examples

An operator configures csfFilterTable entries (via csfFilterEntry) specifying criteria like csfFilterCallingParty, csfFilterInInterface/csfFilterOutInterface, and csfFilterServiceCategory to capture failures of interest, then enables collection with csfFilterControl. When a matching setup failure occurs, the record's csfFilterCause reveals the ATM signaling failure reason (e.g. no route, resource unavailable), letting the admin correlate repeated failures on a specific csfFilterInInterface with a downstream provisioning or capacity problem. A rising count of records filtered by csfFilterConnKind or csfFilterConnCastType would indicate a systemic issue with a particular connection type rather than an isolated fault.

What Can Be Monitored

ATM connection setup failure records
signaling failure cause codes
calling/called party ATM addresses
failures by interface
failures by service category
connection kind/cast type filters

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From CISCO-TC

InterfaceIndexOrZero

From PNNI-MIB

PnniNodeId
PnniPortId
ServiceCategory

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
MODULE-IDENTITY
OBJECT-TYPE

From SNMPv2-TC

RowStatus
TEXTUAL-CONVENTION
TimeStamp

How to Use in IPNetwork Monitor

Example using csfFilterNumMatches OID:

Select a Cisco ATM switches/router 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 csfFilterNumMatches 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. It reports a monotonically increasing counter to keep track of the number of call failures that matched this entry for the entire lifetime of this entry. 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 between polls, since a rising count of errors, failures, or discards often points to a real underlying problem. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoAtmSigDiagMIB	1.3.6.1.4.1.9.9.78			The MIB module to facilitate the diagnosis of failures of ATM Signalling requests. Through this MIB, an ATM device retains information for one, or possibly more, connection setup failure records. Each record stores information about those connection setup failures which match a set of selection criteria, such as particular Calling or Called ATM Addresses.
ciscoSigFailMIBObjects	1.3.6.1.4.1.9.9.78.1
csfBaseGroup	1.3.6.1.4.1.9.9.78.1.1
INT csfFilterControl	1.3.6.1.4.1.9.9.78.1.1.1	INTEGER	read-write	This object enables or disables the call failure filtering feature in the ATM device. When this object is modified from 'enable' to 'disable' the records in the csfRecordTable are not removed but filtering is stopped in the device.
csfFilterGroup	1.3.6.1.4.1.9.9.78.1.2
csfFilterTable	1.3.6.1.4.1.9.9.78.1.2.1		not-accessible	The table whose entries describe the filtering criteria for recording failed connection setup requests.
csfFilterEntry	1.3.6.1.4.1.9.9.78.1.2.1.1		not-accessible	Each entry in this table corresponds to a filtering criteria based on which the rejected calls are recorded. This selection criteria is applied against all connection setup failures generated/detected at this ATM device. Only connection setup failures which match against all of the entry's criteria are recorded in the csfRecordTable. A new entry can be created by specifying a csfFilterIndex value that is currently not being used and also using an appropriate value (createAndGo or createAndWait) for the csfFilterRowStatus object. If a particular call failure matches multiple entries in the csfRecordTable then multiple entries will be created in the csfRecordTable for each of the matched entries in the csfFilterTable . An entry in the csfFilterTable could also be created via the command line interface, available on the ATM devices.
I32 csfFilterIndex	1.3.6.1.4.1.9.9.78.1.2.1.1.1	Integer32	not-accessible	An arbitrary integer uniquely identifying a filtering criteria.
INT csfFilterScope	1.3.6.1.4.1.9.9.78.1.2.1.1.2	INTEGER	read-create	This object restricts the scope of the filter to calls which where rejected either within the system in which the filtering is in progress or to calls which were rejected on external ATM devices but transited through the device in which filtering is in progress.
OCT csfFilterConnKind	1.3.6.1.4.1.9.9.78.1.2.1.1.3	OCTET STRING	read-create	This object enables the user to track failures of soft permanent virtual channel connections, soft permanent virtual path connections, switched virtual channel connections, and/or switched virtual path connections.
OCT csfFilterConnCastType	1.3.6.1.4.1.9.9.78.1.2.1.1.4	OCTET STRING	read-create	This object restricts the scope of the filter based on the type of topology of connections (point-to-point or point-to-multipoint).
OCT csfFilterServiceCategory	1.3.6.1.4.1.9.9.78.1.2.1.1.5	OCTET STRING	read-create	This object restricts the scope of the filter to calls belonging to service categories represented by this object.
NUM csfFilterInInterface	1.3.6.1.4.1.9.9.78.1.2.1.1.6	InterfaceIndexOrZero	read-create	This object restricts the scope of the filter to calls which entered the ATM device through the port represented by this object It has the value 0, or the ifIndex value of an ATM Interface. The value zero indicates that the scope of the filter is not restricted by the incoming port.
NUM csfFilterOutInterface	1.3.6.1.4.1.9.9.78.1.2.1.1.7	InterfaceIndexOrZero	read-create	This object restricts the scope of the filter to calls which exited the ATM device through the port represented by this object It has the value 0, or the ifIndex value of an ATM Interface. The value zero indicates that the scope of the filter is not restricted by the outgoing port. To track calls failed locally in the ATM device in which the call failure tracking is in progress ,the csfFilterScope object should be used , in which case the value of this object need not be changed from its default value.
I32 csfFilterCause	1.3.6.1.4.1.9.9.78.1.2.1.1.8	Integer32	read-create	This object restricts the scope of the filter to calls which were cleared with the cause code represented by this object. The values are the same as the clear code values mentioned in the ATM forum UNI specifications.The value zero indicates that the scope of the filter is not restricted by the cause code value.
ATM csfFilterCallingParty	1.3.6.1.4.1.9.9.78.1.2.1.1.9	AtmAddr	read-create	The combination of this object and the corresponding instance of csfFilterCallingPartyMask is one selection criteria for this record. To match this selection criteria, a failed connection setup must have a Calling Party Address which has the same length as, and is equal in value to csfFilterCallingParty for all bits that are 1 in the value of csfFilterCallingPartyMask. When the default value for the object is retained then the rejected call will match this filtering criteria for any calling address in the rejected call.
OCT csfFilterCallingPartyMask	1.3.6.1.4.1.9.9.78.1.2.1.1.10	OCTET STRING	read-create	The combination of this object and the corresponding instance of csfFilterCallingParty is one selection criteria for this record. To match this selection criteria, a failed connection setup must have a Calling Party Address which equals the value of csfFilterCallingParty for all bit positions identified by the value of csfFilterCallingPartyMask. If the mask value is shorter than the length of csfFilterCallingParty, then it is extended with zero bits to be the required length. If the default value for this object is retained then the rejected call will match this filtering criterion if and only if the calling address in the call matches the csfFilterCallingParty for this entry.
ATM csfFilterCalledParty	1.3.6.1.4.1.9.9.78.1.2.1.1.11	AtmAddr	read-create	The combination of this object and the corresponding instance of csfFilterCalledPartyMask is one selection criteria for this record. To match this selection criteria, a failed connection setup must have a called party address which has the same length as, and is equal in value to csfFilterCalledParty for all bits that are 1 in the value of csfFilterCalledPartyMask. When the default value for the object is retained then the rejected call will match this filtering criteria for any called address in the call.
OCT csfFilterCalledPartyMask	1.3.6.1.4.1.9.9.78.1.2.1.1.12	OCTET STRING	read-create	The combination of this object and the corresponding instance of csfFilterCalledParty is one selection criteria for this record. To match this selection criteria, a failed connection setup must have a Calling Party Address which equals the value of csfFilterCalledParty for all bit positions identified by the value of csfFilterCalledPartyMask. If the mask value is shorter than the length of csfFilterCalledParty, then it is extended with zero bits to be the required length. If the default value for this object is retained then the rejected call will match this filtering criterion if and only if the calling address in the call matches the csfFilterCallingParty for this entry.
I32 csfFilterMaxRecords	1.3.6.1.4.1.9.9.78.1.2.1.1.13	Integer32	read-create	The maximum number of entries that are desired in the csfRecordTable on behalf of this entry. The agent will not create more than this number of entries in the table,but may choose to create fewer entries in the csfRecordTable for any reason including the lack of resources. The agent will however dedicate resources for a minimum number of entries in the csfRecordTable ,to take care of temporary memory allocation failures in the system. In case of memory allocation failures the agent will utilize these dedicated resources for the creation of the new entries. If memory resource failures continue and the dedicated resources are exhausted then the records in the csfRecordTable are pruned such that the oldest entries are removed to make way for the new entries. A value '-1' will indicate no upper limit for the number of records stored. The manager can set this object to -1 if overwriting of records is not desired. The new value for this object will take effect immediately. If this object is set to a value less than the number of entries thats currently present in the csfRecordTable corresponding to this entry, then the oldest entries in the csfRecordTable will be deleted so that their number equals the new value of this object. If the value of this object is changed from -1 to any other positive value then the entries will be pruned such that only the first n records collected for this entry are retained in the csfRecordTable, n being the new value of this object.
I32 csfFilterAgeTimeout	1.3.6.1.4.1.9.9.78.1.2.1.1.14	Integer32	read-create	The number of seconds left for this entry to age out. On expiry of this timer filtering is disabled for this entry. The display records in the csfRecordTable corresponding to this entry are retained. When the timer expires the object will have a value zero. The management station can restart filtering for this entry by setting this object to a positive value. When the object is set to zero, filtering is stopped for this entry. When the management station modifies this object , the currently running timer,if any, is aborted and a timer is started with the new value of this object. The value '-1' will indicate an infinite timeout value.
INT csfFilterPurge	1.3.6.1.4.1.9.9.78.1.2.1.1.15	INTEGER	read-create	The object provides a facility for the user to purge the records in the csfRecordTable corresponding to this entry. When the value is set to 'purge', the records in the csfRecordTable corresponding to this entry are purged. When the value is set to 'noop' no operation is performed. When read, the value 'noop' is returned.
C32 csfFilterNumMatchesEx	1.3.6.1.4.1.9.9.78.1.2.1.1.16	Counter32	read-only	A monotonically increasing counter to keep track of the number of call failures that matched this entry for the entire lifetime of this entry.
ROW csfFilterRowStatus	1.3.6.1.4.1.9.9.78.1.2.1.1.17	RowStatus	read-create	Indicates the status of this row. Used according to the row installation and removal conventions. This object can be used to temporarily inactivate an entry in the table. When this object is set to a value 'notInService' filtering is stopped for the corresponding row. Any records that have been stored in the csfRecordTable corresponding to this entry will not be released. Any writeable objects in the row can be modified when the row is active. All values will take effect immediately.
csfRecordGroup	1.3.6.1.4.1.9.9.78.1.3
csfRecordTable	1.3.6.1.4.1.9.9.78.1.3.1		not-accessible	The table in which the failures of ATM Signalling connection setup requests are recorded.
csfRecordEntry	1.3.6.1.4.1.9.9.78.1.3.1.1		not-accessible	An entry representing one connection setup request failure record. The csfRecordFilterIndex represents the index into the csfFilterTable whose entry is the filtering criteria applied against all connection setup failures generated/detected at this ATM device. Only connection setup failures which match against all of the filtering entry's criteria are recorded in the table. There could be multiple entries for each filtering criteria. The csfFilterMaxRecords indicates the number of records to be stored for the corresponding csfFilterTable entry.
I32 csfRecordIndex	1.3.6.1.4.1.9.9.78.1.3.1.1.1	Integer32	not-accessible	An arbitrary integer used to distinguish between multiple records for the same filtering criteria.
INT csfRecordScope	1.3.6.1.4.1.9.9.78.1.3.1.1.2	INTEGER	read-only	This object indicates the location of the call failure.
INT csfRecordConnKind	1.3.6.1.4.1.9.9.78.1.3.1.1.3	INTEGER	read-only	This object represents the use of call control of the rejected connection.
INT csfRecordConnCastType	1.3.6.1.4.1.9.9.78.1.3.1.1.4	INTEGER	read-only	This object represents the type of topology of the rejected call (point-to-point or point-to-multipoint).
INT csfRecordConnIndicator	1.3.6.1.4.1.9.9.78.1.3.1.1.5	INTEGER	read-only	Indicates whether this record was created due to an add party failure or a setup failure.
SER csfRecordServiceCategory	1.3.6.1.4.1.9.9.78.1.3.1.1.6	ServiceCategory	read-only	This object represents the service category used by the call.
I32 csfRecordInInterface	1.3.6.1.4.1.9.9.78.1.3.1.1.7	Integer32	read-only	The IfIndex of the incoming port on which this call was received by the ATM device.
NUM csfRecordOutInterface	1.3.6.1.4.1.9.9.78.1.3.1.1.8	InterfaceIndexOrZero	read-only	The IfIndex of the outgoing port ,if available, through which this call was routed to the network. The distinguished value zero indicates that the call was rejected before any outgoing interface was chosen.
I32 csfRecordCause	1.3.6.1.4.1.9.9.78.1.3.1.1.9	Integer32	read-only	This object identifies the reason for the call failure. When a PNNI Crankback information element is included in the call clearing message, this object contains the crankback cause. In all other cases, the values are the same as the cause code values defined for the Cause information element.
OCT csfRecordDiags	1.3.6.1.4.1.9.9.78.1.3.1.1.10	OCTET STRING	read-only	This object contains the contents of the diagnostics fields from the Cause information element. When the value of csfRecordCause is 49,'Quality of Service unavailable', the diagnostics are taken from the PNNI Crankback information element instead of the cause information element.
ATM csfRecordCallingParty	1.3.6.1.4.1.9.9.78.1.3.1.1.11	AtmAddr	read-only	Indicates the ATM adddress of the calling party in the rejected call.
ATM csfRecordCallingPartySubAddress	1.3.6.1.4.1.9.9.78.1.3.1.1.12	AtmAddr	read-only	Indicates the ATM sub-adddress of the calling party in the rejected call. The presence of a sub address is not mandatory. If the calling sub-addresses is not present in the call then this object will have a null value.
ATM csfRecordCalledParty	1.3.6.1.4.1.9.9.78.1.3.1.1.13	AtmAddr	read-only	Indicates the ATM address of the called party in the rejected call.
ATM csfRecordCalledPartySubAddress	1.3.6.1.4.1.9.9.78.1.3.1.1.14	AtmAddr	read-only	Indicates the ATM sub-adddress of the called party in the rejected call. The presence of a sub address is not mandatory. If the called sub-address is not present in the call then this object will have a null value.
INT csfRecordCrankBackTransitType	1.3.6.1.4.1.9.9.78.1.3.1.1.15	INTEGER	read-only	This object identifies the type of blockage in case of a blocked call. This object has a value 'noCrankBack' if the call was cleared without a crankback information element.
PNN csfRecordCrankBackNodeId	1.3.6.1.4.1.9.9.78.1.3.1.1.16	PnniNodeId	read-only	This object depends on the csfRecordCrankBackTransitType object. When that object value is 'blockedNode', csfRecordCrankBackNodeId indicates the node ID of the blocked node. When the csfRecordCrankBackTransitType object value is 'blockedLink', this object indicates the node ID of the logical node preceding the link at which the call/connection was blocked. When the csfRecordCrankBackTransitType object value is 'blockedIncomingPort' or 'noCrankBack', this object is set to null.
PNN csfRecordCrankBackPortId	1.3.6.1.4.1.9.9.78.1.3.1.1.17	PnniPortId	read-only	When the csfRecordCrankBackTransitType object value is 'blockedLink', this object identifies a logical port of the blocked link's preceeding node identifier. The distinguished value zero indicates that no port is specified. For all values of csfRecordCrankBackTransitType other than 'blockedLink', this object is set to zero.
PNN csfRecordCrankBackSucceedingNodeId	1.3.6.1.4.1.9.9.78.1.3.1.1.18	PnniNodeId	read-only	This object depends on the csfRecordCrankBackTransitType object. If the csfRecordCrankBackNodeId object value is 'blockedLink' then the value of this object will identify the logical node succeeding a link at which the call/connection was blocked. This object does not have a meaning if the call is cleared without a crankback information element and thus set to null.
TIM csfRecordTimeStamp	1.3.6.1.4.1.9.9.78.1.3.1.1.19	TimeStamp	read-only	The time at which this record entry was created.
csfDtlTable	1.3.6.1.4.1.9.9.78.1.3.2		not-accessible	The table in which the Designated Transit List (DTL)stacks (i.e., source routes) of failed calls are recorded. Each DTL identifies a source route through a single peer group. DTL's are represented as a series of logical Node IDs and logical Port IDs.
csfDtlEntry	1.3.6.1.4.1.9.9.78.1.3.2.1		not-accessible	A segment of the DTL stack. The complete DTL stack is formed by traversing the rows of the table for which the csfFilterIndex and csfRecordIndex are the same. Level transitions are indicated using the csfDtlLinkType. Since the entries in the table are linked to the entries of the csfFilterTable ,the entries are added and removed from the table as and when the corresponding entries in the csfFilterTable are added and removed.
I32 csfDtlEntryIndex	1.3.6.1.4.1.9.9.78.1.3.2.1.1	Integer32	not-accessible	The index in the current DTL stack of this entry. This index represents the the order of this entry in the DTL stack.
PNN csfDtlNodeId	1.3.6.1.4.1.9.9.78.1.3.2.1.2	PnniNodeId	read-only	Each entry in the DTL table corresponds to a node/port tuple based on which a source route through the peer group is built. This object represents the node id in the tuple
PNN csfDtlPortId	1.3.6.1.4.1.9.9.78.1.3.2.1.3	PnniPortId	read-only	Each entry in the DTL table corresponds to a node/port tuple based on which a source route through the peer group is built. This object represents the port id in the tuple
INT csfDtlLinkType	1.3.6.1.4.1.9.9.78.1.3.2.1.4	INTEGER	read-only	The type of link out from the node identified by csfDtlNodeId. This is well defined even if the specific port is not specified. A value 'horizontal' indicates a normal link within the containing peer group. A value 'uplink' indicates a link going up a level. A value 'last' indicates that this is the last entry in the DTL stack. 'invalid' indicates an invalid link.
ciscoSigFailMIBConformance	1.3.6.1.4.1.9.9.78.3
ciscoSigFailMIBCompliances	1.3.6.1.4.1.9.9.78.3.1
ciscoSigFailMIBCompliance	1.3.6.1.4.1.9.9.78.3.1.1			The compliance statement for entities which implement the Cisco ATM Signalling Diagnostic MIB
ciscoSigFailMIBGroups	1.3.6.1.4.1.9.9.78.3.2
ciscoSigFailGeneralGroup	1.3.6.1.4.1.9.9.78.3.2.1			A collection of objects which help in diagnosing ATM signalling failures.
ciscoSigFailMIBGroup	1.3.6.1.4.1.9.9.78.3.2.2			A collection of objects which help in diagnosing ATM signalling failures.

RFC description

Diagnoses ATM signaling failures by recording connection setup errors matching specific selection criteria.

Start monitoring Cisco ATM switches/routers 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-ATM-SIG-DIAG-MIB