-
Cisco IOS XR Interface and Hardware Component Command Reference, Release 3.0
-
802.1Q VLAN Commands on Cisco IOS XR Software
-
cHDLC Commands on Cisco IOS XR Software
-
Cisco CRS-1 Platform and Driver Commands on Cisco IOS-XR Software
-
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software
-
Fabric Management Commands on Cisco IOS XR Software
-
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software
-
LPTS Platform Commands on Cisco IOS XR Software
-
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software
-
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software
-
PPP Commands on Cisco IOS XR Software
-
SONET APS Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software
This module describes the Cisco IOS XR commands used to configure, monitor, and troubleshoot packet-over-SONET (POS). It also describes the Cisco IOS XR software commands used to configure the SONET operation on a router port using Layer 1 SONET transport technology.
All SONET-related configurations of a SONET-based physical port are grouped under the SONET controller configuration submode. The SONET path-related configuration commands are grouped under the SONET path submode.
POS provides a method for efficiently carrying data packets in SONET or Synchronous Digital Hierarchy (SDH) frames. High-bandwidth capacity and efficient link utilization are characteristics that make POS largely preferred for building the core of data networks. POS uses PPP in High-Level Data Link Control (HDLC)-like framing for data encapsulation at Layer 2 (data link) of the Open System Interconnection (OSI) stack. This method provides efficient packet delineation and error control.
In addition to high-bandwidth efficiency, POS offers secure and reliable transmission for data. Reliable data transfer depends on timing integrity.
The real-time POS functionality is performed in hardware, according to the hardware configuration setup. Configured hardware events are detected by the framer application-specific integrated circuits (ASICs) and the control is passed to the software. The generic POS driver is responsible for providing a mechanism to configure the hardware on a per-interface basis, to handle interface state transitions, and to collect POS-related statistics.
ais-shut (SONET)
To enable automatic insertion of a line alarm indication signal (LAIS) in the sent SONET signal whenever the SONET port enters the administrative shutdown state, use the ais-shut command in SONET configuration mode. To disable automatic insertion of a LAIS, use the no form of this command.
ais-shut
no ais-shut
Syntax Description
This command has no arguments or keywords.
Defaults
This command is disabled by default; no AIS is sent.
Command Modes
SONET configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
When the line is placed in administrative shutdown state, use the ais-shut command to send a signal to downstream equipment that indicates that there is a problem with the line.
The ais-shut command is ignored if automatic protection switching (APS) is running for the corresponding port, because the setting must be enabled for proper APS operation.
For SONET ports that do not have hardware support for LAIS insertion, the ais-shut command is disabled.
Examples
In the following example, the alarm indication is forced on the SONET OC-3 controller:
RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/0RP/0/RP0/CPU0:router(config-sonet)# ais-shutais-shut (SONET path)
To enable automatic insertion of path alarm indication signal (PAIS) in the sent SONET signal whenever the SONET path enters the administratively down state, use the ais-shut command in SONET path configuration mode. To disable automatic insertion of PAIS in the SONET signal, use the no form of this command.
ais-shut
no ais-shut
Syntax Description
This command has no arguments or keywords.
Defaults
This command is disabled by default; no AIS is sent.
Command Modes
SONET path configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the ais-shut command to enable automatic insertion of PAIS in the appropriate sent SONET path overhead whenever the corresponding SONET path enters the administratively down state.
Examples
The following example enables the alarm indication on all paths:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2RP/0/RP0/CPU0:router(config-sonet)# pathRP/0/RP0/CPU0:router(config-sonet-path)# ais-shutclear counters sonet
To clear SONET counters for a specific SONET controller, use the clear counters sonet command in EXEC mode.
clear counters sonet interface-type interface-instance
Syntax Description
Command Modes
EXEC
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear counters sonet command to clear SONET counters for a specific SONET controller.
Examples
The following example clears the SONET counters on the SONET interface:
RP/0/RP0/CPU0:router# clear counters ?Loopback Loopback interface(s)MgmtEth Ethernet/IEEE 802.3 interface(s)Null Null interfacePOS Packet over SONET network interface(s)SONET SONET/SDH Port controller(s)all Clear counters on all interfacestunnel-te MPLS Traffic Engineering Tunnel interface(s)RP/0/RP0/CPU0:router# clear counters sonet ?0/1/0/0 SONET Interface Instance0/1/0/1 SONET Interface Instance0/1/0/2 SONET Interface Instance0/1/0/3 SONET Interface Instance0/2/0/0 SONET Interface Instance0/2/0/1 SONET Interface Instance0/2/0/2 SONET Interface Instance0/2/0/3 SONET Interface InstanceRP/0/RP0/CPU0:router# clear counters sonet 0/1/0/0clock source (SONET)
To set the clock source of the sent signal on SONET ports, use the clock source command in SONET configuration mode. To cancel a clock source setting, use the no form of this command.
clock source {internal | line}
no clock source {internal | line}
Syntax Description
Defaults
The default clock source for the controller is the line clock.
Command Modes
SONET configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clock source command to configure which reference clock is used by the sender.
Examples
In the following example, the SONET controller is configured to clock its sent data from its internal clock:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2RP/0/RP0/CPU0:router(config-sonet)# clock source internalcontroller
To configure a SONET controller, use the controller command in global configuration mode. To return to the default state, use the no form of this command.
controller {sonet | preconfigure} interface-type interface-instance
no controller {sonet | preconfigure} interface-type interface-instance
Syntax Description
Command Modes
Global configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Examples
The following example shows how to specify that the configured SONET controller is in slot number 2:
RP/0/RP0/CPU0:router(config)# controller SONET 0/2/0/1RP/0/RP0/CPU0:router(config-sonet)#The following example shows how to specify that the SONET controller you want to preconfigure is in slot number 3, which does not have a line card installed:
RP/0/RP0/CPU0:router(config)# controller preconfigure SONET 0/3/0/1RP/0/RP0/CPU0:router(config-sonet)#crc
To set the length of the cyclic redundancy check (CRC) on a packet-over-SONET (POS) interface, use the crc command in POS interface configuration mode. To return the CRC setting on a POS interface to the 16-bit default setting for OC-3 cards, use the no form of this command.
crc {16 | 32}
no crc {16 | 32}
Syntax Description
16
Sets 16-bit CRC mode (default on OC-3 cards). The default is 16 bits.
32
Sets 32-bit CRC mode (default on OC-12 cards and higher). The default is 32 bits.
Defaults
The default is 16 bits for OC-3/Synchronous Transport Module (STM)-1 and 32 bits for OC-12/STM-4 and OC-48/STM-16 POS interfaces.
Command Modes
POS interface configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Default CRC for interfaces depends on the type of POS interface: OC-3/STM-1 uses a 16-bit CRC; OC-12/STM-4 and OC-48/STM-16 POS interfaces use a 32-bit CRC. All interfaces also support a 32-bit CRC.
CRC is an error-checking technique that uses a calculated numeric value to detect errors in transmitted data. The designators 16 and 32 indicate the length (in bits) of the frame check sequence (FCS). A CRC of 32 bits provides more powerful error detection, but adds overhead. Both the sender and receiver must use the same setting.
CRC-16, the most widely used error checking method throughout the United States and Europe, is used extensively with WANs. CRC-32 is specified by Electrical and Electronics Engineers (IEEE) 802 and as an option by some point-to-point transmission standards. It is often used on Switched Multimegabit Data Service (SMDS) networks and LANs.
Examples
In the following example, the 32-bit CRC on POS interface 0/1/0/2 is enabled:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# interface POS 0/1/0/2RP/0/RP0/CPU0:router(config-if)# POSRP/0/RP0/CPU0:router(config-if-pos)# crc 32Related Commands
delay trigger
To configure SONET line delay trigger values, use the delay trigger command in SONET configuration mode. To cancel the line delay trigger value and return to the default, use the no form of this command.
delay trigger line value
no delay trigger line value
Syntax Description
line value
Sets the SONET line delay trigger value in milliseconds. The range is from 0 to 511. The default is 0 (no delay).
Defaults
value: 0 milliseconds
Command Modes
SONET configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Examples
In the following example, the SONET line delay trigger value is set to 5:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2RP/0/RP0/CPU0:router(config-sonet)# delay trigger line 5framing (SONET)
To specify the framing used on the SONET controller, use the framing command in SONET configuration mode. To disable framing on the SONET controller, use the no form of this command.
framing {sdh | sonet}
no framing {sdh | sonet}
Syntax Description
sdh
Selects Synchronous Digital Hierarchy (SDH) framing. This framing mode is typically used in Europe.
sonet
Selects SONET framing. This is the default.
Defaults
SONET framing.
Command Modes
SONET configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the framing command to select either SONET or SDH framing on the selected physical port, if supported. For physical ports that do not support either of these two options, the framing command is disabled.
Use the no form of this command to disable SONET or SDH framing on the SONET controller.
Examples
In the following example, the SONET controller is configured for SDH framing:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2RP/0/RP0/CPU0:router(config-sonet)# framing sdhloopback (SONET)
To configure the SONET controller for loopback mode, use the loopback command in SONET configuration mode. To remove the loopback SONET command from the configuration file, use the no form of this command.
loopback {internal | line}
no loopback {internal | line}
Syntax Description
internal
Specifies that all the packets be looped back from the source.
line
Specifies that the incoming network packets be looped back to the SONET network.
Defaults
This command is disabled by default.
Command Modes
SONET configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The SONET and Synchronous Digital Hierarchy (SDH) transport layers support two loopback operation modes for diagnostic purposes: internal and line. In the terminal (internal) loopback, the sent signal is looped back to the receiver. While in the facility (line) loopback, the signal received from the far end is looped back and sent on the line. The two loopback modes cannot be active at the same time. In normal operation mode, neither of the two loopback modes is enabled.
Examples
In the following example, all packets are looped back to the SONET controller:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2RP/0/RP0/CPU0:router(config-sonet)# loopback internaloverhead (SONET)
To set the SONET overhead bytes in the frame header to a specific standards requirement or to ensure interoperability with equipment from another vendor, use the overhead command in SONET configuration mode. To remove the setting of the SONET overhead bytes from the configuration file and restore the default condition, use the no form of this command.
overhead {j0 | s1s0} byte value
no overhead {j0 | s1s0} byte value
Syntax Description
Defaults
The default j0 value is 0xcc; the default sls0 value is 0.
Command Modes
SONET configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the overhead command to set the SONET overhead bytes in the frame header to a specific standards requirement.
Use the no form of this command to remove the setting of the SONET overhead bytes from the configuration file and restore the default condition.
For the j0 keyword, the value that you use for the trace byte depends on the type of equipment being used. For the s1s0 keyword, the value that you use depends on whether you are using the SONET or SDH mode. For SONET mode, use the value 0 (this is the default). For SDH mode, use the value 2.
Examples
In the following example, the s1s0 keyword value is set to 2 for SDH:
RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/1RP/0/RP0/CPU0:router(config-sonet)# overhead sls0 2overhead (SONET path)
To set the SONET path overhead bytes in the frame header to a specific standards requirement or to ensure interoperability with equipment from another vendor, use the overhead command in SONET path configuration mode. To remove the setting of the SONET path overhead bytes from the configuration file and restore the system to its default condition, use the no form of this command.
overhead {c2 | j1} byte value
no overhead {c2 | j1} byte value
Syntax Description
Defaults
The default c2 value is 0xCF; the default j1 value is 0.
Command Modes
SONET path configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The SONET standards permit or require user access for configuration of some bytes or bits in the SONET path overhead. Use the overhead command to set the SONET path overhead bytes in the frame header to a specific standards requirement. Use the no form of this command to remove the setting of the SONET path overhead bytes from the configuration file and restore the system to its default condition.
Use the c2 keyword to configure the desired C2 byte value in the SONET path overhead.
Use the j1 keyword to configure a user-defined path trace message in the j1 bytes of the SONET path overhead. For the j1 keyword, use the default message or insert your own message that has a maximum of 62 characters. If no user-defined message is configured, a default message will be automatically generated, containing the router name, the controller name, its IP address, and the values of the sent and received K1 and K2 bytes in the SONET line overhead.
Examples
In the following example, the c2 value is set:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2RP/0/RP0/CPU0:router(config-sonet)# pathRP/0/RP0/CPU0:router(config-sonet-path)# overhead c2 0x13Related Commands
path (SONET)
To enter the SONET path configuration submode, use the path command in SONET controller configuration mode.
path
Syntax Description
This command has no arguments or keywords.
Defaults
This command is disabled by default.
Command Modes
SONET controller configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the path command to access SONET path configuration submode. The following commands are available in SONET path configuration submode:
•
ais-shut—Configure sending path alarm indication signal (PAIS) when shut down
•
•
•
•
•
•
•
•
•
•
Examples
In the following example, the SONET path submode is accessed:
RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/0RP/0/RP0/CPU0:router(config-sonet)# pathpos
To access the POS interface configuration submode, use the pos command in interface configuration mode.
pos
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default behavior or values.
Command Modes
Interface configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Examples
In the following example, POS configuration submode is accessed from POS interface configuration submode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# interface POS 0/1/0/2RP/0/RP0/CPU0:router(config-if)# POSRP/0/RP0/CPU0:router(config-if-pos)#Related Commands
Sets the length of the CRC on a POS interface.
Specifies a number of flag sequences to be inserted between the packets.
pos transmit-delay
To specify a number of flag sequences to be inserted between the packets, use the pos transmit-delay command in interface configuration mode. To restore the default, use the no form of this command.
pos transmit-delay microseconds
no pos transmit-delay microseconds
Syntax Description
microseconds
The number of microseconds of minimum delay after sending a packet. The valid range is from 0 to 1023. The default value is 0 (disabled).
Defaults
The default is 0 (disabled).
Command Modes
Interface configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The pos transmit-delay command is especially useful for serial interfaces that can send back-to-back data packets over interfaces faster than some hosts can receive them.
Examples
In the following example, a delay of 2 microseconds is specified on POS interface 0/1/0/2:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# interface POS 0/1/0/2RP/0/RP0/CPU0:router(config-if)# POS transmit-delay 2In the following example, the transmit delay on POS interface 0/1/0/2 is disabled:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# interface POS 0/1/0/2RP/0/RP0/CPU0:router(config-if)# no POS transmit-delayreport (SONET)
To permit selected SONET alarms to be logged to the console for a SONET controller, use the report command in SONET configuration mode. To disable logging of select SONET alarms, use the no form of this command.
report [b1-tca | b2-tca | lais | lrdi | sd-ber | sf-ber | slof | slos]
no report [b1-tca | b2-tca | lais | lrdi | sd-ber | sf-ber | slof | slos]
Syntax Description
Defaults
Alarms from the following keywords are reported by default:
•
•
•
•
•
•
Command Modes
SONET configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Reporting an alarm means that the alarm can be logged to the console. Just because an alarm is permitted to be logged does not guarantee that it is logged. SONET alarm hierarchy rules dictate that only the most severe alarm of an alarm group is reported. Whether an alarm is reported or not, you can check the current state of masked alarm, a problem indication that is a candidate for an alarm, by displaying the "Masked Alarms" line in the show controllers sonet command output.
For B1, the bit interleaved parity (BIP) error report is calculated by comparing the BIP-8 code with the BIP-8 code that is extracted from the B1 byte of the following frame. Differences indicate that section level bit errors have occurred.
For B2, the BIP error report is calculated by comparing the BIP-8/24 code with the BIP-8 code that is extracted from the B2 byte of the following frame. Differences indicate that line level bit errors have occurred.
Path AIS is sent by line terminating equipment to alert the downstream path terminating equipment (PTE) that it has detected a defect on its incoming line signal.
Path loss of pointer (LOP) is reported as a result of an invalid pointer (H1, H2) or an excess number of new data flag enabled indications.
SLOF is detected when an error framing defect on the incoming SONET signal persists for 3 microseconds.
SLOS is detected when an all-zeros pattern on the incoming SONET signal is observed. This defect might also be reported if the received signal level drops below the specified threshold.
To determine the alarms that are reported on the controller, use the show controllers sonet command.
Examples
In the following example, the reporting of line AIS alarms is enabled on the path controller:
RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/1RP/0/RP0/CPU0:router(config-sonet)# report laisRelated Commands
report (SONET path)
To permit selected SONET alarms to be logged to the console for a SONET path controller, use the report command in SONET path configuration mode. To disable logging of select SONET alarms, use the no form of this command.
report [b3-tca | pais | plop | prdi | puneq]
no report [b3-tca | pais | plop | prdi | puneq]
Syntax Description
Defaults
Alarms from the following keywords are reported by default:
•
•
Command Modes
SONET path configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Reporting an alarm means that the alarm can be logged to the console. Just because an alarm is permitted to be logged does not guarantee that it is logged. SONET alarm hierarchy rules dictate that only the most severe alarm of an alarm group is reported. Whether an alarm is reported or not, you can view the current state of an masked alarm, a problem indication that is a candidate for an alarm, by inspecting the "Masked Alarms" line displayed in the show controllers sonet command output.
For B3, the bit interleaved parity (BIP) error report is calculated by comparing the BIP-8 code with the BIP-8 code that is extracted from the B3 byte of the following frame. Differences indicate that path level bit errors have occurred.
Path AIS is sent by line terminating equipment to alert the downstream path terminating equipment (PTE) that it has detected a defect on its incoming line signal.
Path LOP is reported as a result of an invalid pointer (H1, H2) or an excess number of new data flag enabled indications.
To determine the alarms that are reported on the controller, use the show controllers sonet command.
All report commands accept the default option. The default reporting values are determined based upon the SONET standards specifications and are clearly identified in the corresponding command's help string.
Examples
In the following example, reporting of path PAIS alarms is enabled:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2RP/0/RP0/CPU0:router(config-sonet)# pathRP/0/RP0/CPU0:router(config-sonet-path)# report paisRelated Commands
scrambling (SONET path)
To enable SONET payload scrambling on a SONET path, use the scrambling command in SONET path configuration mode. To disable payload scrambling, use the no form of this command.
scrambling {enable | disable}
no scrambling
Syntax Description
Defaults
The default is enable (SONET payload scrambling is on).
Command Modes
SONET path configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the scrambling command in SONET path configuration mode to enable SONET payload scrambling on a SONET path. Use the no form of this command to disable payload scrambling.
SONET payload scrambling applies a self-synchronous scrambler (x43+1) to the Synchronous Payload Envelope (SPE) of the controller to ensure sufficient bit transition density. Both ends of the connection must be configured using SONET path scrambling.
If the hardware payload scrambling support is not user-configurable, or is not supported, the scrambling command may be disabled or may be rejected.
Examples
In the following example, scrambling is enabled for the path:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2RP/0/RP0/CPU0:router(config-sonet)# pathRP/0/RP0/CPU0:router(config-sonet-path)# scrambling enableshow controllers pos
To display information on the packet-over-SONET (POS) controllers, use the show controllers pos command in EXEC mode.
show controllers pos interface-instance [{all | details | queues | registers | stats} | {{rxfifo | txfifo} address}]
Syntax Description
Command Modes
EXEC
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.
Examples
The following is sample output from the show controllers pos command:
RP/0/RP0/CPU0:router# show controllers POS 0/3/0/2Port Number : 2Interface : POS0_3_0_2Ifhandle : 0x1380120CRC : 32MTU : 4474Port Bandwidth Kbps : 2488320Admin state : UpDriver Link state : UpBundle member : NoBundle MTU : 4474Bundle Adminstate : UpRP/0/RP0/CPU0:router# show controllers POS 0/3/0/2 allPort Number : 2Interface : POS0_3_0_2Ifhandle : 0x1380120CRC : 32MTU : 4474Port Bandwidth Kbps : 2488320Admin state : UpDriver Link state : UpBundle member : NoBundle MTU : 4474Bundle Adminstate : UpPOS Driver Internal Cooked Stats Values for port 2===================================================Rx Statistics Tx Statistics------------- -------------Total Bytes: 1200 Total Bytes: 0Good Bytes: 1200 Good Bytes: 0Good Packets: 25 Good Packets: 0Aborts: 0 Aborts: 0FCS Errors: 0 Min-len errors: 0Runts: 0 Max-len errors: 0FIFO Overflows: 0 FIFO Underruns: 0Giants: 0Drops: 0Sky4402 asic #2 registers:0x000 general_cntrl 0x000x002 sys_intf_cntrl_1 0x060x003 sys_intf_cntrl_2 0x000x004 JTAG3 0x100x005 JTAG2 0x100x006 JTAG1 0x100x007 JTAG0 0x2f0x010 active_led 0x010x011 gpio_port_mode 0x010x012 gpio_port_fault 0x000x013 gpio_port_data 0x580x015 gpio_port_cntrl 0x3f0x017 gpio_port_transition 0x000x019 gpio_port_intr_mask 0xff0x01b gpio_port_intr 0x3f0x01c master_intr_status 0x000x01d master_mask 0x000x020 interrupt_4 0x040x021 interrupt_3 0x000x022 interrupt_2 0x000x023 interrupt_1 0x000x024 status_4 0x040x025 status_3 0x000x026 status_2 0x0c0x027 status_1 0x800x028 mask_4 0x070x029 mask_3 0x030x02a mask_2 0x1c0x02b mask_1 0x8f0x02d link_state_cntrl 0x800x041 diag 0x000x042 stcks 0x030x043 short_frame_cntrl 0x000x0c0 ror_ram_c2 0x160x0c1 ror_ram_g1 0x000x0c2 ror_ram_f2 0x000x0c3 ror_ram_h4 0x000x0c4 ror_ram_z3 0x000x0c5 ror_ram_z4 0x000x0c6 ror_ram_z5 0x000x0c7 ror_ram_db_c2 0x160x0c8 ror_ram_db_g1 0x000x142 tor_ram_c2 0x160x143 tor_ram_g1 0x000x144 tor_ram_f2 0x000x145 tor_ram_h4 0x000x146 tor_ram_z3 0x000x147 tor_ram_z4 0x000x148 tor_ram_z5 0x000x170 tor_ram_s1 0x000x171 tor_ram_e2 0x000x172 tor_ram_e1 0x000x173 tor_ram_f1 0x000x174 tor_ram_k1 0x000x175 tor_ram_k2 0x000x177 tor_ram_z2 0x000x180 rsp_cntrl_1 0x000x181 rsp_cntrl_2 0x020x184 rtop_f1_ovrhd 0x000x185 rtop_k1_ovrhd 0x000x186 rtop_k2_ovrhd 0x000x187 rtop_s1_ovrhd 0x000x188 rtop_e1_ovrhd 0x000x189 rtop_e2_ovrhd 0x000x18a rtop_deb_s1_ovrhd 0x000x18c rtop_b1_mismatch_cnt_u 0x000x18d rtop_b1_mismatch_cnt_l 0x000x190 rtop_b2_mismatch_cnt_u 0x000x191 rtop_b2_mismatch_cnt_l 0x000x194 rtop_rei_l_cnt_u 0x000x195 rtop_rei_l_cnt_l 0x000x198 rtop_ber_thresh_u 0x000x199 rtop_ber_thresh_l 0x000x19a rtop_ber_leak_u 0x000x19b rtop_ber_leak_l 0x000x19c rtop_ber_delay_u 0x000x19d rtop_ber_delay_l 0x000x1c0 rpop_signal_lbl_c2 0x160x1c2 rpop_valid_ptr_u 0x020x1c3 rpop_valid_ptr_l 0x0a0x1c4 rpop_b3_mismatch_cnt_u 0x000x1c5 rpop_b3_mismatch_cnt_l 0x000x1c8 rpop_rei_p_cnt_u 0x000x1c9 rpop_rei_p_cnt_l 0x000x1cc rpop_ber_thresh_u 0x000x1cd rpop_ber_thresh_l 0x000x1ce rpop_ber_leak_u 0x000x1cf rpop_ber_leak_l 0x000x1d0 rpop_ber_delay_u 0x000x1d1 rpop_ber_delay_l 0x000x200 rpp_cntrl_1 0x110x201 rpp_cntrl_2 0x030x202 rpp_cntrl_3 0x3e0x203 rpp_cntrl_4 0x000x204 rpp_cntrl_5 0x000x208 rpp_max_pkt_len_u 0x080x209 rpp_max_pkt_len_l 0xbd0x20a rpp_min_pkt_len 0x040x244 tpp_inter_pkt_u 0x000x245 tpp_inter_pkt_l 0x000x246 tpp_idle_cell_hdr 0x000x247 tpp_idle_cell_filldata 0x000x248 tpp_cntrl 0x040x280 tpog_cntrl 0x200x2c0 ttog_cntrl 0x000x2c2 ttog_ovrhd_src_1 0x000x2c3 ttog_ovrhd_src_2 0x000x2c9 ttog_ovrhd_fill 0x00Table 34 describes the significant fields shown in the display.
show controllers sonet
To display information about the operational status of SONET layers, use the show controllers sonet command in EXEC mode.
show controllers sonet {all | framers | internal-state}
Syntax Description
all
Displays all information.
framers
Displays framer information.
internal-state
Displays internal SONET state.
Command Modes
EXEC
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show controllers sonet command to display information about the operational status of SONET layers on a particular SONET port.
Examples
The following is sample output from the show controllers sonet command:
RP/0/RP0/CPU0:router# show controllers sonet 0/1/0/2Port SONET0/2/0/0:SECTIONLOF = 0 LOS = 1 BIP(B1) = 0LINEAIS = 0 RDI = 0 FEBE = 0 BIP(B2) = 0PATHAIS = 0 RDI = 0 FEBE = 0 BIP(B3) = 0LOP = 0 NEWPTR = 0 PSE = 0 NSE = 0Detected Alarms: SLOSAsserted Alarms: SLOSMask for Detected->Asserted: SLOF LAIS SF_BER SD_BER LRDI PLOP PAIS PRDIDetected Alerts: NoneReported Alerts: NoneMask for Detected->Reported: B1-TCA B2-TCA B3-TCAAlarm reporting enabled for: SLOS SLOF SF_BER PLOPAlert reporting enabled for: B1-TCA B2-TCA B3-TCAFraming: SONETSPE Scrambling: DisabledC2 State: Unstable C2_rx = 0x0 (0) C2_tx = 0xCF (207)S1S0(tx): 0x0PATH TRACE BUFFER : UNSTABLERemote hostname :Remote interface:Remote IP addr :Remote Rx(K1/K2): / Remote Tx(K1/K2): /BER thresholds: SF = 10e-3 SD = 10e-6TCA thresholds: B1 = 10e-6 B2 = 10e-6 B3 = 10e-6Clock source: internal (actual) internal (configured)Optical Power Monitoring (accuracy: +/- 1dB)Rx power = 0.0 mW, n/a dBmTx power = 0.2 mW, -6.7 dBmTx laser current bias = 14.1 mAThe following is sample output from the show controllers sonet framers command:
RP/0/RP0/CPU0:router# show controllers sonet 0/1/0/2 framersPM 5355 asic #0 registers:0x00 master_rst 0x100x11 master_cfg 0x9f0x02 master_intr_sts 0x000x03 piso_intr 0x00<snip>0x80 suni_master_test 0xc0The following is sample output from the show controllers sonet internal-state command:
RP/0/RP0/CPU0:router# show controllers sonet 0/1/0/2 internal-statecontroller(layer) admin_up if_state----------------------------------------SONET2_0 up up(SONET Section) up up(SONET Line) up down(SONET Path) up downSonetPath2_0 up downPOS2_0 up downTable 35 describes the significant fields shown in the display.
shutdown (SONET)
To disable SONET controller processing, use the shutdown command in SONET configuration mode. To bring back up a SONET controller and enable SONET controller processing, use the no form of this command.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Defaults
The SONET controller is up, and SONET controller processing is enabled.
Command Modes
SONET configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the shutdown command to shut down a SONET controller and disable SONET controller processing. Use the no shutdown command to bring back up a SONET controller and enable SONET controller processing.
The SONET controller must be brought up for the proper operation of the Layer 2 interface. The Layer 2 interface has a separate shutdown command available, which does not operate on the SONET controller's administrative state.
Examples
In the following example, the SONET controller is brought down and SONET controller processing is disabled:
RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/2RP/0/RP0/CPU0:router(config-sonet)# shutdownthreshold (SONET)
To set the bit-error rate (BER) threshold values of the specified alarms for a SONET controller, use the threshold command in SONET configuration mode. To remove the setting of the threshold from the configuration file and restore the default condition, use the no form of this command.
threshold {b1-tca | b2-tca | sd-ber | sf-ber} bit-error-rate
no threshold {b1-tca | b2-tca | sd-ber | sf-ber} bit-error-rate
Syntax Description
Defaults
The default bit-error rate is 10e-6 for b1-tca, b2-tca, and sd-ber.
The default bit-error rate is 10e-3 for sf-ber.Command Modes
SONET configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
For B1, the bit interleaved parity (BIP) error report is calculated by comparing the BIP-8 code with the BIP-8 code that is extracted from the B1 byte of the following frame. Differences indicate that section level bit errors have occurred.
For B2, the BIP error report is calculated by comparing the BIP-8/24 code with the BIP-8 code that is extracted from the B2 byte of the following frame. Differences indicate that line level bit errors have occurred.
Signal failure BER and signal degrade BER are sourced from B2 BIP-8 error counts (as is B2-TCA). The b1-tca and b2-tca keywords print only a log message to the console (if reports for them are enabled).
To determine the BER thresholds configured on the controller, use the show controllers sonet command.
Examples
In the following example, thresholds on the SONET controller are configured:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2RP/0/RP0/CPU0:router(config-sonet)# threshold sd-ber 8RP/0/RP0/CPU0:router(config-sonet)# threshold sf-ber 4RP/0/RP0/CPU0:router(config-sonet)# threshold b1-tca 4Related Commands
Permits selected SONET alarms to be logged to the console for a SONET controller.
Displays information about the operational status of SONET layers.
threshold (SONET path)
To set the bit-error rate (BER) threshold values of the specified alarms for a SONET path, use the threshold command in SONET path configuration mode. To remove the setting of the SONET path threshold from the configuration file and restore the default condition, use the no form of this command.
threshold b3-tca bit-error-rate
no threshold b3-tca bit-error-rate
Syntax Description
b3-tca
Sets the B3 BER threshold crossing alarm (TCA). The default BER is 6.
bit-error-rate
BER from 3 to 9 (10 to the minus x).
Defaults
The default BER is 6 for b3-tca.
Command Modes
SONET path configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
For B3, the bit interleaved parity (BIP) error report is calculated by comparing the BIP-8 code with the BIP-8 code that is extracted from the B3 byte of the following frame. Differences indicate that path level bit errors have occurred.
In addition to BIP errors detected at the local end in the receive direction, B3 error counts detected in the G1 byte (P-REI or P-FEBE) by the far-end SONET equipment are returned.
The b3-tca keyword prints only a log message to the console (if reports for them are enabled).
Examples
In the following example, the BER is set to 4:
RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/1RP/0/RP0/CPU0:router(config-sonet)# pathRP/0/RP0/CPU0:router(config-sonet-path)# threshold b3-tca 4Related Commands
Displays information that is specific to SONET controllers.
Permits selected SONET alarms to be logged to the console for a SONET controller.
uneq-shut (SONET path)
To enable automatic insertion of P-UNEQ code (0x00) in the sent SONET path overhead C2 byte, use the uneq-shut command in SONET path configuration mode. To disable this feature, use the no form of this command.
uneq-shut
no uneq-shut
Syntax Description
This command has no arguments or keywords.
Defaults
This command is enabled by default.
Command Modes
SONET path configuration
Command History
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, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the uneq-shut command to disable automatic insertion of P-UNEQ code in the sent SONET path overhead C2 byte whenever the SONET path enters the administratively down state.
Examples
In the following example, automatic insertion of P-UNEQ code is disabled in the sent SONET path overhead C2 byte:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2RP/0/RP0/CPU0:router(config-sonet)# pathRP/0/RP0/CPU0:router(config-sonet-path)# uneq-shut