Cisco IOS XR Commands by Software Package, Release 3.8.0
Dense Wavelength Division Multiplexing Commands on Cisco IOS XR Software

Table Of Contents

Dense Wavelength Division Multiplexing Commands on Cisco IOS XR Software

controller dwdm

g709 bdi-to-client-gais

g709 disable

g709 fec

g709 odu overhead tti

g709 odu report

g709 otu overhead tti

g709 otu report

g709 otu threshold

g709 tim-to-client-gais

g709 tti-processing

laser

loopback (DWDM)

pm fec report

pm fec threshold

pm optics report

pm optics threshold

pm otn report

pm otn threshold

rx-los-threshold

show controller dwdm

show controller dwdm pm

shutdown (DWDM)

transmit-power

wavelength


Dense Wavelength Division Multiplexing Commands on Cisco IOS XR Software


This module describes the commands to configure dense wavelength division multiplexing (DWDM) controller interfaces on routers supporting Cisco IOS XR software.

For information on 10-Gigabit Ethernet (GE) interface commands refer to Ethernet Interface Commands on Cisco IOS XR Software. For information on Packet-over-SONET/SDH (POS) interface commands, refer to Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software.

controller dwdm

To configure a DWDM controller, use the controller dwdm command in global configuration mode. To return to the default state, use the no form of this command.

controller dwdm interface-path-id

no controller dwdm interface-path-id

Syntax Description

interface-path-id

Physical interface or virtual interface.

Note Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

No default behavior or values

Command Modes

Global configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

For the interface-path-id argument, use the following guidelines:

If specifying a physical interface, the naming notation is rack/slot/module/port. The slash between values is required as part of the notation. An explanation of each component of the naming notation is as follows:

rack: Chassis number of the rack.

slot: Physical slot number of the line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

If specifying a virtual interface, the number range varies, depending on interface type.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure a DWDM controller in Slot 6:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/6/0/0

Related Commands

Command
Description

show controller dwdm

Displays the optical parameters, G.709 alarms and counters, and register and module information.


g709 bdi-to-client-gais

To insert a GAIS to client on the detection of a backward defect indication (BDI), use the g709 bdi-to-client-gais command in DWDM configuration mode. To disable this feature, use the no form of this command.

g709 bdi-to-client-gais enable

no g709 bdi-to-client-gais enable

Syntax Description

enable

Indicates that the DWDM controller is disabled if a BDI is received on this interface.


Defaults

By default, no GAIS to client is inserted.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco CRS-1 router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The g709 bdi-to-client-gais command is available on the 10-GE DWDM PLIM only.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure a GAIS to client when a BDI is received:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/6/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# g709 bdi-to-client-gais enable

Related Commands

Command
Description

no g709 disable

Enables the G.709 wrapper on the controller.

show controller dwdm

Displays optical parameters, G.709 alarms and counters, and register and module information for a DWDM controller.


g709 disable

To disable the G.709 wrapper, use the g709 disable command in DWDM configuration mode. To enable the G.709 wrapper, use the no form of this command.

g709 disable

no g709 disable

Syntax Description

This command has no arguments or keywords.

Defaults

The G.709 wrapper is enabled.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.


Note The g709 disable command is available on the 10-GE DWDM PLIM only.


The G.709 wrapper must be enabled to enable forward error correction (FEC) mode on the controller.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to disable the G.709 wrapper on an interface:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/6/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# g709 disable

Related Commands

Command
Description

g709 fec

Configures FEC mode on the controller.

show controller dwdm g709

Displays the optical parameters, G.709 alarms and counters, and register and module information.


g709 fec

To configure the forward error correction mode (FEC) for the DWDM controller, use the g709 fec command in DWDM configuration mode. To return to the default state, use the no form of this command.

g709 fec {disable | standard}

no g709 fec {disable | standard}

Syntax Description

disable

Disables FEC.

standard

Enables standard FEC mode.


Defaults

Enhanced FEC mode is enabled by default.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The g709 fec command can be used only when the DWDM controller is in the shutdown state. The G.709 wrapper must be enabled to enable forward error correction (FEC) mode on the controller.

Enhanced FEC is the default mode; therefore, if you use the no g709 fec command, enhanced FEC is used.


Note The OC-768c/STM-256c DWDM PLIM supports enhanced FEC mode only. Disabling FEC or enabling standard FEC is not supported.


Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure standard FEC mode on a DWDM controller:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/6/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# g709 fec standard

Related Commands

Command
Description

no g709 disable

Enables the G.709 wrapper on the controller.

show controllers dwdm g709

Displays the FEC mode.


g709 odu overhead tti

To configure the trail trace identifier (TTI) level, in ASCII or hexadecimal format, for an optical channel data unit (ODU), use the g709 odu overhead tti command in DWDM configuration mode.
To return to the default state, use the no form of this command.

g709 odu overhead tti {expected | sent} {ascii | hex} tti-string

no g709 odu overhead tti {expected | sent} {ascii | hex} tti-string

Syntax Description

expected

Configures the expected TTI string.

sent

Configures the transmit TTI string.

ascii

Indicates that the string is in ASCII format.

hex

Indicates that the string is in hexidecimal format.

tti-string

The TTI level string. You can configure the TTI level string in ASCII string format or hexadecimal format. The ASCII text string can be a maximum of 64 characters. The hexadecimal string length must be an even number and can be a maximum of 128 bytes.


Defaults

No TTI level string is configured.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.6.0

This command was introduced on the Cisco CRS-1 router and the Cisco XR 12000 Series Router.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure the expected TTI string:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/1/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# g709 odu overhead tti expected test OTU 5678

Related Commands

Command
Description

show controller dwdm

Displays optical parameters, G.709 alarms and counters, and register and module information for a DWDM controller.


g709 odu report

To disable the logging of selected optical channel data unit (ODU) alarms to the console for a DWDM controller, use the g709 odu report command in DWDM configuration mode. To return to the default state, use the no form of this command.

g709 odu report {ais | bdi | eoc | lck | oci | ptim | sd-ber | sf-ber | tim} disable

no g709 odu report {ais | bdi | eoc | lck | oci | ptim | sd-ber | sf-ber | tim} disable

Syntax Description

ais

(Optional) Alarm indication signal reporting status.

bdi

(Optional) Backward defect indication reporting status.

eoc

(Optional) GCC end of channel failure reporting status.

lck

(Optional) Upstream connection locked reporting status.

oci

(Optional) Open connection indication error reporting status.

pm-tca

(Optional) Path monitoring BER TCA reporting status.

ptim

(Optional) Payload type identifier mismatch reporting status.

sd-ber

(Optional) Set SM BER in excess of SD threshold reporting status.

sf-ber

(Optional) Set SM BER in excess of SF threshold reporting status.

tim

(Optional) Set Trace Identifier Mismatch reporting status.

disable

Disables the reporting of the specified trigger.


Defaults

Reporting is enabled for all keywords.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

The tim keyword was added.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to disable ODU reporting for OCI:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# g709 odu report oci disable

Related Commands

Command
Description

show controller dwdm g709

Displays the G.709 alarms and counters.


g709 otu overhead tti

To configure the OTU trail trace identifier (TTI) buffer for a DWDM controller, use the g709 otu overhead tti command in DWDM configuration mode. To return to the default state, use the no form of this command.

g709 otu overhead tti {expected | sent} {ascii | hex} tti-string

no g709 otu overhead tti {expected | sent} {ascii | hex} tti-string

Syntax Description

expected

Configures the expected TTI string.

sent

Configures the transmit TTI string.

ascii

Indicates that the string is in ASCII format.

hex

Indicates that the string is in hexidecimal format.

tti-string

The TTI string. A maximum of 64 characters is allowed.


Defaults

No TTI string is configured

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco CRS-1 router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure the expected TTI string:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# g709 otu overhead tti expected test OTU 5678

Related Commands

Command
Description

show controller dwdm g709

Displays the TTI strings.


g709 otu report

To disable the logging of selected optical channel transport unit (OTU) alarms to the console for a DWDM controller, use the g709 otu report command in DWDM configuration mode. To return to the default state, use the no form of this command.

g709 otu report {ais | bdi | eoc | fecmismatch | iae | lof | lom | los | sd-ber | sf-ber | tim} disable

no g709 otu report {ais | bdi | eoc | fecmismatch | iae | lof | lom | los | sd-ber | sf-ber | tim} disable

Syntax Description

ais

(Optional) Alarm indication signal reporting status.

bdi

(Optional) Backward defect indication reporting status.

eoc

(Optional) GCC end of channel failure reporting status.

fecmismatch

(Optional) FEC mismatch alarm reporting status.

iae

(Optional) Incoming alignment error reporting status.

lof

(Optional) OTU loss of frame reporting status.

lom

(Optional) Loss of multiple frame reporting status.

los

(Optional) Loss of signal reporting status.

sd-ber

(Optional) SM bit error rate (BER) is in excess of the signal degradation BER threshold.

sf-ber

(Optional) SM BER is in excess of the signal failure BER threshold.

sm-tca

(Optional) Section monitoring BER TCA reporting status.

tim

(Optional) Trace Identifier Mismatch reporting status.

disable

Disables the reporting of the specified trigger.


Defaults

Reporting is enabled for all keywords.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

The tim keyword was added.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to disable OTU reporting for IAE:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# g709 otu report iae disable

Related Commands

Command
Description

show controller dwdm g709

Displays the G.709 alarms and counters.


g709 otu threshold

To configure thresholds for selected optical channel transport unit (OTU) bit error rate (BER) alarms, use the g709 otu threshold command in DWDM configuration mode. To return to the default state, use the no form of this command.

g709 otu threshold {sd-ber | sf-ber} bit-error-rate

no g709 otu threshold {sd-ber | sf-ber} bit-error-rate

Syntax Description

sd-ber

Signal degradation bit error rate (BER).

sf-ber

Signal failure BER above threshold.

bit-error-rate

Specifies the BER threshold value in the range from 3 through 9. The threshold value is interpreted as a negative exponent of 10 when determining the bit error rate. For example, a value of 5 implies a bit error rate of 10 to the minus 5. The default BER threshold value is 6.


Defaults

bit-error-rate: 6

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

R/W


Examples

The following example shows how to set the signal fail BER rate to be 5:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# g709 otu threshold sf-ber 5

Related Commands

Command
Description

show controller dwdm g709

Displays the G.709 alarms and counters.


g709 tim-to-client-gais

To insert a generic alarm indication signal (GAIS) on the client side when a trace identifier mismatch (TIM) is detected, use the g709 tim-to-client-gais command in DWDM configuration mode. To disable this feature, use the no form of this command.

g709 tim-to-client-gais enable

no g709 tim-to-client-gais enable

Syntax Description

enable

Enables the insertion of a generic alarm indication signal (GAIS) when a trace identifier mismatch (TIM) is received on this interface.


Defaults

By default, no GAIS to client is inserted.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.6.0

This command was introduced on the Cisco CRS-1 router and the Cisco XR 12000 Series Router.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.


Note The g709 tim-to-client-gais command is available on the 10-GE DWDM PLIM only.


Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure a GAIS to client when a BDI is received:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/1/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# g709 tim-to-client-gais enable

Related Commands

Command
Description

show controller dwdm

Displays optical parameters, G.709 alarms and counters, and register and module information for a DWDM controller.


g709 tti-processing

To enable trace identifier mismatch (TIM) alarms, use the g709 tti-processing command in DWDM configuration mode. To disable trace identifier mismatch (TIM) alarms,, use the no form of this command.

g709 tti-processing

no g709 tti-processing

Syntax Description

This command has no arguments or keywords.

Defaults

By default, trace identifier mismatch (TIM) alarms are disabled.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.6.0

This command was introduced on the Cisco CRS-1 router and the Cisco XR 12000 Series Router.


Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.


Note Trace identifier mismatch (TIM) alarms can be set only when TTI processing is enabled.


Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure the expected TTI string:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/1/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# g709 tti-processing 

Related Commands

Command
Description

show controller dwdm

Displays optical parameters, G.709 alarms and counters, and register and module information for a DWDM controller.


laser

To turn the laser associated with the DWDM controller off, use the laser command in DWDM configuration mode. To turn the laser back on, use the no form of this command.

laser off

no laser off

Syntax Description

off

Turns the laser off.


Defaults

The laser is on by default.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco CRS-1 router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The laser cannot be turned on if the controller is in the shutdown state in a non-G.709 mode or if the controller is in internal loopback mode.

Examples

In the following example, the laser is turned off:

RP/0/RP0/CPU0:router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:router(config-dwdm)# laser off

loopback (DWDM)

To configure the DWDM controller for loopback mode, use the loopback command in DWDM configuration mode. To remove the loopback DWDM 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 to the router.

line

Specifies that the incoming network packets be looped back to the DWDM network.


Defaults

This command is disabled by default.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The DWDM controller supports two loopback operation modes for diagnostic purposes: internal and line. The terminal (internal) loopback mode allows the received data from the Layer 2 Framer (for example, a SONET/SDH framer for POS or Ethernet MAC for 10GE) of the PLIM to be looped back to the ingress side of the Framer. This allows the packets to be looped back to the PLIM. The line loopback mode allows the received trunk/DWDM line Rx to be connected to the trunk/DWDM line Tx towards the line. This is used for line diagnostics.

Examples

In the following example, all packets are looped back to the DWDM controller:

RP/0/RP0/CPU0:router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:router(config-dwdm)# loopback internal

pm fec report

To enable threshold crossing alert (TCA) generation on the FEC layer, use the pm fec report command in DWDM configuration mode. To disable TCAs, use the no form of this command.

pm {15-min | 24-hour} fec report {ec-bits | uc-words} enable

no pm {15-min | 24-hour} fec report {ec-bits | uc-words} enable

Syntax Description

15-min

Configures the TCA generation for 15-minute intervals.

24-hour

Configures TCA generation for 24-hour intervals.

ec-bits

Bit errors corrected (BIEC). Indicates the number of bit errors corrected in the DWDM trunk line during the performance monitoring time interval.

uc-words

Uncorrectable words. This is the number of uncorrectable words detected in the DWDM trunk line during the performance monitoring time interval.

enable

Enables TCA generation for the specified parameter on the DWDM controller.


Defaults

TCA is not enabled.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco CRS-1 router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to enable TCAs on the FEC layer reporting for uncorrectable words:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# pm 15-min fec report uc-words enable

Related Commands

Command
Description

show controller dwdm pm fec

Displays performance measurement information for the FEC layer.


pm fec threshold

To configure performance monitoring thresholds on the FEC layer, use the pm fec threshold command in DWDM configuration mode. To return to the default state, use the no form of this command.

pm {15-min | 24-hour} fec threshold {ec-bits | uc-words} threshold

no pm {15-min | 24-hour} fec threshold {ec-bits | uc-words} threshold

Syntax Description

15-min

Configures the performance monitoring thresholds for 15-minute intervals.

24-hour

Configures performance monitoring thresholds for 24-hour intervals.

ec-bits

Bit errors corrected (BIEC). Indicates the number of bit errors corrected in the DWDM trunk line during the performance monitoring time interval.

uc-words

Uncorrectable Words. This is the number of uncorrectable words detected in the DWDM trunk line during the performance monitoring time interval.

threshold

Threshold for the performance monitoring parameter.


Defaults

No threshold is configured.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco CRS-1 router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure an FEC layer performance monitoring threshold for uncorrectable words:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# pm 15-min fec threshold uc-words 2000000 enable

Related Commands

Command
Description

show controller dwdm pm fec

Displays performance measurement information for the FEC layer.


pm optics report

To enable threshold crossing alert (TCA) generation on the optics layer, use the pm optics report command in DWDM configuration mode. To disable TCA reporting, use the no form of this command.

pm {15-min | 24-hour} optics report {lbc | opr | opt} {max-tca | min-tca} enable

no pm {15-min | 24-hour} optics report {lbc | opr | opt} {max-tca | min-tca} enable

Syntax Description

15-min

Configures TCA generation for 15-minute intervals.

24-hour

Configures TCA generation for 24-hour intervals.

lbc

Laser bias current.

opr

Optical power on the unidirectional port.

opt

Transmit optical power in dBm.

max-tca

Indicates that the maximum value of the parameter is compared against the threshold to determine if a TCA should be generated.

min-tca

Indicates that the minimum value of the parameter is compared against the threshold to determine if a TCA should be generated.

enable

Enables TCA generation for the specified parameter on the DWDM controller.


Defaults

TCA reporting is not enabled.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco CRS-1 router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to enable TCA reporting on the optics layer reporting for the maximum OPT:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# pm 15-min optics report opt max-tca enable

Related Commands

Command
Description

show controller dwdm pm optics

Displays performance measurement information for the optics layer.


pm optics threshold

To configure performance monitoring thresholds on the optics layer, use the pm optics threshold command in DWDM configuration mode. To return to the default state, use the no form of this command.

pm {15-min | 24-hour} optics threshold {lbc | opr | opt} {max | min} threshold

no pm {15-min | 24-hour} optics threshold {lbc | opr | opt} {max | min} threshold

Syntax Description

15-min

Configures the performance monitoring thresholds for 15-minute intervals.

24-hour

Configures performance monitoring thresholds for 24-hour intervals.

lbc

Laser bias current.

opr

Optical power on the unidirectional port.

opt

Transmit optical power in dBm.

max

Indicates that the threshold is for the maximum value of the parameter.

min

Indicates that the threshold is for the minimum value of the parameter.

threshold

Threshold for the performance monitoring parameter.


Defaults

No thresholds are configured.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco CRS-1 router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure an optics layer performance monitoring threshold for maximum OPT:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# pm 15-min optics threshold opt max 2000000 

Related Commands

Command
Description

show controller dwdm pm optics

Displays performance measurement information for the optics layer.


pm otn report

To enable threshold crossing alert (TCA) generation on the optical transport network (OTN) layer, use the pm otn report command in DWDM configuration mode. To disable TCA reporting, use the no form of this command.

pm {15-min | 24-hour} otn report otn-parameter enable

no pm {15-min | 24-hour} otn report otn-parameter enable

Syntax Description

15-min

Configures TCA generation for 15-minute intervals.

24-hour

Configures TCA generation for 24-hour intervals.

otn-parameter

Specific parameter for which to configure the threshold. OTN parameters can be as follows:

bbe-pm-fe—Far-end path monitoring background block errors (BBE-PM). Indicates the number of background block errors recorded in the optical transport network (OTN) path during the performance monitoring time interval.

bbe-pm-ne—Near-end path monitoring background block errors (BBE-PM).

bbe-sm-fe—Far-end section monitoring background block errors (BBE-SM). Indicates the number of background block errors recorded in the OTN section during the performance monitoring time interval.

bbe-sm-ne—Near-end section monitoring background block errors (BBE-SM).

bber-pm-fe—Far-end path monitoring background block errors ratio (BBER-PM). Indicates the background block errors ratio recorded in the OTN path during the performance monitoring time interval.

bber-pm-ne—Near-end path monitoring background block errors ratio (BBER-PM).

bber-sm-fe—Far-end section monitoring background block errors ratio (BBER-SM). Indicates the background block errors ratio recorded in the OTN section during the performance monitoring time interval.

bber-sm-ne—Near-end section monitoring background block errors ratio (BBER-SM)

es-pm-fe—Far-end path monitoring errored seconds (ES-PM). Indicates the errored seconds recorded in the OTN path during the performance monitoring time interval.

es-pm-ne—Near-end path monitoring errored seconds (ES-PM).

es-sm-fe—Far-end section monitoring errored seconds (ES-SM). Indicates the errored seconds recorded in the OTN section during the performance monitoring time interval.

es-sm-ne—Near-end section monitoring errored seconds (ES-SM).

esr-pm-fe—Far-end path monitoring errored seconds ratio (ESR-PM). Indicates the errored seconds ratio recorded in the OTN path during the performance monitoring time interval.

 

esr-pm-ne—Near-end path monitoring errored seconds ratio (ESR-PM).

esr-sm-fe—Far-end section monitoring errored seconds ratio (ESR-SM). Indicates the errored seconds ratio recorded in the OTN section during the performance monitoring time interval.

esr-sm-ne—Near-end section monitoring errored seconds ratio (ESR-SM).

fc-pm-fe—Far-end path monitoring failure counts (FC-PM). Indicates the failure counts recorded in the OTN path during the performance monitoring time interval.

fc-pm-ne—Near-end path monitoring failure counts (FC-PM).

fc-sm-fe—Far-end section monitoring failure counts (FC-SM). Indicates the failure counts recorded in the OTN section during the performance monitoring time interval.

fc-sm-ne—Near-end section monitoring failure counts (FC-SM).

ses-pm-fe—Far-end path monitoring severely errored seconds (SES-PM). Indicates the severely errored seconds recorded in the OTN path during the performance monitoring time interval.

ses-pm-ne—Far-end path monitoring severely errored seconds (SES-PM).

ses-sm-fe—Far-end section monitoring severely errored seconds (SES-SM). Indicates the severely errored seconds recorded in the OTN section during the performance monitoring time interval.

ses-sm-ne—Near-end section monitoring severely errored seconds (SES-SM).

sesr-pm-fe—Far-end path monitoring severely errored seconds ratio (SESR-PM). Indicates the severely errored seconds ratio recorded in the OTN path during the performance monitoring time interval.

sesr-pm-ne—Near-end path monitoring severely errored seconds ratio (SESR-PM).

sesr-sm-fe—Far-end section monitoring severely errored seconds ratio (SESR-SM). Indicates the severely errored seconds ratio recorded in the OTN section during the performance monitoring time interval.

sesr-sm-ne—Near-end section monitoring severely errored seconds ratio (SESR-SM).

uas-pm-fe—Far-end path monitoring unavailable seconds (UAS-PM). Indicates the unavailable seconds recorded in the OTN path during the performance monitoring time interval.

uas-pm-ne—Near-end path monitoring unavailable seconds (UAS-PM).

uas-sm-fe—Far-end section monitoring unavailable seconds (UAS-SM). Indicates the unavailable seconds recorded in the OTN section during the performance monitoring time interval.

uas-sm-ne—Near-end section monitoring unavailable seconds (UAS-SM).

enable

Enables TCA generation for the specified parameter on the DWDM controller.


Defaults

TCA generation is not enabled.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco CRS-1 router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to enable TCA generation on the OTN layer reporting for the path monitoring errored seconds ratio (ESR-PM):

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# pm 15-min otn report esr-pm-fe enable

Related Commands

Command
Description

show controller dwdm pm otn

Displays performance measurement information for the OTN layer.


pm otn threshold

To configure performance monitoring thresholds on the optical transport network (OTN) layer, use the pm otn threshold command in DWDM configuration mode. To disable TCA reporting, use the no form of this command.

pm {15-min | 24-hour} otn threshold otn-parameter threshold

no pm {15-min | 24-hour} otn report otn-parameter threshold

Syntax Description

15-min

Configures performance monitoring thresholds for 15-minute intervals.

24-hour

Configures performance monitoring thresholds for 24-hour intervals.

otn-parameter

Specific parameter for which to configure the threshold. OTN parameters can be as described in pm otn report.

threshold

Threshold for the performance monitoring parameter.


Defaults

No thresholds are configured.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco CRS-1 router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure an OTN layer performance monitoring threshold for path monitoring errored seconds ratio (ESR-PM):

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# pm 15-min otn threshold esr-pm-ne 500000

Related Commands

Command
Description

show controller dwdm pm otn

Displays performance measurement information for the OTN layer.


rx-los-threshold

To configure the transponder receive power threshold on a OC-768c/STM-256c DWDM controller, use the rx-los-threshold command in DWDM configuration mode. To return the transponder receive power threshold to its default value, use the no form of this command.

rx-los-threshold power-level

no rx-los-threshold power-level

Syntax Description

power-level

Receive power level in units of 0.1 dBm. Values can range from -350 to 50, which corresponds to a LOS threshold range of -35 dBm to 5 dBm.


Defaults

power-level: -19.5 dBm

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router and is supported only on the OC-768c/STM-256c DWDM PLIM.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

The value for the power-level argument was changed from -200 to 0, to -350 to 50.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The controller must be in the shutdown state before you can use the rx-los-threshold command.

The rx-los-threshold command is applicable only to the OC-768c/STM-256c DWDM PLIM.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure the receive power threshold to -10 dBm:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# rx-los-threshold -100

Related Commands

Command
Description

show controller dwdm

Displays the optical parameters, G.709 alarms and counters, and register and module information.

transmit-power

Configures the DWDM optics transmit laser power on a DWDM controller.


show controller dwdm

To display optical parameters, G.709 alarms and counters, and register and module information for a DWDM controller, use the show controller dwdm command in EXEC mode.

show controller dwdm instance [g709 [registers] | optics [registers] | [wavelength-map] | [TDC]

Syntax Description

instance

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 line card.

module: Module number. A physical layer interface module (PLIM) is always 0. Shared port adapters (SPAs) are referenced by their subslot number.

port: Physical port number of the interface.

For more information about the syntax for the router, use the question mark (?) online help function.

g709

Displays the G.709 OTN protocol alarms and counters for bit errors, along with the FEC statistics and threshold-based alerts.

optics

Displays optical related information about the interface, such as output power level and wavelength.

registers

For g709, displays platform-specific OTN framer registers; for optics, displays transponder registers.

wavelength-map

Displays the wavelength information.

TDC

Displays tunable dispersion compensator (TDC) information.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router.

Release 3.4.0

The display of the TTI strings was added.

Release 3.5.0

No modification.

Release 3.6.0

Displays tunable dispersion compensator (TDC) information was added.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read


Examples

The following example shows the output from the show controllers dwdm command on a 10-GE DWDM PLIM:

RP/0/RP0/CPU0:Router# show controller dwdm 0/6/0/0 
Port dwdm 0/6/0/0
Controller State: up
Loopback: None
G709 Status 
OTU
         LOS  = 0           LOF  = 0           LOM  = 0          
         BDI  = 0           IAE  = 0           BIP  = 0          
         BEI  = 0           TIM  = 0          
ODU
         AIS  = 0           BDI  = 0           OCI  = 0          
         LCK  = 0           BIP  = 0           BEI  = 0          
         PTIM = 0           TIM  = 0          
FEC Mode: Enhanced FEC(default)
         EC(current second) = 0           EC   = 0           UC   = 0          
         pre-FEC BER < 2.35E-11           Q > 6.66           Q Margin > 7.52 dBQ 
Remote FEC Mode: Unknown
         FECMISMATCH = 0          
Detected Alarms: LOS 
Asserted Alarms: LOS 
Alarm Reporting Enabled for: LOS LOF LOM IAE OTU-BDI OTU-TIM OTU_SF_BER OTU_SD_BER ODU-AIS 
ODU-BDI OCI LCK PTIM ODU-TIM FECMISMATCH 
BER Thresholds: OTU-SF = 10e-3  OTU-SD = 10e-6 
OTU TTI Sent     String ASCII: Tx TTI Not Configured 
OTU TTI Received String ASCII: Rx TTI Not Recieved 
OTU TTI Expected String ASCII: Exp TTI Not Configured 
ODU TTI Sent     String ASCII: Tx TTI Not Configured 
ODU TTI Received String ASCII: Rx TTI Not Recieved 
ODU TTI Expected String ASCII: Exp TTI Not Configured 
Optics Status 
         Optics Type:  DWDM
         Wavelength Info: C-Band, MSA ITU Channel=1, Frequency=196.10THz, 
Wavelength=1528.773nm 
         TX Power = 0.07 dBm 
         RX Power = -43.35 dBm 
         RX LOS Threshold = -17.00 dBm 
TDC Info
        TDC Not Supported on the Plim

The following example shows the output from the show controllers dwdm command on a OC-768c/STM-256c DWDM PLIM.

RP/0/RP0/CPU0:Router# show controller dwdm 0/4/0/0
Port dwdm 0/4/0/0
Controller State: admin-down
Loopback: None
G709 Status 
OTU
         LOS  = 0           LOF  = 0           LOM  = 0          
         BDI  = 0           IAE  = 0           BIP  = 0          
         BEI  = 0           TIM  = 0          
ODU
         AIS  = 0           BDI  = 0           OCI  = 0          
         LCK  = 0           BIP  = 0           BEI  = 0          
         PTIM = 0           TIM  = 0          
FEC Mode: Enhanced FEC(default)
         EC(current second) = 0           EC   = 0           UC   = 0          
         pre-FEC BER < 2.35E-11           Q > 6.66           Q Margin > 7.52 dBQ 
Remote FEC Mode: Unknown
         FECMISMATCH = 0          
Detected Alarms: None
Asserted Alarms: None
Alarm Reporting Enabled for: LOS LOF LOM IAE OTU-BDI OTU-TIM OTU_SF_BER OTU_SD_BER ODU-AIS 
ODU-BDI OCI LCK PTIM ODU-TIM FECMISMATCH 
BER Thresholds: OTU-SF = 10e-3  OTU-SD = 10e-6 
OTU TTI Sent     String ASCII: Tx TTI Not Configured 
OTU TTI Received String ASCII: Rx TTI Not Recieved 
OTU TTI Expected String ASCII: Exp TTI Not Configured 
ODU TTI Sent     String ASCII: Tx TTI Not Configured 
ODU TTI Received String ASCII: Rx TTI Not Recieved 
ODU TTI Expected String ASCII: Exp TTI Not Configured 
Optics Status 
         Optics Type:  DWDM
         Wavelength Info: C-Band, MSA ITU Channel=1, Frequency=196.10THz, 
Wavelength=1528.773nm 
         TX Power = 1.01 dBm 
         RX Power = -99.99 dBm 
         RX LOS Threshold = -17.00 dBm 
TDC Info
        Operational Mode: AUTO
        Status :          AQUIRING
        Dispersion Setting : 0 ps/nm

Table 24 describes selected fields from the show controllers dwdm command output.

Table 24 show controllers dwdm g709 Command Output Field Descriptions 

Field
Description

AIS

Number of alarm indication signal (AIS) alarms. AIS is a signal sent downstream as an indication that an upstream defect has been detected.

Alarm reporting enabled for

Lists the alarms that are enabled for reporting.

Asserted Alarms

Alarms indicated to be reported by the user.

BDI

Number of backward defect indication (BDI) alarms. The BDI is a single bit that conveys information regarding signal failure in the upstream direction.

BER thresholds

Values of the configured bit error rate thresholds.

BIP

Number of bit interleaved parity alarms. The BIP is comprised of one byte and is used for error detection. It is computed over the entire optical channel payload unit (OPU).

Controller State

Status of the controller.

Detected Alarms

Alarms detected by the hardware.

EC

Corrected code words. This is the number of words corrected by the FEC and is displayed as a per second rate.

FEC Mode

Indicates the forward error correction (FEC) mode for the controller. This can be disabled, enhanced, or standard.

IAE

Number of incoming alignment errors (IAE).

LCK

Number of upstream connection locked alarms. LCK is a signal sent downstream as an indication that upstream the connection is locked, and no signal is passed through.

LOF

Number of OTU loss of frame (LOF) alarms.

LOM

Number of OTU loss of multiframe (LOM) alarms.

Loopback

Loopback status—indicates whether loopback is enable or not and which time of loopback is enabled.

LOS

Number of OTU loss of signal (LOS) alarms. The LOS threshold is set using the rx-los-threshold command. If the receive optical power is less than or equal to this defined threshold, the optical LOS alarm is raised.

OCI

Number of open connection indication alarms. OCI is a signal sent downstream as an indication that upstream the signal is not connected to a trail termination source.

ODU

Optical channel data unit alarms.

OTU

Optical transport unit overhead alarms.

OTU TTI Expected

Value of the expected TTI.

OTU TTI Received

Value of the received TTI.

OTU TTI Sent

Value of the transmit trail trace identifier (TTI).

PTIM

Number of payload type identifier mismatch alarms. This occurs when there is a mismatch between the way the ITU-T G.709 option is configured on the PLIM at each end of the optical span.

TDC Info

Tunable Dispersion Compensator (TDC) information.

UC

Uncorrectable code words. This is a raw counter.

Pre-FEC BER

Pre - bit error rate (BER) forward error correction (FEC). The pre-FEC BER is calculated using pre-forward error correction (FEC) error counts.

Q

The general signal quality bit error rate (BER) per voltage. The Q and Q margin are calculated using the Pre-FEC BER.

Q Margin

The general signal quality bit error rate (BER) per voltage. The Q and Q margin are calculated using the Pre-FEC BER.

Operational Mode

Indicates whether the tunable dispersion compensator (TDC) operational mode option is set to Auto or Manual.

Status

Indicates whether the tunable dispersion compensator (TDC) is in the acquiring state or locked state. The status is invalid if there is a major alarm.

Dispersion Setting

Indicates a value between -700 and +700 packets per second (pps). The dispersion setting is read from the optics module after the tunable dispersion compensator (TDC) has locked.

Reroute Control

Not used.

Reroute BER

Not used.


See Table 25 for a description of the optics fields.

The following example shows the output from the show controllers dwdm command with the g709 registers keywords:

RP/0/RP0/CPU0:Router# show controller dwdm 0/3/0/0 g709 registers
Addr          Name                  Value
 0x00800030    Serial[0]             0x30303130
 0x00800034    Serial[1]             0x30353934
 0x00800038    Serial[2]             0x0       
 0x0080003c    PartNum[0]            0x38303030
 0x00800040    PartNum[1]            0x3034312d
 0x00800044    PartNum[2]            0x30300010
 0x00800048    PartNum[3]            0x0       
 0x0080004c    Version[0]            0x312e3041
 0x00800050    Version[1]            0x6c706861
 0x00800054    Version[2]            0x28423133
 0x00800058    Version[3]            0x35290000
 0x0080005c    Version[4]            0x0       
 0x00800060    Version[5]            0x0       
 0x0080002c    Band                  0x0       
 0x0080001c    RefClock              0x0       
 0x00800020    Loopback              0x0       
 0x00800000    IntfStatus            0x5000000 
 0x00800004    ModEnable             0x1       
 0x0080000c    ModStatus             0x34010000
 0x00800010    ModIntrMask           0x7c000000
 0x00800014    ModIntr               0x0       
 0x00800100    TxLineStat            0x80      
 0x00800104    TxLineEvent           0x0       
 0x00800108    TxLineIntrMask        0xc1      
 0x00800114    TxOpticChan           0x1       
 0x00800118    Wavelength            0x1753c5  
 0x00800200    RxLineStat            0x8000    
 0x00800208    RxLineEventMask       0xffe3    
 0x00800204    RxLineEvent           0x0 

The following example shows the output from the show controllers dwdm command with the optics keyword on a 10-GE PLIM:

RP/0/RP0/CPU0:Router# show controller dwdm 0/3/0/0 optics
Optics Status 
         Optics Type:  10Gb MSA WDM (65km)
         Clock Source: Internal
        Wavelength Band: C-Band, MSA ITU Channel = 3, Frequency = 196.00 THz,  
Wavelength = 1529.553 nm 
         TX Power = 3.79 dBm 
         RX Power = -8.83 dBm 

Table 25 describes selected fields from the show controllers dwdm command output with the optics keyword.

Table 25 show controllers dwdm optics Command Output Field Descriptions 

Field
Description

Optics Type

Indicates the optics type: GE or OC-768c/STM-256c DWDM.

Clock Source

Indicates whether the clock is internal or line.

Wavelength Band

Indicates the wavelength band: C-band, L-band.

MSA ITU Channel

Multi Source Agreement (MSA) ITU channel number.

Frequency

Frequency of the channel in terahertz.

Wavelength

Wavelength corresponding to the channel number in nanometers.

TX power

Value of the transmit power level. This is user configurable on the OC-768c/STM-256c DWDM PLIM using the transmit-power command.

RX Power

Actual optical power at the RX port.

RX LOS Threshold

Receive loss of signal threshold. This is user configurable on the OC-768c/STM-256c DWDM PLIM using the rx-los-threshold command. If the receive optical power is less than or equal to this define threshold, the optical LOS alarm is raised.


The following example shows sample output from the show controllers dwdm command with the wavelength-map keyword on a Gigabit Ethernet controller:

RP/0/RP0/CPU0:Router# show controller dwdm 0/0/0/0 wavelength-map 
Wavelength band: C-band
MSA ITU channel range supported: 3~82
Wavelength map table
----------------------------------------
channel frequency       wavelength
 Num      (THZ)            (nm)       
----------------------------------------
03       196.00          1529.55 
--------------------------------------------
04       195.95          1529.94 
--------------------------------------------
05       195.90          1530.33 
--------------------------------------------
06       195.85          1530.72 
--------------------------------------------
07       195.80          1531.12 
--------------------------------------------
08       195.75          1531.51 
--------------------------------------------
09       195.70          1531.90 
--------------------------------------------
10       195.65          1532.29 
.
.
.

Table 26 describes selected fields from the show controllers dwdm command output with the wavelength-map keyword.

Table 26 show controllers dwdm wavelength Command Output Field Descriptions 

Field
Description

channel Num

Channel number.

frequency (THz)

Frequency of the wavelength in terahertz.

wavelength (nm)

Wavelength in nanometers.


Related Commands

Command
Description

rx-los-threshold

Configures the transponder receive power threshold on a DWDM controller.


show controller dwdm pm

To display performance monitoring information for a DWDM controller, use the show controller dwdm pm command in EXEC mode.

show controller dwdm instance pm history [15-min | 24-hour | fec | optics | otn]

show controller dwdm instance pm interval {15-min | 24-hour} [fec | optics | otn] index

Syntax Description

instance

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 line card.

module: Module number. A physical layer interface module (PLIM) is always 0. Shared port adapters (SPAs) are referenced by their subslot number.

port: Physical port number of the interface.

For more information about the syntax for the router, use the question mark (?) online help function.

history

Displays all performance monitoring data.

interval

Displays specific performance monitoring data in a particular interval.

15-min

Displays performance monitoring data in a 15-minute interval.

24-hour

Displays performance monitoring data in a 24-hour interval.

fec

Displays FEC performance parameters, such as bit errors corrected (BIEC) and uncorrectable words.

optics

Displays optics performance parameters, such as optical power.

otn

Displays OTN performance parameters, such as path monitoring failure counts (FC-PM) and section monitoring unavailable seconds (UAS-SM).

index

Interval for which to display the performance monitoring information.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco CRS-1 router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

interface

read


Examples

The following example shows the output from the show controllers dwdm pm command on a 10-GE DWDM PLIM:

RP/0/RP1/CPU0:Router# show controllers dwdm 0/2/0/0 pm interval 24-hour 0
g709 OTN in the current interval [00:00:00 - 08:05:58 Tue Jul 11 2006]
    ES-SM-NE    : 0         Threshold : -1       TCA(enable)  : NO
    ESR-SM-NE   : 0         Threshold : -1       TCA(enable)  : NO
    SES-SM-NE   : 0         Threshold : -1       TCA(enable)  : NO
    SESR-SM-NE  : 0         Threshold : -1       TCA(enable)  : NO
    UAS-SM-NE   : 0         Threshold : -1       TCA(enable)  : NO
    BBE-SM-NE   : 0         Threshold : -1       TCA(enable)  : NO
    BBER-SM-NE  : 0         Threshold : -1       TCA(enable)  : NO
    FC-SM-NE    : 0         Threshold : -1       TCA(enable)  : NO
    ES-PM-NE    : 0         Threshold : -1       TCA(enable)  : NO
    ESR-PM-NE   : 0         Threshold : -1       TCA(enable)  : NO
    SES-PM-NE   : 0         Threshold : -1       TCA(enable)  : NO
    SESR-PM-NE  : 0         Threshold : -1       TCA(enable)  : NO
    UAS-PM-NE   : 0         Threshold : -1       TCA(enable)  : NO
    BBE-PM-NE   : 0         Threshold : -1       TCA(enable)  : NO
    BBER-PM-NE  : 0         Threshold : -1       TCA(enable)  : NO
    FC-PM-NE    : 0         Threshold : -1       TCA(enable)  : NO
    ES-SM-FE    : 0         Threshold : -1       TCA(enable)  : NO
    ESR-SM-FE   : 0         Threshold : -1       TCA(enable)  : NO
    SES-SM-FE   : 0         Threshold : -1       TCA(enable)  : NO
    SESR-SM-FE  : 0         Threshold : -1       TCA(enable)  : NO
    UAS-SM-FE   : 106       Threshold : -1       TCA(enable)  : NO
    BBE-SM-FE   : 0         Threshold : -1       TCA(enable)  : NO
    BBER-SM-FE  : 0         Threshold : -1       TCA(enable)  : NO
    FC-SM-FE    : 0         Threshold : -1       TCA(enable)  : NO
    ES-PM-FE    : 0         Threshold : -1       TCA(enable)  : NO
    ESR-PM-FE   : 0         Threshold : -1       TCA(enable)  : NO
    SES-PM-FE   : 0         Threshold : -1       TCA(enable)  : NO
    SESR-PM-FE  : 0         Threshold : -1       TCA(enable)  : NO
    UAS-PM-FE   : 32327     Threshold : -1       TCA(enable)  : NO
    BBE-PM-FE   : 0         Threshold : -1       TCA(enable)  : NO
    BBER-PM-FE  : 0         Threshold : -1       TCA(enable)  : NO
    FC-PM-FE    : 0         Threshold : -1       TCA(enable)  : NO
g709 FEC in the current interval [00:00:00 - 08:05:58 Tue Jul 11 2006]
    EC-BITS   : 0               Threshold : 0              TCA(enable)  : NO
    UC-WORDS  : 0               Threshold : 0             TCA(enable)  : NO
Optics in the current interval [00:00:00 - 08:05:58 Tue Jul 11 2006]
             MIN     AVG     MAX  Threshold  TCA  Threshold  TCA
                                  (min)  (enable) (max)  (enable)
LBC[mA ] :  1163    4336    8487    -1         NO      -1       NO
OPT[uW]  :  2593    2593    2593    -1         NO      -1       NO
OPR[uW]  :  69      69      70      -1         NO      -1       NO

Table 27 describes selected fields from the show controllers dwdm pm command output.

Table 27 show controllers dwdm pm Command Output Field Descriptions 

Field
Description

EC-BITS

Bit errors corrected (BIEC). Indicates the number of bit errors corrected in the DWDM trunk line during the performance monitoring time interval.

UC-WORDS

Uncorrectable words. This is the number of uncorrectable words detected in the DWDM trunk line during the performance monitoring time interval.

LBC

Laser bias current.

OPR

Optical power on the unidirectional port.

OPT

Transmit optical power in dBm.

MAX

Indicates the maximum value of the parameter.

AVG

Indicates the average value of the parameter

MIN

Indicates the minimum value of the parameter.

THRESHOLD

Indicates the parameter's configured threshold.

TCA

Indicates if TCA reporting is enabled or not.

BBE-PM-FE

Far-end path monitoring background block errors (BBE-PM)—Indicates the number of background block errors recorded in the optical transport network (OTN) path during the performance monitoring time interval.

BBE-PM-NE

Near-end path monitoring background block errors (BBE-PM).

BBE-SM-FE

Far-end section monitoring background block errors (BBE-SM)—Indicates the number of background block errors recorded in the OTN section during the performance monitoring time interval.

BBE-SM-NE

Near-end section monitoring background block errors (BBE-SM).

BBER-PM-FE

Far-end path monitoring background block errors ratio (BBER-PM)—Indicates the background block errors ratio recorded in the OTN path during the performance monitoring time interval.

BBER-PM-NE

Near-end path monitoring background block errors ratio (BBER-PM).

BBER-SM-FE

Far-end section monitoring background block errors ratio (BBER-SM)—Indicates the background block errors ratio recorded in the OTN section during the performance monitoring time interval.

BBER-SM-NE

Near-end section monitoring background block errors ratio (BBER-SM).

ES-PM-FE

Far-end path monitoring errored seconds (ES-PM)—Indicates the errored seconds recorded in the OTN path during the performance monitoring time interval.

ES-PM-NE

Near-end path monitoring errored seconds (ES-PM).

ES-SM-FE

Far-end section monitoring errored seconds (ES-SM)—Indicates the errored seconds recorded in the OTN section during the performance monitoring time interval.

EX-SM-NE

Near-end section monitoring errored seconds (ES-SM).

EXR-PM-FE

Far-end path monitoring errored seconds ratio (ESR-PM)—Indicates the errored seconds ratio recorded in the OTN path during the performance monitoring time interval.

EXR-PM-NE

Near-end path monitoring errored seconds ratio (ESR-PM).

EXR-SM-FE

Far-end section monitoring errored seconds ratio (ESR-SM)—Indicates the errored seconds ratio recorded in the OTN section during the performance monitoring time interval.

ESR-SM-NE

Near-end section monitoring errored seconds ratio (ESR-SM).

FC-PM-FE

Far-end path monitoring failure counts (FC-PM)—Indicates the failure counts recorded in the OTN path during the performance monitoring time interval.

FC-PM-NE

Near-end path monitoring failure counts (FC-PM).

FC-SM-FE

Far-end section monitoring failure counts (FC-SM)—Indicates the failure counts recorded in the OTN section during the performance monitoring time interval.

FC-SM-NE

Near-end section monitoring failure counts (FC-SM).

SES-PM-FE

Far-end path monitoring severely errored seconds (SES-PM)—Indicates the severely errored seconds recorded in the OTN path during the performance monitoring time interval.

SES-PM-NE

Near-end path monitoring severely errored seconds (SES-PM).

SES-SM-FE

Far-end section monitoring severely errored seconds (SES-SM)—Indicates the severely errored seconds recorded in the OTN section during the performance monitoring time interval.

SES-SM-NE

Near-end section monitoring severely errored seconds (SES-SM).

SESR-PM-FE

Far-end path monitoring severely errored seconds ratio (SESR-PM)—Indicates the severely errored seconds ratio recorded in the OTN path during the performance monitoring time interval.

SESR-PM-NE

Near-end path monitoring severely errored seconds ratio (SESR-PM).

SESR-SM-FE

Far-end section monitoring severely errored seconds ratio (SESR-SM)—Indicates the severely errored seconds ratio recorded in the OTN section during the performance monitoring time interval.

SESR-SM-NE

Near-end section monitoring severely errored seconds ratio (SESR-SM).

UAS-PM-FE

Far-end path monitoring unavailable seconds (UAS-PM)—Indicates the unavailable seconds recorded in the OTN path during the performance monitoring time interval.

UAS-PM-NE

Near-end path monitoring unavailable seconds (UAS-PM).

UAS-SM-FE

Far-end section monitoring unavailable seconds (UAS-SM)—Indicates the unavailable seconds recorded in the OTN section during the performance monitoring time interval.

UAS-SM-NE

Near-end section monitoring unavailable seconds (UAS-SM).


shutdown (DWDM)

To disable DWDM controller processing, use the shutdown command in DWDM configuration mode. To bring a DWDM controller back up and enable DWDM controller processing, use the no form of this command.

shutdown

no shutdown

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The DWDM controller is enabled by default. You must use the shutdown command to disable the controller and configure it in DWDM configuration mode.

Task ID
Task ID
Operations

interface

read, write


Examples

In the following example, the DWDM controller is brought down and DWDM controller processing is disabled:

RP/0/RP0/CPU0:router(config)# controller dwdm 0/3/0/2
RP/0/RP0/CPU0:router(config-dwdm)# shutdown

transmit-power

To configure the DWDM optics transmit laser power on a DWDM controller, use the transmit-power command in DWDM configuration mode. To return the transponder transmit power to its default value, use the no form of this command.

transmit-power power-level

no transmit-power power-level

Syntax Description

power-level

Transmit power level in units of 0.1 dBm. Values can range from -190 to +10, which corresponds to a power level range of -19 dBm to +1 dBm.


Defaults

power-level: 0 dBm

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router and is supported only on the OC-768c/STM-256c DWDM PLIM.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.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 Cisco IOS XR System Security Configuration Guide.

The controller must be in the shutdown state before you can use the transmit-power command. You can configure the transponder transmit power only on the OC-768c/STM-256c DWDM PLIM.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to configure the receive power threshold to -10 dBm:

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/0/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# transmit-power -100

Related Commands

Command
Description

rx-los-threshold

Configures the transponder receive power threshold on a DWDM controller.

show controller dwdm

Displays the optical parameters, G.709 alarms and counters, and register and module information.


wavelength

To set the wavelength on a DWDM controller to a specific ITU channel or to define a specific frequency or wavelength to a DWDM controller, use the wavelength command in DWDM configuration mode. To return the wavelength to its default value, use the no form of this command.

wavelength channel-number | frequency | update

no wavelength channel-number | frequency | update

Syntax Description

channel-number

(Optional) ITU channel number. ITU channel numbers have predefined frequencies as defined by Multi Source Agreement (MSA) International Telecommunication Union (ITU) grid.

The range is 1 to 89 for conventional band (C-band)

The range is 106 to 185 for long band (L-band).

frequency

(Optional) Keyword that specifies the frequency for the DWDM controller.

Enter the 5-digit frequency value in the range of 19170 to 19610 GHz.
For example, enter frequency 19580 to specify 195.8 THz.

update

(Optional) Keyword that defines a specific wavelength for the DWDM controller.

Enter the 7-digit frequency value in the range of 1528773-1563863 micrometers (mm).
For example, enter update 1532290 to specifiy 1532.29 nanometers (nm).


Defaults

The default for OC-768c/STM-256c DWDM PLIM, C-band is 1.
The default for10-GE PLIM, C-band is 3.
The default for 10-GE PLIM, L-band is 106.

Command Modes

DWDM configuration

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 router.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

You can set the wavelength to a specific ITU channel, that is represented by a channel number in the Multi Source Agreement (MSA) ITU grid.

The default channel number for the 10-GE PLIM, C-band is 3, which corresponds to a frequency of 196.00 THz and wavelength of 1529.553 nm.

The default channel number for the 10-GE PLIM, L-band is 106, which corresponds to a frequency of 190.85 THz and wavelength of 1570.83 nm.

The default channel number for the OC-768c/STM-256c DWDM PLIM, C-band is 1, which corresponds to a frequency of 196.10 and a wavelength of 1528.773.

The spacing between wavelengths is 50 GHZ. Use the show controllers dwdm command with the wavelength-map keyword to view the channel numbers and wavelengths that are supported for a particular controller.

The controller must be in the shutdown state before you can use the wavelength command.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to set the DWDM wavelength to ITU channel 10.

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/1/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# wavelength 10

The following example shows how to set the frequency of ITU channel 10 to 195.8 THz.

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/1/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# wavelength 10 frequency 19580

The following example shows how to set the wavelength of ITU channel 10 to 1532.29 nm.

RP/0/RP0/CPU0:Router(config)# controller dwdm 0/1/0/0
RP/0/RP0/CPU0:Router(config-dwdm)# wavelength 10 update 1532290

Related Commands

Command
Description

show controller dwdm

Displays the valid channel number, frequency, and wavelength information for the controller using wavelength-map keyword.