ATM Switch Router Command Reference, 12.0(10)W5(18) - D Commands [Cisco Lightstream ATM Switches]

D Commands
debug atm accounting
debug atm conn
debug atm oam-all
debug atm oam-pkt
debug atm pnni
debug atm rm
debug atm sig
debug ncdp
debug sgcp errors
debug sgcp events
debug sgcp packets
debug sscop
debug tag-switching
disable

D Commands

The commands shown in this chapter apply to the Catalyst 8540 MSR, Catalyst 8510 MSR, and LightStream 1010 ATM switch routers. Where an entire command or certain attributes of a command have values specific to a particular switch or switch router, an exception is indicated by the following callouts:

Catalyst 8540 MSR
Catalyst 8510 MSR and LightStream 1010

Note Commands that are identical to those documented in the Cisco IOS software documentation have been removed from this chapter.

Note Commands that no longer function as expected in ATM environments have also been removed from this chapter.

Refer to Appendix D of this command reference for a detailed list of commands that have been removed, changed or replaced.

debug atm accounting

To enable debugging for ATM accounting, use the debug atm accounting EXEC command. To disable debugging, use the no form of this command.

debug atm accounting errors | events

no debug atm accounting errors | events

Syntax Description

errors	Logs significant errors to the console.
events	Logs significant events to the console.

Defaults

Disabled

Command Modes

EXEC

Note Not all of the debug commands are included in this publication. For a complete guide to the debug commands, refer to the Debug Command Reference publication.

Command History

Release	Modification
11.1(4)	New command

debug atm conn

To enable debugging for ATM connection management, use the debug atm conn privileged EXEC command. To disable debugging, use the no form of this command.

debug atm conn {bitmap {errors | events} | errors | events | mib}

no debug atm conn {bitmap {errors | events} | errors | events | mib}

Syntax Description

bitmap	Enables ATM connection bitmap management debugging.
errors	Enables ATM connection management errors debugging.
events	Enables ATM connection management events debugging.
mib	Enables ATM connection management MIB debugging.

Defaults

Disabled

Command Modes

Privileged EXEC

Note Not all of the debug commands are included in this publication. For a complete guide to the debug commands, refer to the Debug Command Reference publication.

Command History

Release	Modification
11.2(8.0.1)	New command

debug atm oam-all

To enable all the debug flags for the OAM, use the debug atm oam-all privileged EXEC command.
To disable the debug flags, use the no form of the command.

debug atm oam-all

no debug atm oam-all

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Privileged EXEC

Caution This command can generate a significant amount of output when it is implemented.

Note Not all of the debug commands are included in this publication. For a complete guide to the debug commands, refer to the Debug Command Reference publication.

Command History

Release	Modification
11.1(4)	New command

debug atm oam-pkt

To display the transmit and receive OAM traffic, use the debug atm oam-pkt privileged EXEC command. This command also decodes individual OAM cells. To disable OAM traffic debugging, use the no form of the command.

debug atm oam-pkt

no debug atm oam-pkt

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Privileged EXEC

Note Not all of the debug commands are included in this publication. For a complete guide to the debug commands, refer to the Debug Command Reference publication.

Command History

Release	Modification
11.1(4)	New command

debug atm pnni

To enable PNNI debugging output, use the following debug atm pnni privileged EXEC commands.
To disable PNNI debugging output, use the no form of these commands.

debug atm pnni adj-events
debug atm pnni adj-packet
debug atm pnni aggregation
debug atm pnni all
debug atm pnni api
debug atm pnni election
debug atm pnni flood-packet
debug atm pnni hello-packet
debug atm pnni rm [local-node node-index]
debug atm pnni route-all
debug atm pnni route-errors
debug atm pnni snmp
debug atm pnni svcc-rcc
debug atm pnni topology

no debug atm pnni adj-events
no debug atm pnni adj-packet
no debug atm pnni aggregation
no debug atm pnni all
no debug atm pnni api
no debug atm pnni election
no debug atm pnni flood-packet
no debug atm pnni hello-packet
no debug atm pnni rm [local-node node-index]
no debug atm pnni route-all
no debug atm pnni route-errors
no debug atm pnni snmp
no debug atm pnni svcc-rcc
no debug atm pnni topology

Syntax Description

adj-events	Turns on adjacency-related event debugging. The feature can be turned on for a specific PNNI interface.
adj-packet	Turns on database summary and request packet debugging. The feature can be turned on for a specific PNNI interface.
aggregation	Turns on link aggregation debugging.
all	Turns on all PNNI debugging. The feature can be turned on for a specific PNNI interface.
api	Turns on application interface debugging.
election	Turns on PGL PNNI election debugging.
flood-packet	Turns on PTSP and ACK packet debugging.
hello-packet	Turns on Hello packet debugging. The feature can be turned on for a specific PNNI interface.
rm	Turns on resource management debugging. Debugging output can be limited to a single node using the local-node node-index option.
route-all	Turns on all route debugging.
route-errors	Turns on PNNI route errors debugging.
snmp	Turns on debugging of SNMP events (get and set) related to the PNNI MIBs.
svcc-rcc	Turns on debugging for SVCC RCC setup, SVCC Hello processing, and horizontal link extension processing.
topology	Turns on internal topology maintenance debugging.

Defaults

Disabled

Command Modes

Privileged EXEC

Note Not all of the debug commands are included in this publication. For a complete guide to the debug commands, refer to the Debug Command Reference publication.

Command History

Release	Modification
11.1(4)	New command

debug atm rm

To enable the debug printout messages for ATM resource manager, use the debug atm rm privileged EXEC command. To disable the printout message, use the no form of this command.

debug atm rm errors
debug atm rm events
debug atm rm pnni-api

no debug atm rm errors
no debug atm rm events
no debug atm rm pnni-api

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Privileged EXEC

Caution This command can generate a significant amount of output and can interfere with other activity on the switch when it is implemented.

Note Not all of the debug commands are included in this publication. For a complete guide to the debug commands, refer to the Debug Command Reference publication.

Command History

Release	Modification
11.1(4)	New command

debug atm sig

To debug the ATM signalling module, use the debug atm sig privileged EXEC commands.
To disable the debugging, use the no form of these commands.

debug atm sig-all
debug atm sig-error [atm card/subcard/port]
debug atm sig-events [atm card/subcard/port]
debug atm sig-ie [atm card/subcard/port]
debug atm sig-nni [atm card/subcard/port]
debug atm sig-packets [atm card/subcard/port]

no debug atm sig-all
no debug atm sig-error [atm card/subcard/port]
no debug atm sig-events [atm card/subcard/port]
no debug atm sig-ie [atm card/subcard/port]
no debug atm sig-nni [atm card/subcard/port]
no debug atm sig-packets [atm card/subcard/port]

Syntax Description

sig-all	Turns on the debug output for all of the above conditions.
sig-error	Turns on the debug output for the ATM signalling error conditions.
sig-events	Turns on the debug output for the ATM signalling state machine events.
sig-ie	Turns on the debug output for the ATM signalling messages information element encoding.
sig-nni	Turns on the debug output for the ATM signalling NNI state machine events.
sig-packets	Turns on the debug output for the ATM signalling packets.
card/subcard/ port	Specifies the card, subcard, and port number for the ATM interface.

Defaults

Disabled

Command Modes

Privileged EXEC

Note Not all of the debug commands are included in this publication. For a complete guide to the debug commands, refer to the Debug Command Reference publication.

Command History

Release	Modification
11.1(4)	New command

debug ncdp

To display NCDP errors, events, and packet information, use the debug ncdp command. To disable ncdp debugging, use the no form of this command.

debug ncdp {errors | events | packets}

no debug ncdp {errors | events | packets}

Syntax Description

errors	Displays NCDP errors, such as "extract-clock failed."
events	Displays NCDP events, such as a "switch vector update."
packets	Displays NCDP messages. This option generates significant output.

Defaults

Disabled

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(3c)W5(9)	New command

debug sgcp errors

To enable the production of debug information on exceptional conditions encountered in the use of SGCP to control the interconnection of CES circuits, use the debug sgcp errors privileged EXEC command. To disable debugging, use the no form of this command.

debug sgcp errors

no debug sgcp errors

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(3c)W5(9)	New command

Usage Guidelines

The debug output consists of exceptional events, which should not occur during normal operations. However, these exceptions are not indicative of a software failure.

Examples

The following example enables the debugging of SGCP error events.

 Switch# debug sgcp errors

Simple Gateway Control Protocol errors debugging is on

Related Commands

Command	Description
debug sgcp events	Enables the production of debug information on significant events encountered in the use of SGCP to control the interconnection of CES circuits.
debug sgcp packets	Enables the production of SGCP packets received to control the interconnection of CES circuits.

debug sgcp events

To enable the production of debug information on significant events encountered in the use of SGCP to control the interconnection of CES circuits, use the debug sgcp events privileged EXEC command. To disable debugging, use the no form of this command.

debug sgcp events

no debug sgcp events

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(3c)W5(9)	New command

Usage Guidelines

The principle debug output includes circuit state changes that occur because of SGCP packet and CES circuit events.

Examples

The following example enables the debugging of SGCP events.

 Switch# debug sgcp events

Simple Gateway Control Protocol events debugging is on

Related Commands

Command	Description
debug ncdp	Displays NCDP errors and/or events.
debug sgcp packets	Enables the production of SGCP packets received to control the interconnection of CES circuits.

debug sgcp packets

To enable the production of SGCP packets received to control the interconnection of CES circuits, use the debug sgcp packets privileged EXEC command. To disable debugging, use the no form of
this command.

debug sgcp packets

no debug sgcp packets

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(3c)W5(9)	New command

Usage Guidelines

This command produces the most verbose output of the SGCP debug commands.

Examples

The following example enables the debugging of SGCP packets.

 Switch# debug sgcp packets

Simple Gateway Control Protocol packets debugging is on

Related Commands

Command	Description
debug ncdp	Displays NCDP errors and/or events.
debug sgcp events	Enables the production of SGCP packets received to control the interconnection of CES circuits.

debug sscop

To debug the ATM signalling SSCOP, use the following debug sscop privileged EXEC commands.
To return the debug SSCOP to the default, use the no form of this command.

debug sscop errors [atm card/subcard/port]
debug sscop events [atm card/subcard/port]
debug sscop packets [atm card/subcard/port]

no debug sscop errors [atm card/subcard/port]
no debug sscop events [atm card/subcard/port]
no debug sscop packets [atm card/subcard/port]

Syntax Description

errors	Turns on the debug output for the SSCOP error conditions.
events	Turns on the debug output for the SSCOP state machine events.
packets	Turns on the debug output for the SSCOP packets.
atm card/subcard/port	Specifies the card, subcard, and port number of the ATM interface.

Defaults

Disabled

Command Modes

Global configuration

Interface configuration when atm card/subcard/port is specified.

Note Not all of the debug commands are included in this publication. For a complete guide to the debug commands, refer to the Debug Command Reference publication.

Command History

Release	Modification
11.1(4)	New command

debug tag-switching

To debug the tag-switching configuration, use the debug tag-switching privileged EXEC commands. To disable tag-switching debugging, use the no form of these commands.

debug tag-switching adjacency
debug tag-switching atm-tdp api
debug tag-switching atm-tdp routes
debug tag-switching atm-tdp states
debug tag-switching packets [if-type] [card/subcard/port]
debug tag-switching tdp advertisements
debug tag-switching tdp bindings
debug tag-switching tdp directed-neighbors
debug tag-switching tdp peer state-machine
debug tag-switching tdp pies {received [all] | sent [all]}
debug tag-switching tdp session {io [all] | state-machine}
debug tag-switching tdp transport {connections | events | timers}
debug tag-switching tsp-tunnels events
debug tag-switching tsp-tunnels signalling
debug tag-switching tsp-tunnels tagging

no debug tag-switching adjacency
no debug tag-switching atm-tdp api
no debug tag-switching atm-tdp routes
no debug tag-switching atm-tdp states
no debug tag-switching packets [if-type] [card/subcard/port]
no debug tag-switching tdp advertisements
no debug tag-switching tdp bindings
no debug tag-switching tdp directed-neighbors
no debug tag-switching tdp peer state-machine
no debug tag-switching tdp pies {received [all] | sent [all]}
no debug tag-switching tdp session {io [all] | state-machine}
no debug tag-switching tdp transport {connections | events | timers}
no debug tag-switching tsp-tunnels events
no debug tag-switching tsp-tunnels signalling
no debug tag-switching tsp-tunnels tagging

Syntax Description

adjacency	Displays changes to tag switching entries in the adjacency database. Use this option to monitor instances when entries are updated or added to the adjacency database.
atm-tdp api	Displays information about the VCI allocation of TVCs, free, and cross-connect requests. Use the debug tag-switching atm-tdp api command with the debug tag-switching atm-tdp states command to display more complete information about a TVC.
atm-tdp routes	Displays information about the state of the routes for which VCI requests are being made. See also "Usage Guidelines."
atm-tdp states	Displays information about TVC state transitions as they occur. See also "Usage Guidelines."
packets	Displays tagged packets switched by this system. The optional if-type (atm, atm-p, cbr, ethernet, or null) and card/subcard/port arguments restrict the display to those packets received or transmitted on the specified interface type or number. This command should be used with care because it generates output for every packet processed. Furthermore, enabling this command causes fast and distributed tag switching to be disabled for the selected interfaces. Use this command only when traffic on the network is low, so other activity on the system is not adversely affected.
tdp advertisements	Displays information about the advertisement of tags and interface addresses to TDP peers.
tdp bindings	Displays information about changes to the TIB used to keep track of tag bindings learned from TDP peers through TDP downstream tag distribution.
tdp directed-neighbors	Displays information about TDP directed-neighbor events.
tdp peer	Displays information about state transitions at the tag distribution level. See also "Usage Guidelines."
tdp pies	Displays information about TDP PIEs received from (received) or sent to (sent) TDP peers. TDP requires periodic transmission of keepalive PIEs. If you do not specify the all option, periodic keepalive PIEs are not displayed.
tdp session	Displays TDP session information. See also "Usage Guidelines."
tdp transport	Used with the connections keyword, this command displays information about the TCP connections used to support TDP sessions. Used with the events keyword, this command displays information about the events related to the TDP peer discovery mechanism, which is used to determine the devices with which to establish TDP sessions. Used with the timers keyword, this command displays TDP discovery and transport timer activity. See also "Usage Guidelines."
tsp-tunnels events	Displays TSP tunnels events.
tsp-tunnels signalling	Displays TSP tunnels signalling.
tsp-tunnels tagging	Displays TSP tunnels tagging.

Defaults

Disabled

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3(3a)	New command

Usage Guidelines

When there are a large number of routes and a number of system activities (shutting down interfaces, learning new routes, and so on), the debug tag-switching atm-tdp routes and debug tag-switching atm-tdp states commands display a lot of information that might interfere with system timing. Most commonly, this affects the normal operation of TDP. You should increase the holdtime value of the TDP by using the tag-switching tdp holdtime command.

TDP sessions are supported by data structures and state machines at three levels:

Transport—TCP connections used to support TDP sessions are established and maintained at the transport level.
Protocol—The protocol level implements the TDP session setup protocol, and deals with constructing and parsing TDP PDUs and PIEs.
Tag distribution—The tag distribution level uses TDP sessions to exchange tags with TDP peers.

The debug tag-switching tdp transport commands provide visible activity at the transport level, the debug tag-switching tdp session commands at the protocol level, and the debug tag-switching tdp peer state-machine command at the tag distribution level.

disable

To return to the EXEC mode by exiting the privileged EXEC mode, use the disable EXEC command.

disable [level]

Syntax Description

level

You can specify up to 16 privilege levels, using numbers 0 through 15. Level 1 is normal EXEC-mode user privileges. If this argument is not specified, the privilege level defaults to level 15 (traditional enable privileges).

Defaults

Command Modes

EXEC

Command History

Release	Modification
11.1(4)	New command

Examples

In the following example, the user is logging out from privilege level 5.

 Switch# disable 5

Related Commands

Command	Description
enable (EXEC)	Cisco IOS command removed from this manual.

Table of Contents

D Commands

debug atm accounting

debug atm conn

debug atm oam-all

debug atm oam-pkt

debug atm pnni

debug atm rm

debug atm sig

debug ncdp

debug sgcp errors

debug sgcp events

debug sgcp packets

debug sscop

debug tag-switching

disable