Table Of Contents

Frame Relay Service Configuration Commands on Cisco IOS XR Software

encap (PVC)

encapsulation frame-relay

frame-relay intf-type

frame-relay lmi disable

frame-relay lmi-n391dte

frame-relay lmi-n392dce

frame-relay lmi-n392dte

frame-relay lmi-n393dce

frame-relay lmi-n393dte

frame-relay lmi-t391dte

frame-relay lmi-t392dce

frame-relay lmi-type

pvc (frame relay)

show frame-relay lmi

show frame-relay pvc

show interfaces (frame relay)

snmp-server traps frame-relay pvc

Frame Relay Service Configuration Commands on Cisco IOS XR Software

---

This chapter describes the commands used to configure Frame Relay service on Packet-over-SONET/SDH (POS) and serial interfaces for the Cisco XR 12000 Series Router running Cisco IOS XR software.

encap (PVC)

To change the encapsulation for a Frame Relay permanent virtual circuit (PVC), use the encap command in Frame Relay PVC configuration mode. To restore default encapsulation from the Frame Relay main interface, use the no form of this command.

encap [cisco | ietf]

no encap [cisco | ietf]

Syntax Description

cisco	(Optional) Uses Cisco encapsulation, which is a 4-byte header, with 2 bytes to identify the data-link connection identifier (DLCI) and 2 bytes to identify the packet type.
ietf	(Optional) Sets the encapsulation method to comply with the Internet Engineering Task Force (IETF) standard (RFC 1490). Use this keyword when connecting to equipment that belongs to a vendor other than Cisco across a Frame Relay network.

Defaults

The default encapsulation keyword is Cisco.
When this command is not configured, encapsulation is inherited from the Frame Relay main interface.

Command Modes

Frame Relay PVC configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the encap command to configure encapsulation for a Frame Relay PVC. If this command is not configured, encapsulation is inherited from the Frame Relay subinterface.

This command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to set encapsulation on PVC data-link connection identifier (DLCI) 16 for Packet-over-SONET/SDH (POS) subinterface 0/4/0/1.1:

RP/0/0/CPU0:router(config)# interface POS 0/4/0/1.1

RP/0/0/CPU0:router(config-subif)# pvc 16

RP/0/0/CPU0:router(config-fr-vc)# encap

Related Commands

Command	Description
encapsulation frame-relay	Enables Frame Relay encapsulation.

encapsulation frame-relay

To enable Frame Relay encapsulation, use the encapsulation frame-relay command in interface configuration mode. To disable Frame Relay encapsulation, use the no form of this command.

encapsulation frame-relay [ietf]

no encapsulation frame-relay [ietf]

Syntax Description

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

Defaults

The default encapsulation method is Cisco.

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the encapsulation frame-relay command to connect an interface to a Frame Relay network. When this command is configured, incoming packets to the interface are encapsulated and outgoing packets are encapsulated with a Frame Relay header.

A Cisco or IETF encapsulation method controls the Network Layer Protocol Identifier (NLPID) that is added to outgoing packets on the interface. The encapsulation method enabled for an outgoing packet can be changed for each data-link connection identifier (DLCI) per subinterface by using the encap (PVC) command in Frame Relay PVC configuration mode.

When the encapsulation frame-relay command is configured, LMI is enabled by default. To disable LMI use the frame-relay lmi disable command.

The following restrictions apply to the encapsulation frame-relay command upon configuration or removal of the command on an interface:

•When configuring this command, Layer 3 and Layer 2 configurations are not allowed on the interface.

•Before removing this command, all Frame Relay subinterfaces and LMI configuration should be deleted from the interface.

The encapsulation frame-relay command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
interface	read, write
fr	read, write

Examples

The following example shows Frame Relay encapsulation configured on Packet-over-SONET/SDH (POS) 0/3/0/1:

RP/0/0/CPU0:router(config)# interface POS 0/3/0/1

RP/0/0/CPU0:router(config-if)# encapsulation frame-relay ietf

Related Commands

Command	Description
encap (PVC)	Configures encapsulation for an FR PVC.
frame-relay lmi disable	Disables the LMI.

frame-relay intf-type

To configure the interface type of the User-Network Interface (UNI), use the frame-relay intf-type command in interface configuration mode. To change the configuration, use the no form of this command.

frame-relay intf-type [dce | dte]

no frame-relay intf-type [dce | dte]

Syntax Description

dce	(Optional) Router functions as a switch connected to a router.
dte	(Optional) Router is connected to a Frame Relay network.

Defaults

DTE

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The frame-relay intf-type command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to configure a DCE switch type on the interface:

RP/0/0/CPU0:router(config)# interface pos 0/4/0/0

RP/0/0/CPU0:router(config-if)# frame-relay intf-type dce

frame-relay lmi disable

To disable the Frame Relay Local Management Interface (LMI), use the frame-relay lmi disable command in interface configuration mode. To reenable LMI, use the no form of this command.

frame-relay lmi disable

no frame-relay lmi disable

Syntax Description

No default behavior or values

Defaults

LMI is enabled.

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The frame-relay lmi disable command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to configure a DCE switch type on the interface:

RP/0/0/CPU0:router(config)# interface pos 0/4/0/0

RP/0/0/CPU0:router(config-if)# frame-relay lmi disable

frame-relay lmi-n391dte

To set the full status polling interval, use the frame-relay lmi-n391dte command in interface configuration mode. To restore the default interval value, use the no form of this command.

frame-relay lmi-n391dte polling-cycles

no frame-relay lmi-n391dte polling-cycles

Syntax Description

polling-cycles

Number of Line Integrity Verification (LIV) exchanges performed before requesting a full status message. Range is from 1 to 255.

Defaults

polling-cycles: 6

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the frame-relay lmi-n391dte command as a means of setting the full status message polling interval. This command is relevant only when the interface type is data terminal equipment (DTE).

Two message types are supported: status inquiry and status. Status inquiry messages are sent from DTE to DCE. Status messages are sent from DCE to DTE (in response to a status inquiry). The Status (Full) and LIV report types are contained within these messages, and typically there is one status transaction for every five LIV transactions.

This command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows that one out of every four status inquiries generated requests a full status response from the DCE on the interface:

RP/0/0/CPU0:router(config)# interface serial 0/1/0/1

RP/0/0/CPU0:router(config-if)# frame-relay intf-type dte

RP/0/0/CPU0:router(config-if)# frame-relay lmi-n391dte 4

frame-relay lmi-n392dce

To set the error threshold on a DCE interface, use the frame-relay lmi-n392dce command in interface configuration mode. To restore the default setting, use the no form of this command.

frame-relay lmi-n392dce threshold

no frame-relay lmi-n392dce threshold

Syntax Description

threshold

Error threshold value. Range is from 1 to 10.

Defaults

errors: 3

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

N392 errors must occur within the number defined by the N393 event count for the link to be declared down. Therefore, the threshold value for this command must be less than the count value defined in the frame-relay lmi-n393dce command.

The frame-relay lmi-n392dce command is relevant only when the interface type is data computer equipment (DCE).

This command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to set the Local Management Interface (LMI) failure threshold to 4. The router acts as a Frame Relay DCE switch.

RP/0/0/CPU0:router(config)# interface serial 0/1/0/1

RP/0/0/CPU0:router(config-if)# frame-relay intf-type dce

RP/0/0/CPU0:router(config-if)# frame-relay lmi-n392dce 4

Related Commands

Command	Description
frame-relay lmi-n393dce	Sets the DCE monitored events count.

frame-relay lmi-n392dte

To set the error threshold on a DTE interface, use the frame-relay lmi-n392dte command in interface configuration mode. To restore the default setting, use the no form of this command.

frame-relay lmi-n392dte threshold

no frame-relay lmi-n392dte threshold

Syntax Description

threshold

Error threshold value. Range is from 1 to 10.

Defaults

errors: 3

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The frame-relay lmi-n392dte command is relevant only when the interface type is data terminal equipment (DTE).

This command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to set the Local Management Interface (LMI) failure threshold to 4. The router acts as a Frame Relay DTE switch.

RP/0/0/CPU0:router(config)# interface serial 0/1/0/1

RP/0/0/CPU0:router(config-if)# frame-relay intf-type dte

RP/0/0/CPU0:router(config-if)# frame-relay lmi-n392dte 4

frame-relay lmi-n393dce

To set the DCE monitored events count, use the frame-relay lmi-n393dce command in interface configuration mode. To restore the default setting, use the no form of this command.

frame-relay lmi-n393dce events

no frame-relay lmi-n393dce events

Syntax Description

events

Monitored events count. Range is from 1 to 10.

Defaults

events: 4

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The frame-relay lmi-n393dce command is used along with the frame-relay lmi-n392dce command to define the condition that causes the link to be declared down.

N392 errors must occur within the events argument count in order for the link to be declared down. Therefore, the events value defined in this command must be greater than the threshold value defined in the frame-relay lmi-n392 dce command.

The frame-relay lmi-n393dce command is relevant only when the interface type is data computer equipment (DCE).

This frame-relay lmi-n393dce command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to set the Local Management Interface (LMI) monitored events count to 5.

RP/0/0/CPU0:router(config)# interface serial 0/1/0/1

RP/0/0/CPU0:router(config-if)# frame-relay intf-type dce

RP/0/0/CPU0:router(config-if)# frame-relay lmi-n393dce 5

Related Commands

Command	Description
frame-relay lmi-n392dce	Sets the error threshold on a DCE interface.

frame-relay lmi-n393dte

To set the monitored event count on a DTE interface, use the frame-relay lmi-n393dte command in interface configuration mode. To restore the default setting, use the no form of this command.

frame-relay lmi-n393dte events

no frame-relay lmi-n393dte events

Syntax Description

events

Monitored events count. Range is from 1 to 10.

Defaults

events: 4

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The frame-relay lmi-n393dte command is relevant only when the interface type is data terminal equipment (DTE).

This frame-relay lmi-n393dte command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to set the Local Management Interface (LMI) monitored events count to 5.

RP/0/0/CPU0:router(config)# interface serial 0/1/0/1

RP/0/0/CPU0:router(config-if)# frame-relay intf-type dte

RP/0/0/CPU0:router(config-if)# frame-relay lmi-n393dte 5

frame-relay lmi-t391dte

To set the Local Management Interface (LMI) polling interval, use the frame-relay lmi-t391dte command in interface configuration mode. To restore the default interval value, use the no form of this command.

frame-relay lmi-t391dte seconds

no frame-relay lmi-t391dte seconds

Syntax Description

seconds

Polling interval (in seconds) between each status inquiry from the DTE end. Range is from 5 to 30.

Defaults

10 seconds

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

This frame-relay lmi-t391dte command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

The seconds value defined in this command must be less than the polling verification timer defined in the frame-relay lmi-t392 dce command.

The frame-relay lmi-t391dte command is relevant only when the interface type is data terminal equipment (DCE).

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to set the LMI polling timer interval to 15 seconds.

RP/0/0/CPU0:router(config)# interface serial 0/1/0/1

RP/0/0/CPU0:router(config-if)# frame-relay intf-type dte

RP/0/0/CPU0:router(config-if)# frame-relay lmi-t391dte 15

frame-relay lmi-t392dce

To set the Local Management Interface (LMI) polling verification timer on the DCE, use the frame-relay lmi-t392dce command in interface configuration mode. To restore the default setting, use the no form of this command.

frame-relay lmi-t392dce seconds

no frame-relay lmi-t392dce seconds

Syntax Description

seconds

Polling verification timer in seconds. Range is from 5 to 30.

Defaults

seconds:15

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The frame-relay lmi-t392dce command is used along with the frame-relay lmi-t391dte command to define the condition that causes the link to be declared down.

The seconds value defined in this command must be greater than the polling verification timer defined in the frame-relay lmi-t391 dte command.

This frame-relay lmi-n392dce command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to set the Local Management Interface (LMI) polling timer interval to 30 seconds.

RP/0/0/CPU0:router(config)# interface serial 0/1/0/1

RP/0/0/CPU0:router(config-if)# frame-relay intf-type dce

RP/0/0/CPU0:router(config-if)# frame-relay lmi-t392dce 30

frame-relay lmi-type

To select the Local Management Interface (LMI) type, use the frame-relay lmi-type command in interface configuration mode. To restore the default setting, use the no form of this command.

frame-relay lmi-type {ansi | cisco | q933a}

no frame-relay lmi-type {ansi | cisco | q933a}

Syntax Description

ansi	Uses LMI as defined by ANSI T1.617a-1994 Annex D.
cisco	Uses LMI as defined by Cisco (not standard).
q933a	Uses LMI as defined by ITU-T Q.933 (02/2003) Annex A.

Defaults

Cisco

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	The ccitt keyword was replaced with the q933a keyword.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

If the DTE is not explicitly configured or the no form is not used after explicit configuration, then the DTE automatically senses the LMI type of the DCE and use that type of LMI.

This frame-relay lmi-type command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to set the Local Management Interface (LMI) type to Q.933, Annex A.

RP/0/0/CPU0:router(config)# interface serial 0/1/0/1

RP/0/0/CPU0:router(config-if)# frame-relay lmi-type q933a

pvc (frame relay)

To associate a data-link connection identifier (DLCI) number to a permanent virtual circuit (PVC), and to enter Frame Relay PVC configuration mode, use the pvc command in subinterface configuration mode. To delete the PVC, use the no form of this command.

pvc dlci-number

no pvc dlci-number

Syntax Description

dlci-number

DLCI number used to identify the PVC. Range is from 16 to 1007.

Defaults

No PVC is defined.

Command Modes

Subinterface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Commands available in Frame Relay PVC configuration mode are:

RP/0/0/CPU0:router(config-fr-vc)#?

  commit    Commit the configuration changes to running

  describe  Describe a command without taking real actions

  do        Run an exec command

  encap     Set the Encapsulation of this PVC

  exit      Exit from this submode

  no        Negate a command or set its defaults

  show      Show contents of configuration

RP/0/0/CPU0:router(config-fr-vc)#

The pvc command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following example shows how to create a PVC with DLCI 16:

RP/0/0/CPU0:router(config)# interface pos 0/4/0/0.1

RP/0/0/CPU0:router(config-subif)# pvc 16

RP/0/0/CPU0:router(config-fr-vc)#

show frame-relay lmi

To display Frame Relay statistics about the Local Management Interface (LMI), use the show frame-relay lmi EXEC command.

show frame-relay lmi [interface type instance | location node-id]

Syntax Description

interface type	(Optional) Interface type. For more information, use the question mark (?) online help function.
instance	(Optional) Either a physical interface instance or a virtual interface instance as follows: •Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation. –rack: Chassis number of the rack. –slot: Physical slot number of the modular services card or line card. –module: Module number. A physical layer interface module (PLIM) is always 0. –port: Physical port number of the interface. Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: interface MgmtEth0/RP1/CPU0/0. •Virtual interface instance. Number range varies depending on interface type. For more information about the syntax for the router, use the question mark (?) online help function.
location node-id	(Optional) Clears hardware resource counters from the designated node. The node-id argument is entered in the rack/slot/module notation.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

This command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

This command is used to check the status enquiry and status message between DCE and DTE.

Task ID

Task ID	Operations
fr	read, write

Examples

The following is sample output from the show frame-relay lmi command:

RP/0/0/CPU0:router# show frame-relay lmi

LMI Statistics for interface POS0/1/0/0/ (Frame Relay DCE) LMI TYPE = ANSI

  Invalid Unnumbered Info 0             Invalid Prot Disc 0

  Invalid Dummy Call Ref 0              Invalid Msg Type 0

  Invalid Status Message 0              Invalid Lock Shift 9

  Invalid Information ID 0              Invalid Report IE Len 0

  Invalid Report Request 0              Invalid Keep IE Len 0

  Num Status Enq. Rcvd 9444             Num Status Msgs Sent 9444

  Num Full Status Sent 1578             Num St Enq. Timeouts 41

  Num Link Timeouts 7

LMI Statistics for interface POS0/1/0/1/ (Frame Relay DCE) LMI TYPE = CISCO

  Invalid Unnumbered Info 0             Invalid Prot Disc 0

  Invalid Dummy Call Ref 0              Invalid Msg Type 0

  Invalid Status Message 0              Invalid Lock Shift 0

  Invalid Information ID 0              Invalid Report IE Len 0

  Invalid Report Request 0              Invalid Keep IE Len 0

  Num Status Enq. Rcvd 9481             Num Status Msgs Sent 9481

  Num Full Status Sent 1588             Num St Enq. Timeouts 16

  Num Link Timeouts 4

Table 66 describes the significant fields shown in the display.

Table 66 show frame-relay lmi Field Descriptions

Field	Description
LMI Statistics	Signaling or LMI specification: CISCO, ANSI, or CCITT. Note CCITT is LMI as defined by ITU-T Q.933 (02/2003) Annex A.
Invalid Unnumbered Info	Number of received LMI messages with invalid unnumbered information field.
Invalid Dummy Call	Number of received LMI messages with invalid dummy calls.
Invalid Status Message	Number of received LMI messages with invalid status message.
Invalid Information ID	Number of received LMI messages with invalid information identifier.
Invalid Report Request	Number of received LMI messages with invalid Report Request.
Num Status Enq. Rcvd	Number of LMI status enquiry messages received.
Num Link Timeouts	Number of link timeouts.
Invalid Prot Disc	Number of received LMI messages with invalid protocol discriminator.
Invalid Msg Type	Number or received LMI messages with invalid message type.
Invalid Lock Shift	Number of received LMI messages with invalid lock shift type.
Invalid Report IE Len	Number of received LMI messages with invalid Report IE Length.
Invalid Keep IE Len	Number of received LMI messages with invalid Report Request.
Num Status Msgs Sent	Number of LMI status enquiry messages sent.
Num St Enq. Timeouts	Number of times the status enquiry message was not received within the T392 DCE timer value.

show frame-relay pvc

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

show frame-relay pvc [interface type instance | location node-id] [dlci-number]

Syntax Description

interface type	(Optional) Interface type. For more information, use the question mark (?) online help function.
instance	(Optional) Either a physical interface instance or a virtual interface instance as follows: •Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation. –rack: Chassis number of the rack. –slot: Physical slot number of the modular services card or line card. –module: Module number. A physical layer interface module (PLIM) is always 0. –port: Physical port number of the interface. Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: interface MgmtEth0/RP1/CPU0/0. •Virtual interface instance. Number range varies depending on interface type. For more information about the syntax for the router, use the question mark (?) online help function.
location node-id	(Optional) Clears hardware resource counters from the designated node. The node-id argument is entered in the rack/slot/module notation.
dlci-number	(Optional) DLCI number used to identify the PVC. Range is from 16 to 1007.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

This command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

This command is used to check the status of PVCs on interfaces.

Task ID

Task ID	Operations
fr	read, write

Examples

The following is sample output from the show frame-relay pvc command:

RP/0/0/CPU0:router# show frame-relay pvc

PVC Statistics for interface Serial0/3/2/0 (Frame Relay DCE)

              Active     Inactive      Deleted       Static

  Local          4           0            0             0

  Switched       0           0            0             0

  Dynamic        0           0            0             0

DLCI = 612, DLCI USAGE = LOCAL, ENCAP = CISCO, INHERIT = TRUE, PVC STATUS = ACT

VE, INTERFACE = Serial0/3/2/0.1

  input pkts 0          output pkts 0           in bytes 0

  out bytes 0           dropped pkts 0          in FECN packets 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:00      last time pvc status changed 00:00:00

DLCI = 613, DLCI USAGE = LOCAL, ENCAP = CISCO, INHERIT = TRUE, PVC STATUS = ACT

VE, INTERFACE = Serial0/3/2/0.2

  input pkts 0          output pkts 0           in bytes 0

  out bytes 0           dropped pkts 0          in FECN packets 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:00      last time pvc status changed 00:00:00

DLCI = 614, DLCI USAGE = LOCAL, ENCAP = CISCO, INHERIT = TRUE, PVC STATUS = ACT

VE, INTERFACE = Serial0/3/2/0.3

  input pkts 0          output pkts 0           in bytes 0

  out bytes 0           dropped pkts 0          in FECN packets 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:00      last time pvc status changed 00:00:00

DLCI = 615, DLCI USAGE = LOCAL, ENCAP = CISCO, INHERIT = TRUE, PVC STATUS = ACT

VE, INTERFACE = Serial0/3/2/0.4

  input pkts 0          output pkts 0           in bytes 0

  out bytes 0           dropped pkts 0          in FECN packets 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:00      last time pvc status changed 00:00:00

RP/0/0/CPU0:router#

The following is sample output for a specific frame-relay PVC:

RP/0/0/CPU0:router# show frame-relay pvc 613

DLCI = 613, DLCI USAGE = LOCAL, ENCAP = CISCO, INHERIT = TRUE, PVC STATUS = ACTI

VE, INTERFACE = Serial0/3/2/0.2

  input pkts 0          output pkts 0           in bytes 0

  out bytes 0           dropped pkts 0          in FECN packets 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:00      last time pvc status changed 00:00:00

Table 67 describes the significant fields shown in the displays.

Table 67 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.
ENCAP	Type of encapsulation.
INHERIT	Encapsulation type for the PVC is inherited from the main interface.
PVC STATUS	Status of the PVC: ACTIVE, INACTIVE, or DELETED.
INTERFACE	Specific subinterface associated with this DLCI.
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 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.
pvc create time	Time at which the PVC was created.
last time pvc status changed	Time at which the PVC changed status.
shaping drops	Number of packets dropped by the traffic-shaping process.

show interfaces (frame relay)

To display statistics about Frame Relay interfaces, use the show interfaces command in EXEC mode.

show interfaces [type instance | all | local | location node-id] [accounting | brief | detail | summary]

Syntax Description

type	(Optional) Interface type. For more information, use the question mark (?) online help function.
instance	(Optional) Either a physical interface instance or a virtual interface instance as follows: •Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation. –rack: Chassis number of the rack. –slot: Physical slot number of the modular services card or line card. –module: Module number. A physical layer interface module (PLIM) is always 0. –port: Physical port number of the interface. Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: interface MgmtEth0/RP1/CPU0/0. •Virtual interface instance. Number range varies depending on interface type. For more information about the syntax for the router, use the question mark (?) online help function.
all	(Optional) Displays interface information for all interfaces. This is the default.
local	(Optional) Displays interface information for all interfaces in the local card.
location node-id	(Optional) Clears hardware resource counters from the designated node. The node-id argument is entered in the rack/slot/module notation.
accounting	(Optional) Displays the number of packets of each protocol type that have been sent through the interface.
brief	(Optional) Displays brief information about each interface (one line per interface).
detail	(Optional) Displays detailed information about each interface. This is the default.
summary	(Optional) Displays a summary of interface information by interface type.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

This command is available on Packet-over-SONET/SDH (POS) and serial interfaces for this Cisco IOS XR software release.

Task ID

Task ID	Operations
fr	read, write

Examples

The following is sample output from the show interfaces command when the interface is configured with Frame Relay encapsulation:

RP/0/0/CPU0:router# show interfaces pos 0/1/0/0

POS0/1/0/0 is up, line protocol is up 

  Hardware is Packet over SONET/SDH

  Internet address is Unknown

  MTU 4474 bytes, BW 622080 Kbit

     reliability 255/255, txload 1/255, rxload 1/255

  Encapsulation FRAME-RELAY, crc 32, controller loopback not set,

  LMI enq sent  0, LMI stat recvd 0, LMI upd recvd 0

  LMI enq recvd 9463, LMI stat sent  9463, LMI upd sent  0 , DCE LMI up

  LMI DLCI 0  LMI type is ANSI Annex D  frame relay DCE 

  Last clearing of "show interface" counters never

  5 minute input rate 0 bits/sec, 0 packets/sec

  5 minute output rate 0 bits/sec, 0 packets/sec

     20934 packets input, 1508069 bytes, 1151 total input drops

     0 drops for unrecognized upper-level protocol

     Received 0 broadcast packets, 0 multicast packets

              0 runts, 0 giants, 0 throttles, 0 parity

     1151 input errors, 1058 CRC, 0 frame, 0 overrun, 93 ignored, 0 abort

     19590 packets output, 990924 bytes, 0 total output drops

     Output 0 broadcast packets, 0 multicast packets

     0 output errors, 0 underruns, 0 applique, 0 resets

     0 output buffer failures, 0 output buffers swapped out

     0 carrier transitions

Table 68 describes the significant fields shown in the display.

Table 68 show interfaces Field Descriptions

Field	Description
Interface name	Displays the name of the current interface. In the example, the interface name is POS0/1/0/0.
Interface state	Displays the state of the interface. In the example, the interface is in the administratively up state.
line protocol state	Displays the state of the Layer 2 line protocol. This field may be different from the interface state if, for example, a keepalive failure has brought down the Layer 2. Note The line protocol state is not the same as the protocol state displayed in the show ip interfaces command, because it is the state of Layer 2 (media) rather than Layer 3 (IP protocol).
Hardware	Displays the current hardware type.
Internet address is n.n.n.n/n	Displays the Layer 2 address (MAC address for Ethernet interfaces). Note Enter the mac-address command to configure the hardware address.
MTU	Displays the maximum transmission unit (MTU) for the interface. The MTU is the maximum packet size that can be transmitted over the interface. Note The MTU field indicates the interface MTU. Enter the mtu command to configure a lower MTU value at the layer 3 level.
BW	Displays the bandwidth of the interface in kbps.
reliability	Displays the proportion of packets that are not dropped and do not have errors. Note The reliability is shown as a fraction of 255.
txload	Indicates the traffic flowing out of the interface as a proportion of the bandwidth. Note The txload is shown as a fraction of 255.
rxload	Indicates the traffic flowing into the interface as a proportion of the bandwidth. Note The rxload is shown as a fraction of 255.
Encapsulation	Layer 2 encapsulation installed on the interface.
CRC	Indicates the length of the cyclic redundancy check (CRC), in bytes. Note Enter the pos crc command to configure the CRC.
controller loopback	Indicates that the hardware was configured as controller loopback.
LMI enq sent	Number of LMI enquiry messages sent.
LMI stat recvd	Number of LMI status messages received.
LMI upd recvd	Number of LMI updated messages received.
LMI enq recvd	Number of LMI enquiry messages received.
LMI stat sent	Number of LMI status messages sent.
LMI upd sent	Number of LMI updated messages sent.
DCE LMI	Displays the state of the DCE LMI.
LMI DLCI	Displays the LMI DLCI identifier.
LMI type	Displays the LMI type.
Last clearing	Time at which the counters that measure cumulative statistics (such as number of bytes transmitted and received) shown in this report were last reset to zero. Note that variables that might affect routing for example, load and reliability) are not cleared when the counters are cleared.
5 minute input rate 5 minute output rate	Average number of bits and packets transmitted per second in the last 5 minutes. The 5-minute input and output rates should be used only as an approximation of traffic per second during a given 5-minute period. These rates are exponentially weighted averages with a time constant of 5 minutes. A period of four time constants must pass before the average will be within two percent of the instantaneous rate of a uniform stream of traffic over that period.
packets input	Total number of error-free packets received by the system.
bytes	Total number of bytes, including data and MAC encapsulation, in the error-free packets received by the system.
Received...broadcasts	Total number of broadcast or multicast packets received by the interface
runts	Number of packets that are discarded because they are smaller than the minimum packet size of the medium.
giants	Number of packets that are discarded because they exceed the maximum packet size of the medium
input errors	Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort counts. Other input-related errors can also increment the count, so that this sum might not balance with the other counts.
CRC	Cyclic redundancy checksum generated by the originating station or far-end device does not match the checksum calculated from the data received. On a serial link, CRCs usually indicate noise, gain hits, or other transmission problems on the data link.
frame	Number of packets received incorrectly having a CRC error and a noninteger number of octets. On a serial line, this is usually the result of noise or other transmission problems.
overrun	Number of times the serial receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data.
ignored	Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. Broadcast storms and bursts of noise can cause the ignored count to be increased.
abort	Illegal sequence of one bits on a serial interface. This usually indicates a clocking problem between the serial interface and the data link equipment.
carrier transitions	Number of times the carrier detect signal of a serial interface has changed state. For example, if data carrier detect (DCD) goes down and comes up, the carrier transition counter will increment two times. Indicates modem or line problems if the carrier detect line is changing state often.

snmp-server traps frame-relay pvc

To enable Simple Network Management Protocol (SNMP) trap notifications for a Frame Relay permanent virtual circuit (PVC), use the snmp-server traps frame-relay pvc command in global configuration mode. To disable SNMP notifications for a FR PVC, use the no form of this command.

snmp-server traps frame-relay pvc [interval seconds]

no snmp-server traps frame-relay pvc [interval seconds]

Syntax Description

interval seconds

(Optional) Minimum period between successive traps. Range is from 0 to 3600.

Defaults

seconds: 30

Command Modes

Global configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the snmp-server traps frame-relay pvc command to enable trap requests for a Frame Relay PVC. This command is used with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications.

See Implementing SNMP on Cisco IOS XR Software for detailed information about SNMP configuration tasks and commands.

Task ID

Task ID	Operations
snmp	read, write

Examples

The following example shows how to configure the router to send SNMP trap notifications for a Frame Relay PVC:

RP/0/0/CPU0:router(config)# snmp-server host 12.26.25.61 traps public udp-port 5000 

RP/0/0/CPU0:router(config)# snmp-server community public RW

RP/0/0/CPU0:router(config)# snmp-server traps frame-relay pvc interval 50

Related Commands

Command	Description
snmp-server host	Specifies the recipient of an SNMP notification operation.
snmp-server community	Configures the community access string to permit access to the SNMP.