Cisco Cisco Prime Optical 10.6 Developer's Guide

Page of 665
Cisco Prime Optical 10.6 GateWay/CORBA Programmer Reference Guide 
 
 
127
 
Compliance 
TMF-defined. 
 
3.3.18  createTopologicalLinkWithYCableProtection 
Synopsis 
Description 
This interface enables an NMS to create a Y-cable topological link manually between two managed 
elements. A Y-cable link is a bidirectional link with one PTP source and two PTP destinations. Because 
of the limitation in TMF for topological links that have one PTP source and one PTP destination, Prime 
Optical reports two topological links for a Y-cable link. These two topological links have the same 
nativeEMSName. Se
 for the naming convention for the Y-cable topological 
link object name. The destination of the Y-cable link must be on a DWDM card on an ONS 15454 
SONET/SDH or ONS NCS2K SONET/SDH. 
Prime Optical generates two object creation event notifications when a new Y-cable topological link is 
created. 
The topological link returned by this method is one leg of the Y-cable.  
Parameters 
Name 
Type 
Input/ 
Output  Description 
createData 
topologicalLink:MTLCreateData_T  In 
Data structure containing details for 
creating a new Y-cable topological link. 
topologicalLink  topologicalLink::TopologicalLink_T  Out 
One leg of the created Y-cable 
topological link information. 
 
Prime Optical support for MTLCreateData_T structure is as follows: 
•  string userLabel 
-  Supported. The value of this field is assigned to the nativeEMSName of the newly created 
topological link. 
•  boolean forceUniqueness 
–  Prime Optical guarantees the uniqueness of topological link names. 
•  string owner 
–  Not supported. 
•  globaldefs::ConnectionDirection_T direction 
–  Supports only CD_BI for bidirectional links. 
•  transmissionParameters::LayerRate_T rate. Supported layer rates are: 
–  LR_Physical_2_5_Gigabit_ITU 
–  LR_Physical_10_Gigabit_ITU 
–  LR_DSR_OC3_STM1 
–  LR_DSR_OC12_STM4