Cisco Cisco Prime Optical 9.8 Developer's Guide
Cisco Prime Optical 9.8 GateWay/CORBA Programmer Reference Guide
OL-29218-01
437
Compliance
TMF-defined.
3.14.4 performProtectionCommand
Synopsis
Description
This interface executes a protection switch. The protection switch can be performed through a
protection switch command on a protection group. Prime Optical requests the EMS to move
the traffic received from the fromTP to the toTP. The same command is used to clear all existing
commands. If there is more than one protection group with the same name, Prime Optical
returns the ProcessingFailureException UNABLE_TO_COMPLY.
protection switch command on a protection group. Prime Optical requests the EMS to move
the traffic received from the fromTP to the toTP. The same command is used to clear all existing
commands. If there is more than one protection group with the same name, Prime Optical
returns the ProcessingFailureException UNABLE_TO_COMPLY.
A protection switch command is used to change the flow of traffic from working to protect or
from protect to working entity. All entities that are represented as working entities before the
switch are still represented as working entities after the switch. Similarly, all entities that are
represented as protect entities before the switch are still represented as protect entities after
the switch.
from protect to working entity. All entities that are represented as working entities before the
switch are still represented as working entities after the switch. Similarly, all entities that are
represented as protect entities before the switch are still represented as protect entities after
the switch.
For 4-fiber SONET/SDH SPrings, the span switch is performed on the PGT_MSP_1_FOR_N
component protection group, and the ring switch on the PGT_4_FIBER_BLSR group. For
example, if the switch is on the east span, the PGP name is ring-ID-EAST.
component protection group, and the ring switch on the PGT_4_FIBER_BLSR group. For
example, if the switch is on the east span, the PGP name is ring-ID-EAST.
For 2-fiber ring switch, it can be either E -> W or W -> E.
For 4-fiber ring switch, it can be Ew (east working) -> Wp (west protecting), Ep -> Ww, Ww ->
Ep, and Wp -> Ew.
Ep, and Wp -> Ew.
For 4-fiber span switch, it can be Ew -> Ep, Ep ->Ew, Ww -> Wp, and Wp -> Ww.
Prime Optical validates whether or not fromTp and toTp are part of same protection group. If
this validation fails then it throws ProcessingFailureException with EXCPT_INVALID_INPUT.
Prime Optical always performs the command on the fromTp for PC_LOCKOUT and
PC_EXERCISE. Prime Optical also verifies if it is possible to perform the command; if not, it
throws EXCPT_UNABLE_TO_COMPLY.
this validation fails then it throws ProcessingFailureException with EXCPT_INVALID_INPUT.
Prime Optical always performs the command on the fromTp for PC_LOCKOUT and
PC_EXERCISE. Prime Optical also verifies if it is possible to perform the command; if not, it
throws EXCPT_UNABLE_TO_COMPLY.