Cisco Cisco Prime Optical 10.6 Developer's Guide

Page of 665
Cisco Prime Optical 10.6 GateWay/CORBA Programmer Reference Guide 
 
 
245
 
Description 
This interface returns a topological link. Prime Optical reports all autodiscovered and manual topological 
links. 
Parameters 
Name 
Type 
Input/ 
Output 
Description 
topoLinkName  Globaldefs::NamingAttributes_T 
In 
Name of the subnetwork 
topological link to retrieve. 
topoLink 
topologicalLink::TopologicalLink_T  Out 
Subnetwork topological link 
returned. 
 
For details about the TopologicalLink_T structure,
 
see
. 
Throws 
Compliance 
TMF-defined. 
3.9.16  createAndActivateSNCFromUserLabel 
Synopsis 
Description 
This interface provides a way to create and activate a subnetwork connection in one command. It is Prime 
Optical-specific and not TMF-defined. According to the TMF, the SNC name is assigned by the EMS 
when it creates the SNC. However, if the NMS is to control the SNC name, it must use this method. The 
NMS provides the name of the SNC in the userLabel field of the SNCCreateData input parameter. Prime 
Optical uses the userLabel value and assign it to the name of the new SNC. Prime Optical also verifies the 
uniqueness of the name. The operation fails if an SNC with the same name as the userLabel exists. This is 
an asynchronous operation. Successful completion of this operation only guarantees delivery of the 
creation request to Prime Optical. Operation on CTPs of this SNC might still fail. 
Optionally, you can also provide a description for the SNC by entering it in the additionalCreationInfo 
field. 
Prime Optical cleans up resources if SNC creation fails. For example, if Prime Optical fails to create the 
SNC on the destination node, Prime Optical also cleans up resources on the source node.