User guide

3-148
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.19 addDrops
3.9.19 addDrops
Synopsis
void addDrops(
in globaldefs::NamingAttributes_T sncName,
in globaldefs::NamingAttributesList_T zEnd)
raises(globaldefs::ProcessingFailureException);
Description
This proprietary interface supports SNCs with multiple drops for the ONS 15310, ONS 15327, and
ONS 15454. There are two steps to create an SNC with multiple drops:
Step 1 Invoke the operation described in 3.9.16 createAndActivateSNCFromUserLabel, page 3-138 to create
a unidirectional SNC between two nodes.
Step 2 Invoke this operation to add new drop points to an existing SNC.
Note • The layer rate must match the SNC layer rate. This interface performs on a best-effort basis. If CTM
fails to add one or more TPs to the SNC, it generates an UNABLE_TO_COMPLY exception. The
errorReason contains a list of CTPs that failed.
• Depending on the card type, the terminology is CTP or FTP. For example, termination points on
CE-MR-6 cards are CTPs when the cards are configured for manual mode. For CE-MR-6 cards
configured for automatic mode, the termination points are FTPs.
Parameters
Throws
globaldefs::ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
EXCPT_INVALID_INPUT - Raised when sncName does not refer to an SNC object, or layer rate
of any CTP does not match the SNC layer.
EXCPT_ENTITY_NOT_FOUND - Raised when sncName references an object that does not exist.
EXCPT_UNABLE_TO_COMPLY – Raised if the CTP is in use by other SNC. This exception is also
raised when there is no bandwidth available.
EXCPT_NE_COMM_LOSS - Raised when communication to the managed element is lost, which
prevents the deactivation of the SNC.
Name Type Input/Output Description
sncName globaldefs::NamingAttributes_T In Name of the subnetwork connection to which to add
termination points (either CTPs or FTPs).
zEnd globaldefs::NamingAttributesList_T In List of additional termination points (either CTPs or
FTPs) to add to the SNC.