Cisco Cisco Prime Optical 10.6 Developer's Guide

Page of 665
Cisco Prime Optical 10.6 GateWay/CORBA Programmer Reference Guide 
 
 
300
 
Description 
This interface returns the L2 topology structure associated with a given ML VLAN name. Prime Optical 
returns an empty L2Topology_T structure if the ML VLAN name specified is currently not associated 
with any L2 topology in the EMS. 
Parameters 
Name 
Type 
Input/Output  Description 
mlVlanName  globaldefs::NamingAttributes_T 
In 
Name of the ML VLAN to 
retrieve containing the L2 
topology. 
l2Topo 
multiLayerSubnetwork::L2Topology_T  Out 
Retrieved L2 topology. 
For details about the L2Topology_T structure, see 
. 
Throws 
Compliance 
Prime Optical-defined. 
3.10.16 createL2Topology 
Synopsis 
Description 
This interface provides a way to create an L2 topology, including all the optical SNCs associated with it. 
The user must associate ML VLANs using the interface method defined i
. Prime 
Optical creates an L2 topology within the same MultiLayerSubnetwork. If the NMS specifies the L2 
topology createData with MEs belonging to a different MultiLayerSubnetwork, Prime Optical returns the 
ProcessingFailureException EXCPT_UNABLE_TO_COMPLY. 
Prime Optical supports point-to-point, hub-and-spoke, Resilient Packet Ring (RPR), and 802.17 RPR 
topologies. However, Prime Optical supports the creation of only RPR, 802.17 RPR, and point-to-point 
topologies. Prime Optical treats a hub-and-spoke topology as multiple point-to-point topologies.  
This is an asynchronous operation. Prime Optical returns this method after all requests for creating the 
underlying SNCs are complete. Prime Optical autodiscovers an L2 topology based on the L1 SNCs 
created. Prime Optical generates OCE for all the L1 SNCs created. Prime Optical also generates L2 
topology OCE after the L2 Topology is autodiscovered. 
To create an RPR or 802.17 RPR topology, you must specify the complete list of ML-series and/or ML2 
(L2/L3) equipment names to involve in the topology. RPR consists of all ML-series equipment or all 
ML2 (L2/L3) equipment or a combination of ML and ML2 (L2/L3) equipment. To create a point-to-point 
topology, you must specify the end TPs of the underlying L1 SNC. 
During the L2 topology creation, if any part of the underlying L1 SNC creation fails, Prime Optical 
generates a processing failure exception. However, Prime Optical autodiscovers the L2 topology in