Cisco Cisco Prime Optical 9.6 Developer's Guide

Page of 818
Cisco Prime Optical 9.6.3 GateWay/CORBA Programmer Reference Guide 
OL-28047-01
 
 
521
 
4.5.3.2  deleteFlowDomain 
Synopsis 
public void deleteFlowDomain(NameAndStringValue_T[] fdName, 
                               TPDataList_THolder tpsToModify, 
                               StringHolder errorReason) 
      throws ProcessingFailureException 
Description 
This interface enables the NMS to request the EMS to delete an FD. 
Parameters 
•  NamingAttributes_T fdName—The name of the FD to be deleted. 
•  TPDataList_T tpsToModify: 
–  in—The list of TPs with associated parameters to be applied. 
–  out—The list of TPs with associated applied parameters. 
•  string errorReason—Specifies the reason for the fault, if any. 
Throws 
Raises ProcessingFailureException 
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure. 
EXCPT_INVALID_INPUT - Raised when any input parameter is syntactically 
incorrect. For example, the fdName attribute does not refer to an FD object. 
EXCPT_OBJECT_IN_USE - Raised when the FD contains at least one FDFr. 
EXCPT_ENTITY_NOT_FOUND - Raised when the fdName attribute references an object 
that does not exist. 
EXCPT_UNABLE_TO_COMPLY - Raised when an associated fdEdge CPTP or MFD could 
not be disassociated. 
EXCPT_NE_COMM_LOSS - Raised when communication is lost to an ME involved in 
this operation. 
Use Case Description 
This interface allows an NMS to delete an existing FD. The EMS verifies that no FDFr exists 
within the FD. The operation disassociates the fdEdge CPTPs and MFDs, and deletes the FD. 
The following describes how the system requests to delete an FD: 
1.  The NMS sends the request to the EMS to delete an FD. 
2.  The EMS validates the request:  
a.  If the syntax is incorrect, an Invalid Input exception is raised. 
b.  If the FD object is unknown to the EMS, an Entity Not Found exception is raised. 
c.  If any FDFr is used in the FD, an Object In Use exception is raised. 
d.  If any of the MFDs cannot be disassociated from the specified FD, no MFD is 
disassociated and an Unable To Comply exception is raised.