- Preface
- Chapter 1, ACT Commands
- Chapter 2, APPLY Commands
- Chapter 3, ALW Commands
- Chapter 4, CANC Commands
- Chapter 5, CHG Commands
- Chapter 6, CLR Commands
- Chapter 7, COPY Commands
- Chapter 8, CONN Commands
- Chapter 9, DISC Commands
- Chapter 10, DLT Commands
- Chapter 11, ED Commands
- Chapter 12, ENT Commands
- Chapter 13, EX Commands
- Chapter 14, INH Commands
- Chapter 15, INIT Commands
- Chapter 16, OPR Commands
- Chapter 17, REPT Commands
- Chapter 18, RLS Commands
- Chapter 19, RMV Commands
- Chapter 20, RST Commands
- Chapter 21, RTRV Commands
- Chapter 22, SCHED Commands
- Chapter 23, SET Commands
- Chapter 24, SW Commands
- Chapter 25, Access Identifiers
- Chapter 26, Conditions
- Chapter 27, Modifiers
Cisco ONS SDH TL1 Command Guide, Release 9.2
- Updated:
- September 11, 2014
Chapter: Chapter 24, SW Commands
SW Commands
This chapter provides switch (SW) commands for the Cisco ONS 15310-MA SDH, Cisco ONS 15454 SDH, Cisco ONS 15454 M2, and Cisco ONS 15454 M6.
Note
All commands supported on the Cisco ONS 15454 SDH platform are also supported on Cisco ONS 15454 M2 and Cisco ONS 15454 M6 platforms.
24.1 SW-DX-EQPT
NoteThe SW-DX-EQPT command does not apply to the Cisco ONS 15310 MA SDH platform.
(Cisco ONS 15454 SDH) The Switch Duplex Equipment (SW-DX-EQPT) command switches an XC-VXL-10G or XC-VXL-2.5G card with its redundant card within the NE.
Usage Guidelines
If sending a mode parameter with a value other than NORM, FRCD, or NULL, the Input, Data Not Valid (IDNV) error message will be returned.
Category
Security
Input Format
Input Example
SW-DX-EQPT:CISCO:SLOT-8:123::NORM;
|
|
|
|
|
|---|---|---|---|
Access identifier from the “EQPT” section. Identifies the equipment unit in the NE that is to be switched with its redundant card. |
|||
(Optional) Command mode. Normal (NORM) mode is the default behavior for all commands but you can specify forced (FRCD) mode to force the system to override a state where the command would normally be denied. The FRCD mode of operation is applicable to delete a virtual concatenated (VCAT) member cross-connect in Unlocked-Enabled or Locked-Disabled, AutomaticInService service states. |
|||
Force the system to override a state in which the command would normally be denied. (FRCD is not supported in this command). |
|||
Execute the command normally. Do not override any conditions that may make the command fail. |
24.2 SW-TOPROTN-EQPT
(Cisco ONS 15310 MA SDH and Cisco ONS 15454 SDH) The Switch to Protection Equipment (SW-TOPROTN-EQPT) command performs an equipment unit protection switch.
NoteThe following modifiers are not supported on the Cisco ONS 15310 MA SDH platform: E4 and DS3i-N-12.
- 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 1:N protection groups with N > 1. For example, suppose a 1:N protection group has 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 become active. When Card B is replaced and the revert timer expires, Card B will carry traffic and Card A will carry traffic. The protect card will not carry any traffic.
- 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 nonrevertive protection group, the unit specified by the AID will raise the transient condition of WKSWPR if the command is executed without an error.
- The following actions will return error messages:
– The default PROTID is the protect unit if there is only one protect unit per protection group in the NE, otherwise a DENY error message will be returned.
– This command only supports the BTH or null value of the DIRN parameter. A command with any other value is considered an incorrect use of the command. An Input, Data Not Valid (IDNV) error message will be returned.
– This command is not used for the common control (TCC2, TCC2P, TCC3, XC-VXL-10G, XC-VXL-2.5G, or XC-VXC-10G) cards. A command on a common control card will generate an Input, Invalid Access Identifier (IIAC) error message. To switch the common control cards, 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 error message. To switch an SDH card, use the OPR-PROTNSW and RLS-PROTNSW commands.
– If this command is used on a card that is not in a protection group, the Status, Not in Valid State (SNVS) error message will be returned.
– If this command is sent to a missing working card, the Status, Working Unit Failed (SWFA) error message will be returned.
– If this command is used on a protect card, the IIAC error message will be returned.
– Sending a mode parameter with a value other than NORM, FRCD, or null will return the IDNV error message.
– Sending the SW-TOPROTN command to a working card when the working card has raised INHSWPR will return the Status, Working Unit Locked (SWLD) error message.
– Sending the SW-TOPROTN command to a working card when the protection card has raised INHSWPR will return the Status, Protection Unit Locked (SPLD) 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 Status, Not in Valid State (SNVS) error message.
– Sending the SW-TOPROTN command to an active working card when the protect card is failed or missing will return the Status, Protection Unit Failed (SPFA) error message.
– Sending this command to a standby working card will return the SNVS error message.
Category
Security
Input Format
SW-TOPROTN-EQPT:[<TID>]:<AID>:<CTAG>::[<MODE>],[<PROTID>],[<DIRN>];
Input Example
SW-TOPROTN-EQPT:CISCO:SLOT-1:123::FRCD,SLOT-3,BTH;
|
|
|
|
|
|---|---|---|---|
Access identifier from the “EQPT” section. Specifies the working unit which will have traffic switched to protection. |
|||
(Optional) Command mode. Normal (NORM) mode is the default behavior for all commands but you can specify forced (FRCD) mode to force the system to override a state where the command would normally be denied. The FRCD mode of operation is applicable to delete a virtual concatenated (VCAT) member cross-connect in Unlocked-Enabled or Locked-Disabled, AutomaticInService service states. |
|||
Force the system to override a state in which the command would normally be denied. |
|||
Execute the command normally. Do not override any conditions that may make the command fail. |
|||
(Optional) 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) 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. The parameter type is DIRECTION, which is the transmit and receive directions. |
|||
24.3 SW-TOWKG-EQPT
(Cisco ONS 15310 MA SDH and Cisco ONS 15454 SDH) The Switch to Working Equipment (SW-TOWKG-EQPT) command switches the active protect card back to working card.
NoteThe following modifiers are not supported on the Cisco ONS 15310 MA SDH platform: E4 and DS3i-N-12.
Usage Guidelines
- This command is used for electrical cards that can participate in an electrical group (for example, 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 is executed without an error. In a nonrevertive 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 the BTH or null value of the DIR> parameter. A command with any other value is considered an incorrect use of the command. An IDNV error message will be returned.
– This command is not used for the common control (TCC2, TCC2P, TCC3, XC-VXL-10G, XC-VXL-2.5G, or XC-VXC-10G) cards. A command on a common control card will return an IIAC error message. To switch common control cards, 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 error message. To switch an SDH card, 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 error message will be returned.
– If this command is sent to a missing working card, the SWFA error message will be returned.
– If this command is used on a protection card, the IIAC error message will be returned.
– If you send a mode parameter with a value other than NORM, FRCD, or null, the IDNV 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 error message.
– Sending the SW-TOWKG command to a working card when the protection card has raised INHSWWKG will return the SPLD error message.
– Sending the SW-TOWKG command to an active working card will return the SNVS error message.
Category
Security
Input Format
Input Example
SW-TOWKG-EQPT:CISCO:SLOT-2:123::FRCD,BTH;
|
|
|
|
|
|---|---|---|---|
Access identifier from the “PRSLOT” section. Specifies the working unit which will have traffic switched to protection. |
|||
(Optional) Command mode. Normal (NORM) mode is the default behavior for all commands but you can specify forced (FRCD) mode to force the system to override a state where the command would normally be denied. The FRCD mode of operation is applicable to delete a virtual concatenated (VCAT) member cross-connect in Unlocked-Enabled or Locked-Disabled, AutomaticInService service states. |
|||
Force the system to override a state in which the command would normally be denied. |
|||
Execute the command normally. Do not override any conditions that may make the command fail. |
|||
(Optional) 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. The parameter type is DIRECTION, which is the transmit and receive directions |
|||
Feedback