Digital Diagnostic Monitoring Commands
This chapter is a reference for Digital Diagnostic Monitoring (DDM) commands:
clear ddm transceiver alarm
Use this command to clear the transceiver alarm in the DDM monitor interface.
Command Syntax 
clear ddm transceiver alarm
Default 
None
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#clear ddm transceiver alarm
(config-if)#exit
clear ddm transceiver alarm all
Use this command to clear the transceiver DDM alarm for all interface.
Command Syntax
clear ddm transceiver alarm all
Parameters
None
Default
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
# clear ddm transceiver alarm all
 
ddm monitor
Use this command to enable or disable DDM monitoring for interfaces which have a supported transceiver.
Use the no form of this command to remove DDM monitoring for all transceivers.
Command Syntax 
ddm monitor (disable|enable)
no ddm monitor 
Parameters
enable
Enable DDM monitoring.
disable
Disable DDM monitoring.
Default 
By default, DDM monitoring is disabled.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#ddm monitor enable
(config-if)#ddm monitor disable
(config-if)#exit
 
(config)#interface xe1
(config-if)#no ddm monitor
(config-if)#exit
ddm monitor all
Use this command to enable DDM monitoring for all transceiver.s
Use the no form of this command to disable DDM monitoring for all transceivers.
Command Syntax 
ddm monitor all
no ddm monitor all
Parameters
None
Default 
By default, DDM monitoring is disabled.
Command Mode
Configuration mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ddm monitor all
 
(config)#no ddm monitor all
 
ddm monitor interval
Use this command to set the monitoring interval for the transceiver.
Use no form with this command to set the monitoring interval to its default.
Command Syntax 
ddm monitor interval <60-3600>
no ddm monitor interval
Parameters
<60-3600>
Interval period in seconds.
Default
The default monitoring interval is 60 seconds.
Command Mode
Configuration mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ddm monitor interval 60
 
debug ddm
Use this command to enable or disable debugging for DDM.
Command Syntax 
debug ddm 
no debug ddm
Parameters
None
Default 
By default, debug command is not configured.
Command Mode
Configuration mode 
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#debug ddm 
(config)#no debug ddm 
 
service unsupported-transceiver
Use this command to allow an unsupported transceiver to be enabled for DDM monitoring.
Use the no form of this command to disable DDM on an unsupported transceiver.
Command Syntax 
service unsupported-transceiver
no service unsupported-transceiver
Parameters
None
Default 
By default, DDM on an unsupported transceiver is disabled.
Command Mode
Configuration mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#service unsupported-transceiver
 
(config)#no service unsupported-transceiver
 
show controller details
Use this command to display the EEPROM details of transceivers.
Command Syntax 
show interface (IFNAME|) controllers 
Parameters
IFNAME
Interface name. If not specified, this command displays details of all connected transceivers.
Default 
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show interface xe52/1 controllers
Port Number             : 52
Vendor oui              : 0x0 0x17 0x6a
Vendor name             : AVAGO
Vendor part_no          : AFBR-79E4Z
serial_number           : QB380161
transceiver_type        : QSFP OR LATER
connector_type          : MPO 1x12
qsfp_transceiver_code   : 1X-LX
vendor_rev              : 01
date_code               : 110920    (yymmddvv, v=vendor specific)
encoding                : SONET
br_nominal              : 103       (100 MHz)
length_km               : 0
length_mtr              : 50
length_50mt             : 0
length_62_5mt           : 0
length_cu               : 0
cc_base                 : 0x7d
cc_ext                  : 0x28
DDM Support             : yes  
show interface frequency grid
Use this command to display channel-number and wavelength mapping.
Command Syntax 
show interface (IFNAME) frequency-grid
Parameters
IFNAME
Interface name. 
Default 
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.1.
Example
#show interface xe7 frequency-grid
------------------------------------------------------
Channel Number  Frequency (THz) Wavelength (nm)
------------------------------------------------------
1        191.40          1566.314
2        191.50          1565.496
3        191.60          1564.679
4        191.70          1563.862
5        191.80          1563.047
6        191.90          1562.233
7        192.00          1561.419
8        192.10          1560.606
9        192.20          1559.794
10       192.30          1558.983
11       192.40          1558.172
12       192.50          1557.363
13       192.60          1556.554
14       192.70          1555.746
15       192.80          1554.939
16       192.90          1554.133
17       193.00          1553.328
18       193.10          1552.524
19       193.20          1551.720
20       193.30          1550.917
21       193.40          1550.115
22       193.50          1549.314
23       193.60          1548.514
24       193.70          1547.714
25       193.80          1546.916*
26       193.90          1546.118
27       194.00          1545.321
28       194.10          1544.525
29       194.20          1543.729
30       194.30          1542.934
31       194.40          1542.141
32       194.50          1541.348
33       194.60          1540.556
34       194.70          1539.765
35       194.80          1538.974
36       194.90          1538.184
37       195.00          1537.396
38       195.10          1536.607
39       195.20          1535.820
40       195.30          1535.034
41       195.40          1534.248
42       195.50          1533.463
43       195.60          1532.679
44       195.70          1531.896
45       195.80          1531.114
46       195.90          1530.332
47       196.00          1529.551
48       196.10          1528.771
#
show interface transceiver details
Use this command to display details of transceivers and threshold violations.
Command Syntax 
show interface (IFNAME|) transceiver (detail|threshold violation|)
Parameters
IFNAME
Interface name. If not specified, this command displays details of all connected transceivers.
detail
Transceiver information such as voltage, temperature, power, and current.
threshold violation
 
Transceiver threshold violations.
Codes           
 
* Not Qualified By IP Infusion,  ** Not Supported By Module.
Default 
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
OcNOS#sh int transceiver detail
Codes:  * Not Qualified By IP Infusion,  ** Not Supported By Module,  -- No Power,  - Not Applicable
 
 
Intf       DDM        Temp       AlertMax   CritMax    CritMin    AlertMin
                      (Celsius)  (Celsius)  (Celsius)  (Celsius)  (Celsius)
---------------------------------------------------------------------------
 
ce0        Active*    +22.52     +85.00     +80.00     -5.00      -10.00
ce2        Active     +20.32     +75.00     +70.00     +0.00      -5.00
xe4        Active*    +23.62     +95.00     +85.00     -40.00     -50.00
xe5        Active*    +19.79     +100.00    +95.00     -35.00     -40.00
xe16       Active*    +25.84     +95.00     +85.00     -10.00     -50.00
xe26       Active     +19.01     +95.00     +90.00     -20.00     -25.00
 
 
 
Intf       DDM        Volt       AlertMax   CritMax    CritMin    AlertMin
                      (Volts)    (Volts)    (Volts)    (Volts)    (Volts)
---------------------------------------------------------------------------
ce0        Active*    +3.314     +3.600     +3.500     +3.100     +2.900
ce2        Active     +3.260     +3.630     +3.465     +3.135     +2.970
xe4        Active*    +3.260     +3.600     +3.500     +3.100     +3.000
xe5        Active*    +3.253     +3.600     +3.500     +2.900     +2.800
xe16       Active*    +3.284     +3.630     +3.500     +3.030     +2.930
xe26       Active     +3.289     +3.900     +3.700     +2.900     +2.700
 
 
Intf       DDM        Lane       Curr       AlertMax   CritMax    CritMin    AlertMin
                                 (mA)       (mA)       (mA)       (mA)       (mA)
-------------------------------------------------------------------------------------
ce0        Active*    1          +6.114     +15.000    +12.000    +2.000     +0.000
                      2          +6.120     +15.000    +12.000    +2.000     +0.000
                      3          +6.110     +15.000    +12.000    +2.000     +0.000
                      4          +6.116     +15.000    +12.000    +2.000     +0.000
ce2        Active     1          +7.464     +13.000    +11.000    +5.000     +3.000
                      2          +7.540     +13.000    +11.000    +5.000     +3.000
                      3          +7.444     +13.000    +11.000    +5.000     +3.000
                      4          +7.474     +13.000    +11.000    +5.000     +3.000
xe4        Active*    -          +6.100     +110.000   +100.000   +1.000     +1.000
xe5        Active*    -          +7.552     +15.000    +13.000    +2.000     +1.000
xe16       Active*    -          +5.800     +15.000    +12.000    +3.000     +2.000
xe26       Active     -          +7.050     +17.000    +14.000    +2.000     +1.000
 
 
 
Intf       DDM        Lane       RxPwr      AlertMax   CritMax    CritMin    AlertMin
                                 (dBm)      (dBm)      (dBm)      (dBm)      (dBm)
-------------------------------------------------------------------------------------
ce0        Active*    1          -0.185     +4.400     +3.400     -13.298    -14.306
                      2          +0.342     +4.400     +3.400     -13.298    -14.306
                      3          +0.396     +4.400     +3.400     -13.298    -14.306
                      4          -2.927     +4.400     +3.400     -13.298    -14.306
ce2        Active     1          +1.302     +3.400     +2.400     -11.002    -14.001
                      2          +1.486     +3.400     +2.400     -11.002    -14.001
                      3          +1.581     +3.400     +2.400     -11.002    -14.001
                      4          +1.594     +3.400     +2.400     -11.002    -14.001
xe4        Active*    -         -1.890     +2.500     +0.500     -14.401    -16.402
xe5        Active*    -         -40.000    +3.000     +0.000     -13.002    -16.003
xe16       Active*    -           --       +2.000     +1.000     -14.401    -16.402
xe26       Active     -         -5.933     +1.000     -1.002     -18.013    -20.000
 
Intf       DDM        Lane       TxPwr      AlertMax   CritMax    CritMin    AlertMin
                                 (dBm)      (dBm)      (dBm)      (dBm)      (dBm)
-------------------------------------------------------------------------------------
ce0        Active*    1         -0.085     +4.400     +3.400     -9.201     -10.205
                      2         -0.161     +4.400     +3.400     -9.201     -10.205
                      3         +0.217     +4.400     +3.400     -9.201     -10.205
                      4         +0.204     +4.400     +3.400     -9.201     -10.205
ce2        Active     1         +0.297     +5.000     +3.000     -8.000     -10.000
                      2         -0.078     +5.000     +3.000     -8.000     -10.000
                      3         +0.131     +5.000     +3.000     -8.000     -10.000
                      4         +0.323     +5.000     +3.000     -8.000     -10.000
xe4        Active*    -         -1.316     +2.500     +0.500     -8.199     -10.200
xe5        Active*    -         -2.299     +1.000     +0.000     -7.001     -8.000
xe16       Active*    -         -1.000     +2.500     +2.000     -8.199     -10.200
xe26       Active     -         -4.441     -2.000     -2.000     -11.024    -11.739
 
Intf       DDM        Lane       Freq-Err   AlertMax   CritMax    CritMin    AlertMin
                                 (GHz)      (GHz)      (GHz)      (GHz)      (GHz)
-------------------------------------------------------------------------------------
 
Intf       DDM        Lane       Wave-Err   AlertMax   CritMax    CritMin    AlertMin
                                 (nm)       (nm)       (nm)       (nm)       (nm)
-------------------------------------------------------------------------------------
 
Intf       DDM        Lane       Tx         Rx-LOS     Tx-LOS
------------------------------------------------------------------------------
ce0        Active*    1          On         Off        Off
                      2          On         Off        Off
                      3          On         Off        Off
                      4          On         Off        Off
ce2        Active     1          On         Off        Off
                      2          On         Off        Off
                      3          On         Off        Off
                      4          On         Off        Off
xe4        Active*    -          On         Off        -
xe5        Active*    -          On         On         -
xe9        Inactive*  -          On         On         -
xe11       Inactive*  -          On         On         -
xe13       Inactive*  -          On         On         -
xe14       Inactive*  -          On         On         -
xe16       Active*    -          On         On         -
xe26       Active     -          On         Off  
 
 
Table 3-20 explains the output fields.
  
Table 3-20: show interface transceiver details output
Field  | Description  | 
|---|
Port  | The number of the transceiver port.  | 
Temp  | Temperature in degrees Celsius of the transceiver.  | 
Voltage  | Voltage in Volts on the transceiver.  | 
Current  | Current in Milliamperes used by the transceiver.  | 
Rx Power  | Power received in Decibel-milliwatts (dBm) by the transceiver.  | 
Tx Power  | Power being transmitted in milliWatts by the transceiver.  | 
High Alarm  | The level that is needed to be reached to trigger a high alarm.  | 
High Warn  | The level that is needed to be reached to trigger a high warning.  | 
Low Warn  | The level that is needed to be reached to trigger a low warning.  | 
Low Alarm    | The level that is needed to be reached to trigger a low alarm.   | 
Codes *  | Not Qualified By IP Infusion, ** Not Supported By Module  | 
 
 
show supported-transceiver
Use this command to display supported transceivers.
Command Syntax 
show supported-transceiver
Parameters
None
Default 
None
Command Mode
Exec mode 
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show supported-transceiver
-----------------------------------------------------
          Transceiver DDM support list
-----------------------------------------------------
Type                      :SFP
Vendor Name               :FINISAR CORP
Vendor Part Number        :FTLF8519P2BNL
DDM Supported             :Yes
 
Type                      :SFP
Vendor Name               :EVERTZ
Vendor Part Number        :SFP10G-TR13S
DDM Supported             :Yes
 
Type                      :QSFP
Vendor Name               :AVAGO
Vendor Part Number        :AFBR-79E4Z
DDM Supported             :Yes
tx-disable
Use this command to disable the transceiver tx-power (disable laser).
Use the no form of this command to enable tx-power (enable laser).
Command Syntax
tx-disable
no tx-disable
Default
By default, tx-disable is false.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 4.2.
Example
#configure terminal
(config)#interface xe1
(config-if)#tx-disable
(config-if)#exit
 
(config)#interface xe1
(config-if)#no tx-disable
(config-if)#exit
wavelength
Use this command to set the transceiver wavelength using the channel-number or the wavelength for interfaces having a supported transceiver.
Use the no form of this command to remove the wavelength configuration.
Command Syntax 
wavelength ((channel-number <1-96>) | (update <1528773-1566723>))
Parameters
channel-number
Sets wavelength corresponding to the channel number
update 
Sets wavelength value
Default 
By default, the interface comes up with a random wavelength chosen by autotuning.
Command Mode
Interface mode
Applicability
This command was introduced in OcNOS version 4.1.
Example
(config)#int xe7
(config-if)#wavelength channel-number 10
(config-if)#no wavelength
(config-if)#
 
(config-if)#wavelength update 1528773
(config-if)#no wavelength
(config-if)#