ATM OAM Ping

Table Of Contents

ATM OAM Ping

Contents

Prerequisites for ATM OAM Ping

Restrictions for ATM OAM Ping

Information About ATM OAM Ping

Uses for ATM OAM Ping Command

How to Use ATM OAM Ping

Testing Network Connectivity Using ATM Interface Ping (Normal Mode)

Testing Network Connectivity Using ATM Interface Ping (Interactive Mode)

Aborting a Ping Session

Configuration Examples for ATM OAM Ping

Verifying the Connectivity of a Specific PVC: Example

Normal Mode ping atm interface atm Command: Example

Interactive ping Command: Example

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

ping atm interface atm

ATM OAM Ping

---

The ATM OAM Ping feature sends an ATM Operation, Administration, and Maintenance (OAM) packet to confirm the connectivity of a specific permanent virtual circuit (PVC). The status of the PVC is displayed when a response to the OAM packet is received. The ATM OAM Ping feature allows the network administrator to verify PVC integrity and facilitates ATM network troubleshooting.

Feature History for the ATM OAM Ping Feature

Release	Modification
12.0(21)S	This feature was introduced.
12.2(13)T	This feature was integrated into Cisco IOS Release 12.2(13)T.
12.2(25)S	This feature was integrated into Cisco IOS Release 12.2(25)S.
12.2(18)SXE	This feature was integrated into Cisco IOS Release 12.2(18)SXE.
12.2(27)SBA	This feature was integrated into Cisco IOS Release 12.2(27)SBA.

Finding Support Information for Platforms and Cisco IOS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.

Contents

•Prerequisites for ATM OAM Ping

•Restrictions for ATM OAM Ping

•Information About ATM OAM Ping

•How to Use ATM OAM Ping

•Configuration Examples for ATM OAM Ping

•Additional References

•Command Reference

Prerequisites for ATM OAM Ping

A PVC corresponding to the virtual path identifier (VPI) and virtual channel identifier (VCI) values entered with the ping command should already exist. (For Cisco 827 series routers, the virtual circuit need not exist.)

For information about how to configure ATM PVCs, see the section "Configuring PVCs" in the chapter "Configuring ATM" in the Cisco IOS Wide-Area Networking Configuration Guide, Release 12.3.

Restrictions for ATM OAM Ping

The ATM OAM Ping feature does not support pings based on the following:

•Network service access point (NSAP) addresses

•Multiple-hop loopbacks

•Loopback location identification

Information About ATM OAM Ping

To use the ATM OAM Ping, you must understand the following concept:

•Uses for ATM OAM Ping Command

Uses for ATM OAM Ping Command

The ATM OAM Ping feature modifies the ping command, which can be used to send an OAM packet to verify the PVC connectivity. The status of the PVC is displayed when a response to the OAM packet is received. This is a common method for testing the accessibility of the devices.

The ping atm interface atm command provides two ATM OAM ping options:

•End loopback—Verifies end-to-end PVC integrity.

•Segment loopback—Verifies PVC integrity to the immediate neighboring ATM device.

The ping atm interface atm command is used to determine the following:

•Whether a remote host is active or inactive.

•The round-trip delay in communicating with the host.

•Packet loss.

The simpler ping command provides an interactive mode for testing ATM network connectivity. The ping command first sends an OAM command loopback cell to the destination and then waits for an OAM response loopback cell. The ping is successful only when the following criteria are met:

•The OAM command loopback cell reaches the destination.

•The destination is able to send an OAM loopback response cell back to the source within a predetermined time called a timeout. The default value of the timeout is 2 seconds on Cisco routers.

How to Use ATM OAM Ping

See the following sections for tasks that use ping commands to test network connectivity in an ATM network. The tasks in this list are optional.

•Testing Network Connectivity Using ATM Interface Ping (Normal Mode)

•Testing Network Connectivity Using ATM Interface Ping (Interactive Mode)

•Aborting a Ping Session

Testing Network Connectivity Using ATM Interface Ping (Normal Mode)

The task in this section tests network connectivity using the ping atm interface atm command in normal mode; that is, by entering all values for the ping test on the command line.

SUMMARY STEPS

1. enable

2. ping atm interface atm interface-number vpi-value vci-value [end-loopback [repeat [timeout]] | seg-loopback [repeat [timeout]]]

DETAILED STEPS

	Command or Action	Purpose
Step 1	enable Example: Router> enable	Enables privileged EXEC mode. •Enter your password if prompted.
Step 2	ping atm interface atm interface-number vpi-value vci-value [end-loopback [repeat [timeout]] | seg-loopback [repeat [timeout]]] Example: Router# ping atm interface atm1/1.1 0 500 end-loopback 1 2	Displays a response to confirm the connectivity of a specific PVC. •atm interface-number—ATM interface name. •vpi-value—Virtual path identifier. Range: 0 to 255. •vci-value—Virtual channel identifier. Range: 0 to 65535. •end-loopback—Sends ATM end loopback cells. This is the default. •seg-loopback—Sends ATM segment loopback cells. •repeat—Number of ping packets that are sent to the destination. Range: 1 to 1000. Default: 5. •timeout—Timeout interval, in seconds. Range: 1 to 30. Default: 2.

Testing Network Connectivity Using ATM Interface Ping (Interactive Mode)

The task in this section tests network connectivity using the ping command by providing inputs in the interactive mode; that is, by providing values for the ping test by typing the value after the prompts displayed and pressing the Enter key. Press the Enter key without supplying a value to use the default.

SUMMARY STEPS

1. enable

2. ping

DETAILED STEPS

	Command or Action	Purpose
Step 1	enable Example: Router> enable	Enables privileged EXEC mode. •Enter your password if prompted.
Step 2	ping Example: Router# ping	Displays a response to confirm the connectivity of a specific PVC.

Aborting a Ping Session

To terminate a ping session, type the escape sequence—by default, Ctrl-Shift-6.

Configuration Examples for ATM OAM Ping

This section provides the following configuration examples:

•Verifying the Connectivity of a Specific PVC: Example

•Normal Mode ping atm interface atm Command: Example

•Interactive ping Command: Example

Verifying the Connectivity of a Specific PVC: Example

The following example helps verify the connectivity of a specific PVC by sending an ATM OAM packet and confirms the connectivity when it is successful:

Router# show atm pvc 0/500

VC 0/500 doesn't exist on interface ATM1/0 - cannot display

ATM1/1.1: VCD: 2, VPI: 0, VCI: 500

UBR, PeakRate: N/A (UBR VC)

AAL5-LLC/SNAP, etype:0x0, Flags: 0xC20, VCmode: 0x0

OAM frequency: 10 second(s), OAM retry frequency: 1 second(s)

OAM up retry count: 3, OAM down retry count: 5

OAM END CC Activate retry count: 3, OAM END CC Deactivate retry count: 3

OAM END CC retry frequency: 30 second(s),

OAM SEGMENT CC Activate retry count: 3, OAM SEGMENT CC Deactivate retry count: 3

OAM SEGMENT CC retry frequency: 30 second(s),

OAM Loopback status: OAM Received

OAM VC state: Verified

ILMI VC state: Not Managed

OAM END CC status: OAM CC Ready

OAM END CC VC state: Verified

OAM SEGMENT CC status: OAM CC Ready

OAM SEGMENT CC VC state: Verified

VC is managed by OAM.

InARP frequency: 15 minutes(s)

InPkts: 289035, OutPkts: 217088, InBytes: 21165546, OutBytes: 17367793

InPRoc: 289039, OutPRoc: 289274

InFast: 0, OutFast: 0, InAS: 1, OutAS: 2

Out CLP=1 Pkts: 0

OAM cells received: 119900

F5 InEndloop: 119809, F5 InSegloop: 0,

F5 InEndcc: 0, F5 InSegcc: 0, F5 InAIS: 92, F5 InRDI: 0

OAM cells sent: 119902

F5 OutEndloop: 119810, F5 OutSegloop: 0,

F5 OutEndcc: 0, F5 OutSegcc: 0, F5 OutAIS: 0, F5 OutRDI: 92

OAM cell drops: 0

Status: UP

Normal Mode ping atm interface atm Command: Example

The following example shows sample output for the ping atm interface atm command in normal mode:

Router# ping atm interface atm1/1.1 0 500

Type escape sequence to abort.

Sending 5, 53-byte end-to-end OAM echoes, timeout is 2 seconds:

!!!!!

Success rate is 100 percent (5/5), round-trip min/avg/max = 4/16/52 ms

Router# ping atm interface atm1/1.1 0 500 seg-loopback

Type escape sequence to abort.

Sending 5, 53-byte segment OAM echoes, timeout is 2 seconds:

!!!!!

Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/1 ms

Router# ping atm interface atm1/1.1 0 500 end-loopback 100 25

Type escape sequence to abort.

Sending 100, 53-byte end-to-end OAM echoes, timeout is 25 seconds:

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

!!!!!!!!!!!!!!!!!!!!

Success rate is 100 percent (100/100), round-trip min/avg/max = 4/13/180 ms

Router# ping atm interface atm1/1.1 0 500 seg-loopback 50 20

Type escape sequence to abort.

Sending 50, 53-byte segment OAM echoes, timeout is 20 seconds:

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Success rate is 100 percent (50/50), round-trip min/avg/max = 1/1/4 ms

Router# show atm pvc 0/500

VC 0/500 doesn't exist on interface ATM1/0 - cannot display

ATM1/1.1: VCD: 2, VPI: 0, VCI: 500

UBR, PeakRate: N/A (UBR VC)

AAL5-LLC/SNAP, etype:0x0, Flags: 0xC20, VCmode: 0x0

OAM frequency: 10 second(s), OAM retry frequency: 1 second(s)

OAM up retry count: 3, OAM down retry count: 5

OAM END CC Activate retry count: 3, OAM END CC Deactivate retry count: 3

OAM END CC retry frequency: 30 second(s),

OAM SEGMENT CC Activate retry count: 3, OAM SEGMENT CC Deactivate retry count: 3

OAM SEGMENT CC retry frequency: 30 second(s),

OAM Loopback status: OAM Received

OAM VC state: Verified

ILMI VC state: Not Managed

OAM END CC status: OAM CC Ready

OAM END CC VC state: Verified

OAM SEGMENT CC status: OAM CC Ready

OAM SEGMENT CC VC state: Verified

VC is managed by OAM.

InARP frequency: 15 minutes(s)

InPkts: 290975, OutPkts: 219031, InBytes: 21306632, OutBytes: 17509085

InPRoc: 290979, OutPRoc: 291219

InFast: 0, OutFast: 0, InAS: 1, OutAS: 2

Out CLP=1 Pkts: 0

OAM cells received: 120881

F5 InEndloop: 120734, F5 InSegloop: 55,

F5 InEndcc: 0, F5 InSegcc: 0, F5 InAIS: 92, F5 InRDI: 0

OAM cells sent: 120882

F5 OutEndloop: 120735, F5 OutSegloop: 55,

F5 OutEndcc: 0, F5 OutSegcc: 0, F5 OutAIS: 0, F5 OutRDI: 92

OAM cell drops: 0

Status: UP

Interactive ping Command: Example

The following is sample output for the ping command in the interactive mode:

Router# ping

Protocol [ip]: atm

ATM Interface: atm1/1.1

VPI value [0]: 0

VCI value [1]: 500

Loopback - End(0), Segment(1) [0]:

Repeat Count [5]:

Timeout [2]:

Type escape sequence to abort.

Sending 5, 53-byte end-to-end OAM echoes, timeout is 2 seconds:

!!!!!

Success rate is 100 percent (5/5), round-trip min/avg/max = 4/9/12 ms

Additional References

The following sections provide references related to the ATM OAM Ping feature.

Related Documents

Related Topic	Document Title
Configuring PVCs and mapping a protocol address to a PVC while configuring ATM	"Creating PVCs" chapter in the Cisco IOS Wide-Area Networking Configuration Guide, Release 12.3
Configuring ATM	"Configuring ATM" chapter in the Cisco IOS Wide-Area Networking Configuration Guide, Release 12.3
WAN commands, complete command syntax, command mode, command history, defaults, usage guidelines, and examples	Cisco IOS Wide-Area Networking Command Reference, Release 12.3
Configuring ATM OAM traffic reduction	ATM OAM Traffic Reduction feature module
Configuring PVCs with or without OAM	Using OAM for PVC Management sample configuration
Detecting failures when using OAM cells and PVC management	Troubleshooting PVC Failures When Using OAM Cells and PVC Management technical note

Standards

Standards	Title
ITU-T Specification I.610 (ITU-T specification for B-ISDN operation and maintenance principles and functions).	I.610 Series I: Integrated Services Digital Network, Maintenance principles

MIBs

MIBs	MIBs Link
No new or modified MIBs are supported by this feature, and support for existing MIBs has not been modified by this feature.	To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL: http://www.cisco.com/go/mibs

RFCs

RFCs	Title
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.	—

Technical Assistance

Description	Link
Technical Assistance Center (TAC) home page, containing 30,000 pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.	http://www.cisco.com/public/support/tac/home.shtml

Command Reference

This section documents the following modified command only.

Modified Command

•ping atm interface atm

ping atm interface atm

To perform an ATM Operation Administration Maintenance (OAM) ping on a specific permanent virtual circuit (PVC), use the ping atm interface atm command in privileged EXEC mode.

ping atm interface atm interface-number vpi-value vci-value [end-loopback [repeat [timeout]] | seg-loopback [repeat [timeout]]]

Syntax Description

atm interface_number	ATM interface name.
vpi-value	Virtual path identifier. Range: 0 to 255.
vci-value	Virtual channel identifier. Range: 0 to 65535.
end-loopback	(Optional) Send ATM end loopback cells. This is the default.
seg-loopback	(Optional) Send ATM segment loopback cells.
repeat	(Optional) Number of ping packets that are sent to the destination address. Range: 1 to 1000. Default: 5.
timeout	(Optional) Timeout interval, in seconds. Range: 1 to 30. Default: 2.

Defaults

End loopback
Repeats: 5
Timeout interval: 2 seconds

Command Modes

Privileged EXEC

Command History

Release	Modification
11.4	This command was introduced on the LightStream 1010.
12.0(21)S	Support for this command was integrated into Cisco IOS Release 12.0(21)S.
12.2(13)T	Support for this command was integrated into Cisco IOS Release 12.2(13)T.
12.2(25)S	Support for this command was integrated into Cisco IOS Release 12.2(25)S.
12.2(18)SXE	This command was integrated into Cisco IOS Release 12.2(18)SXE.
12.2(27)SBA	This command was integrated into Cisco IOS Release 12.2(27)SBA.

Usage Guidelines

The ping atm interface atm command sends an OAM packet and indicates when a response is received. It can be used either in normal mode or in interactive mode. The ping atm interface atm command provides two ATM OAM ping options:

•End loopback—Verifies end-to-end PVC integrity.

•Segment loopback—Verifies PVC integrity to the neighboring ATM device.

Examples

In the following example, an ATM OAM ping with a 15-second timeout verifies end-to-end connectivity for PVC 0/500 in the normal mode:

Router# ping atm interface atm1/1.1 0 500 end-loopback 30 15

Type escape sequence to abort.

Sending 30, 53-byte end-to-end OAM echoes, timeout is 15 seconds:

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Success rate is 100 percent (30/30), round-trip min/avg/max = 1/1/4 ms

In the following example, an ATM OAM ping verifies connectivity to the first-hop ATM switch on PVC 1/100 in the normal mode:

Router# ping atm interface atm1/1.1 0 500 seg-loopback 30 10

Type escape sequence to abort. 

Sending 30, 53-byte segment OAM echoes, timeout is 10 seconds:

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Success rate is 100 percent (30/30), round-trip min/avg/max = 1/1/4 ms

Table 1 describes the output of the ping atm interface atm command.

Table 1 ping atm interface atm Field Descriptions

Field	Description
Success rate is 100 percent	Percentage of packets successfully echoed back to the router. Anything less than 80 percent is usually considered problematic.
round-trip min/avg/max = 1/1/4 ms	Round-trip travel time intervals for the OAM loopback cells, including minimum/average/maximum (in milliseconds).
!!!!!!	Each exclamation point (!) indicates receipt of a reply. A period (.) indicates that an OAM response cell was not received within the timeout interval.

The following example verifies connectivity to the neighboring ATM device for the ATM PVC with the virtual path identifier (VPI) / virtual channel identifier (VCI) value 0/500 in the interactive mode:

Router# ping

Protocol [ip]:atm

ATM Interface:atm1/1.1

VPI value [0]:0

VCI value [1]:500

Loopback - End(0), Segment(1) [0]:1 

Repeat Count [5]:

Timeout [2]:

Type escape sequence to abort. 

Sending 5, 53-byte segment OAM echoes, timeout is 2 seconds:

!!!!!

Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/1 ms

Table 2 describes the ping fields shown in the display.

Table 2 ping atm interface atm Field Descriptions for ATM 

Field	Description
Protocol [ip]:	Prompt for a supported protocol.
ATM Interface:	Prompt for the ATM interface.
VPI value [0]:	Prompt for the virtual path identifier. Default: 0.
VCI value [1]:	Prompt for the virtual channel identifier. Default: 1.
Loopback - End(0), Segment(1) [0]:	Prompt to specify end loopback, which verifies end-to-end PVC integrity, or segment loopback, which verifies PVC integrity to the neighboring ATM device. Default: end loopback.
Repeat Count [5]:	Number of ping packets that will be sent to the destination. Default: 5.
Timeout [2]:	Timeout interval, in seconds. Default: 2.

Related Commands

Command	Description
debug atm oam	Displays information about ATM OAM events.
show atm pvc	Displays the OAM status information.
show atm oam auto-detect	Displays ATM Operations and Maintenance (OAM) autodetect statistics.

Copyright © 2004, 2005 Cisco Systems, Inc. All rights reserved.