User guide

3-103
Cisco Transport Manager Release 9.2 GateWay/CORBA User Guide and Programmer Manual
OL-20937-01
Chapter 3 Using CTM GateWay/CORBA Interfaces
3.8.19 getAllSrcCTPsForSNCProvisioning
Throws
globaldefs::ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
EXCPT_ENTITY_NOT_FOUND - Raised if the managed element does not exist.
EXCPT_INVALID_INPUT - Raised when layerRate or direction are invalid.
EXCPT_NE_COMM_LOSS - Raised when communication to the managed element is lost.
Compliance
CTM-defined.
3.8.19 getAllSrcCTPsForSNCProvisioning
Synopsis
void getAllSrcCTPsForSNCProvisioning(
in globaldefs::NamingAttributes_T ptpName,
in transmissionParameters::LayerRate_T layerRate,
in globaldefs::ConnectionDirection_T direction,
in unsigned long how_many,
out globaldefs::NamingAttributesList_T tpList,
out globaldefs::NamingAttributesIterator_I tpIt)
raises(globaldefs::ProcessingFailureException);
Description
This interface returns a list of CTP names that can be used as the source of an SNC to create on a given
ME. The NMS must specify the layer rate and the direction of the SNC to create. This interface does not
reserve resources for SNC creation; rather, this method returns a CTP name list based on current resource
availability. The actual SNC creation might still fail. Values returned by this list can be used as aEnd in
the SNCCreateData_T parameter of the createAndActivateSNCFromUserLabel method described in
3.9.16 createAndActivateSNCFromUserLabel, page 3-138.
Parameters
For a list of supported layer rates, see 2.2.1 Layer Rate, page 2-23.
Name Type Input/Output Description
ptpName globaldefs::NamingAttributes_T In Name of the PTP that is the source of the SNC to
create.
layerRate transmissionParameters::LayerRate_T In Layer rate at which the SNC is created. All CTP
names available at this layer rate are returned.
direction globaldefs::ConnectionDirection_T In CTM supports CD_UNI (unidirectional) or CD_BI
(bidirectional).
how_many unsigned long In Maximum number of CTP names to report in the
first batch.
tpList globaldefs::NamingAttributesList_T Out First batch of CTP names.
tpIt globaldefs::NamingAttributesIterator_I Out Iterator to retrieve remaining CTP names.