Cisco ONS 15454 SDH TL1 Command Guide, Release 7.0
Chapter 24, SW Commands
Downloads: This chapterpdf (PDF - 175.0KB) The complete bookPDF (PDF - 11.48MB) | Feedback

SW Commands

Table Of Contents

SW Commands

24.1  SW-DX-EQPT

24.2  SW-TOPROTN-EQPT

24.3  SW-TOWKG-EQPT


SW Commands


This chapter provides SW (switch) commands for the Cisco ONS 15454 SDH.

24.1  SW-DX-EQPT

Switch Duplex Equipment (Cisco ONS 15454 and Cisco ONS 15600)

Usage Guidelines

This command switches an XC-VXL-10G/XC-VXL-2.5G card with the mate card within the NE.


Note If sending a mode parameter with a value other than NORM, FRCD, or NULL, the IDNV (Input, Data Not Valid) error message will be returned.


Category

Equipment

Security

Maintenance

Input Format

SW-DX-EQPT:[<TID>]:<AID>:<CTAG>::[<MODE>][,];

Input Example

SW-DX-EQPT:CISCO:SLOT-1:123::FRCD;

Input Parameters

Table 24-1 SW-DX-EQPT Input Parameters 

Parameter and Values
Description

AID

Access identifier from the "EQPT" section. Identifies the equipment unit in the NE that is to be switched with its mate

MODE

Command mode

Parameter type is CMDMDE—forces the system to execute a given command regardless of any standing conditions. Normal mode is the default behavior for all commands but you can specify FRCD to force the system to override a state in which the command would normally be denied

FRCD

Force the system to override a state in which the command would normally be denied

NORM

Execute the command normally. Do not override any conditions that may make the command fail


24.2  SW-TOPROTN-EQPT

Switch to Protection Equipment

Usage Guidelines

This command performs an equipment unit protection switch.

This command is used for electrical cards that can participate in an electrical protection group (for example, E1, E3, E4, and DS3i-N-12).

This command will switch the traffic from the working card specified in the AID to the protect card.

There is a priority for the switch to protection commands. In a 1:N protection group with N > 1, consider two working cards - A and B. Card A is switched to the protect card with the SW-TOPROTN command. If card B is pulled from the system, the protect card will carry the traffic of card B and card A will raise the FAILTOSW condition and carry traffic. When card B is replaced and the revert timer expires, card B will carry traffic and card A will switch to the protect card. The FAILTOSW condition on card A will be cleared. Note:1:N protection groups in the system are always revertive.

In a revertive protection group, the unit specified by the AID will raise the standing condition of WKSWPR if the command were executed without an error. In a non-revertive protection group, the unit specified by the AID will raise the transient condition of WKSWPR if the command were executed without an error.

The following actions will return error messages:

The default PROTID is the protecting unit if there is only one protection unit per protection group in the NE, otherwise a DENY error message will be returned.

This command only supports one value of the <DIRN> parameter - BTH or null. A command with any other value is considered an incorrect use of the command. An IDNV (Input, Data Not Valid) error message will be returned.

This command is not used for the common control (TCC2/TCC2P or XC-VXL-10G/XC-VXL-2.5G) cards. A command on a common control card will generate an IIAC (Input, Invalid Access Identifier) error message. To use the common control card switching commands, use the SW-DX-EQPT and ALW-SWDX-EQPT commands.

This command is not used for SDH (STM) cards. A command on a SDH card will return an IIAC (Input, Invalid Access Identifier) error message. To use a SDH card switching command, use the OPR-PROTNSW and RLS-PROTNSW commands.

If this command is used on a card that is not in a protection group, the SNVS (Status, Not in Valid State) error message will be returned.

If this command is sent to a missing working card, the SWFA (Status, Working Unit Failed) error message will be returned.

If this command is used on a protection card, the IIAC (Input, Invalid Access Identifier) error message will be returned.

Sending a mode parameter with a value other than NORM, FRCD, or null will return the IDNV (Input, Data Not Valid) error message.

Sending the SW-TOPROTN command to a working card when the working card has raised INHSWPR will return the SWLD (Status, Working Unit Locked) error message.

Sending the SW-TOPROTN command to a working card when the protection card has raised INHSWPR will return the SPLD (Status, Protection Unit Locked) error message.

Sending the SW-TOPROTN command to an active working card when the protect card is already carrying traffic (this only occurs in a 1:N protection group with N greater than one) will return the SNVS (Status, Not in Valid State) error message.

Sending the SW-TOPROTN command to an active working card when the protect card is failed or missing will return the SPFA (Status, Protection Unit Failed) error message.

Sending this command to a standby working card will return the SNVS (Status, Not in Valid State) error message.

Category

Equipment

Security

Maintenance

Input Format

SW-TOPROTN-EQPT:[<TID>]:<AID>:<CTAG>::[<MODE>],[<PROTID>],[<DIRN>];

Input Example

SW-TOPROTN-EQPT:CISCO:SLOT-1:123::FRCD,SLOT-3,BTH;

Input Parameters

Table 24-2 SW-TOPROTN-EQPT Input Parameters 

Parameter and Values
Description

AID

Access identifier from the "EQPT" section. Specifies the working unit which will have traffic switched to protection

MODE

Mode with which the command is to be implemented.The parameter will only support the NORM value. A null value defaults to NORM. Sending the FRCD value for will generate the same switching behavior as sending the NORM value

Parameter type is CMDMDE—forces the system to execute a given command regardless of any standing conditions. Normal mode is the default behavior for all commands but you can specify FRCD to force the system to override a state in which the command would normally be denied

FRCD

Force the system to override a state in which the command would normally be denied

NORM

Execute the command normally. Do not override any conditions that may make the command fail

PROTID

Access identifier from the "PRSLOT" section. Identifies the protection unit to be switched when there is more than one protection unit within the NE. Optional

DIRN

The direction relative to the entity defined in the AID field. The direction of the switching. This command only supports the BTH value of this parameter. DIRN defaults to BTH

Parameter type is DIRECTION—transmit and receive directions

BTH

Both transmit and receive directions


24.3  SW-TOWKG-EQPT

Switch to Working Equipment

Usage Guidelines

This command switches the protected working unit back to working unit.

This command is used for electrical cards that can participate in an electrical group (e.g. E1, E3, E4, and DS3i-N-12).

This command will switch the traffic from the protection card to the working card specified by the AID.

In a revertive protection group, the unit specified by the AID will clear the standing condition of WKSWPR if the command were executed without an error. In a non-revertive protection group, the unit specified by the AID will raise the transient condition of WKSWBK if the command were executed without an error.

The following actions will return error messages:

This command only supports one value of the <DIRN> parameter - BTH or null. A command with any other value is considered an incorrect use of the command. An IDNV (Input, Data Not Valid) error message will be returned.

This command is not used for the common control (TCC2/TCC2P or XC-VXL-10G/XC-VXL-2.5G) cards. A command on a common control card will return an IIAC (Input, Invalid Access Identifier) error message. To use the common control card switching commands, use the SW-DX-EQPT and ALW-SWDX-EQPT commands.

This command is not used for SDH (STM) cards. A command on a SDH card will return an IIAC (Input, Invalid Access Identifier) error message. To use a SDH card switching command, use the OPR-PROTNSW and RLS-PROTNSW commands.

If this command is used on a card that is not in a protection group, the SNVS (Status, Not in Valid State) error message will be returned.

If this command is sent to a missing working card, the SWFA (Status, Working Unit Failed) error message will be returned.

If this command is used on a protection card, the IIAC (Input, Invalid Access Identifier) error message will be returned.

If sending a mode parameter with a value other than NORM, FRCD, or null, the IDNV (Input, Data Not Valid) error message will be returned.

Sending the SW-TOWKG command to a working card when the working card has raised INHSWWKG will return the SWLD (Status, Working Unit Locked) error message.

Sending the SW-TOWKG command to a working card when the protection card has raised INHSWWKG will return the SPLD (Status, Protection Unit Locked) error message.

Sending the SW-TOWKG command to an active working card will return the SNVS (Status, Not in Valid State) error message.

Category

Equipment

Security

Maintenance

Input Format

SW-TOWKG-EQPT:[<TID>]:<AID>:<CTAG>::[<MODE>][,<DIRN>];

Input Example

SW-TOWKG-EQPT:CISCO:SLOT-2:123::FRCD,BTH;

Input Parameters

Table 24-3 SW-TOWKG-EQPT Input Parameters 

Parameter and Values
Description

AID

Access identifier from the "PRSLOT" section. Specifies the working unit which will have traffic switched to protection

MODE

Mode with which the command is to be implemented.The parameter will only support the NORM value. A null value defaults to NORM. Sending the FRCD value for will generate the same switching behavior as sending the NORM value

Parameter type is CMDMDE—forces the system to execute a given command regardless of any standing conditions. Normal mode is the default behavior for all commands but you can specify FRCD to force the system to override a state in which the command would normally be denied

FRCD

Force the system to override a state in which the command would normally be denied

NORM

Execute the command normally. Do not override any conditions that may make the command fail

DIRN

The direction relative to the entity defined in the AID field. The direction of the switching. This command only supports the BTH value of this parameter. DIRN defaults to BTH

Parameter type is DIRECTION—transmit and receive directions

BTH

Both transmit and receive directions