Cisco Cisco Prime Optical 9.8 Developer's Guide

Page of 762
Cisco Prime Optical 9.8 GateWay/CORBA Programmer Reference Guide 
OL-29218-01
 
 
286
 
Description 
This interface provides a way to deactivate and then delete a subnetwork connection in one 
operation. 
The ports admin state is forced to ‘OOS, DSBLD’ (for SDH nodes ‘LOCKED, DISABLED’) upon 
successful deletion of non MPLS SNCs. 
Prime Optical removes resources allocated to this SNC from each node. Successful completion 
of this asynchronous operation guarantees only delivery of the deletion request to Prime 
Optical. The NMS waits for an OBJECT_DELETION event for the SNC.  
Prime Optical performs this operation in two steps:  
•  The first step is validation. This is performed synchronously. If successful, this operation 
returns successfully. If validation fails, the NMS receives an exception.  
•  After a successful validation, the second step is the actual deletion of resources from all 
NEs. This step is performed asynchronously. Prime Optical changes the SNC state to 
SNCS_DELETING and sends a notification to the NMS. Upon successful completion, Prime 
Optical generates an OBJECT_DELETION event. If Prime Optical loses connectivity to one or 
more nodes on the SNC, it aborts the cleanup and generates an SNCS_PARTIAL state change 
event. The NMS must reinvoke this method when connectivity to the node is restored. If the 
deletion fails but the state remains SNCS_ACTIVE, Prime Optical generates an AVC event. 
These SNC state change events are generated as part of the Prime Optical operation only. If 
another interface is used, Prime Optical cannot generate these events. 
Parameters 
Name
 
Type
 
Input/ 
Output
 
Description
 
sncName
 
globaldefs::NamingAttributes_T
 
In
 
Name of the subnetwork 
connection to deactivate and 
delete.
 
tolerableImpact
 
subnetworkConnection::GradesOfIm
pact_T
 
In
 
Prime Optical ignores this 
parameter.
 
emsFreedomLevel
 
EMSFreedomLevel_T
 
In
 
Prime Optical ignores this 
parameter.
 
tpsToModify
 
subnetworkConnection::TPDataList_
T
 
In/out
 
Prime Optical ignores this 
parameter.
 
theSNC
 
subnetworkConnection::Subnetwork
Connection_T
 
Out
 
Deactivated and deleted 
subnetwork connection.
 
errorReason
 
string
 
Out
 
Specifies the deactivation 
and/or deletion error(s), if any.
 
For details about the SubnetworkConnection_T structure, see