-
Cisco IOS XR Interface and Hardware Component Command
Referencefor the Cisco CRS Router, Release 4.2.x
Americas HeadquartersCisco Systems, Inc.170 West Tasman DriveSan
Jose, CA 95134-1706USAhttp://www.cisco.comTel: 408 526-4000 800
553-NETS (6387)Fax: 408 527-0883
Text Part Number: OL-26065-03
-
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN
THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS,INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE
BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY
KIND,EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR
THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITEDWARRANTY FOR THE ACCOMPANYING
PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED
WITHTHE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF
YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED
WARRANTY,CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an
adaptation of a program developed by the University of California,
Berkeley (UCB) as part of UCB's public domain versionof the UNIX
operating system. All rights reserved. Copyright 1981, Regents of
the University of California.
NOTWITHSTANDINGANYOTHERWARRANTYHEREIN, ALL DOCUMENT FILES AND
SOFTWARE OF THESE SUPPLIERS ARE PROVIDED AS IS"WITH ALL
FAULTS.CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES,
EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE
OFMERCHANTABILITY, FITNESS FORA PARTICULAR
PURPOSEANDNONINFRINGEMENTORARISING FROMACOURSEOFDEALING, USAGE, OR
TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY
INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUTLIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING
OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR
ITS SUPPLIERSHAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in
this document are not intended to be actual addresses and phone
numbers. Any examples, command display output, networktopology
diagrams, and other figures included in the document are shown for
illustrative purposes only. Any use of actual IP addresses or phone
numbers in illustrative content is unintentionaland
coincidental.
Cisco and the Cisco logo are trademarks or registered trademarks
of Cisco and/or its affiliates in the U.S. and other countries. To
view a list of Cisco trademarks, go to this URL:
http://www.cisco.com/go/trademarks. Third-party trademarks
mentioned are the property of their respective owners. The use of
the word partner does not imply a partnershiprelationship between
Cisco and any other company. (1110R)
2016 Cisco Systems, Inc. All rights reserved.
http://www.cisco.com/go/trademarkshttp://www.cisco.com/go/trademarks
-
C O N T E N T S
P r e f a c e Preface xvii
Changes to This Document xvii
Obtaining Documentation and Submitting a Service Request
xvii
C H A P T E R 1 ATM Commands on the Cisco IOS XR Software 1
atm address-registration 3
atm ilmi-config disable 4
atm ilmi-keepalive 6
atm ilmi-trap disable 8
atm maxvpi-bits 12 9
atm mcpt-timers 11
atm oam flush 13
cell-packing 15
class-int 17
class-vc 19
encapsulation (ATM) 21
interface atm 24
l2transport (ATM) 28
oam ais-rdi 30
oam-pvc manage 32
oam retry 35
ping atm interface atm 38
pvc (ATM) 40
pvp (ATM) 44
shape 46
show atm cell-packing 49
show atm class-link 51
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 iii
-
show atm ilmi-status 55
show atm interface atm 58
show atm pvc 65
show atm pvp 73
show atm vc-class 79
show controllers atm 83
shutdown (ATM) 88
vc-class atm 89
C H A P T E R 2 Dense Wavelength Division Multiplexing Commands
on the Cisco IOS XR Software 91
admin-state 93
controller dwdm 95
g709 bdi-to-client-gais 97
g709 disable 98
g709 fec 100
g709 odu overhead tti 102
g709 odu report disable 104
g709 otu overhead tti 106
g709 otu report disable 108
g709 otu threshold 110
g709 tim-to-client-gais 112
g709 tti-processing 113
log signal 114
loopback (DWDM) 116
maintenance disable 117
network connection id 119
network port id 120
network srlg 121
pm fec report enable 122
pm fec threshold 124
pm optics report enable 126
pm optics threshold 128
pm otn report enable 130
pm otn threshold 133
proactive 136
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
iv OL-26065-03
Contents
-
proactive revert threshold 138
proactive revert window 140
proactive trigger threshold 142
proactive trigger window 144
rx-los-threshold 146
show controller dwdm 148
show controller dwdm pm 158
transport-mode 164
transmit-power 167
wavelength 169
C H A P T E R 3 Diagnostics Commands 171
diagnostic load 172
diagnostic monitor 174
diagnostic monitor interval 176
diagnostic monitor syslog 178
diagnostic monitor threshold 179
diagnostic ondemand action-on-failure 181
diagnostic ondemand iterations 183
diagnostic schedule 184
diagnostic start 187
diagnostic stop 189
diagnostic test-parameters 191
diagnostic unload 193
ping (administration EXEC) 195
show diag 200
show diagnostic bootup level 205
show diagnostic content 206
show diagnostic ondemand settings 210
show diagnostic result 211
show diagnostic schedule 217
show diagnostic status 219
show run diagnostic monitor 221
C H A P T E R 4 Ethernet Interface Commandson the Cisco IOS XR
Software 223
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 v
Contents
-
carrier-delay 225
clear lldp 227
clear mac-accounting (Ethernet) 229
flow-control 231
interface (Ethernet) 233
lldp 235
lldp (interface) 236
lldp holdtime 237
lldp reinit 238
lldp timer 239
lldp tlv-select disable 240
loopback (Ethernet) 242
mac-accounting 244
mac-address (Ethernet) 246
negotiation auto 247
packet-gap non-standard 248
show controllers (Ethernet) 249
show lldp 297
show lldp entry 299
show lldp errors 301
show lldp interface 302
show lldp neighbors 304
show lldp traffic 307
show mac-accounting (Ethernet) 309
C H A P T E R 5 Ethernet OAM Commands on the Cisco IOS XR
Software 311
action capabilities-conflict 315
action critical-event 317
action discovery-timeout 319
action dying-gasp 321
action high-threshold 323
action remote-loopback 325
action session-down 327
action session-up 329
action uni-directional link-fault 331
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
vi OL-26065-03
Contents
-
action wiring-conflict 333
aggregate 335
ais transmission 337
ais transmission up 339
buckets archive 341
buckets size 343
clear ethernet cfm ccm-learning-database location 345
clear ethernet cfm interface statistics 346
clear ethernet cfm local meps 348
clear ethernet cfm peer meps 350
clear ethernet cfm traceroute-cache 352
clear ethernet oam statistics 354
clear ethernet sla statistics all 356
clear ethernet sla statistics on-demand 358
clear ethernet sla statistics profile 360
connection timeout 362
continuity-check archive hold-time 364
continuity-check interval 366
continuity-check loss auto-traceroute 368
cos (CFM) 369
debug ethernet cfm packets 371
debug ethernet cfm protocol-state 374
domain 376
efd 378
ethernet cfm (global) 380
ethernet cfm (interface) 382
ethernet oam 384
ethernet oam loopback 385
ethernet oam profile 387
ethernet sla 388
ethernet sla on-demand operation type cfm-delay-measurement
probe 389
ethernet sla on-demand operation type cfm-loopback probe 396
frame-period threshold 404
frame-period window 406
frame-seconds threshold 407
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 vii
Contents
-
frame-seconds window 409
frame threshold 411
frame window 413
link-monitor 414
log ais 415
log continuity-check errors 417
log continuity-check mep changes 419
log crosscheck errors 420
log efd 422
maximum-meps 423
mep crosscheck 425
mep-id 426
mep domain 428
mib-retrieval 430
mip auto-create 432
mode (Ethernet OAM) 434
monitoring 436
packet size 438
ping ethernet cfm 440
priority (SLA) 443
probe 444
profile (EOAM) 445
profile (SLA) 447
require-remote 449
schedule (SLA) 451
send (SLA) 455
service 458
show efd interface 461
show ethernet cfm ccm-learning-database 463
show ethernet cfm configuration-errors 465
show ethernet cfm interfaces ais 467
show ethernet cfm interfaces statistics 470
show ethernet cfm local maintenance-points 472
show ethernet cfm local meps 475
show ethernet cfm peer meps 481
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
viii OL-26065-03
Contents
-
show ethernet cfm traceroute-cache 488
show ethernet oam configuration 495
show ethernet oam discovery 498
show ethernet oam interfaces 500
show ethernet oam statistics 503
show ethernet sla configuration-errors 505
show ethernet sla operations 507
show ethernet sla statistics 510
sla operation 516
snmp-server traps ethernet cfm 518
snmp-server traps ethernet oam events 519
statistics measure 520
symbol-period threshold 522
symbol-period window 524
traceroute cache 525
traceroute ethernet cfm 527
C H A P T E R 6 Global Interface Commandsonthe Cisco IOS XR
Software 531
bandwidth (global) 532
clear interface 534
dampening 536
interface (global) 538
mtu 540
show im dampening 543
show interfaces 547
shutdown (global) 558
C H A P T E R 7 Internal Ethernet Control Network Commands on
the Cisco IOS XR Software 561
clear controller backplane ethernet clients 563
clear controller backplane ethernet statistics 565
show controllers backplane ethernet brief 566
show controllers backplane ethernet clients 568
show controllers backplane ethernet detail 573
show controllers backplane ethernet manageability bridge basic
578
show controllers backplane ethernet manageability bridge
fdb-entry 580
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 ix
Contents
-
show controllers backplane ethernet manageability bridge
forwarding 583
show controllers backplane ethernet manageability bridge list
586
show controllers backplane ethernet manageability bridge port
588
show controllers backplane ethernet manageability bridge
span-tree 593
show controllers backplane ethernet manageability bridge
transparent 596
show controllers backplane ethernet manageability interface
attributes 598
show controllers backplane ethernet manageability interface list
601
show controllers backplane ethernet manageability interface
mau-autonet-info 604
show controllers backplane ethernet manageability interface
mau-info 608
show controllers backplane ethernet manageability interface
mau-jack-type 614
show controllers backplane ethernet manageability interface
statistics 616
show controllers backplane ethernet multicast groups 620
show controllers switch ports 622
show controllers switch statistics 624
show spantree 627
C H A P T E R 8 Inter-rack Switch Control Network Commands on
the Cisco IOS XR Software 631
clear controller switch 632
clear controller switch errdisable 633
clear controller switch inter-rack 635
show controllers switch 637
show controllers switch inter-rack ports 639
show controllers switch inter-rack statistics 641
show controllers switch inter-rack stp 644
show controllers switch inter-rack udld 646
show controllers switch stp location 648
show controllers switch stp ports 651
show controllers switch stp region 653
show controllers switch udld location 654
show controllers switch udld ports 656
C H A P T E R 9 Link Bundling Commands on the Cisco IOS XR
Software 659
backbone interface 661
bundle-hash 663
bundle id 669
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
x OL-26065-03
Contents
-
bundle maximum-active links 671
bundle minimum-active bandwidth 675
bundle minimum-active links 676
bundle port-priority 677
clear lacp counters 679
interface (bundle) 681
isolation recovery-delay 683
lacp fast-switchover 684
lacp packet-capture 686
lacp period short 689
lacp system priority 692
mlacp connect 694
mlacp iccp-group 695
mlacp node 696
mlacp port-priority 697
mlacp system mac 698
mlacp system priority 699
redundancy iccp group 700
show bundle 701
show bundle brief 713
show bundle replication bundle-ether 716
show iccp group 717
show lacp bundle 719
show lacp counters 722
show lacp io 724
show lacp packet-capture 727
show lacp port 730
show lacp system-id 733
show mlacp 735
show mlacp counters 737
C H A P T E R 1 0 Management Ethernet Interface Commands on the
Cisco IOS XR Software 739
duplex (Management Ethernet) 740
interface MgmtEth 742
mac-address (Management Ethernet) 744
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 xi
Contents
-
speed (Management Ethernet) 746
C H A P T E R 1 1 Null Interface Commands 749
interface null 0 750
show controllers null interface 751
show interfaces null0 753
C H A P T E R 1 2 Packet-over-SONET Interface Commands on the
Cisco IOS XR Software 755
crc (POS) 756
encapsulation (POS) 758
interface pos 760
keepalive (POS) 762
pos 764
show interfaces pos 766
transmit-delay 769
C H A P T E R 1 3 PPP Commands onthe Cisco IOS XR Software
771
clear ppp sso state 773
clear ppp statistics 775
encapsulation ppp 776
group 778
multi-router aps 780
peer ipv4 address 781
ppp authentication 782
ppp chap password 785
ppp chap refuse 787
ppp ipcp dns 789
ppp ipcp neighbor-route disable 790
ppp ipcp peer-address default 791
ppp max-bad-auth 792
ppp max-configure 793
ppp max-failure 795
ppp max-terminate 797
ppp ms-chap hostname 799
ppp ms-chap password 800
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
xii OL-26065-03
Contents
-
ppp ms-chap refuse 802
ppp multilink multiclass 804
ppp multilink multiclass local 805
ppp multilink multiclass remote apply 806
ppp pap refuse 808
ppp pap sent-username password 810
ppp timeout authentication 812
ppp timeout retry 814
redundancy 815
security ttl 816
show ppp interfaces 817
show ppp sso alerts 825
show ppp sso state 827
show ppp sso summary 829
ssrp group 831
ssrp location 832
ssrp profile 833
C H A P T E R 1 4 SONET Controller Commands on the Cisco IOS XR
Software 835
ais-shut (SONET) 837
ais-shut (SONET path) 839
aps group 840
aps group (global) 843
authenticate (PGP) 845
b3-ber-prdi 847
channel local 848
channel remote 850
clear counters sonet 852
clock source (SONET) 854
controller (SONET) 855
delay clear 857
delay trigger 858
down-when-looped 859
force 860
framing (SONET) 862
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 xiii
Contents
-
line delay clear 864
line delay trigger 865
lockout 866
loopback (SONET) 868
manual 869
overhead (SONET) 871
overhead (SONET path) 873
path delay clear 875
path delay trigger 876
path (SONET) 877
report (SONET) 879
report (SONET path) 881
revert 883
scrambling disable (SONET path) 885
show aps 887
show aps agents 889
show aps group 891
show controllers pos 894
show controllers sonet 900
shutdown (SONET) 908
signalling 910
timers (APS) 912
threshold (SONET) 914
threshold (SONET path) 916
uneq-shut (SONET path) 918
unidirectional 919
C H A P T E R 1 5 SRP Commands on the Cisco IOS XR Software
921
clear srp counters 922
hw-module port 926
interface srp 929
show controllers srp 931
show srp 933
srp ips delay trigger-keepalive 945
srp ips request forced-switch 947
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
xiv OL-26065-03
Contents
-
srp ips timer 949
srp ips wtr-timer 951
srp mac-count 953
srp mac-reject 955
srp manual-switch 957
srp priority-threshold 959
srp rate-limit 960
srp shutdown 961
srp topology-timer 963
C H A P T E R 1 6 T3 and E3 Controller Commands on the Cisco IOS
XR Software 965
bert e3 967
bert error 969
bert interval 971
bert pattern 973
bert t3 975
cablelength 977
clear controller t3 978
clock source (T3/E3) 980
controller e3 982
controller t3 984
delay clear (T3/E3) 986
delay trigger (T3/E3) 987
description (T3/E3) 988
down-when-looped (T3/E3) 990
dsu bandwidth 991
dsu mode 993
dsu remote 995
framing (E3) 997
framing (T3) 998
hw-module subslot cardtype 1000
loopback (T3/E3) 1002
mdl 1004
mode 1006
national bits (E3) 1008
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 xv
Contents
-
show controllers e3 1009
show controllers t3 1013
shutdown (T3/E3) 1022
C H A P T E R 1 7 VLAN Subinterface Commandsonthe Cisco IOS XR
Software 1025
dot1q native vlan 1026
dot1q vlan 1028
interface (VLAN) 1030
show vlan interface 1032
show vlan tags 1035
show vlan trunks 1037
C H A P T E R 1 8 10-Gigabit Ethernet WAN PHY Controller
Commandson the Cisco IOS XR Software 1041
clear controller wanphy 1042
clear counters wanphy 1044
controller wanphy 1046
lanmode on 1048
report sd-ber 1050
report sf-ber disable 1052
show controllers wanphy 1054
threshold sd-ber 1064
threshold sf-ber 1066
wanmode on 1068
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
xvi OL-26065-03
Contents
-
Preface
This command reference describes the Cisco IOSXR Interfaces
commands. The preface for the Cisco IOS XRInterface and Hardware
Component Command Reference for the Cisco CRS Router contains the
followingsections:
Changes to This Document, page xvii
Obtaining Documentation and Submitting a Service Request, page
xvii
Changes to This DocumentThis table lists the technical changes
made to this document since it was first published.
Change SummaryDateRevision
Republished with documentation updates for CiscoIOS XR Release
4.2.3 features.
September 2012OL-26065-03
Republished with updates for Cisco IOSXRRelease4.2.1.
June 2012OL-26065-02
Initial release of this document.December 2011OL-26065-01
Obtaining Documentation and Submitting a Service RequestFor
information on obtaining documentation, using the Cisco Bug Search
Tool (BST), submitting a servicerequest, and gathering additional
information, see What's New in Cisco Product Documentation.
To receive new and revised Cisco technical content directly to
your desktop, you can subscribe to the What'sNew in Cisco Product
Documentation RSS feed. RSS feeds are a free service.
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 xvii
http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.htmlhttp://www.cisco.com/assets/cdc_content_elements/rss/whats_new/whatsnew_rss_feed.xmlhttp://www.cisco.com/assets/cdc_content_elements/rss/whats_new/whatsnew_rss_feed.xml
-
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
xviii OL-26065-03
PrefaceObtaining Documentation and Submitting a Service
Request
-
ATM Commands on the Cisco IOS XR Software
This module provides command line interface (CLI) commands for
configuring ATM on your router.
atm address-registration, page 3
atm ilmi-config disable, page 4
atm ilmi-keepalive, page 6
atm ilmi-trap disable, page 8
atm maxvpi-bits 12, page 9
atm mcpt-timers, page 11
atm oam flush, page 13
cell-packing, page 15
class-int, page 17
class-vc, page 19
encapsulation (ATM), page 21
interface atm, page 24
l2transport (ATM), page 28
oam ais-rdi, page 30
oam-pvc manage, page 32
oam retry, page 35
ping atm interface atm, page 38
pvc (ATM), page 40
pvp (ATM), page 44
shape, page 46
show atm cell-packing, page 49
show atm class-link, page 51
show atm ilmi-status, page 55
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 1
-
show atm interface atm, page 58
show atm pvc, page 65
show atm pvp, page 73
show atm vc-class, page 79
show controllers atm, page 83
shutdown (ATM), page 88
vc-class atm, page 89
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
2 OL-26065-03
ATM Commands on the Cisco IOS XR Software
-
atm address-registrationTo enable the router to engage in
address registration and callback functions with the Interim
LocalManagementInterface (ILMI), use the atm address-registration
command in interface configuration mode. To disableILMI address
registration functions, use the no form of this command.
atm address-registration
no atm address-registration
Syntax Description This command has no keywords or
arguments.
Command Default If ILMI is configured on a PVC and its host ATM
interface, then address registration and callback functionenabled
on the router by default.
If ILMI is not configured on a PVC and its host ATM interface,
then address registration and callbackfunctionality is disabled on
the router and must be enabled with the atm address-registration
command.
Command Modes Interface configuration (config-if)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines
The atm address-registration command is effective only when an
ILMI PVC is created under the physicalATM interface.
Note
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to enable the ATM
interface 0 in slot 6 to register its address:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/0RP/0/RP0/CPU0:router(config-if)# atm
address-registration
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 3
ATM Commands on the Cisco IOS XR Softwareatm
address-registration
-
atm ilmi-config disableTo disable Interim Local Management
Interface (ILMI) on an ATM interface, use the atm ilmi-config
disablecommand in interface configuration mode. To re-enable ILMI
on an ATM interface, use the no form of thiscommand.
atm ilmi-config disable
no atm ilmi-config disable
Syntax Description This command has no keywords or
arguments.
Command Default If an ILMI PVC is configured on the ATM
interface, then ILMI is automatically enabled on the ATM
interfacethat hosts that PVC.
If an ILMI PVC is not configured on the ATM interface, then ILMI
is disabled by default on the ATM interface.
Command Modes Interface configuration (config-if)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines
The atm ilmi-config disable command is effective only when an
ILMI PVC is created under the physicalATM interface.
Note
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to disable ILMI on an
ATM interface:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/0RP/0/RP0/CPU0:router(config-if)# atm
ilmi-config disableThe following example shows how to re-enable
ILMI on an ATM interface:
RP/0/RP0/CPU0:router# configure
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
4 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareatm ilmi-config
disable
-
RP/0/RP0/CPU0:router(config)# interface atm
0/6/0/0RP/0/RP0/CPU0:router(config-if)# no atm ilmi-config
disable
Related Commands DescriptionCommand
Displays status information that is related to ILMI.show atm
ilmi-status, on page 55
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 5
ATM Commands on the Cisco IOS XR Softwareatm ilmi-config
disable
-
atm ilmi-keepaliveTo enable Interim LocalManagement Interface
(ILMI) keepalives on an ATM interface and configure
keepalivepolling frequency, use the atm ilmi-keepalive command in
interface configuration mode. To disable ILMIkeepalives, use the no
form of this command.
atm ilmi-keepalive [act-poll-freq frequency] [retries count]
[inact-poll-freq frequency]
no atm ilmi-keepalive [act-poll-freq frequency] [retries count]
[inact-poll-freq frequency]
Syntax Description (Optional) Number of polling seconds between
active keepalives. Rangeis from 1 through 65535 seconds. Default is
5 seconds.
act-poll-freq frequency
(Optional) ILMI keepalive retry count. Range is from 2 through
5. Defaultis 4 retries.
retries count
(Optional) Number of polling seconds between inactive
keepalives. Rangeis from 1 through 65535 seconds. Default is 1
second.
inact-poll-freq frequency
Command Default act-poll-freq frequency: 5
retries count: 4
inact-poll-freq frequency: 1
Command Modes Interface configuration (config-if)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines
The atm ilmi-keepalive command is effective only when an ILMI
PVC is created under the physicalATM interface.
Note
Task ID OperationsTask ID
read, writeatm
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
6 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareatm ilmi-keepalive
-
Examples The following example shows how to enable ILMI
keepalives for the ATM interface 0 in slot 6:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/0RP/0/RP0/CPU0:router(config-if)# atm
ilmi-keepaliveThe following example shows how to configure the ATM
interface 1 in slot 6 to poll the number of inactivekeepalives
every 10 seconds:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/1RP/0/RP0/CPU0:router(config-if)# atm
ilmi-keepalive inact-poll-freq 10The following example shows how to
disable ILMI keepalives for the ATM interface 0 in slot 6:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/0RP/0/RP0/CPU0:router(config-if)# no atm
ilmi-keepalive
Related Commands DescriptionCommand
Displays status information that is related to ILMI.show atm
ilmi-status, on page 55
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 7
ATM Commands on the Cisco IOS XR Softwareatm ilmi-keepalive
-
atm ilmi-trap disableTo disable Interim Local Management
Interface (ILMI) trap generation on an ATM interface, use the
atmilmi-trap disable command in interface configuration mode. To
reenable ILMI trap generation, use the noform of this command.
atm ilmi-trap disable
no atm ilmi-trap disable
Syntax Description This command has no keywords or
arguments.
Command Default Support for ATM ILMI trap generation is
enabled.
Command Modes Interface configuration (config-if)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to disable ILMI trap
generation on the ATM interface 0 in slot 6:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/0RP/0/RP0/CPU0:router(config-if)# atm ilmi-trap
disableThe following example shows how to reenable ILMI trap
generation on the ATM interface 0 in slot 6:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/1RP/0/RP0/CPU0:router(config-if)# no atm
ilmi-trap disable
Related Commands DescriptionCommand
Displays ATM-specific information about an ATM interface.show
atm interface atm, on page 58
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
8 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareatm ilmi-trap
disable
-
atm maxvpi-bits 12To enable support for the 12-bits virtual path
identifier (VPI) Network-Node Interface (NNI) cell format, usethe
atm maxvpi-bits 12 command in interface configuration mode. To
disable support for the 12-bits VPINNI cell format, use the no form
of this command.
atm maxvpi-bits 12
no atm maxvpi-bits 12
Syntax Description This command has no keywords or
arguments.
Command Default Support for the 12-bits VPI NNI cell format is
disabled.
Command Modes Interface configuration (config-if)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines
Out of the twelve bits, four bits in the ATM UNI cell header are
reserved for local standardized genericflow control (GFC).
Note
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to enable support for
the 12-bits VPI NNI cell format on the ATM interface0 in slot
6:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/0RP/0/RP0/CPU0:router(config-if)# atm
maxvpi-bits 12The following example shows how to disable support
for the 12-bits VPI NNI cell format on the ATM interface1 in slot
6:
RP/0/RP0/CPU0:router# configure
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 9
ATM Commands on the Cisco IOS XR Softwareatm maxvpi-bits 12
-
RP/0/RP0/CPU0:router(config)# interface atm
0/6/0/1RP/0/RP0/CPU0:router(config-if)# no atm maxvpi-bits 12
Related Commands DescriptionCommand
Displays ATM-specific information about an ATM interface.show
atm interface atm, on page 58
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
10 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareatm maxvpi-bits 12
-
atm mcpt-timersTo define the three Maximum Cell Packing Timeout
(MCPT) timers under a main ATM interface, use theatm mcpt-timers
command in interface configuration mode. To return the three timers
to the defaultconfiguration, use the no form of this command.
atm mcpt-timers timer-1 timer-2 timer-3
no atm mcpt-timers
Syntax Description Maximum number of microseconds to wait to
complete cell packing on a single packetbefore that packet is
transmitted. Range is from 50 through 4095.
To associate this timer with an interface, use the cell-packing
command and replacethe timer argument 1.
Note
timer-1
Maximum number of microseconds to wait to complete cell packing
on a single packetbefore that packet is transmitted. Range is from
50 through 4095.
To associate this timer with an interface, use the cell-packing
command and replacethe timer argument 2.
Note
timer-2
Maximum number of microseconds to wait to complete cell packing
on a single packetbefore that packet is transmitted. Range is from
50 through 4095.
To associate this timer with an interface, use the cell-packing
command and replacethe timer argument 3.
Note
timer-3
Command Default timer-1 : 50
timer-2 : 50
timer-3 : 50
Command Modes Interface configuration (config-if)
Command History ModificationRelease
This command was introduced.Release 3.7.0
Usage Guidelines Use the cell-packing command to attach one of
the three MCPT timers to an individual L2VPN port, PVC,or PVP. If
the associated MCPT timer expires before the maximum number of
cells that can be packed isreached, then the packet is transmitted
with the number of cells that have been packed thus far.
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 11
ATM Commands on the Cisco IOS XR Softwareatm mcpt-timers
-
We recommend configuring a low, medium, and high value for the
three MCPT timers to accommodatethe different ATM traffic classes.
Low- latency CBR traffic typically uses a lowMCPT timer value,
whilehigh-latency UBR traffic typically requires a highMCPT timer
value. VBR-rt and VBR-nrt traffic typicallyuse a median MCPT timer
value.
Note
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to configure the three
MCPT timers and then apply one of them to aninterface with the
cell-packing command:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/0RP/0/RP0/CPU0:router(config-if)# atm
mcpt-timers 50 100 200RP/0/RP0/CPU0:router(config-if)#
l2transportRP/0/RP0/CPU0:router(config-if-l2)# cell-packing 6 1
Related Commands DescriptionCommand
Configures the maximum number of cells allowed per packet,
andspecifies a MCPT timer for cell packing.
cell-packing, on page 15
Displays ATM-specific information about an ATM interface.show
atm interface atm, on page 58
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
12 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareatm mcpt-timers
-
atm oam flushTo drop all current and future Operation,
Administration, and Maintenance (OAM) cells received on an
ATMinterface, use the atm oam flush command in interface
configuration mode. To receive OAM cells on anATM interface, use
the no form of this command.
atm oam flush
no atm oam flush
Syntax Description This command has no keywords or
arguments.
Command Default The dropping of OAM cells is disabled.
Command Modes Interface configuration (config-if)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to enable the dropping
of all current and future OAM cells received onthe ATM interface 0
in slot 6:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/0RP/0/RP0/CPU0:router(config-if)# atm oam
flush
The following example shows how to disable the dropping of all
current and future OAM cells received onthe ATM interface 1 in slot
6:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/0RP/0/RP0/CPU0:router(config-if)# no atm oam
flush
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 13
ATM Commands on the Cisco IOS XR Softwareatm oam flush
-
Related Commands DescriptionCommand
Displays ATM-specific information about an ATM interface.show
atm interface atm, on page 58
Displays configuration information for the parameters on a VC
classthat is associated with a particular PVC.
show atm class-link, on page 51
Displays information about all ATMVC classes on the router or
fora specific ATM VC-class.
show atm vc-class, on page 79
Displays VP tunnel information for the entire router or for a
specificinterface.
show atm vp-tunnel
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
14 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareatm oam flush
-
cell-packingTo configure themaximum number of cells allowed per
packet, and specify aMaximumCell Packing Timeout(MCPT) timer for
cell packing, use the cell-packing command in the appropriate mode.
To return the interfaceto the default cell packing configuration,
use the no form of this command.
cell-packing cells timer
no cell-packing
Syntax Description Maximum number of cells to use per packet.
Range is from 2 through 86.cells
Indicates the appropriate MCPT timer to use for cell packing.
Can be 1, 2, or 3.
You can configure up to three different MCPT values for a single
main interfacewith the atm mcpt-timers command.
Note
timer
Command Default If you do not configure the maximum number of
cells allowed per packet, only one cell is carried per packet.
Command Modes ATM layer 2 transport interface configuration
(config-if-l2)
ATM layer 2 transport PVC configuration
(config-atm-l2transport-pvc)
ATM layer 2 transport PVP configuration
(config-atm-l2transport-pvp)
Command History ModificationRelease
This command was introduced.Release 3.7.0
Usage Guidelines Use the atm mcpt-timers, on page 11 command to
configure the three MCPT timers under the main ATMinterface.
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to configure cell
packing parameters on an ATM interface:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/0RP/0/RP0/CPU0:router(config-if)#
l2transportRP/0/RP0/CPU0:router(config-if-l2)# cell-packing 6 3
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 15
ATM Commands on the Cisco IOS XR Softwarecell-packing
-
Related Commands DescriptionCommand
Defines the three MCPT timers under a main ATM interface.atm
mcpt-timers, on page 11
Displays cell packing information for the Layer 2
attachmentcircuits (ACs) configured on your system.
show atm cell-packing, on page 49
Displays ATM-specific information about an ATM interface.show
atm interface atm, on page 58
Displays ATM PVC and traffic information for the entire
router.show atm pvc, on page 65
Displays ATM PVP and traffic information for the entire
router,or a specific VPI or ATM interface.
show atm pvp, on page 73
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
16 OL-26065-03
ATM Commands on the Cisco IOS XR Softwarecell-packing
-
class-intTo assign a virtual circuit (VC) class to an ATM main
interface, use the class-int command in interfaceconfiguration
mode. To remove a VC-class, use the no form of this command.
class-int vc-class-name
no class-int vc-class-name
Syntax Description Name of the VC-class you are assigning to
your ATM main interface orsubinterface.
vc-class-name
Command Default No VC-class is assigned to an ATM main interface
or subinterface.
Command Modes Interface configuration (config-if)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines When you create a VC-class for an ATM main
interface or subinterface, you can use the shape andencapsulation
commands to define your parameters.
Parameters that are applied to an individual VC supersede
interface- and subinterface-level parameters.Parameters that are
configured for a VC through discrete commands entered in
interface-ATM-VC configurationmode supersede VC-class parameters
assigned to an ATM main interface or subinterface by the
class-intcommand.
This command is not available for Layer 2 interfaces.Note
Task ID OperationsTask ID
read, writeatm
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 17
ATM Commands on the Cisco IOS XR Softwareclass-int
-
Examples The following example shows how to create a class
called classA and then apply that class to ATM maininterface 1 in
slot 6:
RP/0/RP0/CPU0:router#
configureRP/0/RP0/CPU0:router(config)#vc-class atm
classARP/0/RP0/CPU0:router(config-vc-class-atm)# shape cbr
40000RP/0/RP0/CPU0:router(config-vc-class-atm)# encapsulation
aal5snapRP/0/RP0/CPU0:router(config-vc-class-atm)# oam-pvc manage
300RP/0/RP0/CPU0:router(config-vc-class-atm)#
commitRP/0/RP0/CPU0:router(config-vc-class-atm)#
exitRP/0/RP0/CPU0:router(config)# interface atm
0/6/0/1RP/0/RP0/CPU0:router(config-if)# class-int
classARP/0/RP0/CPU0:router(config-if)#
Related Commands DescriptionCommand
Displays configuration information for the parameters on a VC
classthat is associated with a particular PVC.
show atm class-link, on page 51
Displays information about all ATM VC classes on the router or
fora specific ATM VC-class.
show atm vc-class, on page 79
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
18 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareclass-int
-
class-vcTo attach a virtual circuit (VC) class to an ATM
permanent virtual circuit (PVC), use the class-vc commandin ATMPVC
configurationmode for a PVC that is configured on an ATM
subinterface. To remove a VC-classfrom a PVC, use the no form of
this command.
class-vc vc-class-name
no class-vc vc-class-name
Syntax Description Name of the VC-class you are assigning to
your ATM PVC.vc-class-name
Command Default No VC-class is assigned to an ATM PVC.
Command Modes ATM PVC configuration (config-atm-vc)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines When you create a VC-class for an ATM
subinterface PVC, you can use the shape and encapsulationcommands
to define your parameters.
Parameters that are applied to an individual VC supersede
PVC-level parameters. Parameters that are configuredfor a VC
through discrete commands entered in interface-ATM-VC configuration
mode supersede VC-classparameters assigned to a PVC by the class-vc
command.
The class-vc command is available in ATM PVC configuration mode
for a PVC that is configured on anATM subinterface only. This
command is not available in ATM PVC configuration mode for an
ATMmain interface.
Note
Task ID OperationsTask ID
read, writeatm
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 19
ATM Commands on the Cisco IOS XR Softwareclass-vc
-
Examples The following example shows how to create a class
called classA and then apply that class to the subinterface1 on the
ATM main interface 1 in slot 6:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# vc
atm classARP/0/RP0/CPU0:router(config-vc-class-atm)# shape cbr
40000RP/0/RP0/CPU0:router(config-vc-class-atm)#
commitRP/0/RP0/CPU0:router(config-vc-class-atm)#
exitRP/0/RP0/CPU0:router(config)# interface atm 0/6/0/1.1
point-to-pointRP/0/RP0/CPU0:router(config-if)# pvc
10/100RP/0/RP0/CPU0:router(config-atm-vc)# class-vc
classARP/0/RP0/CPU0:router(config-atm-vc)#
Related Commands DescriptionCommand
Displays configuration information for the parameters on a VC
classthat is associated with a particular PVC.
show atm class-link, on page 51
Displays information about all ATM VC classes on the router or
fora specific ATM VC-class.
show atm vc-class, on page 79
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
20 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareclass-vc
-
encapsulation (ATM)To configure the ATM adaptation layer (AAL)
and encapsulation type for a virtual circuit (VC) class,
ATMpermanent virtual circuit (PVC), or ATM permanent virtual path
(PVP), use the encapsulation command inthe appropriate
configuration mode. To remove an encapsulation type, use the no
form of this command.
For point-to-point ATM PVCs and vc-classes:
encapsulation {aal5mux ipv4| aal5nlpid| aal5snap}
no encapsulation {aal5mux ipv4| aal5nlpid| aal5snap}
For ATM Layer 2 PVCs:
encapsulation {aal0| aal5}
no encapsulation {aal0| aal5}
Syntax Description Specifies IPv4 encapsulation for multiplex
(MUX)-type VCs.
The aal5mux ipv4 keywords are available in ATM PVC configuration
and ATMVC-class configuration modes only.
Note
aal5mux ipv4
Specifies the AAL and encapsulation type that allows ATM
interfaces to interoperate withHigh-Speed Serial Interfaces
(HSSIs), which are using an ATM data service unit (ADSU)and running
ATM-Data Exchange Interface (DXI). Supported on ATM PVCs only.
The aal5nlpid keyword is available in ATMPVC configuration and
ATMVC-classconfiguration modes only.
Note
aal5nlpid
Specifies the AAL encapsulation type that supports Inverse ARP.
Logical LinkControl/Subnetwork Access Protocol (LLC/SNAP) precedes
the protocol datagram.
The aal5snap keyword is available in ATMPVC configuration and
ATMVC-classconfiguration modes only.
Note
aal5snap
Specifies the AAL encapsulation type that contains 48 bytes of
data within an ATM cell.AAL0 cells are also referred to as raw
cells. The payload consists of 48 bytes.
The aal0 keyword is available in the ATM Layer 2 transport PVC
configurationmode only.
Note
aal0
Specifies the AAL encapsulation type that carries higher-layer
datagrams while enhancingthe link layer with services available
through ATM. AAL5 is defined in the ITU standardI.363.5, and is
typically used to carry IP datagrams over ATM.
The aal5 keyword is available in the ATM Layer 2 transport PVC
configurationmode only.
Note
aal5
Command Default For point-to-point PVCs, the default
encapsulation type is aal5snap.
For Layer 2 PVCs, the default encapsulation type is aal5.
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 21
ATM Commands on the Cisco IOS XR Softwareencapsulation (ATM)
-
Command Modes ATM PVC configuration (config-atm-vc)
ATM VC-class configuration (config-vc-class-atm)
ATM layer 2 transport PVC configuration
(config-atm-l2transport-pvc)
Command History ModificationRelease
This command was introduced.Release 3.7.0
Usage Guidelines Use the aal5mux ipv4 encapsulation option to
dedicate the specified PVC to a single protocol; use the
aal5snapencapsulation option to multiplex two or more protocols
over the same PVC. Whether you select aal5muxipv4 or aal5snap
encapsulation depends on the type of network you are configuring,
and the pricing offeredby that network. If the pricing of the
network depends on the number of PVCs set up, we recommend
aal5snapencapsulation. If pricing depends on the number of bytes
transmitted, we recommend aal5mux ipv4encapsulation because it has
less overhead than aal5snap and aal5mux ipv4 encapsulation.
If you configure VC-class parameters for a PVC after that PVC is
configured, you must enter the shutdowncommand followed by the no
shutdown command on the ATM subinterface that hosts the PVC. This
actionrestarts the interface, causing the newly configured VC-class
parameters to take effect on that interface.
Unless specifically configured otherwise, a PVC automatically
inherits the encapsulation type of the VC-classthat is assigned to
the main interface or subinterface that hosts the PVC. If no
VC-class is assigned, then thePVC inherits the encapsulation type
of the main interface or subinterface that hosts the PVC. If no
encapsulationis configured of the main interface or subinterface,
then the PVC inherits the default aal5snap encapsulation.
Use the encapsulation command in ATM PVC configuration mode to
modify the inherited or defaultencapsulation assigned to a PVC. You
can modify the encapsulation for each individual PVC to be
differentfrom the encapsulation configured for the VC-class that is
assigned to the ATMmain interface or subinterfacethat hosts the
PVC.
If you do not use the encapsulation command to configure the
encapsulation type for a new ATM PVC, thenthe PVC inherits the one
of the following default configurations (listed in order of
precedence from lowestto highest):
The encapsulation assigned to the VC-class that is assigned to
the PVC itself.
The encapsulation assigned to the VC-class that is assigned to
the ATM subinterface that hosts the PVC.
The encapsulation assigned to the VC-class that is assigned to
the ATM main interface that hosts thePVC
The default aal5snap encapsulation
When configuring a PVC range or an individual PVC within a PVC
range, the following encapsulation typesare supported:
encapsulation aal5mux ipv4
encapsulation aal5snap
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
22 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareencapsulation (ATM)
-
For Layer 2 PVCs, the default encapsulation type is aal5, and
the encapsulation type isnot inherited from the VC-class.
Note
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to configure a VC-class
with aal5snap encapsulation:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# vc
atm classARP/0/RP0/CPU0:router(config-vc-class-atm)# encapsulation
aal5snapThe following example shows how to configure an individual
PVC with aal5mux encapsulation:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/2/0/0.1
point-to-pointRP/0/RP0/CPU0:router(config-subif)# pvc
10/100RP/0/RP0/CPU0:router(config-atm-vc)# encapsulation aal5muxThe
following example shows how to remove aal5mux ipv4 encapsulation
from a VC-class:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# vc
atm classARP/0/RP0/CPU0:router(config-vc-class-atm)# no
encapsulation aal5mux ipv4The following example shows how to
configure an individual Layer 2 PVC with aal0 encapsulation:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/1.10
l2transportRP/0/RP0/CPU0:router(config-if)# pvc
30/300RP/0/RP0/CPU0:router(config-atm-l2transport-pvc)#
encapsulation aal0
Related Commands DescriptionCommand
Displays ATM PVC and traffic information for the entire
router.show atm pvc, on page 65
Displays information about all ATM VC classes on the router
orfor a specific ATM VC-class.
show atm vc-class, on page 79
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 23
ATM Commands on the Cisco IOS XR Softwareencapsulation (ATM)
-
interface atmTo configure an ATM interface and enter ATM
interface configuration mode, use the interface atm commandin
global configuration mode. To delete the interface configuration,
use the no form of this command.
interface atm interface-path-id[. subinterface][point-to-point|
l2transport]
no interface atm interface-path-id[. subinterface]
Syntax Description Physical interface or virtual interface
followed by the optional subinterfacepath ID. Naming notation is
interface-path-id..subinterface. The period in frontof the
subinterface value is required as part of the notation.
For more information about the syntax for the router, use the
question mark(?) online help function.
interface-path-id.[subinterface]
Interface functions as one endpoint of a point-to-point
link.point-to-point
Interface functions as one endpoint on an Layer 2
link.l2transport
Command Default No interfaces are configured.
Command Modes Global configuration (config)
Command History ModificationRelease
This command was introduced.Release 3.7.0
Usage Guidelines The interface command enters interface
configuration mode to allow you to configure interfaces. If a
virtualinterface is configured, then the interface is created if it
did not already exist.
When you issue the interface atm command in global configuration
mode, the CLI prompt changes toconfig-if, indicating that you have
entered interface configuration submode for an ATM interface.
Although the CLI prompt looks the same in the interface
configuration mode for an ATM main interfaceand for an ATM
subinterface, the commands that are available under each interface
type vary.
Note
In the following sample output, the question mark (?) online
help function displays all the commands availableunder the
interface configuration submode for a ATM main interface:
RP/0/RP0/CPU0:router(config)# interface atm
0/2/0/0RP/0/RP0/CPU0:router(config-if)#?
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
24 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareinterface atm
-
affinity Affinity to include/excludeatm Global ATM interface
configuration subcommandsbandwidth Set the bandwidth of an
interfacecdp Enable CDP on an interfaceclass-int Apply a VC
classcommit Commit the configuration changes to runningcrypto Set
crypto parametersdampening configure state dampening on the given
interfacedescribe Describe a command without taking real
actionsdescription Set description for this interfacedo Run an exec
commandexit Exit from this submodeflow Netflow
configurationframe-relay Frame Relay interface configuration
commandsipv4 IPv4 interface subcommandsipv6 IPv6 interface
subcommandsl2transport Enable Layer 2 transport and enter its
configuration submodeload-interval Specify interval for load
calculation for an interfacempls MPLS interface subcommandsmtu Set
the MTU on an interfaceno Negate a command or set its defaultspvc
Configure a pvc on this interfaceroot Exit to the global
configuration modeshow Show contents of configuration
--More--
In the following sample output, the question mark (?) online
help function displays all the commands availableunder the
interface configuration submode for a point-to-point ATM
subinterface:
RP/0/RP0/CPU0:router(config)# interface atm 0/2/0/0.1
point-to-pointRP/0/RP0/CPU0:router(config-if)# ?
affinity Affinity to include/excludebandwidth Set the bandwidth
of an interfacecdp Enable CDP on an interfaceclass-int Apply a VC
classcommit Commit the configuration changes to runningcrypto Set
crypto parametersdampening configure state dampening on the given
interfacedescribe Describe a command without taking real
actionsdescription Set description for this interfacedo Run an exec
commandexit Exit from this submodeflow Netflow
configurationframe-relay Frame Relay interface configuration
commandsipv4 IPv4 interface subcommandsipv6 IPv6 interface
subcommandsload-interval Specify interval for load calculation for
an interfacelogging Per-interface logging configurationmpls MPLS
interface subcommandsmtu Set the MTU on an interfaceno Negate a
command or set its defaultspvc Configure a pvc on this
interfaceroot Exit to the global configuration modeshow Show
contents of configurationshutdown shutdown the given interface
--More--
In the following sample output, the question mark (?) online
help function displays all the commands availableunder the
interface configuration submode for an ATM Layer 2
subinterface:
RP/0/RP0/CPU0:router(config)#interface atm 0/2/0/0.1
l2transportRP/0/RP0/CPU0:router(config-if)#?
bandwidth Set the bandwidth of an interfacecdp Enable CDP on an
interfacecommit Commit the configuration changes to runningcrypto
Set crypto parametersdampening configure state dampening on the
given interface
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 25
ATM Commands on the Cisco IOS XR Softwareinterface atm
-
describe Describe a command without taking real
actionsdescription Set description for this interfacedo Run an exec
commandexit Exit from this submodefirewall Configure a Virtual
Firewall on this Interfaceflow Netflow configurationframe-relay
Frame Relay interface configuration commandsipv4 IPv4 interface
subcommandsipv6 IPv6 interface subcommandsload-interval Specify
interval for load calculation for an interfacelogging Per-interface
logging configurationmpls MPLS interface subcommandsmtu Set the MTU
on an interfaceno Negate a command or set its defaultspvc Configure
a pvc on this interfacepvp Configure a pvp on this interfacepwd
Commands used to reach current submoderoot Exit to the global
configuration modeshow Show contents of configuration
Cisco IOS XR software supports bulk removal of subinterfaces. To
remove several subinterfaces with a singlecommand enter, replace
the subinterface argument with an asterisk (*), as shown in the
following example:
RP/0/RP0/CPU0:router(config)# no interface atm 0/6/0/1.*
Before you can perform a bulk removal of several subinterfaces,
OAM F5 loopback cell generation mustbe enabled on the PVCs that are
configured under the subinterfaces you want to remove. To enable
OAMF5 loopback cell generation on a PVC, use the oam-pvc manage, on
page 32 command.
Note
The l2transport keyword is mutually exclusive with any Layer 3
interface configuration.Note
Task ID OperationsTask ID
read, writeinterface
Examples The following example shows how to enter interface
configuration mode for the ATM main interface 1 inslot 6:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/6/0/1RP/0/RP0/CPU0:router(config-if)#
The following example shows how to enter ATM interface
configurationmode for a point-to-point subinterface.In this
example, the user adds a subinterface to the ATM main interface 0
in slot 2:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/2/0/0.1
point-to-pointRP/0/RP0/CPU0:router(config-if)#
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
26 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareinterface atm
-
The following example shows how to enter ATM interface
configuration mode for a Layer 2 subinterface. Inthis example, the
user adds a subinterface to the ATM main interface 0 in slot 2:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/2/0/0.1
l2transportRP/0/RP0/CPU0:router(config-if)#
Related Commands DescriptionCommand
Displays ATM-specific information about an ATM interface.show
atm interface atm, on page 58
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 27
ATM Commands on the Cisco IOS XR Softwareinterface atm
-
l2transport (ATM)To enable Layer 2 transport port mode on an ATM
interface and enter Layer 2 transport configuration mode,use the
l2transport command in interface configuration mode. To disable
Layer 2 transport port mode on anATM interface, use the no form of
this command.
l2transport
no l2transport
Syntax Description This command has no keywords or
arguments.
Command Default No default behavior or values
Command Modes Interface configuration (config-if)
Command History ModificationRelease
This command was introduced.Release 3.7.0
Usage Guidelines When you issue the l2transport command in
interface configuration mode, the CLI prompt changes
toconfig-if-l2, indicating that you have entered the Layer 2
transport configuration submode. In the followingsample output, the
question mark (?) online help function displays all the commands
available under Layer2 transport configuration submode for an ATM
interface:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/2/0/0RP/0/RP0/CPU0:router(config-if)#
l2transportRP/0/RP0/CPU0:router(config-if-l2)# ?
cell-packing Configure L2VPN cell packing parameterscommit
Commit the configuration changes to runningdescribe Describe a
command without taking real actionsdo Run an exec commandexit Exit
from this submodeno Negate a command or set its defaultspwd
Commands used to reach current submoderoot Exit to the global
configuration modeservice-policy Configure QoS Service policyshow
Show contents of configuration
RP/0/RP0/CPU0:router(config-if-l2)#
The l2transport command is mutually exclusive with any Layer 3
interface configuration.Note
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
28 OL-26065-03
ATM Commands on the Cisco IOS XR Softwarel2transport (ATM)
-
Task ID OperationsTask ID
read, writel2vpn
Examples The following example shows how to enable Layer 2
transport port mode on an ATM interface and enterLayer 2 transport
configuration mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface ATM 0/2/0/0RP/0/RP0/CPU0:router(config-if)#
l2transportRP/0/RP0/CPU0:router(config-if-l2)#
Related Commands DescriptionCommand
Displays brief information on configured xconnects.show l2vpn
xconnect
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 29
ATM Commands on the Cisco IOS XR Softwarel2transport (ATM)
-
oam ais-rdiTo configure the behavior of an ATM permanent virtual
circuit (PVC) when it receives Operation,Administration, and
Maintenance (OAM) alarm indication signal and remote defect
indication (AIS/RDI)cells, use the oam ais-rdi command in ATM PVC
configuration or ATM VC-class configuration mode. Toreturn the PVC
to the default behavior, use the no form of this command.
oam ais-rdi [down-count [ up-count ]]
no oam ais-rdi [down-count [ up-count ]]
Syntax Description (Optional) Number of consecutive OAM AIS/RDI
cells received on a PVC before thatPVC is brought down. Range is
from 1 through 60. The default is 1.
down-count
(Optional) Number of seconds after which a down PVC is brought
up if no OAMAIS/RDIcells are received. Range is from 3 through 60.
The default is 3.
The specified up-count applies under the following conditions
only:
OAM F5 loopback cell generation must be enabled on the PVC.
The PVC is in a down state because it received AIS/RDI
cells.
To enable OAMF5 loopback cell generation on a PVC, use the
oam-pvc manage,on page 32 command.
Note
up-count
Command Default down-count: 1
up-count: 3
Command Modes ATM VC-class configuration
(config-vc-class-atm)
ATM PVC configuration (config-atm-vc)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines Use the oam ais-rdi command to configure the
following:
the maximum number of Operation, Administration, and Maintenance
(OAM) alarm indication signalsand remote defect indication
(AIS/RDI) cells that can be received on a PVC before it is brought
down.
the interval after which a downed PVC comes back up if no OAM
AIS/RDI cells have been received.
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
30 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareoam ais-rdi
-
Use the oam ais-rdi command in ATM PVC configuration mode to
configure the OAMAIS/RDI down countand up count for a specific
PVC.
Use the oam ais-rdi command in ATM VC-class configuration mode
to configure the OAM AIS/RDI downcount and up count for all PVCs
that are associated with the specified class map.
Keep the following in mind when configuring the OAM AIS/RDI down
count and up count:
Unless specifically configured otherwise, a PVC automatically
inherits the OAM AIS/RDI down countand up count of the VC-class
that is assigned to the main interface or subinterface that hosts
the PVC.
If the OAM AIS/RDI down count and up count is not configured for
the VC-class, or if no VC-class isassigned to the main interface or
subinterface that hosts the PVC, or to the PVC itself, then the
PVCinherits the default OAM AIS/RDI down count and up count.
The default values for the OAM AIS/RDI down count and up count
are used in the following situations:
If the oam ais-rdi command has not been entered
If the oam ais-rdi command is entered without the up-count or
down-count argument
If the no oam ais-rdi command is entered
If the oam ais-rdi command is entered without the up-count or
down-count argument, the command does notappear in the show
running-config command output.
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to bring down a PVC
after 25 consecutive OAMAIS/RDI cells have beenreceived on the PVC.
The PVC is brought up when no OAMAIS/RDI cells have been received
for 5 seconds.
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/2/0/0.1
point-to-pointRP/0/RP0/CPU0:router(config-subif)# pvc
50/100RP/0/RP0/CPU0:router(config-atm-vc)# oam ais-rdi 25 5The
following example shows how to configure the OAMAIS/RDI down count
and up count for a VC-class.In this example, all PVCs that are
associated with the VC-class called classA inherit an OAM
AIS/RDIdown count of 30 and up count of 10:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# vc
atm classARP/0/RP0/CPU0:router(config-vc-class-atm)# oam ais-rdi 30
10
Related Commands DescriptionCommand
Displays configuration information for the parameters on a VC
classthat is associated with a particular PVC.
show atm class-link, on page 51
Displays ATM PVC and traffic information for the entire
router.show atm pvc, on page 65
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 31
ATM Commands on the Cisco IOS XR Softwareoam ais-rdi
-
oam-pvc manageTo enable ATMOperation, Administration,
andMaintenance (OAM) F5 loopback cell generation and
configurecontinuity check (CC) management for an ATM permanent
virtual circuit (PVC), use the oam-pvc managecommand in ATM PVC
configuration or ATM VC-class configuration mode. To disable OAM F5
continuitychecking on a PVC, use the no form of this command.
In ATM PVC configuration mode:
oam-pvc manage [f requency] [disable] [keep-vc-up
[seg-aisrdi-failure]]
no oam-pvc manage [frequency] [disable] [keep-vc-up
[seg-aisrdi-failure]]
In ATM VC class configuration mode:
oam-pvc manage [frequency]
no oam-pvc manage [frequency]
Syntax Description (Optional) Frequency (in seconds) at which
end-to-end F5 OAM loopback cells aretransmitted. Range is from 0
through 600.
frequency
(Optional) Disables OAM management on the specified PVC.
The disable keyword is available in ATM PVC configuration
modeonly.
Note
disable
(Optional) Specifies that PVC remains in the UP state when CC
cells detectconnectivity failure.
The keep-vc-up keyword is available in ATM PVC configuration
modeonly.
Note
keep-vc-up
(Optional) Specifies that if segment AIS/RDI cells are received,
the VC will not bebrought down because of end CC failure or
loopback failure.
The seg-aisrdi-failure keyword is available in ATM PVC
configurationmode only.
Note
seg-aisrdi-failure
Command Default frequency: 10 seconds
Command Modes ATM PVC configuration (config-atm-vc)
ATM VC class configuration (config-vc-class-atm)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
32 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareoam-pvc manage
-
Usage Guidelines Keep the following in mind when configuring the
OAM F5 loopback cell generation and CC managementfor an ATM
PVC:
Unless specifically configured otherwise, a PVC automatically
inherits the OAM F5 loopback cellmanagement configuration from the
VC-class that is assigned to the main interface or subinterface
thathosts the PVC.
If OAM F5 loopback cell generation is not enabled for the
assigned VC-class, or if no VC-class isassigned to the PVC itself,
or to main interface or subinterface that hosts the PVC, then OAMF5
loopbackcell generation is disabled on that PVC. To enable OAM F5
loopback cell generation on that PVC, youneed to use the oam-pvc
manage command in ATM PVC configuration mode.
VC-classes support the configuration of the seconds argument
only; the keep-vc-up, disable, andseg-aisrdi-failure keywords are
available in ATM PVC configuration mode only and are
configureddirectly on each individual PVC.
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to enable OAMF5
loopback cell generation on a PVC, and configure thePVC to remain
up when CC cells detect connectivity failure:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/2/0/0.1
point-to-pointRP/0/RP0/CPU0:router(config-subif)# pvc
10/100RP/0/RP0/CPU0:router(config-atm-vc)# oam-pvc manage 200
keep-vc-upThe following example shows how to disable OAMF5 loopback
cell generation on a PVC:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/2/0/0.1
point-to-pointRP/0/RP0/CPU0:router(config-subif)# pvc
10/100RP/0/RP0/CPU0:router(config-atm-vc)# oam-pvc manage
disableThe following example shows how to configure the OAM F5
loopback frequency for a VC-class. In thisexample, all PVCs
associated with the VC-class called classA transmit end-to-end F5
OAM loopback cellsevery 300 seconds:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# vc
atm classARP/0/RP0/CPU0:router(config-vc-class-atm)# oam-pvc manage
300The following example shows how to remove the configured ATM OAM
F5 loopback frequency from aVC-class:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# vc
atm classARP/0/RP0/CPU0:router(config-vc-class-atm)# no oam-pvc
manage
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 33
ATM Commands on the Cisco IOS XR Softwareoam-pvc manage
-
Related Commands DescriptionCommand
Displays configuration information for the parameters on a VC
classthat is associated with a particular PVC.
show atm class-link, on page 51
Displays ATM PVC and traffic information for the entire
router.show atm pvc, on page 65
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
34 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareoam-pvc manage
-
oam retryTo configure the number of F5 Operation,
Administration, and Maintenance (OAM) loopback cells that needto be
successfully transmitted by a down ATM permanent virtual circuit
(PVC) before it is brought up, usethe oam retry command in ATM PVC
configuration or ATM VC-class configuration mode. To return thePVC
to the default behavior, use the no form of this command
oam retry [up-count [down-count [ retry-frequency ]]]
no oam retry [up-count [down-count [ retry-frequency ]]]
Syntax Description (Optional) Number of consecutive end-to-end
F5 OAM loopback cell responses thatmust be received to change a
connection state to up.
retry-count
(Optional) Number of consecutive unreceived end-to-end F5 OAM
loopback cellsallowed on a PVC before its state changes to
down.
down-count
(Optional) Frequency (in seconds) at which end-to-end F5 OAM
loopback cells aretransmitted when a change in the up or down state
is being verified. For example, ifa PVC is up and a loopback cell
response is not received after the frequency (in seconds)is
specified using the oam-pvc manage command, loopback cells are sent
at the retryfrequency to verify whether the PVC is down.
retry-frequency
Command Default up-count: 3
down-count: 5
retry-frequency: 1 second
Command Modes ATM PVC configuration (config-atm-vc)
ATM VC-class configuration (config-vc-class-atm)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines Keep the following in mind when configuring the
OAM AIS/RDI down count and up count:
Unless specifically configured otherwise, a PVC automatically
inherits the OAM AIS/RDI down countand up count of the VC-class
that is assigned to the main interface or subinterface that hosts
the PVC.
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 35
ATM Commands on the Cisco IOS XR Softwareoam retry
-
If no encapsulation is configured for the VC-class, or if no
VC-class is assigned to the main interfaceor subinterface that
hosts the PVC, or to the PVC itself, then the PVC inherits the
default OAMAIS/RDIdown count and up count.
Keep the following in mind when configuring the F5 OAM loopback
cell up count, down count, and retryfrequency:
Unless specifically configured otherwise, a PVC automatically
inherits the F5 OAM loopback cell upcount, down count, and retry
frequency of the VC-class that is assigned to the main interface
orsubinterface that hosts the PVC.
If the F5 OAM loopback cell up count, down count, and retry
frequency are not configured for theVC-class, or if no VC-class is
assigned to the PVC itself, or to the main interface or
subinterface thathosts the PVC, then the PVC inherits the default
F5 OAM loopback cell up count, down count, and retryfrequency.
In other words, if the oam retry command is not explicitly
configured on an individual PVC, then that PVCinherits the
following default configuration (listed in order of
precedence):
F5 OAM loopback cell up count, down count, and retry frequency
configured for the VC-class that isassigned to the PVC itself
F5 OAM loopback cell up count, down count, and retry frequency
configured for VC-class assigned tothe ATM subinterface that hosts
the PVC
F5 OAM loopback cell up count, down count, and retry frequency
configured for the VC-class assignedto the ATM main interface that
hosts the PVC
For the defaults, it is assumed that OAM loopback cell
generation is enabled on the PCV. To enable OAMF5 loopback cell
generation, use the oam-pvc manage command.
Note
Task ID OperationsTask ID
read, writeatm
Examples The following example shows how to OAM management
parameters for an ATM PVC. In this example, thePVC is brought down
after five consecutive OAMAIS/RDI cells are received and then
brought back up whenno OAMAIS/RDI cells are received for 10
seconds. End-to-end F5OAM loopback cells are transmitted everyfive
seconds if a change in the up or down state is verified.
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/2/0/0.1
point-to-pointRP/0/RP0/CPU0:router(config-subif)# pvc
10/100RP/0/RP0/CPU0:router(config-atm-vc)# oam retry 5 10 5
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
36 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareoam retry
-
The following example shows how to configure OAMmanagement
parameters for a VC-class. In this example,all PVCs that are
associated with the VC-class called classA inherit an OAM up-count
of 3, down-count of5, and retry-frequency of 10:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# vc
atm classARP/0/RP0/CPU0:router(config-vc-class-atm)# oam retry 10
20 10
Related Commands DescriptionCommand
Displays configuration information for the parameters on a VC
classthat is associated with a particular PVC.
show atm class-link, on page 51
Displays ATM PVC and traffic information for the entire
router.show atm pvc, on page 65
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 37
ATM Commands on the Cisco IOS XR Softwareoam retry
-
ping atm interface atmTo verify connectivity between two ATM
connection endpoints through a permanent virtual circuit (PVC)or
VP-tunnel, use the ping atm interface atm command in EXEC mode.
ping atm interface atm interface-path-id [. subinterface]
[vpi/vci] [end-loopback packets| seg-loopbackpackets] [timeout
seconds]
Syntax Description Physical interface or virtual interface
followed by the optional subinterface pathID. Naming notation is
interface-path-id.subinterface. The period in front of
thesubinterface value is required as part of the notation.
For more information about the syntax for the router, use the
question mark (?)online help function.
interface-path-id[.subinterface]
(Optional) ATM virtual path identifier (VPI) and virtual channel
identifier (VCI)numbers. The absence of the slash (/) and a vpi
value defaults the vpi value to 0.
A VPI of 0 is not applicable to VP-tunnels or Layer 2PVPs.
Note
vpi/vci
(Optional) Sends a specified number of end-to-end OAM loopback
packets overthe connection. Replace packets with the number of
end-to-end OAM loopbackpackets you want to send over the ATM
interface.
end-loopback packets
(Optional) Sends a specified number of segmented OAM loopback
packets overthe connection. Replace packets with the number of OAM
loopback packets youwant to send over the ATM interface.
seg-loopback packets
Predetermined time during which the destination can send an OAM
loopbackresponse cell back to the source. Replace seconds with
number of seconds to waitfor an OAM loopback response before the
ping times out. The default value of thetimeout is 2 seconds on
Cisco routers.
timeout seconds
Command Default seconds: 2
Command Modes EXEC (#)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines The following guidelines apply to PVCs and
VC-classes.
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
38 OL-26065-03
ATM Commands on the Cisco IOS XR Softwareping atm interface
atm
-
The ping atm interface atm command sends an OAM packet to verify
ATM PVC connectivity. The statusof the PVC is displayed when a
response to the OAM packet is received. This is a common method for
testingthe accessibility of the devices.
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.
For the interface-path-id argument, use the following
guidelines:
If specifying a physical interface, the naming notation is
rack/slot/module/port. The slash between valuesis required as part
of the notation. An explanation of each component of the naming
notation is as follows:
rack: Chassis number of the rack.
slot: Physical slot number of the line card.
module: Module number. A physical layer interface module (PLIM)
is always 0.
port: Physical port number of the interface.
If specifying a virtual interface, the number range varies,
depending on interface type.
Include the end-loopback packets keyword argument with the ping
atm interface atm command to verifyend-to-end PVC integrity.
Include the seg-loopback packets keyword argument with the ping
atm interface atm command to verifyPVC integrity to the immediate
neighboring ATM device.
The ping command is not available for Layer 2 ACs.Note
Task ID OperationsTask ID
executebasic-services
readatm
Examples The following example shows how verify connectivity
between two ATM connection endpoints through aPVC with a VPI of 10
and a VCI of 100.
RP/0/RP0/CPU0:router# ping atm interface atm 0/2/0/0.10
10/100
Related Commands DescriptionCommand
Displays ATM-specific information about an ATM interface.show
atm interface atm, on page 58
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 39
ATM Commands on the Cisco IOS XR Softwareping atm interface
atm
-
pvc (ATM)To create an ATM permanent virtual circuit (PVC) with
Interim Local Management Interface (ILMI)encapsulation and enter
ATMvirtual circuit configurationmode, use the pvc command in
interface configurationmode or subinterface configuration mode. To
remove an ATM PVC from an interface, use the no form ofthis
command.
In interface configuration mode for a point-to-point ATM main
interface:
pvc vpi/vci ilmi
no pvc vpi/vci ilmi
In interface configuration mode for an ATM subinterface:
pvc vpi/vci
no pvc vpi/vci
Syntax Description ATM network virtual path identifier (VPI) for
this PVC.
If support for the 12-bits VPI Network-Node Interface (NNI) cell
format is enabled on the ATMmain interface that hosts this PVC,
then the range is from 0 through 4095.
If support for the 12-bits VPI NNI cell format is not enabled on
the host ATM main interface,then the range is from 0 through
255.
To enable support for the 12-bits VPI NNI cell format on the
main ATM interface hostingthe specified PVC, use the atm
maxvpi-bits 12 command.
Note
vpi/
ATM network virtual channel identifier (VCI) for this PVC. Range
is from 1 through 65535.
The VCI is a 16-bit field in the header of the ATM cell. The VCI
value is unique only on a singlelink, not throughout the ATM
network, because it has local significance only.
Typically, lower values from 1 through 18 are reserved for
specific traffic (for example,F4 OAM, ILMI, and so on), and should
not be used.
Note
The vpi and vci arguments cannot both be set to 0; if one is 0,
the other cannot be0.
Note
vci
Sets up communication with the Interim LocalManagement Interface
(ILMI). The associated VPIis 0, and VCI the associated VCI is any
VCI.
VCI 16 is typically used forILMI.
Note
The ilmi keyword is available for point-to-point ATM
interfacesonly.
Note
ilmi
Command Default No PVC is defined.
Command Modes Interface configuration (config-if)
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release4.2.x
40 OL-26065-03
ATM Commands on the Cisco IOS XR Softwarepvc (ATM)
-
Subinterface configuration (config-subif)
Command History ModificationRelease
This command was introduced.Release 3.9.2
Usage Guidelines The pvc command creates a PVC and attaches it
to the specified VPI and VCI. Both the vpi and vci argumentscannot
be simultaneously specified as 0; if one is 0, the other cannot be
0.
Cisco IOS XR software dynamically creates rate queues as
necessary to satisfy the requests of the PVCcommands.
When you issue the pvc command in interface or subinterface
configuration mode for a point-to-point ATMmain interface, the CLI
prompt changes to config-atm-vc, indicating that you have entered
the ATM virtualcircuit configuration submode.
Although the CLI prompt looks the same for the ATM virtual
circuit configuration submode under theATM main interface and the
ATM subinterface in point-to-point configurations, the commands
that areavailable under each interface type vary.
Note
When you issue the pvc command in subinterface configuration
mode for an ATM AC, the CLI promptchanges to
config-atm-l2transport-pvc, indicating that you have entered the
ATM layer 2 transport PVCconfiguration submode.
For the 4-Port OC-3 and 4-Port OC-12 line cards, the VCI range
is 19 through 65535.Note
In the following sample output, the question mark (?) online
help function displays all the commands availableunder the ATM
virtual circuit configuration submode for the main ATM
interface:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)#
interface atm 0/2/0/0.1
point-to-pointRP/0/RP0/CPU0:router(config-if)# pvc
10/100RP/0/RP0/CPU0:router(config-atm-vc ?
commit Commit the configuration changes to runningdescribe
Describe a command without taking real actionsdo Run an exec
commandexit Exit from this submodeno Negate a command or set its
defaultsroot Exit to the global configuration mode
RP/0/0/CPU0:router(config-atm-vc)#
In the following sample output, the question mark (?) online
help function displays all the commands availableunder the ATM
virtual circuit configuration submode for the ATM subinterface:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config-if)#
interface atm 0/2/0/0.1
point-to-pointRP/0/RP0/CPU0:router(config-subif)# pvc
20/200RP/0/RP0/CPU0:router(config-atm-vc)# ?
class-vc Configure vc-class
Cisco IOS XR Interface and Hardware Component Command Reference
for the Cisco CRS Router, Release 4.2.x
OL-26065-03 41
ATM Commands on the Cisco IOS XR Softwarepvc (ATM)
-
commit Commit the configuration changes to runningdescribe
Describe a command without taking real actionsdo Run an exec
commandencapsulation Configure encapsulation on this PVCexit Exit
from this submodeno Negate a command or set its defaultsoam
Configure ATM OAM VC commandsoam-pvc Enter OAM to generate OAM
cellsroot Exit to the global configuration modeservice-policy
Configure QoS Service policyshape ATM Traffic Shapingshow Show
contents of configuration
RP/0/RP0/CPU0:router(config-atm-vc)#
In the following sample output, the question mark (?) online
help function displays all the commands availableunder the ATM
layer 2 transport PVC configuration submode for the ATM
interface:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config-if)#
interface atm 0/2/0/0.