User guide

3-280
Cisco Transport Manager Release 9.2 GateWay/CORBA User Guide and Programmer Manual
OL-20937-01
Chapter 3 Using CTM GateWay/CORBA Interfaces
3.14.4 performProtectionCommand
Parameters
For details about the ProtectionGroup_T structure, see 3.14.2 getAllProtectionGroups, page 3-277.
Throws
globaldefs::ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
EXCPT_INVALID_INPUT - Raised when protectionGroupName does not reference a protection
group.
EXCPT_ENTITY_NOT_FOUND - Raised when meName references an object that does not exist.
EXCPT_NE_COMM_LOSS - Raised when communication to the managed element is lost.
Compliance
TMF-defined.
3.14.4 performProtectionCommand
Synopsis
void performProtectionCommand(
in ProtectionCommand_T protectionCommand,
in globaldefs::NamingAttributes_T reliableSinkCtpOrGroupName,
in globaldefs::NamingAttributes_T fromTp,
in globaldefs::NamingAttributes_T toTp,
out SwitchData_T switchData)
raises(globaldefs::ProcessingFailureException);
Description
This interface executes a protection switch. The protection switch can be performed through a protection
switch command on a protection group. CTM 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, CTM 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.
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.
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.
Name Type Input/Output Description
pgName globaldefs::NamingAttributes_T In Name of the protection group that the client is
interested in.
protectiongroup ProtectionGroup_T Out Returned protection group.