Cisco Cisco Prime Optical 9.6 Developer's Guide

Page of 818
Cisco Prime Optical 9.6.3 GateWay/CORBA Programmer Reference Guide 
OL-28047-01
 
 
441
 
Throws 
globaldefs::ProcessingFailureException 
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure. 
EXCPT_INVALID_INPUT - Raised when pgName does not reference a protection group 
object. 
EXCPT_ENTITY_NOT_FOUND - Raised when pgName references an object that does not 
exist. 
EXCPT_NE_COMM_LOSS - Raised when communication to the managed element is lost. 
EXCPT_TOO_MANY_OPEN_ITERATORS - Raised when the maximum number of iterators 
reaches 128. 
Compliance 
TMF-defined. 
3.14.2  getAllProtectionGroups  
Synopsis 
void getAllProtectionGroups( 
in globaldefs::NamingAttributes_T meName, 
      in unsigned long how_many, 
      out ProtectionGroupList_T pgList, 
      out ProtectionGroupIterator_I pgpIt) 
    raises(globaldefs::ProcessingFailureException); 
Description 
This interface is used by the client to discover all of the protection groups currently in operation 
for the ME. Note that Prime Optical does not have any protection groups for path protection. 
The supported protection group types are PGT_MSP_1_FOR_N, PGT_MSP_1_PLUS_1, 
PGT_2_FIBER_BLSR, PGT_4_FIBER_BLSR, and PGT_Y_CABLE. 
The following table lists default names for the protection groups when created through CTC. 
PGT_MSP_1_FOR_1
 
Slot n (Equipment Native Name), where n represents the slot number of the 
protecting equipment. For example, slot 3 (DS3IN).
 
PGT_MSP_1_FOR_N
 
Slot n (Equipment Native Name), where n represents the slot number of the 
protecting equipment. For example, slot 3 (DS3XM).
 
PGT_MSP_1_PLUS_1
 
Slot n (Equipment Native Name), port m, where n represents the slot number 
and m represents the protecting port number. For example, slot 5 (OC3), port 
1.
 
PGT_2_FIBER_BLSR
 
No defaults; the name is a user-specified ring ID from 1 to 9999.
 
PGT_4_FIBER_BLSR
 
No defaults; the name is a user-specified ring ID from 1 to 9999.
 
PGT_Y_CABLE
 
SHELF N SLOT M PORT O, where N represents the shelf number, M represents 
the slot number, and O represents the protecting port number.