User guide

3-149
Cisco Transport Manager Release 9.2 GateWay/CORBA User Guide and Programmer Manual
OL-20937-01
Chapter 3 Using CTM GateWay/CORBA Interfaces
3.9.20 deactivateAndDeleteSNC
Compliance
CTM-defined.
3.9.20 deactivateAndDeleteSNC
Synopsis
void deactivateAndDeleteSNC(
in globaldefs::NamingAttributes_T sncName,
in subnetworkConnection::GradesOfImpact_T tolerableImpact,
in EMSFreedomLevel_T emsFreedomLevel,
inout subnetworkConnection::TPDataList_T tpsToModify,
out subnetworkConnection::SubnetworkConnection_T theSNC,
out string errorReason)
raises(globaldefs::ProcessingFailureException);
Description
This interface provides a way to deactivate and then delete a subnetwork connection in one operation.
CTM removes resources allocated to this SNC from each node. Successful completion of this
asynchronous operation guarantees only delivery of the deletion request to CTM. The NMS waits for an
OBJECT_DELETION event for the SNC.
CTM performs this operation in two steps:
1. The first step is validation. This is performed synchronously. If successful, this operation returns
successfully. If validation fails, the NMS receives an exception.
2. After a successful validation, the second step is the actual deletion of resources from all NEs. This
step is performed asynchronously. CTM changes the SNC state to SNCS_DELETING and sends a
notification to the NMS. Upon successful completion, CTM generates an OBJECT_DELETION
event. If CTM 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, CTM
generates an AVC event. These SNC state change events are generated as part of the CTM operation
only. If another interface is used, CTM cannot generate these events.
Parameters
For details about the SubnetworkConnection_T structure, see 3.8.2 getAllSNCs, page 3-83.
Name Type Input/Output Description
sncName globaldefs::NamingAttributes_T In Name of the subnetwork connection to
deactivate and delete.
tolerableImpact subnetworkConnection::GradesOfImpact_T In CTM ignores this parameter.
emsFreedomLevel EMSFreedomLevel_T In CTM ignores this parameter.
tpsToModify subnetworkConnection::TPDataList_T In/out CTM ignores this parameter.
theSNC subnetworkConnection::SubnetworkConne
ction_T
Out Deactivated and deleted subnetwork
connection.
errorReason string Out Specifies the deactivation and/or
deletion error(s), if any.