Guest

Cisco IOS Software Releases 12.2 T

Frame Relay PVC Bundles with IP and MPLS QoS Support

Table Of Contents

Frame Relay PVC Bundles with QoS Support for IP and MPLS

Contents

Prerequisites for Frame Relay PVC Bundles with QoS Support for IP and MPLS

Restrictions for Frame Relay PVC Bundles with QoS Support for IP and MPLS

Information About Frame Relay PVC Bundles with QoS Support for IP and MPLS

Benefits of Frame Relay PVC Bundles with QoS Support for IP and MPLS

Frame Relay PVC Bundle Support

Service Levels and PVC Selection Criteria

Frame Relay PVC Bundle Management

Traffic Bumping

PVC-Bundle Protection Rules

MPLS EXP-based Mapping

How to Configure Frame Relay PVC Bundles with QoS Support for IP and MPLS

Configuring Frame Relay PVC Bundles with IP QoS Support

Configuring Frame Relay PVC Bundles with MPLS QoS Support

Verifying Frame Relay PVC Bundles Configuration

Monitoring and Maintaining Frame Relay PVC Bundles

Configuration Examples for Frame Relay PVC Bundles with QoS Support for IP and MPLS

PVC Bundles with IP QoS Support on Main, Multipoint, and Point-to-Point Interfaces Example

PVC Bundle with IP QoS Support with Multiple QoS Parameters Example

PVC Bundle with MPLS QoS Support Example

Verifying Frame Relay PVC Bundle Configuration Examples

Monitoring and Maintaining Frame Relay PVC Bundles Examples

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

bump (Frame Relay VC-bundle-member)

class

debug frame-relay adjacency

debug frame-relay vc-bundle

dscp (Frame Relay VC-bundle-member)

encapsulation (Frame Relay VC-bundle)

exp

frame-relay inverse-arp

frame-relay map

frame-relay vc-bundle

inarp (Frame Relay VC-bundle-member)

match

precedence (Frame Relay VC-bundle-member)

protect (Frame Relay VC-bundle-member)

pvc (Frame Relay VC-bundle)

show frame-relay ip rtp header-compression

show frame-relay ip tcp header-compression

show frame-relay map

show frame-relay pvc

show frame-relay vc-bundle

Glossary


Frame Relay PVC Bundles with QoS Support for IP and MPLS


First Published: November 25, 2002
Last Updated: February 28, 2006

Frame Relay permanent virtual circuit (PVC) bundle functionality allows you to associate a group of Frame Relay PVCs with a single next-hop address. When Frame Relay PVC bundles are used with IP, packets are mapped to specific PVCs in the bundle on the basis of the precedence value or differentiated services code point (DSCP) settings in the type of service (ToS) field of the IP header. Each packet is treated differently according to the QoS configured for each PVC.

MPLS QoS support for Frame Relay PVC bundles extends Frame Relay PVC bundle functionality to support the mapping of Multiprotocol Label Switching (MPLS) packets to specific PVCs in the bundle. MPLS packets are mapped to PVCs according to the settings of the experimental (EXP) bits in the MPLS packet header.

History for the Frame Relay PVC Bundles with QoS Support for IP and MPLS Feature

Release
Modification

12.2(13)T

This feature was introduced.

12.2(28)SB

This feature was integrated into Cisco IOS Release 12.2(28)SB.


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 Frame Relay PVC Bundles with QoS Support for IP and MPLS

Restrictions for Frame Relay PVC Bundles with QoS Support for IP and MPLS

Information About Frame Relay PVC Bundles with QoS Support for IP and MPLS

How to Configure Frame Relay PVC Bundles with QoS Support for IP and MPLS

Configuration Examples for Frame Relay PVC Bundles with QoS Support for IP and MPLS

Additional References

Command Reference

Glossary

Prerequisites for Frame Relay PVC Bundles with QoS Support for IP and MPLS

To implement Frame Relay PVC bundles between two routers, you must enable IP Cisco Express Forwarding switching on the routers.

To configure MPLS EXP levels on bundle member PVCs, you must have tag-switching enabled on the interface.

It is recommended (but not required) that you implement PVC Interface Priority Queueing (PIPQ) in conjunction with Frame Relay PVC bundles. This will ensure that if the interface becomes congested, higher-priority traffic can exit the interface ahead of lower-priority traffic.

Restrictions for Frame Relay PVC Bundles with QoS Support for IP and MPLS

A PVC can be a part of one and only one PVC bundle.

A PVC bundle may contain no more than eight PVCs.

A PVC that is a bundle member cannot be used in any other capacity, For example a PVC bundle member cannot be configured in a map statement.

A PVC bundle cannot perform precedence and DSCP matching at the same time. If the wrong matching scheme is configured, unpredictable behavior will result.

A PVC bundle will not come up unless all the precedence, DSCP, or EXP levels are configured in the bundle.

Voice over Frame Relay (VoFR) is not supported on PVC-bundle members.

Fast switching over Frame Relay PVC bundles is not supported.

Information About Frame Relay PVC Bundles with QoS Support for IP and MPLS

Before configuring and implementing Frame Relay PVC Bundles with QoS Support for IP and MPLS, you should understand the following concepts:

Benefits of Frame Relay PVC Bundles with QoS Support for IP and MPLS

Frame Relay PVC Bundle Support

Frame Relay PVC Bundle Management

Benefits of Frame Relay PVC Bundles with QoS Support for IP and MPLS

IP or MPLS packets carrying different types of traffic can be transported on different PVCs within the same PVC bundle.

Precedence-based PVC bundles can be converted to EXP-based PVC bundles by enabling tag-switching. EXP-based PVC bundles can be converted to precedence-based PVC bundles by disabling tag-switching.

This feature provides flexible PVC management within a PVC bundle by allowing traffic assigned to a failed PVC to be redirected to an alternate PVC within the bundle. This feature also allows you to configure the bundle to go down when certain PVCs go down.

Frame Relay PVC Bundle Support

The use of Frame Relay PVC bundles allows you to configure multiple PVCs with different QoS characteristics between any pair of Frame Relay-connected routers. As shown in Figure 1, a PVC bundle may contain up to eight PVCs. The individual PVCs within a bundle are called bundle members.

To determine which PVC in a bundle will be used to forward a specific type of traffic, the router maps the IP precedence level or DSCP value in an IPv4 packet header to a PVC configured with the same value. In the case of MPLS, packets are mapped to specific PVCs in a bundle based on the settings of the EXP bits in the MPLS packet headers.

Once you define a Frame Relay bundle and add PVCs to it, you can configure attributes and characteristics to discrete PVC bundle members, or you can apply them collectively at the bundle level. Frame Relay traffic shaping may be applied to every PVC within a bundle. As with individual PVCs, you can enable rate adaptation to occur in response to incoming backward explicit congestion notifications (BECN) from the network.

Figure 1 Frame Relay PVC bundle

You can create differentiated service using PVC bundles by distributing IP precedence levels or DSCP values over the various bundle members. You can map either a single precedence level or a range of precedence levels to each PVC in the bundle. Thus, either you can limit an individual PVC to carry only packets marked with a specific precedence level or you can enable a PVC to carry packets marked with different precedence levels.

Service Levels and PVC Selection Criteria

The DSCP and Precedence bits classify IP packet service levels. The Precedence field consists of the first three bits of the ToS octet in the IPv4 header. These bits define eight precedence levels. When DSCP mapping is used, the DSCP octet replaces the ToS octet in the IPv4 header. Currently the first six bits are used, defining 64 service levels.

Using precedence-based or DSCP-based mapping, each IPv4 packet is mapped to a specific PVC in the bundle, according to the value of the ToS or DSCP octet in the IP header. There is no special treatment for broadcast or multicast or IP routing packets; the only differentiation in treatment is a result of the ToS or DSCP octet settings.

The MPLS EXP bits make up a three-bit experimental field in the MPLS packet header. They are a bit-by-bit copy of the IP Precedence bits and provide the same eight QoS levels. Under MPLS EXP-based mapping, each MPLS packet is mapped to a specific PVC in the bundle, according the setting of the EXP bits.

Frame Relay PVC Bundle Management

In addition to mapping specific traffic types to specific PVCs according to QoS parameters designated by the ToS or DSCP values in the IPv4 headers or EXP values in the MPLS headers, PVC bundle management takes care of handling non-IP traffic and determining what happens if a PVC goes down.

By default, Inverse Address Resolution Protocol (ARP) traffic and other critical non-IP traffic is carried by the PVC configured for carrying IP Precedence or EXP level 6 or DSCP level 63. You can select a PVC with a different QoS to carry Inverse ARP traffic if required. Noncritical non-IP traffic is carried by the PVC that configured for carrying IP precedence, EXP, or DSCP level 0.

It is important during configuration to account for every precedence, EXP, or DSCP level in the configuration of the PVC bundle members. If all the packet service levels are not accounted for, the PVC bundle will never come up.

Once a PVC bundle is up, if an individual bundle member goes down, an attempt is made to identify an alternate PVC to handle the packet service level or levels that were carried by the downed PVC. If no alternate PVC is found, the entire PVC bundle is brought down.

Traffic Bumping

You can configure each PVC bundle member to bump traffic to another PVC in the bundle in the event that the bundle member goes down. You can specify whether the bumping will be implicit or explicit bumping. You can also specify that a particular PVC will never accept bumped traffic from another PVC. The default conditions are to perform implicit traffic bumping and to accept bumped traffic.

Implicit bumping diverts the traffic from a failed PVC to the PVC having the next-lower service level. Explicit bumping forces the traffic to a specific PVC rather than allowing it to find a PVC carrying traffic of the next-lower service level. For example, PVC x, responsible for carrying precedence level 3 traffic, can be configured to bump its traffic to PVC y, responsible for carrying precedence level 6 traffic—provided that PVC y is configured to accept bumped traffic. If PVC x goes down, PVC y takes over. If PVC y is already down or goes down later, the alternate PVC selected will depend on the bumping rule for PVC y. If no alternate PVC can be found for bumped traffic, the entire PVC bundle goes down.

PVC-Bundle Protection Rules

Traffic bumping provides a way to keep a PVC bundle up and traffic flowing even though some individual PVCs may be down. Protection rules provide a way to force the PVC bundle down even though some individual PVCs are up and might be able to handle all the traffic, though perhaps not in a satisfactory manner.

You can configure a PVC bundle member as an individually protected PVC or as part of a PVC bundle protected group. Only one protected group may exist within a PVC bundle; however, many individually protected PVCs may exist. The protection rules add flexibility for controlling the PVC bundle state.

When any one individually protected PVC goes down, the entire bundle goes down. If all the PVCs in a protected group go down, the entire bundle goes down.

If no protection rule is specified, the PVC bundle goes down only when all the PVCs go down. However, protection is overridden if a PVC that has no place to bump its traffic goes down. In this case, the entire bundle will go down despite any protection rules that have been set up.

MPLS EXP-based Mapping

To enable MPLS EXP-based mapping, tag-switching must be enabled on the interface or subinterface by using the tag-switching ip command. When tag-switching is enabled, MPLS and IP packets can flow across the interface and PVC bundles that are configured for IP Precedence mapping are converted to MPLS EXP mapping. The PVC bundle functionality remains the same with respect to priority levels, bumping, and so on, but the match precedence command is replaced by match exp, and each precedence command is replaced by the exp command. The effect is that a bundle member PVC previously configured to carry precedence level 1 IP traffic now carries EXP level 1 MPLS traffic.

PVC bundles configured for DSCP mapping go down when tag-switching is enabled. The DSCP configuration for each bundle member PVC is reset, resulting in the PVCs being unmapped and Inverse ARP, bumping, and protection settings being unconfigured. The match dscp command is replaced by match exp command.

When tag-switching is disabled, the match precedence and match dscp commands are restored and the exp commands are replaced by precedence commands.

When tag-switching is enabled or disabled, PVC bundles configured for IP precedence mapping or MPLS EXP mapping will stay up and traffic will transmit over the appropriate bundle member PVCs.

How to Configure Frame Relay PVC Bundles with QoS Support for IP and MPLS

This section contains the following configuration tasks.

Configuring Frame Relay PVC Bundles with IP QoS Support (required)

Configuring Frame Relay PVC Bundles with MPLS QoS Support (required)

Verifying Frame Relay PVC Bundles Configuration (optional)

Monitoring and Maintaining Frame Relay PVC Bundles (optional)

Configuring Frame Relay PVC Bundles with IP QoS Support

To configure Frame Relay PVC bundles for handling IP packets, perform the following steps:

SUMMARY STEPS

1. enable

2. configure terminal

3. ip routing

4. ip cef

5. interface type number
or
interface type number.subinterface-number [multipoint | point-to-point]

6. encapsulation frame-relay [cisco | ietf]

7. ip address ip-address mask [secondary]

8. frame-relay map protocol protocol-address {dlci | vc-bundle vc-bundle-name} [broadcast] [ietf | cisco]

9. frame-relay vc-bundle vc-bundle-name

10. encapsulation [ cisco| ietf]

11. match {dscp dscp-value | precedence precedence-value}

12. pvc dlci [vc-name]

13. class name

14. precedence {level | other}
or
dscp {level | other}

15. bump {explicit level | implicit | traffic}

16. protect {group | vc}

17. inarp

18. end

19. Configure the PVC bundle on the peer router.

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode.

Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

ip routing

Example:

Router(config)# ip routing

Enables IP routing.

Step 4 

ip cef

Example:

Router(config)# ip cef

Enables Cisco Express Forwarding.

Note For the Cisco 7500, enter ip cef distributed.

Step 5 

interface type number


or


interface type number.subinterface-number

[multipoint | point-to-point]

Example:

Router(config)# interface serial 0


or

Example:

Router(config)# interface serial 1.1 multipoint

Specifies the interface type and number and enters interface configuration mode.

Physical interfaces are multipoint subinterfaces by default.

or

Specifies the interface type and subinterface and enters subinterface configuration mode.

Once you create a specific type of subinterface (point-to-point or multipoint), you cannot change it without a reload. To change it, you must either reload the router or create another subinterface.

Step 6 

encapsulation frame-relay [cisco |ietf]

Example:

Router(config-if)# encapsulation frame-relay

Enables Frame Relay encapsulation.

The default encapsulation method is cisco.

Step 7 

ip address ip-address mask [secondary]

Example:

Router(config-if)# ip address 10.1.1.1 255.0.0.0

Sets a primary IP address for the interface.

The optional secondary keyword specifies that the configured address is a secondary IP address. If this keyword is omitted, the configured address is the primary IP address.

Step 8 

frame-relay map protocol protocol-address {dlci | vc-bundle vc-bundle-name} [broadcast] [ietf | cisco]

Example:

Router(config-if)# frame-relay map ip 10.2.2.2 vc-bundle MAIN-1

(Optional) Maps between a next-hop protocol address and a data-link connection identifier (DLCI) destination address, and creates a PVC bundle if it does not already exist.

The protocol-address is the destination IP address.

The frame-relay map command is required for multipoint interfaces if Inverse ARP has been disabled or is not supported at the other end of the connection.

Step 9 

frame-relay vc-bundle vc-bundle-name

Example:

Router(config-if)# frame-relay vc-bundle MAIN-1

Creates a PVC bundle if it does not already exist, and enters Frame Relay VC-bundle configuration mode.

Step 10 

encapsulation [cisco | ietf]

Example:

Router(config-fr-vcb)# encapsulation ietf

(Optional) Overrides the encapsulation type configured on the interface and configures the Frame Relay encapsulation type for the PVC bundle.

This command is available only when the PVC bundle is configured on a point-to-point subinterface.

Step 11 

match {dscp dscp-value | precedence precedence-value}

Example:

Router(config-fr-vcb)# match precedence 5

Establishes the type of matching to use between incoming packet headers and PVC-bundle members.

The default match type is precedence.

Step 12 

pvc dlci [vc-name]

Example:

Router(config-fr-vcb)# pvc 100 1a

Creates a PVC-bundle member and enters Frame Relay VC-bundle-member configuration mode.

The vc-name argument is an optional name that can be used for referring to the PVC.

Step 13 

class name

Example:

Router(config-fr-vcb-vc)# class premium

(Optional) Assigns a map class to the PVC-bundle member defined in the previous step.

Step 14 

precedence {level | other}


or


dscp {level | other}

Example:

Router(config-fr-vcb-vc)# precedence 6-7


or

Example:

Router(config-fr-vcb-vc)# dscp other

(Optional) Enters the mapped service level or range for the PVC-bundle member.

The precedence command is available when the PVC-bundle match type is set to precedence.

The precedence range is from 0 to 7.

The dscp command is available when the PVC-bundle match type is set to dscp.

The dscp range is from 0 to 63.

The other keyword is used to designate a PVC to handle all the remaining levels that have not been assigned to other PVCs in the bundle.

Critical non-IP traffic will automatically use precedence level 0.

Step 15 

bump {explicit level | implicit | traffic}

Example:

Router(config-fr-vcb-vc)# bump explicit 7

(Optional) Specifies the bumping rule for the PVC-bundle member.

The default bumping rule is implicit bumping.

Use the explicit level option to specify the service level to which traffic on this PVC will be bumped if the PVC goes down. In that event, the traffic will be directed to a PVC mapped with the service level configured here. If the PVC that picks up and carries the traffic also goes down, the traffic is subject to the bumping rules for that PVC. You can specify only one service level for bumping.

The PVC-bundle member accepts bumped traffic by default when the PVC-bundle match type is precedence. To configure the PVC to reject bumped traffic from another PVC-bundle member, use the no bump traffic command.

Step 16 

protect {group | vc}

Example:

Router(config-fr-vcb-vc)# protect group

(Optional) Specifies the protection rule for the PVC-bundle member.

By default, the PVC-bundle member is not protected.

If you use the vc keyword, the PVC bundle goes down whenever this PVC goes down.

If you use the group keyword, the PVC bundle goes down when the last PVC in the protected group goes down.

Step 17 

inarp

Example:

Router(config-fr-vcb-vc)# inarp

(Optional) Enables Inverse ARP for the PVC-bundle member.

By default, Inverse ARP traffic uses the PVC configured for precedence level 6 or DSCP level 63.

Step 18 

end

Example:

Router(config-fr-vcb-vc)# end

Exits to privileged EXEC mode.

Step 19 

Configure the PVC bundle on the peer router.

(Optional) While it is not necessary to configure a PVC bundle on the peer router, it is recommended that you do so for applications that rely on communications on the same PVC (such as TCP header-compression.)

Configuring Frame Relay PVC Bundles with MPLS QoS Support

To configure Frame Relay PVC bundles for handling MPLS packets, perform the following steps:

SUMMARY STEPS

1. enable

2. configure terminal

3. ip routing

4. ip cef

5. interface type number

or

interface {type slot | port-adapter | port.subinterface-number}[multipoint | point-to-point]

6. encapsulation frame-relay [cisco | ietf]

7. tag-switching ip

8. ip address ip-address mask [secondary]

9. frame-relay map protocol protocol-address {dlci | vc-bundle vc-bundle-name} [broadcast] [ietf | cisco]

10. frame-relay vc-bundle vc-bundle-name

11. encapsulation [ietf | cisco]

12. pvc dlci [vc-name]

13. class name

14. exp {level | other}

15. bump {explicit level | implicit | traffic}

16. protect {group | vc}

17. inarp

18. end

19. Configure the PVC bundle on the peer router.

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode.

Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

ip routing

Example:

Router(config)# ip routing

Enables IP routing.

Step 4 

ip cef

Example:

Router(config)# ip cef

Enables Cisco Express Forwarding.

Note For the Cisco 7500, enter ip cef distributed.

Step 5 

interface type number


or


interface {type slot | port-adapter | port.subinterface-number}[multipoint | point-to-point]

Example:

Router(config)# interface serial 0


or


Example:

Router(config)# interface serial 1.1 multipoint

Specifies the interface type and number and enters interface configuration mode.

Physical interfaces are multipoint subinterfaces by default.

or

Specifies the interface type and subinterface and enters subinterface configuration mode.

Once you create a specific type of subinterface (point-to-point or multipoint), you cannot change it without a reload. To change it, you need to either reload the router or create another subinterface.

Step 6 

encapsulation frame-relay [cisco | ietf]

Example:

Router(config-if)# encapsulation frame-relay

Enables Frame Relay encapsulation.

The default encapsulation method is cisco.

Step 7 

tag-switching ip

Example:

Router(config-if)# tag-switching ip

Enables label switching of IPv4 packets on an interface.

Step 8 

ip address ip-address mask [secondary]

Example:

Router(config-if)# ip address 10.1.1.1 255.0.0.0

Sets a primary IP address for the interface.

The optional secondary keyword specifies that the configured address is a secondary IP address. If this keyword is omitted, the configured address is the primary IP address.

Step 9 

frame-relay map protocol protocol-address {dlci | vc-bundle vc-bundle-name} [broadcast] [ietf | cisco]

Example:

Router(config-if)# frame-relay map ip 10.2.2.2 vc-bundle MAIN-1

(Optional) Maps between a next-hop protocol address and a DLCI destination address, and creates a PVC bundle if it does not already exist.

The protocol-address is the destination IP address.

The frame-relay map command is required for multipoint interfaces if Inverse ARP has been disabled or is not supported at the other end of the connection.

Step 10 

frame-relay vc-bundle vc-bundle-name

Example:

Router(config-if)# frame-relay vc-bundle MAIN-1

Creates a PVC bundle if it does not already exist, and enters Frame Relay VC-bundle configuration mode.

Step 11 

encapsulation [ietf | cisco]

Example:

Router(config-fr-vcb)# encapsulation ietf

(Optional) Overrides the encapsulation type configured on the interface and configures the Frame Relay encapsulation type for the PVC bundle.

This command is available only when the PVC bundle is configured on a point-to-point subinterface.

Step 12 

pvc dlci [vc-name]

Example:

Router(config-fr-vcb)# pvc 100 1a

Creates a PVC-bundle member and enters Frame Relay VC-bundle-member configuration mode.

The vc-name argument is an optional name that can be used for referring to the PVC.

Step 13 

class name

Example:

Router(config-fr-vcb-vc)# class premium

(Optional) Assigns a map class to the PVC-bundle member.

Step 14 

exp {level | other}

Example:

Router(config-fr-vcb-vc)# exp 6-7

(Optional) Enters the mapped EXP level or range for the PVC-bundle member.

The exp command is available only when tag-switching has been enabled.

The EXP level values are from 0 to 7.

The other keyword is used to designate a PVC to handle all the remaining levels that have not been assigned to other PVCs in the bundle.

Step 15 

bump {explicit level | implicit | traffic}

Example:

Router(config-fr-vcb-vc)# bump explicit 7

(Optional) Specifies the bumping rule for the PVC-bundle member defined above.

The default bumping rule is implicit bumping.

Use the explicit level option to specify the EXP level to which traffic on this PVC will be bumped if the PVC goes down. In that event, the traffic will be directed to a PVC mapped with the EXP level configured here. If the PVC that picks up and carries the traffic also goes down, the traffic is subject to the bumping rules for that PVC. You can specify only one EXP level for bumping.

To configure the PVC to reject bumped traffic from another PVC-bundle member, use the no bump traffic command.

Step 16 

protect {group | vc}

Example:

Router(config-fr-vcb-vc)# protect group

(Optional) Specifies the protection rule for the PVC-bundle member defined above.

By default, the PVC-bundle member is not protected.

If you use the vc keyword, the PVC bundle goes down whenever this PVC goes down.

If you use the group keyword, the PVC bundle goes down when the last PVC in the protected group goes down.

Step 17 

inarp

Example:

Router(config-fr-vcb-vc)# inarp

(Optional) Enables Inverse ARP for the PVC-bundle member defined above.

By default, Inverse ARP traffic uses the PVC configured for EXP level 6.

Step 18 

end

Example:

Router(config-fr-vcb-vc)# end

(Optional) Exits to privileged EXEC mode.

Step 19 

Configure the PVC bundle on the peer router.

(Optional) While it is not necessary to configure a PVC bundle on the peer router, it is recommended that you do so for applications that rely on communications on the same PVC (such as TCP header-compression.)

Verifying Frame Relay PVC Bundles Configuration

To verify the configuration and operation of Frame Relay PVC bundles with QoS support, perform the following optional steps:

SUMMARY STEPS

1. enable

2. show frame-relay vc-bundle vc-bundle-name [detail]

3. show frame-relay map

4. show frame-relay pvc

5. show frame-relay ip rtp header-compression [interface type number]

6. show frame-relay ip tcp header-compression [interface type number]

7. show adjacency [type number] [detail] [summary]

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode.

Enter your password if prompted.

Step 2 

show frame-relay vc-bundle vc-bundle-name [detail]

Example:

Router# show frame-relay vc-bundle mp-3-static

Displays status, bumping information, protection information, and active and configured precedence or DSCP levels for the PVCs in a PVC bundle.

Step 3 

show frame-relay map

Example:

Router# show frame-relay map

Displays the current Frame Relay map entries and information about the connections.

Step 4 

show frame-relay pvc

Example:

Router# show frame-relay pvc

Displays PVC statistics for the PVC-bundle members.

Step 5 

show frame-relay ip rtp header-compression [interface type number]

Example:

Router# show frame-relay ip rtp header-compression

Displays Frame Relay Real-Time Transport Protocol (RTP) header compression statistics for PVC bundles.

Step 6 

show frame-relay ip tcp header-compression [interface type number]

Example:

Router# show frame-relay ip tcp header-compression serial 1/4

Displays Frame Relay TCP/IP header compression statistics for PVC bundles.

Step 7 

show adjacency [type number] [detail] [summary]

Example:

Router# show adjacency

Displays Cisco Express Forwarding adjacency table information.

Monitoring and Maintaining Frame Relay PVC Bundles

To monitor and maintain Frame Relay PVC bundles, perform this task.

SUMMARY STEPS

1. enable

2. debug frame-relay adjacency {pvc [dlci] | vc-bundle [vc-bundle-name]}

3. debug frame-relay vc-bundle {detail | state-change} [vc-bundle-name]

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables higher privilege levels, such as privileged EXEC mode.

Enter your password if prompted.

Step 2 

debug frame-relay adjacency {pvc [dlci] | vc-bundle [vc-bundle-name]}

Example:

Router# debug frame-relay adjacency pvc

Displays information pertaining to an adjacent node that has one or more Frame Relay PVCs or PVC bundles.

Use this command to monitor adjacency activity.

Step 3 

debug frame-relay vc-bundle {detail | state-change} [vc-bundle-name]

Example:

Router# debug frame-relay vc-bundle state-change

Displays information about the Frame Relay PVC bundles configured on a router.

Use this command to monitor state changes and Inverse ARP activity for one or all of the PVC bundles and bundle members configured on a router.

Note Using the detail keyword generates a large number of debugs that can quickly fill up a log buffer.

Configuration Examples for Frame Relay PVC Bundles with QoS Support for IP and MPLS

This section provides the following configuration examples:

PVC Bundles with IP QoS Support on Main, Multipoint, and Point-to-Point Interfaces Example

PVC Bundle with IP QoS Support with Multiple QoS Parameters Example

PVC Bundle with MPLS QoS Support Example

Verifying Frame Relay PVC Bundle Configuration Examples

Monitoring and Maintaining Frame Relay PVC Bundles Examples

PVC Bundles with IP QoS Support on Main, Multipoint, and Point-to-Point Interfaces Example

The following example shows the configuration of five PVC bundles with IP precedence and DSCP mapping. Two bundles are configured on the main interface, one bundle with static mapping and one with dynamic mapping. Two bundles are configured on a multipoint subinterface, one bundle with static mapping and one with dynamic mapping. One bundle is configured on a point-to-point subinterface.

configure terminal 
ip routing 
ip cef 
interface Serial 1/4 
 encapsulation frame-relay 
 frame-relay intf-type dte 
 ip address 10.1.1.1 255.0.0.0 
 frame-relay map ip 192.168.2.2 vc-bundle MAIN-1-static 
 frame-relay vc-bundle MAIN-1-static 
 match precedence 
 pvc 100 1a 
 precedence other 
 pvc 101 1b 
 precedence 1 
 pvc 102 1c 
 precedence 2 
 pvc 103 1d 
 precedence 3 
 pvc 104 1e 
 precedence 4 
 pvc 105 1f 
 precedence 5 
 pvc 106 1g 
 precedence 6 
 pvc 107 1h 

 frame-relay vc-bundle MAIN-2-dynamic 
 match precedence 
 pvc 200 
 precedence 0 
 pvc 201 
 precedence 1 
 pvc 202 
 precedence 2 
 pvc 203 
 precedence 3 
 pvc 204 
 precedence 4 
 pvc 205 
 precedence 5 
 pvc 206 
 precedence 6 
 pvc 207 
 precedence 7 

interface Serial 1/4.1 multipoint 
 ip address 172.16.1.1 255.0.0.0 
 frame-relay map ip 172.17.2.2 vc-bundle MP-3-static 
 frame-relay vc-bundle MP-3-static 
  match precedence 
 pvc 300 3a 
 precedence 0 
 pvc 301 3b 
 precedence 1 
 pvc 302 3c 
 precedence 2 
 pvc 303 3d 
 precedence 3 
 pvc 304 3e 
 precedence 4 
 pvc 305 3f 
 precedence 5 
 pvc 306 3g 
 precedence 6 
 pvc 307 3h 
 precedence 7 

interface Serial 1/4.1 multipoint 
 frame-relay vc-bundle MP-4-dynamic 
 match precedence 
 match dscp 
 pvc 400 4a 
 dscp other 
 pvc 401 4b 
 dscp 10-19 
 pvc 402 4c 
 dscp 20-29 
 pvc 403 4d 
 dscp 30-39 
 pvc 404 4e 
 dscp 40-49 
 pvc 405 4f 
 dscp 50-59 
 pvc 406 4g 
 dscp 60-62 
 pvc 407 4h 
 dscp 63 
 end 

interface Serial 1/4.2 point-to-point 
 ip address 192.168.2.1 255.0.0.0 
 frame-relay vc-bundle P2P-5 
 match precedence 
 pvc 500 5a 
 precedence 0 
 pvc 501 5b 
 precedence 1 
 pvc 502 5c 
 precedence 2 
 pvc 503 5d 
 precedence 3 
 pvc 504 5e 
 precedence 4 
 pvc 505 5f 
 precedence 5 
 pvc 506 5g 
 precedence 6 
 pvc 507 5h 
 precedence 7

PVC Bundle with IP QoS Support with Multiple QoS Parameters Example

The following example shows the configuration of a Frame Relay PVC bundle with DSCP-based mapping. The bundle member PVCs are configured with bumping, protection, and other parameters.

interface Serial 1/4.2 point-to-point
 frame-relay vc-bundle BUNDLE-SEFEN
 encapsulation ietf
 match dscp
  pvc 301
 dscp other
 bump explicit 45
 protect group
 class CIR-64000
 pvc 302
 dscp 40-49
 bump explicit 20
 no bump traffic
 protect vc
 inarp
 pvc 303
 dscp 30-39
 bump implicit
 protect group

PVC Bundle with MPLS QoS Support Example

The following example shows the configuration of four Frame Relay PVC bundle members with MPLS EXP level support in the PVC bundle named "user1".

interface serial 0.1 point-to-point
 encapsulation frame-relay
 ip address 10.1.1.1
 tag-switching ip
 frame-relay vc-bundle user1
 pvc 100 ny-control
 class control
 exp 7
 protect vc
 pvc 101 ny-premium
 class premium
 exp 6-5
 bump explicit 7
 no bump traffic
 protect group
 pvc 102 my-priority
 class priority
 exp 4-2
 protect group
 pvc 103 ny-basic
 class basic
 exp other

 protect group

Verifying Frame Relay PVC Bundle Configuration Examples

The following examples show output for the commands that can be used to verify Frame Relay PVC bundle configuration.

Sample Output for the show frame-relay vc-bundle Command

The following example shows the Frame Relay PVC bundle named "MP-4-dynamic" with PVC protection applied. Note that in this PVC bundle, DLCI 400 is configured to bump traffic explicitly to the PVC that handles DSCP level 40, which is DLCI 404. All the other DLCIs are configured for implicit bumping. In addition, all the DLCIs are configured to accept bumped traffic.

The asterisk (*) before PVC 4a indicates that this PVC was configured with the precedence other command, which means the PVC will handle all levels that are not explicitly configured on other PVCs.

In this example all PVCs are up so the values in the "Active level" fields match the values in the "Config level" fields. If a PVC goes down and its traffic is bumped, the "Active level" field value for the PVC that went down is cleared. The "Active level" field values for the PVC that the traffic bumped to will be updated to include the levels of the PVC that went down.

The first three PVCs in the following example make up a protected group. All three of these PVCs must go down before the bundle will go down. The last two PVCs are protected PVCs: if either of these PVCs go down, the bundle will go down.

Router# show frame-relay vc-bundle MP-4-dynamic

MP-4-dynamic on Serial 1/4.1 - Status: UP Match-type: DSCP

Name 		DLCI 		Config. 	Active 				Bumping 			PG/ 		CIR 		Status 
				level 		level 			to/accept 			PV 		kbps
*4a 		400 		0-9 		0-9 			40/Yes 			pg 				up 
4b 		401 		10-19 		10-19 			9/Yes 			pg 				up 
4c 		402 		20-29 		20-29 			19/Yes 			pg 				up 
4d 		403 		30-39 		30-39 			29/Yes 			- 				up 
4e 		404 		40-49 		40-49 			39/Yes 			- 				up 
4f 		405 		50-59 		50-59 			49/Yes 			- 				up 
4g 		406 		60-62 		60-62 			59/Yes 			pv 				up 
4h 		407 		63 		63 			62/Yes 			pv 				up

Packets sent out on vc-bundle MP-4-dynamic : 0:
Router# 

The following example shows the detail output of a PVC bundle. Note in this example that because all packet service levels are not handled, and because the PVCs are currently down, this bundle can never come up.

Router# show frame-relay vc-bundle x41 detail

x41 on Serial1/1 - Status: DOWN Match-type: DSCP

Name 		DLCI 		Config. 		Active 			Bumping 			PG/ 		CIR 		Status 
				level 		level 			to/accept 			PV 		kbps

		410 		50-62 					49/Yes 			- 				down 
		411 		30,32,34,36,3.. 					29/Yes 			- 				down

Packets sent out on vc-bundle x41 : 0

Active configuration and statistics for each member PVC
DLCI 		Output pkts 				Active level
410 		0 				50-62 
411 		0 				30,32,34,36,38-40 
Router#

Sample Output for the show frame-relay map Command

The following sample output displays map and connection information for a PVC bundle called "MAIN-1-static":

Router# show frame-relay map

Serial1/4 (up):ip 10.2.2.2 vc-bundle MAIN-1-static, static,
              CISCO, status up

Sample Output for the show frame-relay pvc Command

The following sample output indicates that PVC 202 is a member of VC bundle "MAIN-1-static":

Router# show frame-relay pvc 202

PVC Statistics for interface Serial1/4 (Frame Relay DTE)

DLCI = 202, DLCI USAGE = LOCAL, PVC STATUS = STATIC, INTERFACE = Serial1/4

  input pkts 0             output pkts 45           in bytes 0
  out bytes 45000          dropped pkts 0           in FECN pkts 0
  in BECN pkts 0           out FECN pkts 0          out BECN pkts 0
  in DE pkts 0             out DE pkts 0
  out bcast pkts 0         out bcast bytes 0
  5 minute input rate 0 bits/sec, 0 packets/sec
  5 minute output rate 2000 bits/sec, 2 packets/sec
  pvc create time 00:01:25, last time pvc status changed 00:01:11
  VC-Bundle MAIN-1-static 

Sample Output for the show adjacency Command

The following is sample output for the show adjacency command for a PVC bundle configured on serial subinterface 1/4.1. Each bundle member is listed. The bundle itself is indicated by "incomplete" because no traffic actually transmitted on that entry.

Router# show adjacency

      Protocol Interface                 Address
      IP       Serial1/4.1               10.2.2.2(4)
      IP       Serial1/4.1               10.2.2.2(4)
      IP       Serial1/4.1               10.2.2.2(4)
      IP       Serial1/4.1               10.2.2.2(4)
      IP       Serial1/4.1               10.2.2.2(4)
      IP       Serial1/4.1               10.2.2.2(4)
      IP       Serial1/4.1               10.2.2.2(4)
      IP       Serial1/4.1               10.2.2.2(4)
      IP       Serial1/4.1               10.2.2.2(5) (incomplete) 

Monitoring and Maintaining Frame Relay PVC Bundles Examples

The following examples show output for the debug frame-relay adjacency and debug frame-relay vc-bundle commands, which can be used to troubleshoot Frame Relay PVC bundle operation. "FR-VCB" indicates output from the debug frame-relay vc-bundle command, and "FR-ADJ" indicates output from the debug frame-relay adjacency command.


Note Debug messages that are prefixed with "FR_ADJ" (instead of FR-ADJ") or "FR_VCB" (instead of "FR-VCB") indicate serious failures in the Frame Relay PVC bundle performance. Contact the Cisco Technical Assistance Center (TAC) if you see debug messages with these prefixes.


The following is sample output that shows a PVC bundle that uses static map coming up. PVC bundle member 100 comes up first, then the PVC bundle itself can come up.

Router# debug frame-relay vc-bundle state-change
Router# debug frame-relay adjacency vc-bundle

00:35:58:FR-VCB:MAIN-1-static:member 100 state changed to UP 
00:35:58:FR-VCB:MAIN-1-static:state changed to UP 
00:35:58:FR-ADJ:vcb MAIN-1-static:ip 10.2.2.2:adding primary adj  
00:35:58:FR-ADJ:vcb MAIN-1-static:member 100:adding adj 
00:35:58:FR-ADJ:vcb MAIN-1-static:member 100:locking adj at index 0 00:35:58:FR-ADJ:vcb 
MAIN-1-static:member 100:locking adj at index 1
00:35:58:FR-ADJ:vcb MAIN-1-static:member 100:locking adj at index 2
00:35:58:FR-ADJ:vcb MAIN-1-static:member 100:locking adj at index 3
00:35:58:FR-ADJ:vcb MAIN-1-static:member 100:locking adj at index 4
00:35:58:FR-ADJ:vcb MAIN-1-static:member 100:locking adj at index 5
00:35:58:FR-ADJ:vcb MAIN-1-static:member 100:locking adj at index 6
00:35:58:FR-ADJ:vcb MAIN-1-static:member 100:locking adj at index 7
00:35:58:%FR-5-DLCICHANGE:Interface Serial1/4 - DLCI 100 state changed to ACTIVE 
00:35:58:FR-VCB:MAIN-1-static:member 101 state changed to UP 
00:35:58:FR-ADJ:vcb MAIN-1-static:ip 10.2.2.2:updating primary adj 
00:35:58:FR-ADJ:vcb MAIN-1-static:member 100:updating adj 
00:35:58:FR-ADJ:vcb MAIN-1-static:member 101:adding adj 
00:35:58:FR-ADJ:vcb MAIN-1-static:member 100:unlocking adj at index 1 
00:35:58:FR-ADJ:vcb MAIN-1-static:member 101:locking adj at index 1 

The following is sample output that shows a PVC bundle going down. Each bundle member PVC is marked for removal from Cisco Express Forwarding adjacency table, and then the adjacency for the PVC bundle itself is marked for removal. The adjacencies are actually removed from the table later when a background clean-up process runs.

00:38:35:FR-VCB:MP-3-static:state changed to DOWN 
00:38:35:FR-ADJ:vcb MP-3-static:ip 172.17.2.2:member 300:removing adj 
00:38:35:FR-ADJ:vcb MP-3-static:ip 172.17.2.2:member 301:removing adj
00:38:35:FR-ADJ:vcb MP-3-static:ip 172.17.2.2:member 302:removing adj
00:38:35:FR-ADJ:vcb MP-3-static:ip 172.17.2.2:member 303:removing adj
00:38:35:FR-ADJ:vcb MP-3-static:ip 172.17.2.2:member 304:removing adj
00:38:35:FR-ADJ:vcb MP-3-static:ip 172.17.2.2:member 305:removing adj
00:38:35:FR-ADJ:vcb MP-3-static:ip 172.17.2.2:removing primary adj 

The following is sample output that shows Inverse ARP information for the PVC bundle. PVC bundle member 406 is the only PVC in the bundle to handle Inverse ARP packets. The Inverse ARP packets coming in on other bundle member PVCs are dropped.

00:23:48:FR-VCB:MP-4-dynamic:inarp received on elected member 406 
00:23:48:FR-VCB:MP-4-dynamic:installing dynamic map 
00:23:48:FR-VCB:MP-4-dynamic:dropping inarp received on member 407 
00:23:52:FR-VCB:MP-4-dynamic:sending inarp pkt on member 406 

In the following example the PVC bundle goes down because the protected group goes down. All information about active transmission on each PVC is removed.

00:58:27:FR-VCB:MP-4-dynamic:member 402 state changed to DOWN 
00:58:27:FR-VCB:MP-4-dynamic:protected group is DOWN 
00:58:27:FR-VCB:MP-4-dynamic:state changed to DOWN 
00:58:27:FR-VCB:MP-4-dynamic:active table reset 

Additional References

The following sections provide references related to Frame Relay PVC Bundles with QoS Support for IP and MPLS.

Related Documents

Related Topic
Document Title

Frame Relay configuration tasks

"Configuring Frame Relay" chapter in the Cisco IOS Wide-Area Networking Configuration Guide, Release 12.2

Frame Relay commands

"Frame Relay Commands" chapter in the Cisco IOS Wide-Area Networking Command Reference, Release 12.2

Frame Relay PVC interface priority queueing configuration tasks

"Configuring Weighted Fair Queueing" section in the Congestion Management chapter in the Cisco IOS Quality of Service Configuration Guide, Release 12.2


Standards

Standards
Title

None


MIBs

MIBs
MIBs Link

None

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

None


Technical Assistance

Description
Link

The Cisco Technical Support & Documentation website contains thousands of 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/techsupport


Command Reference

This section documents modified commands only.

bump (Frame Relay VC-bundle-member)

class

debug frame-relay adjacency

debug frame-relay vc-bundle

dscp (Frame Relay VC-bundle-member)

encapsulation (Frame Relay VC-bundle)

exp

frame-relay inverse-arp

frame-relay map

frame-relay vc-bundle

inarp (Frame Relay VC-bundle-member)

match

precedence (Frame Relay VC-bundle-member)

protect (Frame Relay VC-bundle-member)

pvc (Frame Relay VC-bundle)

show frame-relay ip rtp header-compression

show frame-relay ip tcp header-compression

show frame-relay map

show frame-relay pvc

show frame-relay vc-bundle

bump (Frame Relay VC-bundle-member)

To configure the bumping rules for a Frame Relay permanent virtual circuit (PVC) bundle member, use the bump command in Frame Relay VC-bundle-member configuration mode. To specify that the PVC bundle member does not accept any bumped traffic, use the no bump traffic command.

bump {explicit level | implicit | traffic}

no bump traffic

Syntax Description

explicit level

Specifies the precedence, experimental (EXP), or differentiated services code point (DSCP) level to which traffic on a PVC will be bumped when the PVC goes down. For PVC bundles that use precedence or EXP mapping, valid values for the level argument are from 0 to 7. For PVC bundles that use DSCP mapping, valid values are from 0 to 63.

implicit

Applies the implicit bumping rule, which is the default, to a single PVC bundle member. The implicit bumping rule stipulates that bumped traffic is to be carried by a PVC that has the lower precedence level.

traffic

Specifies that the PVC accepts bumped traffic (the default condition). The no form stipulates that the PVC does not accept any bumped traffic.


Defaults

Implicit bumping rule stipulates that bumped traffic is to be carried by a PVC.

Command Modes

Frame Relay VC-bundle-member configuration

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Use the bump command to configure bumping rules for a discrete PVC bundle member. To change the configured bumping rules for a PVC bundle member, override the current configuration with a new bump command entry.

To return to the default condition of implicit bumping, use the bump implicit command.

The effects of different bumping configuration approaches are as follows:

Implicit bumping: If you configure implicit bumping, bumped traffic is sent to the PVC configured to handle the next-lower service level. When the original PVC that bumped the traffic comes back up, it will resume transmission of the configured service level. When the bump explicit command is not configured, the bump implicit command is enabled by default; however, bump implicit will not appear in the show running-config and show startup-config output.

Explicit bumping: If you configure a PVC with the bump explicit command, you can specify the service level to which traffic will be bumped when that PVC goes down, and the traffic will be directed to a PVC mapped with that level. If the PVC that picks up and carries the traffic goes down, the traffic is subject to the bumping rules for that PVC. You can specify only one service level for bumping.

Permit bumping: The PVC accepts bumped traffic by default. If the PVC has been previously configured to reject bumped traffic, you must use the bump traffic command to return the PVC to its default condition.

Reject bumping: To configure a discrete PVC to reject bumped traffic when the traffic is directed to it, use the no bump traffic command.


Note When no alternative PVC can be found to handle bumped traffic, even when there are no packets of that traffic type present, the bundle is declared down. In the case where default (implicit) bumping is used for all PVCs, the PVC that is handling the lowest service level can be configured to bump explicitly to a PVC handling a higher service level.


The following warnings appear during configuration and let you know about configuration problems that may prevent the bundle from coming up or cause the bundle to go down unexpectedly:

The following warning occurs when the bump explicit command is configured. It warns that PVC 300 may be configured to bump to a PVC that will in turn bump back to PVC 300, in which case the bundle will go down.

%DLCI 300 could end up bumping traffic to itself

The following warning occurs when an explicit bump is directed to a PVC configured with the no bump traffic command.

%DLCI 306 is configured for bumping traffic to level 7

The following warning occurs when the service levels handled by a PVC are changed, leaving other PVCs explicitly configured to bump to levels that are no longer being handled by that PVC.

%DLCI(s) configured for explicitly bumping traffic to DLCI 300

The following warning occurs when a PVC is configured to explicitly bump to a level that is not yet handled by any PVCs.

%Presently no member is configured for level 3

The following warning occurs when you attempt to explicitly configure bumping to a PVC that is already configured with no bump traffic.

%DLCI configured for level 0 does not accept bumping

Examples

The following example configures PVC 101 in the Frame Relay PVC bundle "bundle1" with explicit bumping to the PVC bundle member having a precedence level of 7. PVC 101 is also configured to prohibit traffic from other PVCs from being bumped to it.

frame-relay vc-bundle bundle1
 match precedence
 pvc 101
  precedence 5
  no bump traffic
  bump explicit 7

Related Commands

Command
Description

class

Associates a map class with a specified DLCI.

dscp (Frame Relay VC-bundle-member)

Specifies the DSCP value or values for a specific Frame Relay PVC bundle member.

exp

Configures MPLS EXP levels for a Frame Relay PVC bundle member.

precedence (Frame Relay VC-bundle-member)

Configures the precedence levels for a Frame Relay PVC bundle member.

protect (Frame Relay VC-bundle-member)

Configures a Frame Relay PVC bundle member with protected group or protected PVC status.

pvc (Frame Relay VC-bundle)

Creates a PVC and PVC bundle member and enters Frame Relay VC-bundle-member configuration mode.


class

To associate a map class with a specified data-link connection identifier (DLCI), use the class command in Frame Relay DLCI configuration mode or Frame Relay VC-bundle-member configuration mode. To remove the association between the DLCI and the map class, use the no form of this command.

class name

no class name

Syntax Description

name

Name of the map class to associate with the specified DLCI.


Defaults

No map class is defined.

Command Modes

Frame Relay DLCI configuration
Frame Relay VC-bundle-member configuration

Command History

Release
Modification

11.2

This command was introduced.

12.2(13)T

This command was made available in Frame Relay VC-bundle-member configuration mode.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

This command applies to DLCIs that are created using the frame-relay interface-dlci command and to DLCIs that are created as permanent virtual circuit (PVC) bundle members within a specified Frame Relay PVC bundle. The PVC bundle is created using the frame-relay vc-bundle command. The Frame Relay PVC bundle member DLCIs are then created using the pvc command in Frame Relay VC-bundle configuration mode.

A map class applied to the interface will be applied to all PVC members in a PVC bundle. A class applied to an individual PVC-bundle member supersedes the class applied at the interface level.

The map class is created using the map-class frame-relay command in global configuration mode.

Examples

The following example shows how to define a map class called "slow-vcs" and apply it to DLCI 100:

interface serial 0.1 point-to-point 
 frame-relay interface-dlci 100 
 class slow-vcs

map-class frame-relay slow-vcs 
 frame-relay cir out 9600 

The following example shows how to apply a map class to a DLCI for which a frame-relay map statement exists. The frame-relay interface-dlci command must also be used.

interface serial 0.2 point-to-multipoint
 frame-relay map ip 172.16.13.2 100
 frame-relay interface-dlci 100
 class slow_vcs

map-class frame-relay slow_vcs
 frame-relay traffic-rate 56000 128000
 frame-relay idle-timer 30

The following example creates a Frame Relay map-class "class1" and shows how to assign it to PVC 300 in a Frame Relay PVC bundle called "MP-3-static":

map-class frame-relay HI
interface serial 1/4
 frame-relay map ip 10.2.2.2 vc-bundle MP-3-static
 frame-relay vc-bundle MP-3-static
 pvc 300
 class class1

Related Commands

Command
Description

frame-relay interface-dlci

Assigns a DLCI to a specified Frame Relay subinterface on the router or access server.

frame-relay map

Defines mapping between a destination protocol address and the DLCI used to connect to the destination address.

frame-relay vc-bundle

Creates a Frame Relay PVC bundle and enters Frame Relay VC-bundle configuration mode.

map-class frame-relay

Creates a map class for which unique QoS values can be assigned.

pvc (frame-relay vc-bundle)

Creates a PVC and PVC bundle member and enters Frame Relay VC-bundle-member configuration mode.


debug frame-relay adjacency

To display information pertaining to an adjacent node that has one or more Frame Relay permanent virtual circuit (PVC) bundles, use the debug frame-relay adjacency command in privileged EXEC mode. To stop displaying the adjacent node information, use the no form of this command.

debug frame-relay adjacency {pvc [dlci] | vc-bundle [vc-bundle-name]}

no debug frame-relay adjacency {pvc [dlci] | vc-bundle [vc-bundle-name]}

Syntax Description

pvc

Displays information regarding the adjacent PVC only.

dlci

(Optional) Data-link connection identifier for a specific PVC.

vc-bundle

Displays information regarding the adjacent PVC bundle and its members.

vc-bundle-name

(Optional) Name of the PVC bundle.


Defaults

No default behaviors or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Use this command to monitor adjacency activity and status for an adjacent node.


Note Debug messages that are prefixed with "FR_ADJ" (instead of "FR-ADJ") indicate serious failures in the Frame Relay PVC bundle performance. Contact the Cisco Technical Assistance Center (TAC) if you see debugging messages with this prefix.


Examples

The following sample output from the debug frame-relay adjacency vc-bundle command shows PVC bundle "MP-4-dynamic" going down. Each bundle member PVC is marked for removal from the Cisco Express Forwarding adjacency table, and then the adjacency for the PVC bundle itself is marked for removal. The adjacencies are actually removed from the table later when a background clean-up process runs.

Router# debug frame-relay adjacency vc-bundle MP-4-dynamic

00:46:35: FR-ADJ: vcb MP-4-dynamic: ip 10.2.2.2: member 400: removing adj 
00:46:35: FR-ADJ: vcb MP-4-dynamic: ip 10.2.2.2: member 401: removing adj 
00:46:35: FR-ADJ: vcb MP-4-dynamic: ip 10.2.2.2: member 402: removing adj 
00:46:35: FR-ADJ: vcb MP-4-dynamic: ip 10.2.2.2: member 403: removing adj 
00:46:35: FR-ADJ: vcb MP-4-dynamic: ip 10.2.2.2: member 404: removing adj 
00:46:35: FR-ADJ: vcb MP-4-dynamic: ip 10.2.2.2: member 405: removing adj 
00:46:35: FR-ADJ: vcb MP-4-dynamic: ip 10.2.2.2: member 406: removing adj 
00:46:35: FR-ADJ: vcb MP-4-dynamic: ip 10.2.2.2: member 407: removing adj 
00:46:35: FR-ADJ: vcb MP-4-dynamic: ip 10.2.2.2: removing primary adj 

Related Commands

Command
Description

debug frame-relay vc-bundle

Displays information pertaining to all the PVC bundles configured on the router.


debug frame-relay vc-bundle

To display information about the Frame Relay permanent virtual circuit (PVC) bundles that are configured on a router, use the debug frame-relay vc-bundle command in privileged EXEC mode. To stop the display, use the no form of this command.

debug frame-relay vc-bundle {detail | state-change} [vc-bundle-name]

no debug frame-relay vc-bundle {detail | state-change} [vc-bundle-name]

Syntax Description

detail

Displays detailed information about the members of the bundle specified by vc-bundle-name. Displays detailed information about the members of all PVC bundles if vc-bundle-name is not specified.

state-change

Displays information pertaining only to the state changes of the PVC bundle and PVC bundle members specified by vc-bundle-name. Displays state-change information for all PVC bundles and bundle members if vc-bundle-name is not specified.

vc-bundle-name

(Optional) Specifies a particular PVC bundle.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Use this command to monitor state changes and Inverse Address Resolution Protocol (ARP) activity for one or all of the PVC bundles and bundle members configured on a router.


Note Debugging messages that are prefixed with "FR_VCB" (instead of "FR-VCB") indicate serious failures in the Frame Relay PVC bundle performance. Contact the Cisco Technical Assistance Center (TAC) if you see debugging messages with this prefix.


Examples

The following is sample output from the debug frame-relay vc-bundle command that shows Inverse ARP information for the PVC bundle. PVC bundle member 406 is the only PVC in the bundle to handle Inverse ARP packets. The Inverse ARP packets coming in on other bundle member PVCs are dropped.

Router# debug frame-relay vc-bundle detail

00:23:48:FR-VCB:MP-4-dynamic:inarp received on elected member 406 
00:23:48:FR-VCB:MP-4-dynamic:installing dynamic map 
00:23:48:FR-VCB:MP-4-dynamic:dropping inarp received on member 407 
00:23:52:FR-VCB:MP-4-dynamic:sending inarp pkt on member 406 

In the following example the PVC bundle goes down because the protected group goes down. All information about active transmission on each PVC is removed.

00:58:27:FR-VCB:MP-4-dynamic:member 402 state changed to DOWN 
00:58:27:FR-VCB:MP-4-dynamic:protected group is DOWN 
00:58:27:FR-VCB:MP-4-dynamic:state changed to DOWN 
00:58:27:FR-VCB:MP-4-dynamic:active table reset 

The following is sample output from the debug frame-relay vc-bundle detail command. State change and Inverse ARP activity is displayed for all PVC bundles and bundle members on the router.

Router# debug frame-relay adjacency vc-bundle detail

00:33:40: FR-VCB: MP-4-dynamic: member 404 state changed to UP 
00:33:40: FR-VCB: MP-4-dynamic: active table update 
00:33:40: FR-VCB: MP-3-static: sending inarp pkt on member 300 
00:33:41: FR-VCB: MP-3-static: inarp received on elected member 300 
00:33:48: FR-VCB: MP-3-static: inarp received on elected member 300 
00:33:48: FR-VCB: MAIN-1-static: dropping inarp received on member 100 
00:33:48: FR-VCB: MP-4-dynamic: dropping inarp received on member 404 
00:33:48: FR-VCB: MP-4-dynamic: dropping inarp received on member 405 
00:33:48: FR-VCB: P2P-5: dropping inarp received on member 507 
00:33:48: FR-VCB: MP-3-static: dropping inarp received on member 303 
00:33:48: FR-VCB: MAIN-2-dynamic: dropping inarp received on member 202 
00:33:48: FR-VCB: MAIN-1-static: dropping inarp received on member 107 
00:33:48: FR-VCB: MP-3-static: dropping inarp received on member 305 
00:33:48: FR-VCB: MAIN-1-static: dropping inarp received on member 105 
00:33:49: FR-VCB: P2P-5: dropping inarp received on member 505 
00:33:49: FR-VCB: P2P-5: dropping inarp received on member 504 
00:33:49: FR-VCB: P2P-5: dropping inarp received on member 503 
00:33:49: FR-VCB: P2P-5: dropping inarp received on member 502 
00:33:49: FR-VCB: P2P-5: dropping inarp received on member 501 

Related Commands

Command
Description

debug frame-relay adjacency

Displays information pertaining to an adjacent node that has one or more Frame Relay PVC bundles.


dscp (Frame Relay VC-bundle-member)

To configure the differentiated services code point (DSCP) levels for a Frame Relay permanent virtual circuit (PVC) bundle member, use the dscp command in Frame Relay VC-bundle-member configuration mode. To remove the DSCP level configuration from the PVC, use the no form of this command.

dscp {level | other}

no dscp level

Syntax Description

level

Specifies the DSCP level or levels for this Frame Relay PVC bundle member. The range is from 0 to 63. A PVC bundle member can be configured with a single DSCP level, multiple individual DSCP levels, a range of DSCP levels, multiple ranges of DSCP levels, or a combination of individual levels and level ranges. Examples are as follows:

9

25,35,45

25-35,45-55

10,20,25-35,40,45-55,60

other

Specifies that this Frame Relay PVC bundle member will handle all of the remaining DSCP levels that are not specified by other PVC bundle members.


Defaults

DSCP levels are not configured.

Command Modes

Frame Relay VC-bundle-member configuration

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Assignment of DSCP levels to PVC bundle members allows you to create differentiated service because you can distribute the DSCP levels over the various PVC bundle members. You can map a single DSCP level or range of levels to each discrete PVC in the bundle, thereby enabling PVCs in the bundle to carry packets marked with different DSCP levels. Use the dscp other command to configure a PVC to carry traffic marked with DSCP levels not specifically configured on other PVCs. Only one PVC in the bundle can be configured with the dscp other command.

This command is available only when the match type for the PVC bundle is set to dscp using the match dscp command in Frame Relay VC-bundle configuration mode.

You can overwrite the DSCP level configuration on a PVC by reentering the dscp command with a new level value.

There is no default value for this command. When the PVC bundle is set to dscp using the match dscp command, all PVCs in the bundle are reset to remove any existing DSCP values. If one or more DSCP values are not specifically configured, the bundle will not come up.

Note, however, that a PVC may exist in a bundle but have no DSCP value associated with it. As long as all valid DSCP values are handled by one or more of the other PVCs in the bundle, the bundle can come up, but the PVC that has no DSCP value configured will not participate in it.

A DSCP level can be configured on one PVC-bundle member per bundle. If you configure the same DSCP level on more than one PVCs within a bundle, the following error warning appears on the console:

%Overlapping diff-serv code points

Examples

The following example assigns DSCP levels 0 through 9 to PVC bundle member 300 in a Frame Relay PVC bundle called "MP-3-static":

interface serial 1/4
 frame-relay map ip 10.2.2.2 vc-bundle MP-3-static
 frame-relay vc-bundle MP-3-static
  pvc 300
   dscp 0-9

The following example changes the DSCP levels in the above example from 0 through 9 to 0, 9, and 20 through 29:

interface serial 1/4
 frame-relay map ip 10.2.2.2 vc-bundle MP-3-static
 frame-relay vc-bundle MP-3-static
  pvc 300
   dscp 0,9,20-29

Related Commands

Command
Description

exp

Configures MPLS EXP levels for a Frame Relay PVC bundle member.

frame-relay map

Defines mapping between a destination protocol address and the DLCI used to connect to the destination address.

frame-relay vc-bundle

Creates a Frame Relay PVC bundle and enters Frame Relay VC-bundle configuration mode.

match

Specifies which bits in the ToS octet to use for mapping packet service levels to Frame Relay PVC bundle members.

precedence (Frame Relay VC-bundle-member)

Configures the precedence levels for a Frame Relay PVC bundle member.

pvc (frame-relay vc-bundle)

Creates a PVC and PVC bundle member and enters Frame Relay VC-bundle-member configuration mode.


encapsulation (Frame Relay VC-bundle)

To override the encapsulation for a point-to-point subinterface and configure Frame Relay encapsulation for an individual Frame Relay permanent virtual circuit (PVC) bundle, use the encapsulation command in Frame Relay VC-bundle configuration mode. To disable the encapsulation for the individual PVC bundle and revert to the encapsulation for the point-to-point subinterface, use the no form of this command.

encapsulation [cisco | ietf]

no encapsulation [cisco | ietf]

Syntax Description

cisco

(Optional) Uses Cisco proprietary encapsulation, which is a four-byte header, with two bytes to identify the data-link connection identifier (DLCI) and two bytes to identify the packet type

ietf

(Optional) Sets the encapsulation method to comply with the Internet Engineering Task Force (IETF) standard (RFC 1490 and RFC 2427). Use this keyword when connecting to another vendor's equipment across a Frame Relay network on point-to-point interfaces.


Defaults

Encapsulation type that is configured on the main interface.

Command Modes

Frame Relay VC-bundle configuration

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Use this command to override the encapsulation at a point-to-point subinterface for an individual Frame Relay PVC bundle. This command is available for point-to-point subinterfaces only; it cannot be used on multipoint interfaces.

Examples

The following example configures RFC 1490 encapsulation for the Frame Relay PVC bundle named "P2P-5":

interface serial 1/4.2 point-to-point
 ip address 10.1.1.1 255.0.0.0
 frame-relay vc-bundle P2P-5
  encapsulation ietf 

Related Commands

Command
Description

encapsulation frame-relay

Enables Frame Relay encapsulation on an interface.


exp

To configure Multiprotocol Label Switching (MPLS) experimental (EXP) levels for a Frame Relay permanent virtual circuit (PVC) bundle member, use the exp command in Frame Relay VC-bundle-member configuration mode. To remove the EXP level configuration from the PVC, use the no form of this command.

exp {level | other}

no exp

Syntax Description

level

Specifies the MPLS EXP level or levels for this Frame Relay PVC bundle member. The range is from 0 to 7. A PVC bundle member can be configured with a single MPLS EXP level, multiple individual MPLS EXP levels, a range of MPLS EXP levels, multiple ranges of MPLS EXP levels, or a combination of individual levels and level ranges. Examples are as follows:

0

0,2,3

0-2,4-5

0,1,2-4,7

other

Specifies that this Frame Relay PVC bundle member will handle all of the remaining MPLS EXP levels that are not explicitly configured on any other bundle member PVCs.


Defaults

EXP levels are not configured.

Command Modes

Frame Relay VC-bundle-member configuration

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Assignment of MPLS EXP levels to Frame Relay PVC bundle members allows you to create differentiated service because you can distribute the levels over the various PVC bundle members. You can map a single level or a range of levels to each discrete PVC in the bundle, thereby enabling PVCs in the bundle to carry packets marked with different levels. Use the exp other command to indicate that a PVC can carry traffic marked with EXP levels not specifically configured for other PVCs. Only one PVC in the bundle can be configured using the exp other command.

All EXP levels must be accounted for in the PVC bundle configuration, or the bundle will not come up. Note, however, that a PVC may be a bundle member but have no EXP level associated with it. As long as all valid EXP levels are handled by other PVCs in the bundle, the bundle can come up, but the PVC that has no EXP level configured will not participate in it.

The exp command is available only when tag switching is configured on the interface with the tag-switching ip command.

You can overwrite the EXP level configuration on a PVC by reentering the exp command with a new value.

The MPLS experimental bits are a bit-by-bit copy of the IP precedence bits. When Frame Relay PVC bundles are configured for IP precedence and tag switching is enabled, the precedence command is replaced by the exp command. When tag switching is disabled, the exp command is replaced by the precedence command.

Examples

The following example shows the configuration of four Frame Relay PVC bundle members in PVC bundle "bundle1" configured with MPLS EXP level support:

interface serial 0.1 point-to-point
 encapsulation frame-relay
 ip address 10.1.1.1
 tag-switching ip
 frame-relay vc-bundle bundle1
 pvc 100 ny-control
 class control
 exp 7
 protect vc
 pvc 101 ny-premium
 class premium
 exp 6-5
 protect group
 no bump traffic
 bump explicit 7
 pvc 102 my-priority
 class priority
 exp 4-2
 protect group
 pvc 103 ny-basic
 class basic
 exp other
 protect group

Related Commands

Command
Description

bump

Configures the bumping rules for a specific PVC member of a bundle.

class

Associates a map class with a specified DLCI.

dscp (Frame Relay VC-bundle-member)

Configures the DSCP value or values for a Frame Relay PVC bundle member.

match

Specifies which bits of the IP header to use for mapping packet service levels to Frame Relay PVC bundle members.

precedence (Frame Relay VC-bundle-member)

Configures the precedence levels for a Frame Relay PVC bundle member.

protect

Configures a Frame Relay PVC bundle member with protected group or protected PVC status.

tag-switching ip

Enables label switching of IPv4 packets on an interface.


frame-relay inverse-arp

To reenable Inverse Address Resolution Protocol (Inverse ARP) on a specified interface, subinterface, data-link connection identifier (DLCI), or Frame Relay permanent virtual circuit (PVC) bundle if Inverse ARP was previously disabled, use the frame-relay inverse-arp command in interface configuration mode. To disable Inverse ARP, use the no form of this command.

frame-relay inverse-arp [protocol] [dlci | vc-bundle vc-bundle-name]

no frame-relay inverse-arp [protocol] [dlci | vc-bundle vc-bundle-name]

Syntax Description

protocol

(Optional) One of the following values: appletalk, decnet, ip, and ipx.

dlci

(Optional) One of the DLCI numbers used on the interface. Acceptable values are integers from 16 through 1007, inclusive.

vc-bundle vc-bundle-name

(Optional) A specific Frame Relay PVC bundle configured on the interface.


Defaults

Inverse ARP is enabled.

Command Modes

Interface configuration

Command History

Release
Modification

10.0

This command was introduced.

12.2(13)T

The vc-bundle vc-bundle-name keyword and argument pair was added.

The apollo, vines, and xns keywords were removed because Apollo Domain, Banyan VINES, and Xerox Network Systems are no longer available in the Cisco IOS software.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

To enable Inverse ARP for all protocols that were enabled before the prior no frame-relay inverse-arp command was issued, use the frame-relay inverse-arp command without arguments. To disable Inverse ARP for all protocols supported on an interface, use the no frame-relay inverse-arp command without arguments.

To enable or disable Inverse ARP for a specific protocol and DLCI pair, use both the protocol and dlci arguments. To enable or disable Inverse ARP for a specific protocol and Frame Relay PVC bundle (consisting of up to eight DLCIs), use both the protocol and vc-bundle vc-bundle-name elements.

To enable or disable Inverse ARP for all protocols on a DLCI or Frame Relay PVC bundle, use either the dlci argument by itself or the vc-bundle vc-bundle-name keyword and argument pair by itself. To enable or disable Inverse ARP for a specific protocol for all DLCIs on the specified interface or subinterface, use only the protocol argument.

When a Frame Relay PVC bundle is specified, only one member of the PVC bundle will handle Inverse ARP packets. By default, the bundle member PVC that handles precedence or EXP level 6 or DSCP level 63 handles Inverse ARP packets. Use the inarp command to configure a different PVC bundle member to handle Inverse ARP packets.

This implementation of Inverse ARP is based on RFC 1293. It allows a router or access server running Frame Relay to discover the protocol address at the other side of a virtual circuit.

The show frame-relay map command displays the word "dynamic" to flag virtual circuits that are created dynamically by Inverse ARP.

Examples

The following example sets Inverse ARP on DLCI 100 on an interface running Internetwork Packet Exchange (IPX):

interface serial 0
 frame-relay inverse-arp ipx 100

Related Commands

Command
Description

clear frame-relay-inarp

Clears dynamically created Frame Relay maps, which are created by the use of Inverse ARP.

inarp

Specifies the PVC bundle member used to handle the Inverse ARP packets.

show frame-relay map

Displays the current map entries and information about the connections.


frame-relay map

To define the mapping between a destination protocol address and the data-link connection identifier (DLCI) or Frame Relay permanent virtual circuit (PVC) bundle that connects to the destination address, use the frame-relay map command in interface configuration mode. To delete the map entry, use the no form of this command.

frame-relay map protocol protocol-address {dlci | vc-bundle vc-bundle-name}[broadcast] [ietf | cisco] [payload-compression {packet-by-packet | frf9 stac [one-way-negotiation] [ratio level] [skip-zero-sync] [software | hardware-options] | data-stream stac [one-way-negotiation] [ratio level] [software | hardware-options]}]

no frame-relay map protocol protocol-address

Syntax Description

protocol

One of the following values: appletalk, decnet, dlsw, ip, ipx, llc2, and rsrb.

protocol-address

Destination protocol address.

dlci

DLCI number used to connect to the specified protocol address on the interface. Acceptable numbers are integers from 16 through 1007, inclusive.

vc-bundle vc-bundle-name

A specific Frame Relay PVC bundle configured on the interface.

broadcast

(Optional) Forwards broadcasts to this address when multicast is not enabled (see the frame-relay multicast-dlci command for more information about multicasts). This keyword also simplifies the configuration of Open Shortest Path First (OSPF) (see the "Usage Guidelines" section for more detail).

ietf

(Optional) Internet Engineering Task Force (IETF) form of Frame Relay encapsulation, based on RFC 1490 and RFC 2427. Used when the router or access server is connected to another vendor's equipment across a Frame Relay network.

cisco

(Optional) Cisco-proprietary encapsulation method consisting of a four-byte header, with two bytes to identify the DLCI and two bytes to identify the packet type.

payload-compression

(Optional) Enables payload compression.

packet-by-packet

(Optional) Packet-by-packet payload compression using the Stacker method.

frf9 stac

(Optional) Enables FRF.9 compression using the Stacker method.

If the router contains a CSA1 , compression is performed in the CSA hardware (hardware compression).

If the CSA is not available, compression is performed in the software installed on the VIP22 (distributed compression).

If the VIP2 is not available, compression is performed in the main processor of the router (software compression).

one-way-negotiation

(Optional) Enables one-way negotiation. Use this keyword if your router will be negotiating compression with another device that is running Cisco IOS Release 12.1(9) or earlier releases. Later Cisco IOS releases use a two-way handshake by default to negotiate compression.

ratio level

(Optional) Sets throughput versus compression ratio. This option is available only with hardware compression. Values for the level argument are as follows:

high—high compression versus low throughput

medium—medium compression versus medium throughput

low—low compression versus high throughput (default)

skip-zero-sync

(Optional) Causes compression frames to be numbered starting from 1 rather than 0. Use this keyword if your router will be interoperating with a device conforming to IBM partner conventions.

software

(Optional) Specifies that compression is implemented in the Cisco IOS software installed in the main processor of the router.

hardware-options

(Optional) Choose one of the following hardware options:

caim element-number—Enables the CAIM3 to perform compression.

distributed—Specifies that compression is implemented in the software that is installed in a VIP2. If the VIP2 is not available, compression is performed in the main processor of the router (software compression). This option applies only to the Cisco 7500 series routers. This option is not supported with data-stream compression.

csa csa-numberSpecifies the CSA to use for a particular interface. This option applies only to Cisco 7200 series routers.

data-stream stac

(Optional) Enables data-stream compression using the Stacker method.

If the router contains a CSA, compression is performed in the CSA hardware (hardware compression).

If the CSA is not available, compression is performed in the main processor of the router (software compression).

1 CSA = compression service adapter

2 VIP2 = second-generation Versatile Interface Processor

3 CAIM = compression Advanced Interface Module


Defaults

No mapping is defined.

Command Modes

Interface configuration

Command History

Release
Modification

10.0

This command was introduced.

11.3

The payload-compress frf9 stac keyword was added.

12.1(5)T

The payload-compress data-stream stac keyword was added.

12.2(4)T

The skip-zero-sync keyword was added.

12.2(13)T

The vc-bundle vc-bundle-name keyword and argument pair was added.

The apollo, vines, and xns arguments were removed because Apollo Domain, Banyan VINES, and Xerox Network Systems are no longer available in the Cisco IOS software.

The one-way-negotiation keyword was added.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Many DLCIs can be known by a router or access server and can send data to many different places, but they are all multiplexed over one physical link. The Frame Relay map defines the logical connection between a specific protocol and address pair and the correct DLCI or PVC bundle.

The optional ietf and cisco keywords allow flexibility in the configuration. If no keywords are specified, the map inherits the attributes set with the encapsulation frame-relay command. You can also use the encapsulation options to specify, for example, that all interfaces use IETF encapsulation except one, which needs the original Cisco encapsulation method and can be configured through use of the cisco keyword with the frame-relay map command.

Data-stream compression is supported on interfaces and virtual circuits (VCs) using Cisco proprietary encapsulation. When the data-stream stac keyword is specified, Cisco encapsulation is automatically enabled. FRF.9 compression is supported on IETF-encapsulated VCs and interfaces. When the frf9 stac keyword is specified, IETF encapsulation is automatically enabled.

Packet-by-packet compression is Cisco-proprietary and will not interoperate with routers of other manufacturers.

You can disable payload compression by entering the no frame-relay map payload command and then entering the frame-relay map command again with one of the other encapsulation keywords (ietf or cisco).

Use the frame-relay map command to enable or disable payload compression on multipoint interfaces. Use the frame-relay payload-compression command to enable or disable payload compression on point-to-point interfaces.

We recommend that you shut down the interface before changing encapsulation types. Although shutting down the interface is not required, it ensures that the interface is reset for the new encapsulation.

The broadcast keyword provides two functions: it forwards broadcasts when multicasting is not enabled, and it simplifies the configuration of OSPF for nonbroadcast networks that will use Frame Relay.

The broadcast keyword may also be required for some routing protocols—for example, AppleTalk—that depend on regular routing table updates, especially when the router at the remote end is waiting for a routing update packet to arrive before adding the route.

By requiring selection of a designated router, OSPF treats a nonbroadcast multiaccess network such as Frame Relay in much the same way as it treats a broadcast network. When the frame-relay map command (with the broadcast keyword) and the ip ospf network command (with the broadcast keyword) are configured, there is no need to configure any neighbors manually. OSPF will run automatically over the Frame Relay network as a broadcast network. (See the ip ospf network interface command for more detail.)


Note The OSPF broadcast mechanism assumes that IP class D addresses are never used for regular traffic over Frame Relay.


Examples

IP Address to DLCI Mapping Example

The following example maps the destination IP address 172.16.123.1 to DLCI 100:

interface serial 0
 frame-relay map ip 172.16.123.1 100 broadcast

OSPF will use DLCI 100 to broadcast updates.

IP Address to Frame Relay PVC Bundle Mapping Example

The following example maps the destination IP address 172.16.123.1 to the Frame Relay PVC bundle named "MAIN-1":

interface serial 0
 frame-relay map ip 172.16.123.1 vc-bundle MAIN-1 broadcast

FRF.9 Compression Example

The following example shows FRF.9 compression configuration using the frame-relay map command:

interface serial2/0/1
 ip address 172.16.1.4 255.255.255.0
 no ip route-cache
 encapsulation frame-relay ietf
 no keepalive
 shutdown
 frame-relay map ip 172.16.1.1 105 ietf payload-compression frf9 stac

Data-Stream Compression Example

The following example shows data-stream compression configuration using the frame-relay map command:

interface serial0/0
 frame-relay map ip 10.0.0.1 100 payload-compression data-stream stac

Related Commands

Command
Description

encapsulation frame-relay

Enables Frame Relay encapsulation on an interface.

frame-relay payload-compression

Enables Stacker payload compression on a specified point-to-point interface or subinterface.

frame-relay vc-bundle

Creates a Frame Relay PVC bundle and enters Frame Relay VC-bundle configuration mode.

ip ospf network

Configures the OSPF network type to a type other than the default for a given medium.


frame-relay vc-bundle

To create a Frame Relay permanent virtual circuit (PVC) bundle if it does not already exist, and to enter Frame Relay VC-bundle configuration mode, use the frame-relay vc-bundle command in interface configuration mode. To remove a Frame Relay PVC bundle, use the no form of this command.

frame-relay vc-bundle vc-bundle-name

no frame-relay vc-bundle vc-bundle-name

Syntax Description

vc-bundle-name

User-defined name of this Frame Relay PVC bundle.


Defaults

A bundle is not created.

Command Modes

Interface configuration

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Use this command to create a unique Frame Relay PVC bundle if one has not already been created using the frame-relay map command. Also use this command to enter Frame Relay VC-bundle configuration mode so you can configure PVC bundle attributes and PVC bundle members.

Examples

The following example creates a PVC bundle named "MAIN-1":

interface serial 0
 frame-relay vc-bundle MAIN-1

Related Commands

Command
Description

frame-relay map

Defines mapping between a destination protocol address and the DLCI or Frame Relay PVC bundle that connects to the destination address.


inarp (Frame Relay VC-bundle-member)

To override the default permanent virtual circuit (PVC) bundle member used for Inverse Address Resolution Protocol (ARP) and specify a different PVC bundle member to handle the Inverse ARP packets, use the inarp command in Frame Relay VC-bundle-member configuration mode. To disable Inverse ARP on the PVC bundle member, use the no form of this command.

inarp

no inarp

Syntax Description

This command has no arguments or keywords.

Defaults

Inverse ARP is handled by the PVC that handles precedence or EXP level 6 or DSCP level 63.

Command Modes

Frame Relay VC-bundle-member configuration

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

In each Frame Relay PVC bundle, Inverse ARP by default is handled by the PVC that handles precedence or EXP level 6 or DSCP level 63. In the default case, if the PVC handling Inverse ARP traffic goes down, the Inverse ARP packets are diverted to the PVC that has been configured to handle the bumped traffic for precedence level 6 or DSCP level 63.

Inverse ARP packets arriving on PVCs that are not configured to handle Inverse ARP will be dropped.

If you override the default packet service levels and enable Inverse ARP on a PVC that handles a different precedence or DSCP level, and that PVC goes down, the Inverse ARP packets will be dropped even if another PVC accepts the bumped traffic from the failed PVC.

If the inarp command is entered on two different PVC bundle members, Inverse ARP traffic will be handled by the second entry.

Examples

The following example shows Inverse ARP enabled on PVC 250, which handles DSCP level 60:

interface serial 1/4.1 multipoint
 frame-relay vc-bundle MP-4-dynamic
  match dscp
  pvc 100
   dscp other
  pvc 250
   dscp 60
   inarp

Related Commands

Command
Description

dscp (Frame Relay VC-bundle-member))

Configures the DSCP value or values for a Frame Relay PVC bundle member.

precedence (Frame Relay VC-bundle-member)

Configures the precedence levels for a Frame Relay PVC bundle member.


match

To specify match criteria for the NetFlow MIB and Top Talkers feature, use the match command in NetFlow top talkers configuration mode. To remove match criteria for the NetFlow MIB and Top Talkers feature, use the no form of this command.

match [[source address | destination address | nexthop address] [ip-address] [mask | /nn]] [[source port | destination port] [port-number | min port | max port | min port max port]] [[source as | destination as] as-number] [[input-interface | output-interface] interface] [tos [tos-value dscp dscp-value | precedence precedence-value]] [protocol [protocol-number | tcp | udp]] [flow-sampler flow-sampler-name] [class-map class] [packet-range | byte-range [[min-range-number max-range-number] [min minimum-range | max maximum-range | min minimum-range max maximum-range]]]

no match [[source address | destination address | nexthop address] [ip-address] [mask | /nn]] [[source port | destination port] [port-number | min port | max port | min port max port]] [[source as | destination as] as-number] [[input-interface | output-interface] interface] [tos [tos-value dscp dscp-value | precedence precedence-value]] [protocol [protocol-number | tcp | udp]] [flow-sampler flow-sampler-name] [class-map class] [packet-range | byte-range [[min-range-number max-range-number] [min minimum-range | max maximum-range | min minimum-range max maximum-range]]]

Syntax Description

source address

(Optional) Specifies that the match criterion is based on the source IP address.

destination address

(Optional) Specifies that the match criterion is based on the destination IP address.

nexthop address

(Optional) Specifies that the match criterion is based on the next hop IP address.

ip-address

(Optional) IP address of the source, destination, or next-hop address to be matched.

mask

(Optional) Address mask, in dotted decimal format.

/nn

(Optional) Address mask as entered in Classless InterDomain Routing (CIDR) format. An address mask of 255.255.255.0 is equivalent to a /24 mask in CIDR format.

source port

(Optional) Specifies that the match criterion is based on the source port.

destination port

(Optional) Specifies that the match criterion is based on the destination port.

port-number

(Optional) Specifies that the match criterion is based on the port number.

min port

(Optional) The minimum port number to be matched. Any port number equal to or greater than this number constitutes a match. Range: 0 to 65535.

max port

(Optional) The maximum port number to be matched. Any port number equal to or less than this number constitutes a match. Range: 0 to 65535.

min port max port

(Optional) A range of port numbers to be matched. Range: 0 to 65535.

source as

(Optional) Specifies that the match criterion is based on the source autonomous system.

destination as

(Optional) Specifies that the match criterion is based on the destination autonomous system.

as-number

(Optional) The autonomous system number to be matched.

input-interface

(Optional) Specifies that the match criterion is based on the input interface.

output-interface

(Optional) Specifies that the match criterion is based on the output interface.

interface

(Optional) The interface to be matched.

tos

(Optional) Specifies that the match criterion is based on type of service (ToS).

tos-value

(Optional) The ToS to be matched.

dscp dscp-value

(Optional) Differentiated services code point (DSCP) value to be matched.

precedence precedence-value

(Optional) Precedence value to be matched.

protocol

(Optional) Specifies that the match criterion is based on protocol.

protocol-number

(Optional) The protocol number to be matched. Range: 0 to 255.

tcp

(Optional) The protocol number to be matched as TCP.

udp

(Optional) The protocol number to be matched as UDP.

flow-sampler

(Optional) The match criterion is based on top talker sampling.

flow-sampler-name

(Optional) Name of the top talker sampler to be matched.

class-map

(Optional) Specifies that the match criterion is based on a class map.

class

(Optional) Name of the class map to be matched.

packet-range

(Optional) The protocol number to be matched on a range of packets.

byte-range

(Optional) The protocol number to be matched on a range of bytes.

min-range-number max-range-number

(Optional) Range of bytes or packets to be matched. These numbers can range from 1 to 4,294,967,295.

min minimum-range

(Optional) Minimum number of bytes or packets to be matched. Range: 1 to 4,294,967,295.

max maximum-range

(Optional) Maximum number of bytes or packets to be matched. Range: 1 to 4,294,967,295.

min minimum-range max maximum-range

(Optional) Range of bytes or packets to be matched. Range: 1 to 4,294,967,295.


Defaults

No matching criteria are specified by default. All top talkers will be displayed.

Command Modes

NetFlow top talkers configuration

Command History

Release
Modification

12.2(25)S

This command was introduced.

12.3(11)T

This feature was integrated into Cisco IOS Release 12.3(11)T.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Use this command to specify match criteria for the NetFlow MIB and Top Talkers feature. Using matching criteria is useful to restrict the list of top talkers.

If you are using a MIB and using simple network management protocol (SNMP) commands to configure this feature, refer to the following table for a mapping of the command-line interface (CLI) commands to the MIB SNMP commands:

Table 1 Router CLI Commands and Equivalent SNMP Commands 

Router CLI Command
SNMP Command

match source address [ip-address] [mask | /nn]

cnfTopFlowsMatchSrcAddress ip-address

cnfTopFlowsMatchSrcAddressType type1

cnfTopFlowsMatchSrcAddressMask mask

match destination address [ip-address] [mask | /nn]

cnfTopFlowsMatchDstAddress ip-address

cnfTopFlowsMatchDstAddressType type1

cnfTopFlowsMatchDstAddressMask mask

match nexthop address [ip-address] [mask | /nn]]

cnfTopFlowsMatchNhAddress ip-address

cnfTopFlowsMatchNhAddressType type1

cnfTopFlowsMatchNhAddressMask mask

match source port min port

cnfTopFlowsMatchSrcPortLo port

match source port max port

cnfTopFlowsMatchSrcPortHi port

match destination port min port

cnfTopFlowsMatchDstPortLo port

match destination port max port

cnfTopFlowsMatchDstPortHi port

match source as as-number

cnfTopFlowsMatchSrcAS as-number

match destination as as-number

cnfTopFlowsMatchDstAS as-number

match input-interface interface

cnfTopFlowsMatchInputIf interface

match output-interface interface

cnfTopFlowsMatchOutputIf interface

match  tos [tos-value dscp dscp-value | precedence precedence-value]

cnfTopFlowsMatchTOSByte tos-value2

match protocol [protocol-number | tcp | udp]

cnfTopFlowsMatchProtocol protocol-number

match flow-sampler flow-sampler-name

cnfTopFlowsMatchSampler flow-sampler-name

match class-map class

cnfTopFlowsMatchClass class

match packet-range min minimum-range

cnfTopFlowsMatchMinPackets minimum-range

match packet-range max maximum-range

cnfTopFlowsMatchMaxPackets maximum-range

match byte-range min minimum-range

cnfTopFlowsMatchMinBytes minimum-range

match byte-range max maximum-range

cnfTopFlowsMatchMaxPackets maximum-range

1 The only IP version type that is currently supported is IPv4 (type 1).

2 tos-value is 6 bits for DSCP, 3 bits for precedence, and 8 bits (one byte) for ToS.


Examples

The following example enters NetFlow top talkers configuration mode and specifies that the top talkers will contain the following characteristics:

The list of top talkers will have an IP address of 10.1.1.17 with a subnet mask of 255.255.255.240 (/28).

The list of top talkers will have an autonomous system number of 64512.

Router(config)# ip flow-top-talkers
Router(config-flow-top-talkers)# match source address 10.1.1.17/28
Router(config-flow-top-talkers)# match destination as 64512

Related Commands

Command
Description

cache-timeout

Specifies the length of time for which the list of top talkers is retained.

ip flow-top-talkers

Enters NetFlow top talkers configuration mode.

show ip flow top-talkers

Displays the list of top talkers.

sort-by

Specifies the sorting criterion for the NetFlow MIB and Top Talkers feature.

top

Specifies the maximum number of top talkers to be displayed.


precedence (Frame Relay VC-bundle-member)

To configure the precedence levels for a Frame Relay permanent virtual circuit (PVC) bundle member, use the precedence command in Frame Relay VC-bundle-member configuration mode. To remove the precedence level configuration from the PVC, use the no form of this command.

precedence {level | other}

no precedence

Syntax Description

level

Specifies the precedence level or levels for this Frame Relay PVC bundle member. The range is from 0 to 7. A PVC bundle member can be configured with a single precedence level, multiple individual precedence levels, a range of precedence levels, multiple ranges of precedence levels, or a combination of individual levels and level ranges. Examples are as follows:

0

0,2,3

0-2,4-5

0,1,2-4,7

other

Specifies that this Frame Relay PVC bundle member will handle all of the remaining precedence levels that are not explicitly configured on any other bundle member PVCs.


Defaults

Precedence levels are not configured.

Command Modes

Frame Relay VC-bundle-member configuration

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Assignment of precedence levels to PVC bundle members allows you to create differentiated service because you can distribute the IP precedence levels over the various PVC bundle members. You can map a single precedence level or a range of levels to each discrete PVC in the bundle, thereby enabling PVCs in the bundle to carry packets marked with different precedence levels. Use the precedence other command to indicate that a PVC can carry traffic marked with precedence levels not specifically configured for other PVCs. Only one PVC in the bundle can be configured using the precedence other command.

This command is available only when the match type for the PVC bundle is set to precedence using the match precedence command in Frame Relay VC-bundle configuration mode.

You can overwrite the precedence level configuration on a PVC by reentering the precedence command with a new level value.

All precedence levels must be accounted for in the PVC bundle configuration, or the bundle will not come up. Note, however, that a PVC may be a bundle member but have no precedence level associated with it. As long as all valid precedence levels are handled by other PVCs in the bundle, the bundle can come up, but the PVC that has no precedence level configured will not participate in it.

A precedence level can be configured on one PVC bundle member per bundle. If you configure the same precedence level on more than one PVC within a bundle, the following error warning appears on the console:

%Overlapping precedence levels

When tag switching is enabled on the interface by using the tag-switching ip command, MPLS and IP packets can flow across the interface, and PVC bundles that are configured for IP precedence mapping are converted to MPLS experimental (EXP) mapping. The PVC bundle functionality remains the same with respect to priority levels, bumping, and so on, but the match precedence command is replaced by "match exp," and each precedence command is replaced by the exp command. The result is that a bundle-member PVC previously configured to carry precedence level 1 IP traffic now carries EXP level 1 MPLS traffic.

When tag switching is disabled, the match precedence and match dscp commands are restored, and the exp commands are replaced by precedence commands.

When tag switching is enabled or disabled, PVC bundles configured for IP precedence mapping or MPLS EXP mapping will stay up, and traffic will be sent over the appropriate bundle-member PVCs.

Examples

The following example configures Frame Relay PVC bundle member 101 to carry traffic with IP precedence level 5:

frame-relay vc-bundle bundle1
 match precedence
 pvc 101
 precedence 5

Related Commands

Command
Description

bump

Configures the bumping rules for a specific PVC member of a bundle.

class

Associates a map class with a specified DLCI.

dscp (Frame Relay VC-bundle-member)

Configures the DSCP value or values for a Frame Relay PVC bundle member.

exp

Configures MPLS EXP levels for a Frame Relay PVC bundle member.

match

Specifies which bits of the IP header to use for mapping packet service levels to Frame Relay PVC bundle members.

protect (Frame Relay VC-bundle-member)

Configures a Frame Relay PVC bundle member with protected group or protected PVC status.


protect (Frame Relay VC-bundle-member)

To configure a Frame Relay protected permanent virtual circuit (PVC) bundle member with protected group or protected PVC status, use the protect command in Frame Relay VC-bundle-member configuration mode. To remove the protected status from the PVC, use the no form of this command.

protect {group | vc}

no protect {group | vc}

Syntax Description

group

Configures the PVC bundle member as part of a collection of protected PVCs within the PVC bundle.

vc

Configures the PVC member as individually protected.


Defaults

The PVC neither belongs to the protected group nor is an individually protected PVC.

Command Modes

Frame Relay VC-bundle-member configuration

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

When an individually protected PVC goes down, it takes the bundle down. When all members of a protected group go down, the bundle goes down.

Despite any protection configurations, the PVC bundle will go down if a downed PVC has no PVC to which to bump its traffic or if the last PVC that is up in a PVC bundle goes down.

Examples

The following example configures Frame Relay PVC bundle member 101 as an individually protected PVC:

frame-relay vc-bundle bundle1
 pvc 101
  protect vc

Related Commands

Command
Description

bump

Configures the bumping rules for a specific PVC member of a bundle.

bundle

Creates a bundle or modifies an existing bundle to enter bundle configuration mode.

dscp (Frame Relay VC-bundle-member)

Configures the DSCP value or values for a Frame Relay PVC bundle member.

exp

Configures MPLS EXP levels for a Frame Relay PVC bundle member.

precedence (Frame Relay VC-bundle-member)

Configures the precedence levels for a Frame Relay PVC bundle member.


pvc (Frame Relay VC-bundle)

To create a permanent virtual circuit (PVC) that is a Frame Relay PVC bundle member, and to enter Frame Relay VC-bundle-member configuration mode, use the pvc command in Frame Relay VC-bundle configuration mode. To delete the PVC from the Frame Relay PVC bundle, use the no form of this command.

pvc dlci [vc-name]

no pvc dlci [vc-name]

Syntax Description

dlci

Data-link connection identifier (DLCI) number used to identify the PVC.

vc-name

(Optional) An alphanumeric name for the PVC.


Defaults

No PVC is defined.

Command Modes

Frame Relay VC-bundle configuration

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

To use this command, you must first create a Frame Relay PVC bundle and enter Frame Relay VC-bundle configuration mode.

A PVC bundle must have at least one PVC for the bundle to come up. A PVC bundle cannot have more than eight PVCs. If you try to configure more than eight PVCs in a bundle, the following message will appear on the console:

%FR vc-bundle contains 8 members. Cannot add another.

Dynamic PVCs can be specified as PVC bundle members; however, if a PVC has already been created by using some other configuration command, you will not be able to add it to a PVC bundle. If you try to add it to a bundle, the following message will appear on the console:

%DLCI 200 is not a dynamic PVC. Cannot add to VC-Bundle.

If a PVC is already a member of a PVC bundle, any attempt to reuse that same PVC in a command that creates a PVC (for example, frame-relay interface-dlci, frame-relay local-dlci) will result in the following error message:

%Command is inapplicable to vc-bundle PVCs.

Examples

The following example creates PVC 101 belonging to the Frame Relay PVC bundle named "bundle1":

frame-relay vc-bundle bundle1
 pvc 101

Related Commands

Command
Description

dscp (frame-relay vc-bundle-member)

Configures the DSCP value or values for a Frame Relay PVC bundle member.

exp

Configures MPLS EXP levels for a Frame Relay PVC bundle member.

frame-relay vc-bundle

Creates a Frame Relay PVC bundle and enters Frame Relay VC-bundle configuration mode.

match

Specifies which bits of the IP header to use for mapping packet service levels to Frame Relay PVC bundle members

precedence (Frame Relay VC-bundle-member)

Configures the precedence levels for a Frame Relay PVC bundle member.


show frame-relay ip rtp header-compression

To display Frame Relay Real-Time Transport Protocol (RTP) header compression statistics, use the show frame-relay ip rtp header-compression command in user EXEC or privileged EXEC mode.

show frame-relay ip rtp header-compression [interface type number] [dlci]

Syntax Description

interface type number

(Optional) Specifies an interface for which information will be displayed. A space between the type and number is optional.

dlci

(Optional) Specifies a data-link connection identifier (DLCI) for which information will be displayed. Range: 16 to 1022.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

11.3

This command was introduced.

12.2(13)T

This command was modified to support display of TCP/IP header compression statistics for Frame Relay permanent virtual circuit (PVC) bundles.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC, and the DLCI argument was added to the command syntax.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Examples

The following is sample output from the show frame-relay ip rtp header-compression command:

Router# show frame-relay ip rtp header-compression 

DLCI 17 	 Link/Destination info: ip 10.1.1.1 
  Interface Serial0:
    Rcvd:    0 total, 0 compressed, 0 errors
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    6000 total, 5998 compressed, 
             227922 bytes saved, 251918 bytes sent
             1.90 efficiency improvement factor
    Connect: 16 rx slots, 16 tx slots, 2 long searches, 2 misses
             99% hit ratio, five minute miss rate 0 misses/sec, 0 max

DLCI 21         Link/Destination info: ip 10.1.4.1
  Interface Serial 3/0 DLCI 21 (compression on, Cisco)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

 DLCI 20         Link/Destination info: ip 10.1.1.1
  Interface Serial 3/1 DLCI 20 (compression on, Cisco)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

 DLCI 21         Link/Destination info: ip 10.1.2.1
  Interface Serial 3/1 DLCI 21 (compression on, Cisco)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

 DLCI 22         Link/Destination info: ip 10.1.3.1
  Interface Serial 3/1 DLCI 22 (compression on, Cisco)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

In the following example, the show frame-relay ip rtp header-compression command displays information about DLCI 21:

Router# show frame-relay ip rtp header-compression 21

 DLCI 21         Link/Destination info: ip 10.1.4.1
  Interface Serial 3/0 DLCI 21 (compression on, Cisco)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

 DLCI 21         Link/Destination info: ip 10.1.2.1
  Interface Serial 3/1 DLCI 21 (compression on, Cisco)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

In the following example, the show frame-relay ip rtp header-compression command displays information for all DLCIs on serial interface 3/1:

Router# show frame-relay ip rtp header-compression interface serial 3/1

 DLCI 20         Link/Destination info: ip 10.1.1.1
  Interface Serial 3/1 DLCI 20 (compression on, Cisco)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

 DLCI 21         Link/Destination info: ip 10.1.2.1
  Interface Serial 3/1 DLCI 21 (compression on, Cisco)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

 DLCI 22         Link/Destination info: ip 10.1.3.1
  Interface Serial 3/1 DLCI 22 (compression on, Cisco)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

In the following example, the show frame-relay ip rtp header-compression command displays information for only DLCI 21 on serial interface 3/1:

Router# show frame-relay ip rtp header-compression interface serial 3/1 21

 DLCI 21         Link/Destination info: ip 10.1.2.1
  Interface Serial 3/1 DLCI 21 (compression on, Cisco)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

The following sample output from the show frame-relay ip rtp header-compression command shows statistics for a PVC bundle called MP-3-static:

Router# show frame-relay ip rtp header-compression interface Serial 1/4

 vc-bundle MP-3-static      Link/Destination info:ip 10.1.1.1
  Interface Serial 1/4:
    Rcvd:   14 total, 13 compressed, 0 errors
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:   15 total, 14 compressed,
             474 bytes saved, 119 bytes sent
             4.98 efficiency improvement factor
    Connect:256 rx slots, 256 tx slots,
             1 long searches, 1 misses 0 collisions, 0 negative cache hits
             93% hit ratio, five minute miss rate 0 misses/sec, 0 max

Table 2 describes the significant fields shown in the display.

Table 2 show frame-relay ip rtp header-compression Field Descriptions 

Field
Description

Interface Serial0

Type and number of the interface.

Rcvd:

Table of details concerning received packets.

total

Number of packets received on the interface.

compressed

Number of packets with compressed header.

errors

Number of errors.

dropped

Number of dropped packets.

buffer copies

Number of buffers that were copied.

buffer failures

Number of failures in allocating buffers.

Sent:

Table of details concerning sent packets.

total

Total number of packets sent.

compressed

Number of packets sent with compressed header.

bytes saved

Total savings in bytes due to compression.

bytes sent

Total bytes sent after compression.

efficiency improvement factor

Compression efficiency.

Connect:

Table of details about the connections.

rx slots

Total number of receive slots.

tx slots

Total number of transmit slots.

long searches

Searches that needed more than one lookup.

misses

Number of new states that were created.

hit ratio

Number of times existing states were revised.

five minute miss rate

Average miss rate.

max

Maximum miss rate.


Related Commands

Command
Description

frame-relay ip rtp compression-connections

Specifies the maximum number of RTP header compression connections on a Frame Relay interface.

frame-relay ip rtp header-compression

Enables RTP header compression for all Frame Relay maps on a physical interface.

frame-relay map ip compress

Enables both RTP and TCP header compression on a link.

frame-relay map ip nocompress

Disables both RTP and TCP header compression on a link.

frame-relay map ip rtp header-compression

Enables RTP header compression per DLCI.

show ip rpf events

Displays RTP header compression statistics.


show frame-relay ip tcp header-compression

To display Frame Relay TCP/IP header compression information, use the show frame-relay ip tcp header-compression command in user EXEC or privileged EXEC mode.

show frame-relay ip tcp header-compression [interface type number] [dlci]

Syntax Description

interface type number

(Optional) Specifies an interface for which information will be displayed. A space is optional between the type and number.

dlci

(Optional) Specifies a data-link connection identifier (DLCI) for which information will be displayed. Range: 16 to 1022.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

10.3

This command was introduced.

12.2(13)T

This command was modified to support display of TCP/IP header compression statistics for Frame Relay permanent virtual circuit (PVC) bundles.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC, and the DLCI argument was added to the command syntax.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Examples

The following is sample output from the show frame-relay ip tcp header-compression command:

Router# show frame-relay ip tcp header-compression


DLCI 200          Link/Destination info: ip 10.108.177.200
Interface Serial0:
Rcvd:     40 total, 36 compressed, 0 errors
          0 dropped, 0 buffer copies, 0 buffer failures
Sent:     0 total, 0 compressed
          0 bytes saved, 0 bytes sent
Connect:  16 rx slots, 16 tx slots, 0 long searches, 0 misses, 0% hit ratio
          Five minute miss rate 0 misses/sec, 0 max misses/sec

The following sample output from the show frame-relay ip rtp header-compression command shows statistics for a PVC bundle called "MP-3-static":

Router# show frame-relay ip tcp header-compression interface Serial 1/4


 vc-bundle MP-3-static      Link/Destination info:ip 10.1.1.1
  Interface Serial1/4:
    Rcvd:   14 total, 13 compressed, 0 errors
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:   15 total, 14 compressed,
             474 bytes saved, 119 bytes sent
             4.98 efficiency improvement factor
    Connect:256 rx slots, 256 tx slots,
             1 long searches, 1 misses 0 collisions, 0 negative cache hits
             93% hit ratio, five minute miss rate 0 misses/sec, 0 max

In the following example, the show frame-relay ip tcp header-compression command displays information about DLCI 21:

Router# show frame-relay ip tcp header-compression 21


DLCI 21         Link/Destination info: ip 10.1.2.1
  Interface POS2/0 DLCI 21 (compression on, VJ)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

 DLCI 21         Link/Destination info: ip 10.1.4.1
  Interface Serial3/0 DLCI 21 (compression on, VJ)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

The following is sample output from the show frame-relay ip tcp header-compression command for a specific DLCI on a specific interface:

Router# show frame-relay ip tcp header-compression pos 2/0 21

DLCI 21         Link/Destination info: ip 10.1.2.1
  Interface POS2/0 DLCI 21 (compression on, VJ)
    Rcvd:    0 total, 0 compressed, 0 errors, 0 status msgs
             0 dropped, 0 buffer copies, 0 buffer failures
    Sent:    0 total, 0 compressed, 0 status msgs, 0 not predicted
             0 bytes saved, 0 bytes sent
    Connect: 256 rx slots, 256 tx slots, 
             0 misses, 0 collisions, 0 negative cache hits, 256 free contexts

Table 3 describes the significant fields shown in the display.

Table 3 show frame-relay ip tcp header-compression Field Descriptions 

Field
Description

Rcvd:

Table of details concerning received packets.

total

Sum of compressed and uncompressed packets received.

compressed

Number of compressed packets received.

errors

Number of errors caused by errors in the header fields (version, total length, or IP checksum).

dropped

Number of packets discarded. Seen only after line errors.

buffer failures

Number of times that a new buffer was needed but was not obtained.

Sent:

Table of details concerning sent packets.

total

Sum of compressed and uncompressed packets sent.

compressed

Number of compressed packets sent.

bytes saved

Number of bytes reduced because of the compression.

bytes sent

Actual number of bytes transmitted.

Connect:

Table of details about the connections.

rx slots, tx slots

Number of states allowed over one TCP connection. A state is recognized by a source address, a destination address, and an IP header length.

long searches

Number of times that the connection ID in the incoming packet was not the same as the previous one that was processed.

misses

Number of times that a matching entry was not found within the connection table and a new entry had to be entered.

hit ratio

Percentage of times that a matching entry was found in the compression tables and the header was compressed.

Five minute miss rate

Miss rate computed over the most recent 5 minutes and the maximum per-second miss rate during that period.


show frame-relay map

To display current Frame Relay map entries and information about connections, use the show frame-relay map command in privileged EXEC mode.

show frame-relay map [interface type number] [dlci]

Syntax Description

interface type number

(Optional) Specifies an interface for which mapping information will be displayed. A space is optional between the type and number.

dlci

(Optional) Specifies a data-link connection identifier (DLCI) for which mapping information will be displayed. Range: 16 to 1022.


Command Modes

Privileged EXEC

Command History

Release
Modification

10.0

This command was introduced.

12.2(2)T

The display output for this command was modified to include the IPv6 address mappings of remote nodes to Frame Relay permanent virtual circuits (PVCs).

12.0(21)ST

This command was integrated into Cisco IOS Release 12.0(21)ST.

12.0(22)S

This command was integrated into Cisco IOS Release 12.0(22)S.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(13)T

The display output for this command was modified to include information about Frame Relay PVC bundle maps.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB, and the interface and dlci arguments were added to the command syntax.


Examples

This section contains the following examples:

Sample Router Configuration

Display All Maps: Example

Display Maps for a Specific DLCI: Example

Display Maps for a Specific Interface: Example

Display Map for a Specific DLCI on a Specific Interface: Example

Display Maps for a Specific Subinterface: Example

Display Maps for a Specific DLCI on a Specific Subinterface: Example

Maps with IPV6 Addresses: Example

Maps for VC Bundles: Example

Sample Router Configuration

This configuration example corresponds to the following examples of output for the show frame-relay map command:

interface POS2/0
 no ip address
 encapsulation frame-relay
 frame-relay map ip 10.1.1.1 20 tcp header-compression
 frame-relay map ip 10.1.2.1 21 tcp header-compression
 frame-relay map ip 10.1.3.1 22 tcp header-compression
 frame-relay map bridge 23
 frame-relay interface-dlci 25
 frame-relay interface-dlci 26
 bridge-group 1
interface POS2/0.1 point-to-point
 frame-relay interface-dlci 24 protocol ip 10.1.4.1

interface Serial3/0
 no ip address
 encapsulation frame-relay
 serial restart-delay 0
 frame-relay map ip 172.16.3.1 20
 frame-relay map ip 172.16.4.1 21 tcp header-compression active
 frame-relay map ip 172.16.1.1 100
 frame-relay map ip 172.16.2.1 101
interface Serial3/0.1 multipoint
 frame-relay map ip 192.168.11.11 24
 frame-relay map ip 192.168.11.22 105

Display All Maps: Example

Router# show frame-relay map

POS2/0 (up): ip 10.1.1.1 dlci 20(0x14,0x440), static,
              CISCO, status deleted
              TCP/IP Header Compression (enabled), connections: 256
POS2/0 (up): ip 10.1.2.1 dlci 21(0x15,0x450), static,
              CISCO, status deleted
              TCP/IP Header Compression (enabled), connections: 256
POS2/0 (up): ip 10.1.3.1 dlci 22(0x16,0x460), static,
              CISCO, status deleted
              TCP/IP Header Compression (enabled), connections: 256
POS2/0 (up): bridge dlci 23(0x17,0x470), static,
              CISCO, status deleted
POS2/0.1 (down): point-to-point dlci, dlci 24(0x18,0x480), broadcast
          status deleted
Serial3/0 (down): ip 172.16.3.1 dlci 20(0x14,0x440), static,
              CISCO, status deleted
Serial3/0 (down): ip 172.16.4.1 dlci 21(0x15,0x450), static,
              CISCO, status deleted
              TCP/IP Header Compression (enabled), connections: 256
Serial3/0.1 (down): ip 192.168.11.11 dlci 24(0x18,0x480), static,
              CISCO, status deleted
Serial3/0 (down): ip 172.16.1.1 dlci 100(0x64,0x1840), static,
              CISCO, status deleted
Serial3/0 (down): ip 172.16.2.1 dlci 101(0x65,0x1850), static,
              CISCO, status deleted
Serial3/0.1 (down): ip 192.168.11.22 dlci 105(0x69,0x1890), static,
              CISCO, status deleted
Serial4/0/1:0.1 (up): point-to-point dlci, dlci 102(0x66,0x1860), broadcast, CISCO
          status defined, active,
              RTP Header Compression (enabled), connections: 256

Display Maps for a Specific DLCI: Example

Router# show frame-relay map 20

POS2/0 (up): ip 10.1.1.1 dlci 20(0x14,0x440), static,
              CISCO, status deleted
              TCP/IP Header Compression (enabled), connections: 256
Serial3/0 (down): ip 172.16.3.1 dlci 20(0x14,0x440), static,
              CISCO, status deleted

Display Maps for a Specific Interface: Example

Router# show frame-relay map interface pos 2/0

POS2/0 (up): ip 10.1.1.1 dlci 20(0x14,0x440), static,
              CISCO, status deleted
              TCP/IP Header Compression (enabled), connections: 256
POS2/0 (up): ip 10.1.2.1 dlci 21(0x15,0x450), static,
              CISCO, status deleted
              TCP/IP Header Compression (enabled), connections: 256
POS2/0 (up): ip 10.1.3.1 dlci 22(0x16,0x460), static,
              CISCO, status deleted
              TCP/IP Header Compression (enabled), connections: 256
POS2/0 (up): bridge dlci 23(0x17,0x470), static,
              CISCO, status deleted
POS2/0.1 (down): point-to-point dlci, dlci 24(0x18,0x480), broadcast
          status deleted

Display Map for a Specific DLCI on a Specific Interface: Example

Router# show frame-relay map interface pos 2/0 20

POS2/0 (up): ip 10.1.1.1 dlci 20(0x14,0x440), static,
              CISCO, status deleted
              TCP/IP Header Compression (enabled), connections: 256

Display Maps for a Specific Subinterface: Example

Router# show frame-relay map interface pos 2/0.1

POS2/0.1 (down): point-to-point dlci, dlci 24(0x18,0x480), broadcast
          status deleted

Display Maps for a Specific DLCI on a Specific Subinterface: Example

Router# show frame-relay map interface pos 2/0.1 24

POS2/0.1 (down): point-to-point dlci, dlci 24(0x18,0x480), broadcast
          status deleted

Maps with IPV6 Addresses: Example

The following sample output from the show frame-relay map command shows that the link-local and global IPv6 addresses (FE80::E0:F727:E400:A and 3ffe:1111:2222:1044::73; FE80::60:3E47:AC8:8 and 3ffe:1111:2222:1044::72) of two remote nodes are explicitly mapped to data-link connection identifier (DLCI) 17 and DLCI 19, respectively. Both DLCI 17 and DLCI 19 are terminated on interface serial 3 of this node; therefore, interface serial 3 of this node is a point-to-multipoint interface.

Router# show frame-relay map


Serial3 (up): ipv6 FE80::E0:F727:E400:A dlci 17(0x11,0x410), static, 
              broadcast, CISCO, status defined, active 
Serial3 (up): ipv6 3ffe:1111:2222:1044::72 dlci 19(0x13,0x430), static, 
              CISCO, status defined, active 
Serial3 (up): ipv6 3ffe:1111:2222:1044::73 dlci 17(0x11,0x410), static, 
              CISCO, status defined, active 
Serial3 (up): ipv6 FE80::60:3E47:AC8:8 dlci 19(0x13,0x430), static, 
              broadcast, CISCO, status defined, active 

Maps for VC Bundles: Example

The following sample output displays mapping information for two PVC bundles. The PVC bundle "MAIN-1-static" is configured with a static map. The map for PVC bundle "MAIN-2-dynamic" is created dynamically using Inverse Address Resolution Protocol (ARP).

Router# show frame-relay map


Serial1/4 (up): ip 10.1.1.1 vc-bundle MAIN-1-static, static, 
          CISCO, status up
Serial1/4 (up): ip 10.1.1.2 vc-bundle MAIN-2-dynamic, dynamic, 
          broadcast, status up

Table 4 describes the significant fields shown in the displays.

 

Table 4 show frame-relay map Field Descriptions  

Field
Description

vc-bundle

PVC bundle that serves as the logical connection being used to reach the interface.

static/dynamic

Indicates whether this is a static or dynamic entry.

broadcast

Indicates pseudobroadcasting.

CISCO

Indicates the encapsulation type for this map: either CISCO or IETF.

status defined, active

Indicates that the mapping between the destination address and the data-link connection identifier (DLCI) used to connect to the destination address is active.


Related Commands

Command
Description

show frame-relay pvc

Displays statistics about PVCs for Frame Relay interfaces.

show frame-relay vc-bundle

Displays attributes and other information about a Frame Relay PVC bundle.


show frame-relay pvc

To display statistics about Frame Relay permanent virtual circuits (PVCs), use the show frame-relay pvc command in privileged EXEC mode.

show frame-relay pvc [[interface interface] [dlci] [64-bit] | summary [all]]

Syntax Description

interface

(Optional) Specific interface for which PVC information will be displayed.

interface

(Optional) Interface number containing the data-link connection identifiers (DLCIs) for which you wish to display PVC information.

dlci

(Optional) A specific DLCI number used on the interface. Statistics for the specified PVC are displayed when a DLCI is also specified.

64-bit

(Optional) Displays 64-bit counter statistics.

summary

(Optional) Displays a summary of all PVCs on the system.

all

(Optional) Displays a summary of all PVCs on each interface.


Command Modes

Privileged EXEC

Command History

Release
Modification

10.0

This command was introduced.

12.0(1)T

This command was modified to display statistics about virtual access interfaces used for PPP connections over Frame Relay.

12.0(3)XG

This command was modified to include the fragmentation type and size associated with a particular PVC when fragmentation is enabled on the PVC.

12.0(4)T

This command was modified to include the fragmentation type and size associated with a particular PVC when fragmentation is enabled on the PVC.

12.0(5)T

This command was modified to include information on the special voice queue that is created using the queue keyword of the frame-relay voice bandwidth command.

12.1(2)T

This command was modified to display the following information:

Details about the policy map attached to a specific PVC.

The priority configured for PVCs within Frame Relay PVC interface priority queueing.

Details about Frame Relay traffic shaping and policing on switched PVCs.

12.0(12)S

This command was modified to display reasons for packet drops and complete status information for switched NNI PVCs.

12.1(5)T

This command was modified to display the following information:

The number of packets in the post-hardware-compression queue.

The reasons for packet drops and complete status information for switched network-to-network PVCs.

12.0(17)S

This command was modified to display the number of outgoing packets dropped and the number of outgoing bytes dropped because of QoS policy.

12.2 T

This command was modified to show that when payload compression is configured for a PVC, the throughput rate reported by the PVC is equal to the rate reported by the interface.

12.2(4)T

The 64-bit keyword was added.

12.2(11)T

This command was modified to display the number of outgoing packets dropped and the number of outgoing bytes dropped because of QoS policy.

12.2(13)T

This command was modified to support display of Frame Relay PVC bundle information.

12.2(15)T

This command was modified to support display of Frame Relay voice-adaptive fragmentation information.

12.2(27)SBC

The summary and all keywords were added.

12.2(28)SB

This command was modified to support hierarchical queueing framework (HQF).


Usage Guidelines

Use this command to monitor the PPP link control protocol (LCP) state as being open with an up state or closed with a down state.

When the vofr command or the vofr with the cisco keyword has been configured on the PVC, and a voice bandwidth has been allocated to the class associated with this PVC, configured voice bandwidth and used voice bandwidth are also displayed.

Statistics Reporting

To obtain statistics about PVCs on all Frame Relay interfaces, use this command with no arguments.

To obtain statistics about a PVC that include policy-map configuration or the priority configured for that PVC, use this command with the dlci argument.

To display a summary of all PVCs on the system, use the show frame-relay pvc command with the summary keyword. To display a summary of all PVCs per interface, use the summary all keywords.

Per-VC counters are not incremented at all when either autonomous or silicon switching engine (SSE) switching is configured; therefore, PVC values will be inaccurate if either switching method is used.

You can change the period of time over which a set of data is used for computing load statistics. If you decrease the load interval, the average statistics are computed over a shorter period of time and are more responsive to bursts of traffic. To change the length of time for which a set of data is used to compute load statistics for a PVC, use the load-interval command in Frame-Relay DLCI configuration mode.

Traffic Shaping

Congestion control mechanisms are currently not supported on terminated PVCs nor on PVCs over ISDN. Where congestion control mechanisms are supported, the switch passes forward explicit congestion notification (FECN) bits, backward explicit congestion notification (BECN) bits, and discard eligible (DE) bits unchanged from entry points to exit points in the network.

Examples

The various displays in this section show sample output for a variety of PVCs. Some of the PVCs carry data only; some carry a combination of voice and data. This section contains the following examples:

Summary of Frame Relay PVCs Example

Frame Relay Generic Configuration Example

Frame Relay Voice-Adaptive Fragmentation Example

Frame Relay PVC Bundle Example

Frame Relay 64-Bit Counter Example

Frame Relay Fragmentation and Hardware Compression Example

Switched PVC Example

Frame Relay Congestion Management on a Switched PVC Example

Frame Relay Policing on a Switched PVC Example

Frame Relay PVC Priority Queueing Example

Low Latency Queueing for Frame Relay Example

PPP over Frame Relay Example

Voice over Frame Relay Example

FRF.12 Fragmentation Example

Multipoint Subinterfaces Transporting Data Example

PVC Shaping When HQF Is Enabled Example

PVC Transporting Voice and Data Example

Summary of Frame Relay PVCs Example

The following example shows sample output from the show frame-relay pvc command with the summary keyword. The summary keyword displays all PVCs on the system.

Router# show frame-relay pvc summary          

Frame-Relay VC Summary

              Active     Inactive      Deleted       Static
  Local          0           12            0            0
  Switched       0            0            0            0
  Unused         0            0            0            0

The following example shows sample output from the show frame-relay pvc command with the summary and all keywords. The summary and all keywords display all PVCs per interface.

Router# show frame-relay pvc summary all

VC Summary for interface Serial3/0 (Frame Relay DTE)

              Active     Inactive      Deleted       Static
  Local          0            7            0            0
  Switched       0            0            0            0
  Unused         0            0            0            0

VC Summary for interface Serial3/1 (Frame Relay DTE)

              Active     Inactive      Deleted       Static
  Local          0            5            0            0
  Switched       0            0            0            0
  Unused         0            0            0            0

Frame Relay Generic Configuration Example

The following sample output shows a generic Frame Relay configuration on DLCI 100:

Router# show frame-relay pvc 100


PVC Statistics for interface Serial4/0/1:0 (Frame Relay DTE)

DLCI = 100, DLCI USAGE = LOCAL, PVC STATUS = ACTIVE (EEK UP), INTERFACE = Serial4/0/1:0.1

  input pkts 4360          output pkts 4361         in bytes 146364    
  out bytes 130252         dropped pkts 3735        in pkts dropped 0         
  out pkts dropped 3735             out bytes dropped 1919790
  late-dropped out pkts 3735        late-dropped out bytes 1919790
  in FECN pkts 0           in BECN pkts 0           out FECN pkts 0         
  out BECN pkts 0          in DE pkts 0             out DE pkts 0         
  out bcast pkts 337       out bcast bytes 102084    
  5 minute input rate 0 bits/sec, 0 packets/sec
  5 minute output rate 0 bits/sec, 0 packets/sec
  pvc create time 05:34:06, last time pvc status changed 05:33:38

Frame Relay Voice-Adaptive Fragmentation Example

The following sample output indicates that Frame Relay voice-adaptive fragmentation is active on DLCI 202 and there are 29 seconds left on the deactivation timer. If no voice packets are detected in the next 29 seconds, Frame Relay voice-adaptive fragmentation will become inactive.

Router# show frame-relay pvc 202

PVC Statistics for interface Serial3/1 (Frame Relay DTE)
DLCI = 202, DLCI USAGE = LOCAL, PVC STATUS = STATIC, INTERFACE = Serial3/1.2
  input pkts 0             output pkts 479          in bytes 0
  out bytes 51226          dropped pkts 0           in pkts dropped 0
  out pkts dropped 0                out bytes dropped 0
  in FECN pkts 0           in BECN pkts 0           out FECN pkts 0
  out BECN pkts 0          in DE pkts 0             out DE pkts 0
  out bcast pkts 0         out bcast bytes 0
  5 minute input rate 0 bits/sec, 0 packets/sec 
  5 minute output rate 5000 bits/sec, 5 packets/sec
  pvc create time 00:23:36, last time pvc status changed 00:23:31     
  fragment type end-to-end fragment size 80 adaptive active, time left 29 secs

Frame Relay PVC Bundle Example

The following sample output indicates that PVC 202 is a member of VC bundle MAIN-1-static:

Router# show frame-relay pvc 202


PVC Statistics for interface Serial1/4 (Frame Relay DTE)

DLCI = 202, DLCI USAGE = LOCAL, PVC STATUS = STATIC, INTERFACE = Serial1/4

  input pkts 0             output pkts 45           in bytes 0
  out bytes 45000          dropped pkts 0           in FECN pkts 0
  in BECN pkts 0           out FECN pkts 0          out BECN pkts 0
  in DE pkts 0             out DE pkts 0
  out bcast pkts 0         out bcast bytes 0
  5 minute input rate 0 bits/sec, 0 packets/sec
  5 minute output rate 2000 bits/sec, 2 packets/sec
  pvc create time 00:01:25, last time pvc status changed 00:01:11
  VC-Bundle MAIN-1-static 

Frame Relay 64-Bit Counter Example

The following sample output displays the Frame Relay 64-bit counters:

Router# show frame-relay pvc 35 64-bit


DLCI = 35, INTERFACE = Serial0/0
  input pkts 0                       output pkts 0
  in bytes 0                         out bytes 0

Frame Relay Fragmentation and Hardware Compression Example

The following is sample output from the show frame-relay pvc command for a PVC configured with Cisco-proprietary fragmentation and hardware compression:

Router# show frame-relay pvc 110


PVC Statistics for interface Serial0/0 (Frame Relay DTE)

DLCI = 110, DLCI USAGE = LOCAL, PVC STATUS = STATIC, INTERFACE = Serial0/0

  input pkts 409           output pkts 409          in bytes 3752      
  out bytes 4560           dropped pkts 1           in FECN pkts 0         
  in BECN pkts 0           out FECN pkts 0          out BECN pkts 0         
  in DE pkts 0             out DE pkts 0         
  out bcast pkts 0          out bcast bytes 0         
  pvc create time 3d00h, last time pvc status changed 2d22h
  Service type VoFR-cisco
   Voice Queueing Stats: 0/100/0 (size/max/dropped)
  Post h/w compression queue: 0
  Current fair queue configuration:
   Discard     Dynamic      Reserved
   threshold   queue count  queue count
   64          16           2    
  Output queue size 0/max total 600/drops 0
  configured voice bandwidth 16000, used voice bandwidth 0
  fragment type VoFR-cisco         fragment size 100
  cir 64000     bc   640       be 0         limit 80     interval 10  
  mincir 32000     byte increment 80    BECN response no 
  frags 428       bytes 4810      frags delayed 24        bytes delayed 770      
  shaping inactive    
  traffic shaping drops 0
  ip rtp priority parameters 16000 32000 20000

Switched PVC Example

The following is sample output from the show frame-relay pvc command for a switched Frame Relay PVC. This output displays detailed information about Network-to-Network Interface (NNI) status and why packets were dropped from switched PVCs.

Router# show frame-relay pvc


 PVC Statistics for interface Serial2/2 (Frame Relay NNI) 

 DLCI = 16, DLCI USAGE = SWITCHED, PVC STATUS = INACTIVE, INTERFACE = Serial2/2 
 LOCAL PVC STATUS = INACTIVE, NNI PVC STATUS = INACTIVE

   input pkts 0             output pkts 0            in bytes 0 
   out bytes 0              dropped pkts 0           in FECN pkts 0 
   in BECN pkts 0           out FECN pkts 0          out BECN pkts 0 
   in DE pkts 0             out DE pkts 0 
   out bcast pkts 0         out bcast bytes 0 
   switched pkts0 
   Detailed packet drop counters: 
   no out intf 0            out intf down 0          no out PVC 0 
   in PVC down 0            out PVC down 0           pkt too big 0 
   shaping Q full 0         pkt above DE 0           policing drop 0 
   pvc create time 00:00:07, last time pvc status changed 00:00:07

Frame Relay Congestion Management on a Switched PVC Example

The following is sample output from the show frame-relay pvc command that shows the statistics for a switched PVC on which Frame Relay congestion management is configured:

Router# show frame-relay pvc 200

PVC Statistics for interface Serial3/0 (Frame Relay DTE)
DLCI = 200, DLCI USAGE = SWITCHED, PVC STATUS = ACTIVE, INTERFACE = Serial3/0

  input pkts 341           output pkts 390          in bytes 341000
  out bytes 390000         dropped pkts 0           in FECN pkts 0
  in BECN pkts 0           out FECN pkts 0          out BECN pkts 0
  in DE pkts 0             out DE pkts 390
  out bcast pkts 0          out bcast bytes 0            Num Pkts Switched 341

  pvc create time 00:10:35, last time pvc status changed 00:10:06
  Congestion DE threshold 50 
  shaping active 
  cir 56000     bc 7000      be 0         byte limit 875    interval 125
  mincir 28000     byte increment 875   BECN response no
  pkts 346       bytes 346000    pkts delayed 339       bytes delayed 339000
  traffic shaping drops 0
  Queueing strategy:fifo
  Output queue 48/100, 0 drop, 339 dequeued 

Frame Relay Policing on a Switched PVC Example

The following is sample output from the show frame-relay pvc command that shows the statistics for a switched PVC on which Frame Relay policing is configured:

Router# show frame-relay pvc 100


PVC Statistics for interface Serial1/0 (Frame Relay DCE)

DLCI = 100, DLCI USAGE = SWITCHED, PVC STATUS = ACTIVE, INTERFACE = Serial1/0  

  input pkts 1260          output pkts 0            in bytes 1260000
  out bytes 0              dropped pkts 0           in FECN pkts 0
  in BECN pkts 0           out FECN pkts 0          out BECN pkts 0
  in DE pkts 0             out DE pkts 0
  out bcast pkts 0          out bcast bytes 0            Num Pkts Switched 1260

  pvc create time 00:03:57, last time pvc status changed 00:03:19
  policing enabled, 180 pkts marked DE
  policing Bc  6000        policing Be  6000        policing Tc  125 (msec)
  in Bc pkts   1080        in Be pkts   180         in xs pkts   0
  in Bc bytes  1080000     in Be bytes  180000      in xs bytes  0

Frame Relay PVC Priority Queueing Example

The following is sample output for a PVC that has been assigned high priority:

Router# show frame-relay pvc 100


PVC Statistics for interface Serial0 (Frame Relay DTE)

DLCI = 100, DLCI USAGE = LOCAL, PVC STATUS = ACTIVE, INTERFACE = Serial0
  input pkts 0             output pkts 0            in bytes 0
  out bytes 0              dropped pkts 0           in FECN pkts 0
  in BECN pkts 0           out FECN pkts 0          out BECN pkts 0
  in DE pkts 0             out DE pkts 0
  out bcast pkts 0          out bcast bytes 0
  pvc create time 00:00:59, last time pvc status changed 00:00:33
  priority high 

Low Latency Queueing for Frame Relay Example

The following is sample output from the show frame-relay pvc command for a PVC shaped to a 64000 bits per second committed information rate (CIR) with fragmentation. A policy map is attached to the PVC and is configured with a priority class for voice, two data classes for IP precedence traffic, and a default class for best-effort traffic. Weighted Random Early Detection (WRED) is used as the drop policy on one of the data classes.

Router# show frame-relay pvc 100


PVC Statistics for interface Serial1/0 (Frame Relay DTE)

DLCI = 100, DLCI USAGE = LOCAL, PVC STATUS = INACTIVE, INTERFACE = Serial1/0.1

  input pkts 0             output pkts 0            in bytes 0         
  out bytes 0              dropped pkts 0           in FECN pkts 0         
  in BECN pkts 0           out FECN pkts 0          out BECN pkts 0         
  in DE pkts 0             out DE pkts 0         
  out bcast pkts 0          out bcast bytes 0         
  pvc create time 00:00:42, last time pvc status changed 00:00:42
  service policy mypolicy
 Class voice
  Weighted Fair Queueing
      Strict Priority
      Output Queue: Conversation 72 
        Bandwidth 16 (kbps) Packets Matched 0
        (pkts discards/bytes discards) 0/0
 Class immediate-data
  Weighted Fair Queueing
      Output Queue: Conversation 73 
        Bandwidth 60 (%) Packets Matched 0
        (pkts discards/bytes discards/tail drops) 0/0/0
        mean queue depth: 0
        drops: class  random   tail     min-th   max-th   mark-prob 
               0      0        0        64       128      1/10
               1      0        0        71       128      1/10
               2      0        0        78       128      1/10
               3      0        0        85       128      1/10
               4      0        0        92       128      1/10
               5      0        0        99       128      1/10
               6      0        0        106      128      1/10
               7      0        0        113      128      1/10
               rsvp   0        0        120      128      1/10
 Class priority-data
  Weighted Fair Queueing
      Output Queue: Conversation 74 
        Bandwidth 40 (%) Packets Matched 0 Max Threshold 64 (packets)
        (pkts discards/bytes discards/tail drops) 0/0/0
 Class class-default
  Weighted Fair Queueing
      Flow Based Fair Queueing
      Maximum Number of Hashed Queues 64  Max Threshold 20 (packets)
  Output queue size 0/max total 600/drops 0
  fragment type end-to-end         fragment size 50
  cir 64000     bc   640       be 0         limit 80     interval 10  
  mincir 64000     byte increment 80    BECN response no 
  frags 0         bytes 0         frags delayed 0         bytes delayed 0        
  shaping inactive    
  traffic shaping drops 0

PPP over Frame Relay Example

The following is sample output from the show frame-relay pvc command that shows the PVC statistics for serial interface 5 (slot 1 and DLCI 55 are up) during a PPP session over Frame Relay:

Router# show frame-relay pvc 55


PVC Statistics for interface Serial5/1 (Frame Relay DTE)
DLCI = 55, DLCI USAGE = LOCAL, PVC STATUS = ACTIVE, INTERFACE = Serial5/1.1
     input pkts 9             output pkts 16           in bytes 154
     out bytes 338            dropped pkts 6           in FECN pkts 0
     in BECN pkts 0           out FECN pkts 0          out BECN pkts 0
     in DE pkts 0             out DE pkts 0
     out bcast pkts 0         out bcast bytes 0
     pvc create time 00:35:11, last time pvc status changed 00:00:22
     Bound to Virtual-Access1 (up, cloned from Virtual-Template5)

Voice over Frame Relay Example

The following is sample output from the show frame-relay pvc command for a PVC carrying Voice over Frame Relay (VoFR) traffic configured via the vofr cisco command. The frame-relay voice bandwidth command has been configured on the class associated with this PVC, as has fragmentation. The fragmentation type employed is proprietary to Cisco.

A sample configuration for this situation is shown first, followed by the output for the show frame-relay pvc command.

interface serial 0
 encapsulation frame-relay
 frame-relay traffic-shaping
 frame-relay interface-dlci 108
  vofr cisco
  class vofr-class
map-class frame-relay vofr-class
 frame-relay fragment 100
 frame-relay fair-queue
 frame-relay cir 64000
 frame-relay voice bandwidth 25000

Router# show frame-relay pvc 108


PVC Statistics for interface Serial0 (Frame Relay DTE)
DLCI = 108, DLCI USAGE = LOCAL, PVC STATUS = STATIC, INTERFACE = Serial0
  input pkts 1260          output pkts 1271         in bytes 95671     
  out bytes 98604          dropped pkts 0           in FECN pkts 0         
  in BECN pkts 0           out FECN pkts 0          out BECN pkts 0         
  in DE pkts 0             out DE pkts 0         
  out bcast pkts 1271       out bcast bytes 98604     
  pvc create time 09:43:17, last time pvc status changed 09:43:17
  Service type VoFR-cisco
  configured voice bandwidth 25000, used voice bandwidth 0
  voice reserved queues 24, 25
  fragment type VoFR-cisco         fragment size 100
  cir 64000     bc 64000     be 0         limit 1000   interval 125 
  mincir 32000     byte increment 1000  BECN response no 
  pkts 2592      bytes 205140    pkts delayed 1296      bytes delayed 102570   
  shaping inactive    
  shaping drops 0
  Current fair queue configuration:
   Discard     Dynamic      Reserved
   threshold   queue count  queue count
    64          16           2    
  Output queue size 0/max total 600/drops 0

FRF.12 Fragmentation Example

The following is sample output from the show frame-relay pvc command for an application employing pure FRF.12 fragmentation. A sample configuration for this situation is shown first, followed by the output for the show frame-relay pvc command.

interface serial 0
 encapsulation frame-relay
 frame-relay traffic-shaping
 frame-relay interface-dlci 110
  class frag
map-class frame-relay frag
 frame-relay fragment 100
 frame-relay fair-queue
 frame-relay cir 64000

Router# show frame-relay pvc 110


PVC Statistics for interface Serial0 (Frame Relay DTE)
DLCI = 110, DLCI USAGE = LOCAL, PVC STATUS = STATIC, INTERFACE = Serial0
  input pkts 0             output pkts 243          in bytes 0         
  out bytes 7290           dropped pkts 0           in FECN pkts 0         
  in BECN pkts 0           out FECN pkts 0          out BECN pkts 0         
  in DE pkts 0             out DE pkts 0         
  out bcast pkts 243        out bcast bytes 7290      
  pvc create time 04:03:17, last time pvc status changed 04:03:18
  fragment type end-to-end         fragment size 100
  cir 64000     bc 64000     be 0         limit 1000   interval 125 
  mincir 32000     byte increment 1000  BECN response no 
  pkts 486       bytes 14580     pkts delayed 243       bytes delayed 7290     
  shaping inactive    
  shaping drops 0
  Current fair queue configuration:
   Discard     Dynamic      Reserved
   threshold   queue count  queue count
   64          16           2    
  Output queue size 0/max total 600/drops 0

Note that when voice is not configured, voice bandwidth output is not displayed.

Multipoint Subinterfaces Transporting Data Example

The following is sample output from the show frame-relay pvc command for multipoint subinterfaces carrying data only. The output displays both the subinterface number and the DLCI. This display is the same whether the PVC is configured for static or dynamic addressing. Note that neither fragmentation nor voice is configured on this PVC.

Router# show frame-relay pvc


DLCI = 300, DLCI USAGE = LOCAL, PVC STATUS = ACTIVE, INTERFACE = Serial0.103
input pkts 10  output pkts 7  in bytes 6222 
out bytes 6034  dropped pkts 0  in FECN pkts 0 
in BECN pkts 0  out FECN pkts 0  out BECN pkts 0 
in DE pkts 0  out DE pkts 0         
outbcast pkts 0  outbcast bytes 0
pvc create time 0:13:11  last time pvc status changed 0:11:46
DLCI = 400, DLCI USAGE = LOCAL, PVC STATUS = ACTIVE, INTERFACE = Serial0.104
input pkts 20  output pkts 8  in bytes 5624 
out bytes 5222  dropped pkts 0  in FECN pkts 0 
in BECN pkts 0  out FECN pkts 0  out BECN pkts 0 
in DE pkts 0  out DE pkts 0         
outbcast pkts 0  outbcast bytes 0
pvc create time 0:03:57  last time pvc status changed 0:03:48

PVC Shaping When HQF Is Enabled Example

The following is sample output from the show frame-relay pvc command for a PVC when HQF is enabled:

Router# show frame-relay pvc 16

PVC Statistics for interface Serial4/1 (Frame Relay DTE)

DLCI = 16, DLCI USAGE = LOCAL, PVC STATUS = ACTIVE, INTERFACE = Serial4/1

  input pkts 1             output pkts 1            in bytes 34
  out bytes 34             dropped pkts 0           in pkts dropped 0
  out pkts dropped 0                out bytes dropped 0
  in FECN pkts 0           in BECN pkts 0           out FECN pkts 0
  out BECN pkts 0          in DE pkts 0             out DE pkts 0
  out bcast pkts 1         out bcast bytes 34
  pvc create time 00:09:07, last time pvc status changed 00:09:07
  shaping inactive

PVC Transporting Voice and Data Example

The following is sample output from the show frame-relay pvc command for a PVC carrying voice and data traffic, with a special queue specifically for voice traffic created using the frame-relay voice bandwidth command queue keyword:

Router# show frame-relay pvc interface serial 1 45

 PVC Statistics for interface Serial1 (Frame Relay DTE)
 DLCI = 45, DLCI USAGE = LOCAL, PVC STATUS = STATIC, INTERFACE = Serial1
   input pkts 85            output pkts 289          in bytes 1730      
   out bytes 6580           dropped pkts 11          in FECN pkts 0         
   in BECN pkts 0           out FECN pkts 0          out BECN pkts 0         
   in DE pkts 0             out DE pkts 0         
   out bcast pkts 0          out bcast bytes 0         
   pvc create time 00:02:09, last time pvc status changed 00:02:09
   Service type VoFR
   configured voice bandwidth 25000, used voice bandwidth 22000
   fragment type VoFR         fragment size 100
   cir 20000     bc   1000      be 0         limit 125    interval 50  
   mincir 20000     byte increment 125   BECN response no 
   fragments 290       bytes 6613      fragments delayed 1         bytes delayed 33       
   shaping inactive    
   traffic shaping drops 0
    Voice Queueing Stats: 0/100/0 (size/max/dropped)
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   Current fair queue configuration:
    Discard     Dynamic      Reserved
    threshold   queue count  queue count
    64          16           2    
   Output queue size 0/max total 600/drops 0

Table 5 describes the significant fields shown in the displays.

Table 5 show frame-relay pvc Field Descriptions 

Field
Description

DLCI

One of the DLCI numbers for the PVC.

DLCI USAGE

Lists SWITCHED when the router or access server is used as a switch, or LOCAL when the router or access server is used as a DTE device.

PVC STATUS

Status of the PVC: ACTIVE, INACTIVE, or DELETED.

INTERFACE

Specific subinterface associated with this DLCI.

LOCAL PVC STATUS1

Status of PVC configured locally on the NNI interface.

NNI PVC STATUS1

Status of PVC learned over the NNI link.

input pkts

Number of packets received on this PVC.

output pkts

Number of packets sent on this PVC.

in bytes

Number of bytes received on this PVC.

out bytes

Number of bytes sent on this PVC.

dropped pkts

Number of incoming and outgoing packets dropped by the router at the Frame Relay level.

in pkts dropped

Number of incoming packets dropped. Incoming packets may be dropped for a number of reasons, including the following:

Inactive PVC

Policing

Packets received above DE discard level

Dropped fragments

Memory allocation failures

Configuration problems

out pkts dropped

Number of outgoing packets dropped, including shaping drops and late drops.

out bytes dropped

Number of outgoing bytes dropped.

late-dropped out pkts

Number of outgoing packets dropped because of QoS policy (such as with VC queuing or Frame Relay traffic shaping). This field is not displayed when the value is zero.

late-dropped out bytes

Number of outgoing bytes dropped because of QoS policy (such with as VC queuing or Frame Relay traffic shaping). This field is not displayed when the value is zero.

in FECN pkts

Number of packets received with the FECN bit set.

in BECN pkts

Number of packets received with the BECN bit set.

out FECN pkts

Number of packets sent with the FECN bit set.

out BECN pkts

Number of packets sent with the BECN bit set.

in DE pkts

Number of DE packets received.

out DE pkts

Number of DE packets sent.

out bcast pkts

Number of output broadcast packets.

out bcast bytes

Number of output broadcast bytes.

switched pkts

Number of switched packets.

no out intf2

Number of packets dropped because there is no output interface.

out intf down2

Number of packets dropped because the output interface is down.

no out PVC2

Number of packets dropped because the outgoing PVC is not configured.

in PVC down2

Number of packets dropped because the incoming PVC is inactive.

out PVC down2

Number of packets dropped because the outgoing PVC is inactive.

pkt too big2

Number of packets dropped because the packet size is greater than media MTU3 .

shaping Q full2

Number of packets dropped because the Frame Relay traffic-shaping queue is full.

pkt above DE2

Number of packets dropped because they are above the DE level when Frame Relay congestion management is enabled.

policing drop2

Number of packets dropped because of Frame Relay traffic policing.

pvc create time

Time at which the PVC was created.

last time pvc status changed

Time at which the PVC changed status.

VC-Bundle

PVC bundle of which the PVC is a member.

priority

Priority assigned to the PVC.

pkts marked DE

Number of packets marked DE because they exceeded the Bc.

policing Bc

Committed burst size.

policing Be

Excess burst size.

policing Tc

Measurement interval for counting Bc and Be.

in Bc pkts

Number of packets received within the committed burst.

in Be pkts

Number of packets received within the excess burst.

in xs pkts

Number of packets dropped because they exceeded the combined burst.

in Bc bytes

Number of bytes received within the committed burst.

in Be bytes

Number of bytes received within the excess burst.

in xs bytes

Number of bytes dropped because they exceeded the combined burst.

Congestion DE threshold

PVC queue percentage at which packets with the DE bit are dropped.

Service type

Type of service performed by this PVC. Can be VoFR or VoFR-cisco.

Post h/w compression queue

Number of packets in the post-hardware-compression queue when hardware compression and Frame Relay fragmentation are configured.

configured voice bandwidth

Amount of bandwidth in bits per second (bps) reserved for voice traffic on this PVC.

used voice bandwidth

Amount of bandwidth in bps currently being used for voice traffic.

service policy

Name of the output service policy applied to the VC.

Class

Class of traffic being displayed. Output is displayed for each configured class in the policy.

Output Queue

The WFQ4 conversation to which this class of traffic is allocated.

Bandwidth

Bandwidth in kbps or percentage configured for this class.

Packets Matched

Number of packets that matched this class.

Max Threshold

Maximum queue size for this class when WRED is not used.

pkts discards

Number of packets discarded for this class.

bytes discards

Number of bytes discarded for this class.

tail drops

Number of packets discarded for this class because the queue was full.

mean queue depth

Average queue depth, based on the actual queue depth on the interface and the exponential weighting constant. It is a moving average. The minimum and maximum thresholds are compared against this value to determine drop decisions.

drops:

WRED parameters.

class

IP precedence value.

random

Number of packets randomly dropped when the mean queue depth is between the minimum threshold value and the maximum threshold value for the specified IP precedence value.

tail

Number of packets dropped when the mean queue depth is greater than the maximum threshold value for the specified IP precedence value.

min-th

Minimum WRED threshold in number of packets.

max-th

Maximum WRED threshold in number of packets.

mark-prob

Fraction of packets dropped when the average queue depth is at the maximum threshold.

Maximum Number of Hashed Queues

(Applies to class default only) Number of queues available for unclassified flows.

fragment type

Type of fragmentation configured for this PVC. Possible types are as follows:

end-to-end—Fragmented packets contain the standard FRF.12 header

VoFR—Fragmented packets contain the FRF.11 Annex C header

VoFR-cisco—Fragmented packets contain the Cisco proprietary header

fragment size

Size of the fragment payload in bytes.

time left

Number of seconds left on the Frame Relay voice-adaptive fragmentation deactivation timer. When this timer expires, Frame Relay fragmentation turns off.

cir

Current CIR in bps.

bc

Current committed burst (Bc) size, in bits.

be

Current excess burst (Be) size, in bits.

limit

Maximum number of bytes sent per internal interval (excess plus sustained).

interval

Interval being used internally (may be smaller than the interval derived from Bc/CIR; this happens when the router determines that traffic flow will be more stable with a smaller configured interval).

mincir

Minimum CIR for the PVC.

byte increment

Number of bytes that will be sustained per internal interval.

BECN response

Indication that Frame Relay has BECN adaptation configured.

pkts

Number of packets associated with this PVC that have gone through the traffic-shaping system.

frags

Total number of fragments shaped on this VC.

bytes

Number of bytes associated with this PVC that have gone through the traffic-shaping system.

pkts delayed

Number of packets associated with this PVC that have been delayed by the traffic-shaping system.

frags delayed

Number of fragments delayed in the shaping queue before being sent.

bytes delayed

Number of bytes associated with this PVC that have been delayed by the traffic-shaping system.

shaping

Indication that shaping will be active for all PVCs that are fragmenting data; otherwise, shaping will be active if the traffic being sent exceeds the CIR for this circuit.

shaping drops

Number of packets dropped by the traffic-shaping process.

Queueing strategy

Per-VC queueing strategy.

Output queue

48/100

0 drop

300 dequeued

State of the per-VC queue.

Number of packets enqueued/size of the queue

Number of packets dropped

Number of packets dequeued

Voice Queueing Stats

Statistics showing the size of packets, the maximum number of packets, and the number of packets dropped in the special voice queue created using the frame-relay voice bandwidth command queue keyword.

Output queue size

Size in bytes of each output queue.

max total

Maximum number of packets of all types that can be queued in all queues.

drops

Number of frames dropped by all output queues.

1 The LOCAL PVC STATUS and NNI PVC STATUS fields are displayed only for PVCs configured on Frame Relay NNI interface types. These fields are not displayed if the PVC is configured on DCE or DTE interface types.

2 The detailed packet drop fields are displayed for switched Frame Relay PVCs only. These fields are not displayed for terminated PVCs.

3 MTU = maximum transmission unit.

4 WFQ = weighted fair queueing.


Related Commands

Command
Description

frame-relay accounting adjust

Enables byte count adjustment at the PVC level so that the number of bytes sent and received at the PVC corresponds to the actual number of bytes sent and received on the physical interface.

frame-relay interface-queue priority

Enables FR PIPQ on a Frame Relay interface and assigns priority to a PVC within a Frame Relay map class.

frame-relay pvc

Configures Frame Relay PVCs for FRF.8 Frame Relay-ATM Service Interworking.

load-interval

Enables to specify the length of time to be used to calculate the average load for an interface.

service-policy

Attaches a policy map to an input interface or VC or an output interface or VC.

show dial-peer voice

Displays configuration information and call statistics for dial peers.

show frame-relay fragment

Displays Frame Relay fragmentation details.

show frame-relay map

Displays the current Frame Relay map entries and information about the connections.

show frame-relay vc-bundle

Displays attributes and other information about a Frame Relay PVC bundle.


show frame-relay vc-bundle

To display attributes and other information about a Frame Relay permanent virtual circuit (PVC) bundle, use the show frame-relay vc-bundle command in privileged EXEC mode.

show frame-relay vc-bundle vc-bundle-name [detail]

Syntax Description

vc-bundle-name

Name of this Frame Relay PVC bundle.

detail

(Optional) Displays output packet count information in addition to the other bundle member attributes for each PVC in the bundle specified by vc-bundle-name.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(13)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


Usage Guidelines

Use this command to display packet service levels, bumping attributes, and other information about a specific Frame Relay PVC bundle. To display packet counts for each PVC in the bundle in addition to the other attributes, use the detail keyword.

Examples

General Example

The following example shows the Frame Relay PVC bundle named "MP-4-dynamic" with PVC protection applied. Note that in this PVC bundle, data-link connection identifier (DLCI) 400 is configured to explicitly bump traffic to the PVC that handles DSCP level 40, which is DLCI 404. All the other DLCIs are configured for implicit bumping. In addition, all the DLCIs are configured to accept bumped traffic.

The asterisk (*) before PVC 4a indicates that this PVC was configured with the precedence command with the other keyword, which means the PVC will handle all levels that are not explicitly configured on other PVCs.

In this example all PVCs are up, so the values in the "Active leve"l fields match the values in the "Config level" fields. If a PVC goes down and its traffic is bumped, the "Active level" field value for the PVC that went down is cleared. The "Active level" field values for the PVC that the traffic bumped to will be updated to include the levels of the PVC that went down.

The first three PVCs in the following example make up a protected group. All three of these PVCs must go down before the bundle will go down. The last two PVCs are protected PVCs; if either of these PVCs goes down, the bundle will go down.

Router# show frame-relay vc-bundle MP-4-dynamic


MP-4-dynamic on Serial1/4.1 - Status: UP Match-type: DSCP

Name 		DLCI 		Config. 	Active 				Bumping 			PG/ 		CIR 		Status 
				level 		level 			to/accept 			PV 		kbps
*4a 		400 		0-9 		0-9 			40/Yes 			pg 				up 
4b 		401 		10-19 		10-19 			9/Yes 			pg 				up 
4c 		402 		20-29 		20-29 			19/Yes 			pg 				up 
4d 		403 		30-39 		30-39 			29/Yes 			- 				up 
4e 		404 		40-49 		40-49 			39/Yes 			- 				up 
4f 		405 		50-59 		50-59 			49/Yes 			- 				up 
4g 		406 		60-62 		60-62 			59/Yes 			pv 				up 
4h 		407 		63 		63 			62/Yes 			pv 				up

Packets sent out on vc-bundle MP-4-dynamic : 0:
Router# 

Bumping Example

The following example shows that although some DLCIs are down, the bumping rules and the remaining DLCIs keep the bundle up and running for all traffic types.

Note that DLCI 304 is handling the traffic being bumped from the three DLCIs that are down. The "Active level" field indicates the levels that the PVC is actually handling, not just which levels are configured.

Router# show frame-relay vc-bundle MP-3-static


MP-3-static on Serial1/4.1 - Status: UP Match-type: DSCP

Name 		DLCI 		Config. 	Active 				Bumping 			PG/ 		CIR 		Status 
				level 		level 			to/accept 			PV 		kbps
3a 		300 		0-9 		0-9 			-/Yes 			- 				up 
3b 		301 		10-19 		10-19 			9/Yes 			- 				up 
3c 		302 		20-29 		20-29 			19/Yes 			- 				up 
3d 		303 		30-39 					40/Yes 			- 				deleted 
3e 		304 		40-49 		30-59,63 			39/Yes 			- 				up 
3f 		305 		50-59 					49/Yes 			- 				deleted 
3g 		306 		60-62 		60-62 			59/No 			- 				up 
3h 		307 		63 					62/Yes 			- 				deleted

Packets sent out on vc-bundle MP-3-static : 335
Router#

Traffic-Shaping Example

The following example shows output for a PVC bundle configured with traffic shaping. The same rules of class inheritance apply to PVC-bundle members as to regular PVCs.

Router# show frame-relay vc-bundle 26k

26k on Serial1/4.1 - Status:UP  Match-type:PRECEDENCE

Name    DLCI  Config.         Active          Bumping     PG/ CIR   Status
              level           level           to/ accept  PV  kbps

        521   0,2,4           0,2,4           -/Yes       -   20    up
        522   1,3,5-6         1,3,5-6         0/Yes       -   26    up
        523   7               7               6/Yes       -   20    up

Packets sent out on vc-bundle 26k :0
Router#

Detail Example

The following example shows the detail output of a PVC bundle. Note in this example that because all packet service levels are not handled, and because the PVCs are currently down, this bundle can never come up.

Router# show frame-relay vc-bundle x41 detail


x41 on Serial1/1 - Status: DOWN Match-type: DSCP

Name 		DLCI 		Config. 		Active 			Bumping 			PG/ 		CIR 		Status 
				level 		level 			to/accept 			PV 		kbps

		410 		50-62 					49/Yes 			- 				down 
		411 		30,32,34,36,3.. 					29/Yes 			- 				down

Packets sent out on vc-bundle x41 : 0

Active configuration and statistics for each member PVC
DLCI 		Output pkts 				Active level
410 		0 				50-62 
411 		0 				30,32,34,36,38-40 
Router#

Table 6 describes the significant fields shown in the displays.

Table 6 show frame-relay vc-bundle Field Descriptions

Field
Description

Status:

PVC bundle status. Values are UP, DOWN, and INITIAL (no PVCs associated with the bundle).

Name

The user-defined, alphanumeric name of the PVC.

DLCI

The ID number of the PVC bundle member.

Config. level

The packet service levels configured for the PVC.

Active level

The packet service levels actually handled by the PVC. This may include packet service levels for bumped traffic accepted by the PVC.

Bumping to/accept

The packet service level that the PVC will bump to if it goes down/whether or not the PVC will accept bumped traffic from another PVC.

PG/PV

Indicates whether the PVC is a member of a protected group or is an individually protected PVC. A dash in this field indicates that the PVC is not protected.

CIR kbps

Committed information rate for the PVC, in kilobits per second.

Status

Indicates whether the PVC is up, down, or deleted.

Output pkts

Number of packets sent out on the PVC.


Related Commands

Command
Description

Precedence

Configures the precedence levels for a Frame Relay permanent virtual circuit (PVC) bundle member.

show frame-relay map

Displays the current Frame Relay map entries and information about the connections.

show frame-relay pvc

Displays statistics about PVCs for Frame Relay interfaces.


Glossary

DLCI—Data-link connection identifier.

DSCP—Differentiated services code point.

PVC—Permanent virtual circuit.

PVC bundle—A set of parallel VCs between two CPEs.

RTP—Real-Time Transport Protocol. Protocol that is designed to provide end-to-end network transport functions for applications transmitting real-time data, such as audio, video, or simulation data, over multicast or unicast network services.

QoS—Quality of service. Generic term for differentiated network services.

ToS—Type of service. A one-byte field in an IP header.


Note See Internetworking Terms and Acronyms for terms not included in this glossary..