Table Of Contents

SONET Controller Commands on Cisco IOS XR Software

ais-shut (SONET)

ais-shut (SONET path)

aps group

au

authenticate (PGP)

channel local

channel remote

clear counters sonet

clock source (SONET)

controller (SONET)

delay trigger

down-when-looped

force

framing (SONET)

lockout

loopback (SONET)

manual

mode

overhead (SONET)

overhead (SONET path)

path (SONET)

report (SONET)

report (SONET path)

revert

scrambling disable (SONET path)

show aps

show aps agents

show aps group

show controllers pos

show controllers sonet

shutdown (SONET)

signalling

sts

timers (APS)

threshold (SONET)

threshold (SONET path)

tug3

uneq-shut (SONET path)

unidirectional

width

SONET Controller Commands on Cisco IOS XR Software

---

This module describes the Cisco IOS XR software commands used to configure SONET operation on a router port using Layer 1 SONET transport technology. The configuration of the SONET controller includes SONET Automatic Protection Switch (APS), which is a feature offering recovery from fiber (external) or equipment (interface and internal) failures at the SONET line layer. You must configure a SONET controller before you can configure a Packet-over-SONET/SDH (POS) interface or a Spatial Reuse Protocol (SRP) interface.

All SONET-related configurations of a SONET-based physical port are grouped under the SONET controller configuration submode. The SONET path-related configuration commands are grouped under the SONET path submode.

ais-shut (SONET)

To enable automatic insertion of a line alarm indication signal (LAIS) in the sent SONET signal whenever the SONET port enters the administrative shutdown state, use the ais-shut command in SONET/SDH configuration mode. To disable automatic insertion of a LAIS, use the no form of this command.

ais-shut

no ais-shut

Syntax Description

This command has no arguments or keywords.

Defaults

This command is disabled by default; no AIS is sent.

Command Modes

SONET/SDH configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

When the line is placed in administrative shutdown state, use the ais-shut command to send a signal to downstream equipment that indicates that there is a problem with the line.

The ais-shut command is ignored if automatic protection switching (APS) is running for the corresponding port, because the setting must be enabled for proper APS operation.

For SONET ports that do not have hardware support for LAIS insertion, the ais-shut command is disabled.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

In the following example, the alarm indication is forced on the SONET OC-3 controller:

RP/0/0/CPU0:router(config)# controller sonet 0/1/0/0

RP/0/0/CPU0:router(config-sonet)# ais-shut

Related Commands

Command	Description
show controllers sonet	Displays information about the operational status of SONET layers.

ais-shut (SONET path)

To enable automatic insertion of path alarm indication signal (PAIS) in the sent SONET signal whenever the SONET path enters the administratively down state, use the ais-shut command in SONET/SDH path configuration mode. To disable automatic insertion of PAIS in the SONET signal, use the no form of this command.

ais-shut

no ais-shut

Syntax Description

This command has no arguments or keywords.

Defaults

This command is disabled by default; no AIS is sent.

Command Modes

SONET/SDH path configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

Use the ais-shut command to enable automatic insertion of PAIS in the appropriate sent SONET path overhead whenever the corresponding SONET path enters the administratively down state.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

The following example shows the alarm indication being enabled on all paths:

RP/0/0/CPU0:router(config)# controller sonet 0/2/0/2

RP/0/0/CPU0:router(config-sonet)# path

RP/0/0/CPU0:router(config-sonet-path)# ais-shut

Related Commands

Command	Description
show controllers sonet	Displays information about the operational status of SONET layers.

aps group

To add an automatic protection switching (APS) group and enter APS group configuration mode, use the aps group command in global configuration mode. To remove a group, use the no form of this command.

aps group number

no aps group number

Syntax Description

number

Number of the group. Range is from 1 through 255.

Defaults

No groups exist.

Command Modes

Global configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

Use the aps group command to enter APS group configuration mode and configure APS connections with other SONET equipment. The following commands are available in APS group configuration submode:

•authenticate—Configure sending path alarm indication signal (PAIS) when shut down

•channel—Assign a channel to an APS group

•commit—Commit the configuration changes to the running configuration

•describe—Describe a command without taking real actions

•do—Run an EXEC command

•exit—Exit from this submode

•lockout—Set APS Lockout user request

•no—Negate a command or set its defaults

•revert— Enable automatic switchover from the protect interface to the working interface after the working interface becomes available

•show—Show contents of the current configuration

•signalling—Set APS signaling mode

•timers—Modify the time between hello packets and the time before the protect interface process declares a working interface router to be down

•unidirectional—Set unidirectional mode

An APS group contains one protect (P) SONET port and one working (W) SONET port. The working and protect ports can reside on the same logical channel (LC), on different LCs in the same router, or on different routers. One APS group must be configured for each protect port and its corresponding working ports.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

The following example shows how the aps group command is used to configure APS group 1 and enter APS group configuration mode:

RP/0/0/CPU0:router(config)# aps group 1

Related Commands

Command	Description
show aps	Displays SONET APS group operational status.

au

To specify the administrative unit (AU) and enter the AU controller configuration mode, use the au command in SONET controller configuration mode.

au number

Syntax Description

number

Administrative unit number (AU3 or AU4) in the range from 1 to 48.

Defaults

The default is 1.

Command Modes

SONET controller configuration

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco XR 12000 Series Router.

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

The au command enables you to begin configuring the interface in the AU controller configuration mode, where you can configure tributary unit groups (TUGs), virtual containers (VCs), and DS3s:

STM1 -> AU4 -> TUG3 -> VC-3 -> DS3

You can configure one AU4 path or three AU3 paths. An administrative unit 4 (AU4) consists of three STM-1s or one STM-3. An administrative unit 3 (AU3) consists of one STM-1.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

The following example shows how to specify AU 1.

RP/0/0/CPU0:router(config)# controller sonet 0/1/0/0

RP/0/0/CPU0:router(config-sonet)#au 1

RP/0/0/CPU0:router(config-auPath)#

Related Commands

Command	Description
tug3	Specifies the tributary unit group (TUG) number.

authenticate (PGP)

To configure the authentication string for the Protect Group Protocol (PGP) message exchange between the protect and working routers, use the authenticate command in APS group configuration mode. To revert to the default authentication string, use the no form of this command.

authenticate string

no authenticate string

Syntax Description

string

Authentication string that the router uses to authenticate PGP message exchange between protect or working routers. The maximum length of the string is eight alphanumeric characters. Spaces are not accepted.

Defaults

Authentication is always disabled by using the string cisco.

Command Modes

APS group configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

Use the authenticate command to configure the authentication string for the PGP message exchange between the protect and working routers. Use the no form of this command to revert to the default authentication string.

The authenticate command applies only in multirouter automatic protection switching (APS) group configurations.

In multirouter APS topologies, the protect and working routers communicate with each other through the User Datagram Protocol (UDP)-based Pretty Good Privacy protocol. Each Pretty Good Privacy packet contains an authentication string used for packet validation. The authentication string on all routers involved in the same APS group operation must match for proper APS operation.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

The following example enables authentication for APS group 1 in abctown:

RP/0/0/CPU0:router(config)# aps group 1

RP/0/0/CPU0:router(config-aps)# authenticate abctown

Related Commands

Command	Description
channel local	Assigns a port and interface local to the router as a SONET APS channel.
channel remote	Assigns a port and interface that is physically located in a remote router as a SONET APS channel.
show aps	Displays SONET APS group operational status.

channel local

To assign local SONET physical ports as SONET automatic protection switching (APS) channels in the current APS group, use the channel local command in APS group configuration mode. To return to the default setting, use the no form of this command.

channel {0 | 1} local {sonet | preconfigure} sonet instance

no channel {0 | 1} local {sonet | preconfigure} sonet instance

Syntax Description

0 | 1	Assigned channel number: 0 = protect, 1 = working.
sonet	Configures SONET port controllers.
preconfigure	Specifies a SONET preconfiguration. This keyword is used only when a modular services or line card is not physically installed in a slot.
sonet	Specifies a SONET interface type.
instance	Either a physical interface instance or a virtual interface 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 modular services card or line card. –module: Module number. A physical layer interface module (PLIM) is always 0. –port: Physical port number of the interface. •Virtual interface instance. Number range varies depending on interface type. For more information about the syntax for the router, use the question mark (?) online help function.

Defaults

A SONET APS local channel is not assigned.

Command Modes

APS group configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

Use the channel local command to designate SONET physical ports as SONET APS channels in the current APS group. Use the channel remote command to assign channels that are physically located in a different router.

Preconfigured interfaces are supported.

If the protect channel is local, it must be assigned using a channel command before any of the working channels are assigned. The reason is that having only a working channel assigned is a valid configuration for a working router in a multirouter APS topology and further attempts to configure a local protect channel will be rejected.

The interface type must be a SONET controller.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

The following example shows how to configure SONET 0/2/0/2 as a local protect channel:

RP/0/0/CPU0:router(config)# aps group 1

RP/0/0/CPU0:router(config-aps)# channel 0 local SONET 0/2/0/2 

Related Commands

Command	Description
channel remote	Assigns a port and interface that is physically located in a remote router as a SONET APS channel.
show aps	Displays SONET APS group operational status.

channel remote

To assign a port and interface that is physically located in a remote router as a SONET automatic protection switching (APS) channel (working or protect), use the channel remote command in APS group configuration mode. To return to the default setting, use the no form of this command.

channel {0 | 1} remote ip-address

no channel {0 | 1} remote ip-address

Syntax Description

{0 | 1}	Assigned channel number. Replace the channel-number argument with a number that identifies the channel. Enter 0 to designate the channel as protect channel, or 1 to designate the channel as a working channel.
ip-address	Remote router IP address in A.B.C.D format.

Defaults

A SONET APS remote channel is not assigned.

Command Modes

APS group configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

Use the channel remote command to assign working or protect channels that are physically located in a different router.

Use the channel local command to assign channels in the local router.

---

Note The channel remote command should not be used in single-router APS topologies.

---

The IP address of the remote router is required only if a working channel configured as the protect router contacts all working routers.

Specifying a remote protect channel is optional. If you do not specify a remote protect channel, the default value of 0.0.0.0 is used. The protect router is always the one that contacts the working router. The working router replies to the protect router using the source address extracted from the incoming messages as the destination address. If an address other than 0.0.0.0 (the default value) is specified, the working router always uses that address when sending messages to the protect router.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

In the following examples, a remote channel with IP address 192.168.1.1 is assigned as the working channel:

RP/0/0/CPU0:router(config)# aps group 1

RP/0/0/CPU0:router(config-aps)# channel 1 remote 192.168.1.1

Related Commands

Command	Description
channel local	Assigns a port and interface local to the router as a SONET APS channel.
show aps	Displays SONET APS group operational status.

clear counters sonet

To clear SONET counters for a specific SONET controller, use the clear counters sonet command in EXEC mode.

clear counters sonet instance

Syntax Description

instance

Either a physical interface instance or a virtual interface instance as follows: •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 modular services card or line card. –module: Module number. A physical layer interface module (PLIM) is always 0. –port: Physical port number of the interface. •Virtual interface instance. Number range varies depending on interface type. Note For more information about the syntax for the router, use the question mark (?) online help function.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

Use the clear counters sonet command to clear SONET counters for a specific SONET controller.

Task ID

Task ID	Operations
sonet-sdh	read, write
basic-services	read, write

Examples

The following example shows the SONET counters being cleared on the SONET interface:

RP/0/0/CPU0:router# clear counters sonet 0/1/0/0

Related Commands

Command	Description
show controllers sonet	Displays information about the operational status of SONET layers.

clock source (SONET)

To set the clock source of the sent signal on SONET ports, use the clock source command in SONET/SDH configuration mode. To cancel a clock source setting, use the no form of this command.

clock source {internal | line}

no clock source {internal | line}

Syntax Description

internal	Specifies that the controller will clock its sent data from its internal clock.
line	Specifies that the controller will clock its sent data from a clock recovered from the receive data stream of the line. This is the default value.

Defaults

The clock source for the controller is line.

Command Modes

SONET/SDH configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

Use the clock source command to configure which reference clock is used by the sender.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

In the following example, the SONET controller is configured to clock its sent data from its internal clock:

RP/0/0/CPU0:router(config)# controller sonet 0/2/0/2

RP/0/0/CPU0:router(config-sonet)# clock source internal

Related Commands

Command	Description
show controllers sonet	Displays information about the operational status of SONET layers.

controller (SONET)

To enter SONET/SDH configuration mode so that you can configure a specific SONET controller, use the controller command in global configuration mode. To return to the default state, use the no form of this command.

controller [preconfigure] sonet instance

no controller [preconfigure] sonet instance

Syntax Description

preconfigure	(Optional) Specifies a SONET preconfiguration. Use the preconfigure keyword only when a modular services card in not physically installed in a slot.
sonet	Configures SONET port controllers.
instance	Either a physical interface instance or a virtual interface instance as follows: •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 modular services card or line card. –module: Module number. A physical layer interface module (PLIM) is always 0. –port: Physical port number of the interface. •Virtual interface instance. Number range varies depending on interface type. Note 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 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
interface	read, write

Examples

The following example shows how to enter SONET/SDH configuration mode for the SONET controller in slot number 2:

RP/0/0/CPU0:router(config)# controller SONET 0/2/0/1 

RP/0/0/CPU0:router(config-sonet)#

Related Commands

Command	Description
show controllers sonet	Displays information about the operational status of SONET layers.

delay trigger

To configure SONET line delay trigger values, use the delay trigger command in SONET/SDH configuration mode. To cancel the line delay trigger value and return to the default, use the no form of this command.

delay trigger line value

no delay trigger line value

Syntax Description

line value

Sets the SONET line delay trigger value in milliseconds. Range is from 0 to 511. Default is 0 (no delay).

Defaults

value: 0

Command Modes

SONET/SDH configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

In the following example, the SONET line delay trigger value is set to 5:

RP/0/0/CPU0:router(config)# controller sonet 0/2/0/2

RP/0/0/CPU0:router(config-sonet)# delay trigger line 5

Related Commands

Command	Description
show controllers sonet	Displays information about the operational status of SONET layers.

down-when-looped

To configure an interface to inform the system that it is down when loopback is detected, use the down-when-looped command in interface configuration mode.

down-when-looped

Syntax Description

This command has no arguments or keywords.

Defaults

The default is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco XR 12000 Series Router.

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

This command does not have a no form.

This command is valid for High-Level Data Link Control (HDLC) or PPP encapsulation on serial interfaces.

When an interface has a backup interface configured, it is often desirable that the backup interface be enabled when the primary interface is either down or in loopback. By default, the backup is enabled only if the primary interface is down. By using the down-when-looped command, the backup interface is also enabled if the primary interface is in loopback.

---

Note When testing an interface with the loopback command, or when placing the DCE into loopback, do not configure the interface with the down-when-looped command, or packets will not be transmitted out the interface.

---

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

The following example shows how to specify serial interface 0 with HDLC encapsulation. The interface is then configured to let the system know that it is down when in loopback mode.

RP/0/0/CPU0:router(config)# interface serial 0

RP/0/0/CPU0:router(config-if)# encapsulation hdlc

RP/0/0/CPU0:router(config-if)# down-when-looped

Related Commands

Command	Description
loopback (SONET)	Configures the SONET controller for loopback mode.

force

To initiate a forced automatic protection switching (APS) request at the local end of the SONET link, use the force command in APS group configuration mode. To cancel the switch, use the no form of this command.

force {0 | 1}

no force {0 | 1}

Syntax Description

0 | 1

Assigned channel number. 0 = protect, 1 = working.

Defaults

No default behavior or values

Command Modes

APS group configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

---

Note If a request of equal or higher priority is in effect, you cannot use the force command to initiate a forced APS request at the local end of the SONET link.

---

Use the force command to manually switch the traffic to a protect channel. For example, if you need to change the fiber connection, you can manually force the working channel to switch to the protect interface.

The 0 or 1 keyword (by default 1) identifies on which channel the traffic should be stopped and moved on the protect channel. The force 1 command moves traffic from the working channel to the protect channel; the force 0 command moves traffic from the protect channel back to the working channel.

A forced switch can be used to override an automatic (Signal Failed Signal Degraded) or a manual switch request. A lockout request (via the lockout command) overrides a force request.

In a multirouter APS topology, a force request is allowed only on the protect router.

This command remains in effect until it is unconfigured by using the no form of the command.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

The following example shows how to move traffic from the working channel back to the protect channel:

RP/0/0/CPU0:router(config)# aps group 1

RP/0/0/CPU0:router(config-aps)# force 1

Related Commands

Command	Description
lockout	Initiates an APS lockout switch request at the local end of the SONET link.
manual	Initiates an APS manual switch request at the local end of the SONET link.

framing (SONET)

To specify the framing used on the SONET controller, use the framing command in SONET/SDH configuration mode. To disable framing on the SONET controller, use the no form of this command.

framing {sdh | sonet}

no framing {sdh | sonet}

Syntax Description

sdh	Selects Synchronous Digital Hierarchy (SDH) framing. This framing mode is typically used in Europe.
sonet	Selects SONET framing. This is the default.

Defaults

The default framing on SONET controllers is sonet.

Command Modes

SONET/SDH configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.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 the Cisco IOS XR System Security Configuration Guide.

Use the framing command to select either SONET or SDH framing on the selected physical port, if supported. For physical ports that do not support either of these two options, the framing command is disabled.

Use the no form of this command to disable SONET or SDH framing on the SONET controller.

Task ID

Task ID	Operations
sonet-sdh	read, write

Examples

In the following example, the SONET controller is configured for SDH framing:

RP/0/0/CPU0:router(config)# controller sonet 0/2/0/2

RP/0/0/CPU0:router(config-sonet)# framing sdh

Related Commands

Command	Description
show controllers sonet	Displays information about the operational status of SONET layers.

lockout

To initiate a forced automatic protection switching (APS) request at the local end of the SONET link, use the lockout command in APS group configuration mode. To remove the lockout, use the no form of this command.

lockout {0 |1}

no lockout {0 | 1}

Syntax Description

channel-number

(Optional) Assigned channel number. 0 = protect, 1 = working. Default is 0.

Defaults

The default is 0.

Command Modes

APS group configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was first supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0