User guide

3-27
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.8 createTopologicalLink
EXCPT_ENTITY_NOT_FOUND - Raised when topoLinkName references a top level topological link
object that does not exist in the EMS.
Compliance
TMF-defined.
3.3.8 createTopologicalLink
Synopsis
void createTopologicalLink(
in topologicalLink::TLCreateData_T createData,
out topologicalLink::TopologicalLink_T topologicalLink)
raises(globaldefs::ProcessingFailureException);
Description
This interface enables an NMS to create a topological link manually between two MEs. CTM supports
topological link creation between MEs belonging to the same multilayer subnetwork. If CTM
autodiscovers a topological link between two endpoints on which a manually created link exists, CTM
overwrites the manually created topological link information with the autodiscovered topological link
information. CTM generates an attribute value change event when a manually created link is overwritten
with autodiscovered topological link information. CTM supports topological link creation between two
unmanaged NEs, and also between a managed NE and an unmanaged NE. CTM ignores the topological
link layer rate if the topological link creation is between two unmanaged NEs.
CTM generates an object creation event notification when a new topological link is created.
Note CTM creates topological links between two PTPs even if there are no existing physical link connections
in the network. To enable SDCC on the topological link, the NMS must ensure the presence of physical
link connectivity.
Parameters
CTM support for TLCreateData_T structure is as follows:
• string userLabel
– Supported. The value of this field is assigned to the name of the newly created topological link.
For patchcord links, CTM assigns the link name. The user label that is passed as input is ignored
for patchcord links.
• boolean forceUniqueness
– CTM guarantees the uniqueness of topological link names.
• string owner
– Not supported.
• globaldefs::ConnectionDirection_T direction
Name Type Input/Output Description
createData topologicalLink::TLCreateData_T In Data structure containing details for
creating new topological links.
topologicalLink topologicalLink::TopologicalLink_T Out Created topological link information.