Command Reference

This appendix provides a command reference for those Cisco IOS commands or aspects of the commands that are unique to ML-Series cards. For information about the standard IOS Release 12.1 commands, refer to the IOS documentation set available from the Cisco.com home page. Use the Select an Area pull-down menu to select Products and Services > Technical Documentation. On the Cisco Product Documentation home page, select Release 12.1 from the Cisco IOS Software drop-down list.

[no] clock auto

Use the clock auto command to determine whether the system clock parameters are configured automatically from the TCC+/TCC2. When enabled both summertime and timezone are automatically configured, and the system clock is periodically synchronized to the TCC+/TCC2. Use the no form of the command to disable this feature.

Syntax Description

This command has no arguments or keywords.

Defaults

The default setting is clock auto.

Command Modes

Global configuration.

Usage Guidelines

The no form of the command is required before any manual configuration of summertime, timezone, or clock. The no form of the command is required if Network Time Protocol (NTP) is configured in Cisco IOS. The ONS 15454 is also configured through CTC to use a NTP or Simple Network Time Protocol (SNTP) server to set the date and time of the node.

Examples 

Gateway(config)#no clock auto

Related Commands

clock summertime

clock timezone

clock set

[no] pos flag c2 <value>

Use this command to specify the C2 byte value for transmitted and received frames. Use the no form of the command to return the C2 byte to it's default value.

Parameter
Description

value

C2 byte value


Defaults

When changing the encapsulation on a POS port between LEX and PPP/HDLC, the scrambling and c2 settings will be automaticallychanged to their default values according to the table below.

encap
scrambling
c2

LEX

pos scramble-spe

pos flag c2 0x01

PPP/HDLC

no pos scramble-spe

pos flag c2 0xCF


In PPP/HDLC encapsulation, changing the scrambling, automatically changes the "pos flag c2" to it's default according to the table below. In LEX encapsulation, changing the scrambling does not affect c2.

encap
scrambling
c2

PPP/HDLC

pos scramble-spe

pos flag c2 0xCF

PPP/HDLC

no pos scramble-spe

pos flag c2 0x16


Command Modes

Interface configuration mode (POS only)

Usage Guidelines

This value is normally configured to match the setting on the peer Path Terminating Equipment (PTE). Using the correct order of operations will avoid having the non-default settings overridden by the encapsulation change. The recommended order follows:

•Set encap to PPP/HDLC

•Set scrambling (if a non-default setting is required)

•Set c2 (if a non-default setting is required)

Also note that the crc setting varies among different types of PTE. The default crc on the ML series card is 32-bits, regardless of any other settings. In most circumstances, the default settings should be correct, but users need to verify this with the user documentation for the PTE.

Examples 

Gateway(config)#int pos0

Gateway(config-if)#pos flag c2 0x16

Related Commands

pos trigger defects

pos report

[no] pos report alarm

Use this command to specify which alarms/signals are logged to the console. This command has no effect on whether alarms are reported to the TCC2/TCC2P and CTC. These conditions are soaked and cleared per Telcordia GR-253. Use the no form of the command to disable reporting of a specific alarm/signal.

Syntax Description

Parameter
Description

alarm

The SONET/SDH alarm that is logged to the console. The alarms are as follows:

all—All link down alarm failures

ber_sd_b3—PBIP BER in excess of SD threshold failure

ber_sf_b3—PBIP BER in excess of SD threshold failure

encap—Path Signal Label Encapsulation Mismatch failure

pais—Path Alarm Indication Signal failure

plop—Path Loss of Pointer failure

ppdi—Path Payload Defect Indication failure

pplm—Payload label mismatch path

prdi—Path Remote Defect Indication failure

ptim—Path Trace Indicator Mismatch failure

puneq—Path Label Equivalent to Zero failure


Defaults

The default is to report all alarms.

Command Modes

Interface configuration mode (POS only)

Usage Guidelines

This value is normally configured to match the setting on the peer PTE.

Examples 

Gateway(config)# int pos0

Gateway(config-if)# pos report all

Gateway(config-if)# pos flag c2 1

03:16:51: %SONET-4-ALARM:  POS0: PPLM   

Gateway(config-if)# pos flag c2 0x16

03:17:34: %SONET-4-ALARM:  POS0: PPLM  cleared

Related Commands

pos trigger defects

[non] pos trigger defects condition

Use this command to specify which conditions cause the associated POS link state to change. These conditions are soaked/cleared using the delay specified in the pos trigger delay command. Use the no form of the command to disable triggering on a specific condition.

Syntax Description

Parameter
Description

condition

The SONET/SDH condition that causes the link state change. The conditions are as follows:

all—All link down alarm failures

ber_sd_b3—PBIP BER in excess of SD threshold failure

ber_sf_b3—PBIP BER in excess of SD threshold failure (default)

encap—Path Signal Label Encapsulation Mismatch failure (default)

pais—Path Alarm Indication Signal failure (default)

plop—Path Loss of Pointer failure (default)

ppdi—Path Payload Defect Indication failure (default)

pplm—Payload label mismatch path (default)

prdi—Path Remote Defect Indication failure (default)

ptim—Path Trace Indicator Mismatch failure (default)

puneq—Path Label Equivalent to Zero failure (default)


Defaults

See list in above description.

Command Modes

Interface configuration mode (POS only)

Usage Guidelines

This value is normally configured to match the setting on the peer PTE.

Examples 

Gateway(config)# int pos0

Gateway(config-if)# pos trigger defects all

Related Commands

pos trigger delay

[no] pos trigger delay <time>

Use this command to specify which conditions cause the associated POS link state to go change. The conditions specified in the pos trigger defects command are soaked/cleared using this delay. Use the no form of the command to use the default value.

Parameter
Description
time
delay time in milliseconds, 200 to 2000

Defaults

The default value is 200 milliseconds.

Command Modes

Interface configuration mode (POS only)

Usage Guidelines

This value is normally configured to match the setting on the peer Path Terminating Equipment (PTE). The time granularity for this command is 50 milliseconds.

Examples 

Gateway(config)#int pos0

Gateway(config-if)#pos trigger delay 500

Related Commands

pos trigger defects

[no] pos scramble-spe

Use this command to enable scrambling.

Syntax Description

This command has no arguments or keywords.

Defaults

The default value depends on the encapsulation.

encap
scrambling

LEX

pos scramble-spe

PPP/HDLC

no pos scramble-spe


Command Modes

Interface configuration mode (POS only)

Usage Guidelines

This value is normally configured to match the setting on the peer Path Terminating Equipment (PTE). This command may change the pos flag c2 configuration.

Examples 

Gateway(config)#int pos0

Gateway(config-if)#pos scramble-spe

Related CommandsRelated Commnads

pos flag c2

show controllers pos <interface-number> [details]

Use this command to display the status of the POS controller. Use the details argument to obtain certain additional information as described below.

Parameter
Description
interface-number
Number of the POS interface <0-1>

Defaults

N/A

Command Modes

Privileged EXEC

Usage Guidelines

This command may be used to help diagnose and isolate POS or SONET problems.

Examples 

Gateway#show controllers pos0 details

Interface POS0

Hardware is Packet/Ethernet over Sonet 

PATH

  PAIS      = 0         PLOP      = 0         PRDI    = 0         PTIM = 0

  PPLM      = 3         PUNEQ     = 0         PPDI    = 0       

  BER_SF_B3 = 0         BER_SD_B3 = 0         BIP(B3) = 0          REI = 15

  NEWPTR    = 1         PSE       = 0         NSE     = 0       


Active Alarms : None

Demoted Alarms: None

Active Defects: None

Alarms reportable to CLI: PAIS PRDI PLOP PUNEQ PPLM PTIM PPDI BER_SF_B3 BER_SD_B3

Link state change defects: PAIS PLOP PRDI BER_SF_B3 

Link state change time   : 500 (msec)


DOS FPGA channel number: 0

Starting STS (0 based) : 0

Circuit size           : STS-3c

RDI Mode               : 1 bit

C2 (tx / rx)           : 0x16 / 0x16

Framing                : SONET


Path Trace

 Mode            : off          

 Buffer          : Unstable

 Remote hostname :                         

 Remote interface:               

 Remote IP addr  :                 


B3 BER thresholds: 

SFBER = 1e-5,   SDBER = 1e-7

  Xmt Str:                                                                 

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  Exp Str:                                                                 

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  Rcv Str:                                                                 

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................

  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00    ................


B3 BER thresholds: 

BER TH: SFBER=1e-5, SDBER=1e-7,

BER TH: Cur SFBER=0, Cur SDBER=0, berMap=0x00,

BER TH: BER 1e-3, BIP Sum=0, setTh=7404, clrTh=0

        WIND BER TH: SetCross=0x0003, setTh=3630

        Counts= 0, 0, 

BER TH: BER 1e-4, BIP Sum=0, setTh=2637, clrTh=2931

        WIND BER TH: SetCross=0x0003, setTh=1266

        Counts= 0, 0, 

BER TH: BER 1e-5, BIP Sum=0, setTh=1380, clrTh=1602

        WIND BER TH: SetCross=0x001F, setTh=237

        Counts= 0, 0, 0, 0, 0, 

BER TH: BER 1e-6, BIP Sum=0, setTh=1245, clrTh=1458

        WIND BER TH: SetCross=0x01FF, setTh=105

        Counts= 0, 0, 0, 0, 0, 0, 0, 0, 0, 

BER TH: BER 1e-7, BIP Sum=0, setTh=1248, clrTh=1458

        WIND BER TH: SetCross=0x03FF, setTh=93

        Counts= 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 

BER TH: BER 1e-8, BIP Sum=0, setTh=1248, clrTh=1458

        WIND BER TH: SetCross=0x03FF, setTh=93

        Counts= 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 

BER TH: BER 1e-9, BIP Sum=0, setTh=1248, clrTh=1458

        WIND BER TH: SetCross=0x03FF, setTh=93

        Counts= 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 

BER TH: BER 1e-10, BIP Sum=0, setTh=0, clrTh=1458

        WIND BER TH: SetCross=0x03FF, setTh=0

        Counts= 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,

Related Commands

show interface pos

clear counters

show interface pos <interface-number>

Use this command to display the status of the POS.

Parameter
Description
interface-number
Number of the POS interface <0-1>

Defaults

N/A

Command Modes

Privileged EXEC

Usage Guidelines

This command may be used to help diagnose and isolate POS or SONET/SDH problems.

Examples 

Gateway#show interfaces pos0

POS0 is up, line protocol is up 

  Hardware is Packet/Ethernet over Sonet

  Description: foo bar

  MTU 4470 bytes, BW 155520 Kbit, DLY 100 usec, 

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

  Encapsulation HDLC, crc 32, loopback not set

  Keepalive set (10 sec)

  Scramble enabled 

  Last input 00:00:09, output never, output hang never

  Last clearing of "show interface" counters 05:17:30

  Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0

  Queueing strategy: fifo

  Output queue :0/40 (size/max)

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

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


     2215 total input packets,  223743 post-HDLC bytes

     0 input short packets,  223951 pre-HDLC bytes

     0  input long packets , 0  input runt packets

     0  input CRCerror packets , 0  input drop packets

     0 input abort packets

     0 input packets dropped by ucode


     0 packets input, 0 bytes

     Received 0 broadcasts, 0 runts, 0 giants, 0 throttles

              0 parity

     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort


     2216  total output packets, 223807  output pre-HDLC bytes

     224003 output post-HDLC bytes


     0 packets output, 0 bytes, 0 underruns

     0 output errors, 0 applique, 8 interface resets

     0 output buffer failures, 0 output buffers swapped out

     0 carrier transitions

Related Commands

Show controller pos

Clear counters

show ons alarm

Use this command to display all the active alarms on the card.

Syntax Description

This command has no arguments or keywords.

Defaults

N/A

Command Modes

Privileged EXEC

Usage Guidelines

This command may be used to help diagnose and isolate card problems.

Examples 

Gateway# show ons alarm

Equipment 

Active Alarms: None


Port Alarms

  POS0  Active: TPTFAIL

  POS1  Active: TPTFAIL

  GigabitEthernet0  Active: None

  GigabitEthernet1  Active: None 


POS0

Active Alarms : None

Demoted Alarms: None


POS1

Interface not provisioned

Related Commands

show controller pos

show ons alarm defects

show ons alarm failures

show ons alarm defect eqpt

This commands displays the equipment layer defects.

Syntax Description

This command has no arguments or keywords.

Defaults

N/A

Command Modes

Privileged EXEC

Usage Guidelines

This commands displays set of active defects for the equipment layer and the possible set of defects that can be set.

Examples 

router#show ons alarm defect eqpt

Equipment Defects

Active: CONTBUS-IO-B

Reportable to TCC/CLI: CONTBUS-IO-A CONTBUS-IO-B CTNEQPT-PBWORK CTNEQPT-PBPROT EQPT 
RUNCFG-SAVENEED ERROR-CONFIG

Related Commands

show ons alarm failures

show ons alarm defect port

This commands displays the port layer defects.

Syntax Description

This command has no arguments or keywords.

Defaults

N/A

Command Modes

Privileged EXEC

Usage Guidelines

This commands displays set of active defects for the link layer and the possible set of defects that can be set. Note that the TPTFAIL defect can only occur on the POS ports and CARLOSS can only occur on the ethernet ports.

Examples 

router#show ons alarm defect port

Port Defects

  POS0

  Active: TPTFAIL

  Reportable to TCC: CARLOSS TPTFAIL

  POS1

  Active: TPTFAIL

  Reportable to TCC: CARLOSS TPTFAIL

  GigabitEthernet0

  Active: None

  Reportable to TCC: CARLOSS TPTFAIL

  GigabitEthernet1

  Active: None

  Reportable to TCC: CARLOSS TPTFAIL

Related Commands

show interface

show ons alarm failures

show ons alarm defect pos <interface-number>

This commands displays the link layer defects.

Parameter
Description
interface-number
Number of the interface <0-1>

Defaults

N/A

Command Modes

Privileged EXEC

Usage Guidelines

This commands displays set of active defects for the POS layer and the possible set of defects that can be set.

Examples 

POS0

Active Defects: None

Alarms reportable to TCC/CLI: PAIS PRDI PLOP PUNEQ PPLM PTIM PPDI BER_SF_B3 BER_SD_B3

Related Commands

show controller pos

show ons alarm failures

show ons alarm failure eqpt

This commands displays the equipment layer failures.

Syntax Description

This command has no arguments or keywords.

Defaults

N/A

Command Modes

Privileged EXEC

Usage Guidelines

This commands displays set of active failures for the equipment layer. If an EQPT alarm is present the Board Fail defect that was the source of the alarm will be displayed.

Examples 

router#show ons alarm failure eqpt

Equipment

Active Alarms: None

Related Commands

show ons alarm defect

show ons alarm failure port

This commands displays the port layer failures.

Syntax Description

This command has no arguments or keywords.

Defaults

N/A

Command Modes

Privileged EXEC

Usage Guidelines

This commands displays set of active failures for the link layer.

Examples 

router#show ons alarm failure port

Port Alarms

  POS0  Active: TPTFAIL

  POS1  Active: TPTFAIL

  GigabitEthernet0  Active: None

  GigabitEthernet1  Active: None

Related Commands

show interface

show ons alarm defect

show ons alarm failure pos <interface-number>

This commands displays the link layer failures.

Parameter
Description

interface-number

Number of the interface <0-1>

Defaults

N/A

Command Modes

Privileged EXEC

Usage Guidelines

This commands displays set (active) failures for a specific interface at the pos layer. The display also specifies if an alarm has been demoted, as defined in Telcordia GR-253.

Examples 

router#show ons alarm failure pos 0

POS0

Active Alarms : None

Demoted Alarms: None

Related Commands

show controller pos

show ons alarm defect