User guide

3-26
Cisco Transport Manager Release 9.2 GateWay/CORBA User Guide and Programmer Manual
OL-20937-01
Chapter 3 Using CTM GateWay/CORBA Interfaces
3.3.7 getTopLevelTopologicalLink
Parameters
Throws
globaldefs::ProcessingFailureException
EXCPT_NOT_IMPLEMENTED - Raised if the EMS cannot support this service.
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
EXCPT_TOO_MANY_OPEN_ITERATORS - Raised when the maximum number of iterators reaches 128.
Compliance
TMF-defined.
3.3.7 getTopLevelTopologicalLink
Synopsis
void getTopLevelTopologicalLink(
in globaldefs::NamingAttributes_T topoLinkName,
out topologicalLink::TopologicalLink_T topoLink)
raises(globaldefs::ProcessingFailureException);
Description
This interface enables an NMS to request the top-level topological link if its name is under the control
of the EMS.
If a link that is under the control of the EMS is removed from the NE, the ProvType parameter is reported
as INVALID.
Parameters
Throws
globaldefs::ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
EXCPT_INVALID_INPUT - Raised when topoLinkName does not reference a top level topological
link object.
Name Type Input/Output Description
how_many unsigned long In Maximum number of top-level topological links to return in
the first batch.
nameList globaldefs::NamingAttributes
List_T
Out First batch of top-level topological link names.
nameIt globaldefs::NamingAttributesI
terator_I
Out Iterator to retrieve the remaining top-level topological link
names.
Name Type Input/Output Description
topoLinkName globaldefs::NamingAttributes_T In Name of the topological link.
topoLink TopologicalLink::TopologicalLink_T Out Top-level topological link.