Configuration Guide for Cisco NCS 1001, IOS XR Release 25.x.x

OTS OCH controllers

Updated: July 27, 2026

Want to summarize with AI?

This topic explains OTS OCH controllers, channel granularity, wavelength information, and the low-power threshold parameters available on OCM hardware interfaces.

An Optical Transport Section Optical Channel (OTS OCH) controller is a channel-level controller that

represents the optical channel monitor (OCM) device on an OTS optical interface,
provides channel granularity over the OTS interface, and
stores wavelength information with controller numbers that start at 1 and match ITU channel identifiers.

The system creates 48 OTS OCH controllers for a 100 GHz grid and 96 OTS OCH controllers for a 50 GHz grid.

Configuration parameters for OTS OCH controllers

Table 1. Configuration parameters for OTS OCH controllers
Parameter	Description	Hardware capability	Range	Default
rx-low-threshold (0.1 dBm)	Low receive power threshold.	OCM	-500 to +300	-25.0
tx-low-threshold (0.1 dBm)	Low transmit power threshold.	OCM	-500 to +300	-25.0

Configure an OTS OCH controller

Use the controller identifier for the OTS OCH controller that you want to configure.

Procedure

	1.	Enter configuration mode. configure
	2.	Use the controller ots-och command to enter OTS OCH controller configuration mode. controller ots-och rack/slot/instance/port
	3.	Configure the low-power thresholds. rx-low-threshold value tx-low-threshold value
	4.	Commit the configuration. commit
	5.	Exit the configuration mode. end Example: `configure controller ots-och 0/1/0/0 rx-low-threshold -30 tx-low-threshold -35 commit end`

Display OTS OCH controller parameters

The show controllers command displays all the configuration parameters, performance monitoring thresholds, and alarms if no optional keyword is provided. If you include the summary keyword, the command displays RX and TX power values and wavelength details.

Procedure

Display OTS OCH controller parameters.

show controllers controller-type rack/slot/instance/port/channel-number [ summary]

Use * as a wildcard to display all OTS OCH controllers associated with an OTS controller, such as show controllers ots-och 0/1/0/* summary .

Example:


Fri Feb 24 13:20:18.456 CET

 Controller State: Up

 Transport Admin State: Maintenance

 Port Type: Line

 Laser State: Unnown 

 Optics Status::


         Alarm Status:
         -------------
         Detected Alarms:None 
                  

         Alarm Statistics:
         -----------------
          LOW-RX-PWR = 0 
          LOW-TX-PWR = 0 
          

         Parameter Statistics:
         ---------------------
         TX Power = -3.30 dBm
         RX Power = -21.10 dBm
         TX psd = 13.586 nW/MHz
         RX psd = 0.220 nW/MHz
         Channel Central Frequency = 196100.0 GHz
         Channel Width = 50.0 GHz

         Configured Parameters:
         -------------
         Rx Low Threshold = -25.0 dBm
         Tx Low Threshold = -25.0 dBm

RP/0/RP0/CPU0:ios#show controllers ots-och 0/2/0/0/* summary


Fri Oct  9 10:37:50.109 CEST

 Port               Type    Status       TX Power     RX Power      TX psd        RX psd    Central Frequency Channel Width
                                             (dBm)        (dBm)      nW/MHz)     (nW/MHz)       (GHz)             (GHz)
 -----------------  ----    -------      ---------    ---------     ---------     -------     ---------------   -------------
  Ots-Och0_2_0_0_1    Com      N/A      -18.30        -19.30         0.392         0.333        196100.0          75.0
  Ots-Och0_2_0_0_2    Com      N/A      -19.10        -19.80         0.094         0.068        196025.0          75.0
  Ots-Och0_2_0_0_3    Com      N/A      -18.00        -18.90         0.450         0.392        195950.0          75.0
  Ots-Och0_2_0_0_4    Com      N/A      -16.90        -17.60         0.318         0.290        195875.0          75.0
  Ots-Och0_2_0_0_5    Com      N/A      -18.10        -19.20         0.326         0.290        195800.0          75.0
  Ots-Och0_2_0_0_6    Com      N/A      -19.50        -19.90         0.059         0.041        195725.0          75.0
  Ots-Och0_2_0_0_7    Com      N/A      -18.60        -19.00         0.471         0.450        195650.0          75.0
  Ots-Och0_2_0_0_8    Com      N/A      -17.00        -17.60         0.304         0.318        195575.0          75.0
  Ots-Och0_2_0_0_9    Com      N/A      -18.50        -19.20         0.318         0.297        195500.0          75.0
 Ots-Och0_2_0_0_10    Com      N/A      -17.60        -18.00         0.318         0.297        195425.0          75.0
 Ots-Och0_2_0_0_11    Com      N/A      -18.50        -19.00         0.401         0.374        195350.0          75.0
 Ots-Och0_2_0_0_12    Com      N/A      -17.70        -18.00         0.188         0.253        195275.0          75.0
 Ots-Och0_2_0_0_13    Com      N/A      -18.90        -19.70         0.304         0.271        195200.0          75.0
 Ots-Och0_2_0_0_14    Com      N/A      -20.50        -20.90         0.242         0.236        195125.0          75.0
 Ots-Och0_2_0_0_15    Com      N/A      -24.00        -27.40         0.031         0.011        195050.0          75.0
 Ots-Och0_2_0_0_16    Com      N/A      -17.80        -18.40         0.215         0.242        194975.0          75.0
 Ots-Och0_2_0_0_17    Com      N/A      -18.50        -19.10         0.318         0.290        194900.0          75.0
 Ots-Och0_2_0_0_18    Com      N/A      -16.90        -17.30         0.333         0.297        194825.0          75.0
 Ots-Och0_2_0_0_19    Com      N/A      -18.10        -18.90         0.410         0.366        194750.0          75.0
 Ots-Och0_2_0_0_20    Com      N/A      -17.00        -17.50         0.357         0.366        194675.0          75.0
 Ots-Och0_2_0_0_21    Com      N/A      -18.50        -19.30         0.326         0.290        194600.0          75.0
 Ots-Och0_2_0_0_22    Com      N/A      -17.20        -17.70         0.259         0.265        194525.0          75.0
 Ots-Och0_2_0_0_23    Com      N/A      -18.40        -19.10         0.410         0.392        194450.0          75.0
 Ots-Och0_2_0_0_24    Com      N/A      -16.50        -16.90         0.450         0.430        194375.0          75.0
 Ots-Och0_2_0_0_25    Com      N/A      -24.30        -28.90         0.040         0.000        194300.0          75.0
 Ots-Och0_2_0_0_26    Com      N/A      -16.60        -16.90         0.326         0.297        194225.0          75.0
 Ots-Och0_2_0_0_27    Com      N/A      -18.10        -18.70         0.420         0.410        194150.0          75.0
 Ots-Och0_2_0_0_28    Com      N/A      -16.80        -16.90         0.383         0.392        194075.0          75.0
 Ots-Och0_2_0_0_29    Com      N/A      -19.10        -19.80         0.333         0.311        194000.0          75.0
 Ots-Och0_2_0_0_30    Com      N/A      -16.90        -17.10         0.284         0.311        193925.0          75.0
 Ots-Och0_2_0_0_31    Com      N/A      -18.70        -19.20         0.374         0.383        193850.0          75.0
 Ots-Och0_2_0_0_32    Com      N/A      -17.20        -17.40         0.374         0.392        193775.0          75.0
 Ots-Och0_2_0_0_33    Com      N/A      -18.60        -19.10         0.410         0.410        193700.0          75.0
 Ots-Och0_2_0_0_34    Com      N/A      -17.30        -17.60         0.311         0.311        193625.0          75.0
 Ots-Och0_2_0_0_35    Com      N/A      -18.90        -19.10         0.392         0.401        193550.0          75.0
 Ots-Och0_2_0_0_36    Com      N/A      -18.00        -18.20         0.265         0.265        193475.0          75.0
 Ots-Och0_2_0_0_37    Com      N/A      -19.50        -20.00         0.304         0.318        193400.0          75.0
 Ots-Och0_2_0_0_38    Com      N/A      -17.80        -17.90         0.265         0.311        193325.0          75.0
 Ots-Och0_2_0_0_39    Com      N/A      -18.60        -19.00         0.383         0.392        193250.0          75.0
 Ots-Och0_2_0_0_40    Com      N/A      -16.80        -17.00         0.383         0.392        193175.0          75.0
 Ots-Och0_2_0_0_41    Com      N/A      -18.70        -19.10         0.440         0.450        193100.0          75.0
 Ots-Och0_2_0_0_42    Com      N/A      -16.80        -17.10         0.374         0.349        193025.0          75.0
 Ots-Och0_2_0_0_43    Com      N/A      -18.90        -19.40         0.401         0.420        192950.0          75.0
 Ots-Och0_2_0_0_44    Com      N/A      -17.00        -17.40         0.450         0.440        192875.0          75.0
 Ots-Och0_2_0_0_45    Com      N/A      -18.50        -18.80         0.392         0.392        192800.0          75.0
 Ots-Och0_2_0_0_46    Com      N/A      -17.40        -17.60         0.284         0.271        192725.0          75.0
 Ots-Och0_2_0_0_47    Com      N/A      -24.40        -31.50         0.064         0.000        192650.0          75.0
 Ots-Och0_2_0_0_48    Com      N/A      -19.20        -19.60         0.410         0.430        192575.0          75.0
 Ots-Och0_2_0_0_49    Com      N/A      -18.70        -19.40         0.392         0.383        192500.0          75.0
 Ots-Och0_2_0_0_50    Com      N/A      -17.10        -17.60         0.374         0.326        192425.0          75.0
 Ots-Och0_2_0_0_51    Com      N/A      -19.10        -19.50         0.401         0.401        192350.0          75.0
 Ots-Och0_2_0_0_52    Com      N/A      -20.40        -20.50         0.357         0.311        192275.0          75.0
 Ots-Och0_2_0_0_53    Com      N/A      -24.70        -34.20         0.042         0.000        192200.0          75.0
 Ots-Och0_2_0_0_54    Com      N/A      -17.60        -18.10         0.201         0.236        192125.0          75.0
 Ots-Och0_2_0_0_55    Com      N/A      -18.50        -19.10         0.401         0.392        192050.0          75.0
 Ots-Och0_2_0_0_56    Com      N/A      -17.20        -17.80         0.341         0.284        191975.0          75.0
 Ots-Och0_2_0_0_57    Com      N/A      -25.60        -30.40         0.050         0.000        191900.0          75.0
 Ots-Och0_2_0_0_58    Com      N/A      -17.40        -17.90         0.220         0.188        191825.0          75.0
 Ots-Och0_2_0_0_59    Com      N/A      -19.40        -20.40         0.333         0.290        191750.0          75.0
 Ots-Och0_2_0_0_60    Com      N/A      -27.10        -38.90         0.023         0.000        191675.0          75.0
 Ots-Och0_2_0_0_61    Com      N/A      -26.00        -38.90         0.031         0.000        191600.0          75.0
 Ots-Och0_2_0_0_62    Com      N/A      -19.50        -20.10         0.133         0.045        191525.0          75.0
 Ots-Och0_2_0_0_63    Com      N/A      -19.20        -19.90         0.401         0.392        191450.0          75.0
 Ots-Och0_2_0_0_64    Com      N/A      -17.30        -17.60         0.333         0.333        191375.0          75.0

From Release 7.3.1, the Central Frequency and Channel Width columns include a decimal place.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.