User guide

3-116
Cisco Transport Manager Release 9.2 GateWay/CORBA User Guide and Programmer Manual
OL-20937-01
Chapter 3 Using CTM GateWay/CORBA Interfaces
3.8.33 getRollFromCTPs
Parameters
Throws
globaldefs::ProcessingFailureException
EXCPT_UNABLE_TO_COMPLY - Raised if the managed element is in the initial poll state or in
config synchronization state.
EXCPT_ENTITY_NOT_FOUND - Raised if the managed element does not exist.
EXCPT_INVALID_INPUT - Raised if the managed element name is invalid.
EXCPT_NE_COMM_LOSS - Raised when communication to the managed element is lost.
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
Compliance
CTM-defined.
3.8.33 getRollFromCTPs
Synopsis
void getRollFromCTPs(
in globaldefs::NamingAttributes_T meName,
in globaldefs::NamingAttributesList_T sncNames,
in globaldefs::NamingAttributes_T fixCTPName,
in unsigned long how_many,
out globaldefs::NamingAttributesList_T tpList,
out globaldefs::NamingAttributesIterator_I tpIt)
raises(globaldefs::ProcessingFailureException);
Description
This interface returns a list of rollFromCTPNames after selecting the fixed point of the roll. This is
needed for path-protection SNCs and SNCs that have a secondary source, because multiple rollFromCTP
values are possible.
This interface also returns a list of CTPs that can be used to populate the rollFromCTP data structure in
the RollCreateData_T data structure.
Name Type Input/Output Description
ptpName globaldefs::NamingAttributes_T In Name of the PTP for which the list of CTPs is
obtained for roll provisioning.
how_many Unsigned In Maximum number of PTPs to report in the first
batch.
sncNames globaldefs::NamingAttributesList_T In Name of the SNC to roll over. If more than one
SNC is specified, the first SNC becomes the
RollFrom SNC and the second SNC becomes the
RollToSNC.
tpList globaldefs::namingAttributesList_T Out First batch of CTP names.
tpIt globaldefs::NamingAttributesIterator_I Out Iterator to retrieve remaining CTP names.