Cisco Cisco Prime Optical 10.3 Developer's Guide
Cisco Prime Optical 10.3 GateWay/CORBA Programmer Reference Guide
254
Name
Type
Input/
Output
Output
Description
topological link to retrieve.
topoLink
topologicalLink::TopologicalLink_T
Out
Subnetwork topological link
returned.
returned.
For details about the TopologicalLink_T structure,
see
Throws
Compliance
TMF-defined.
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.
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.