User guide

3-134
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.12 getCTPsAndTopologicalLinks
EXCPT_INVALID_INPUT - Raised when subnetName does not reference a multiLayerSubnetwork
object.
EXCPT_ENTITY_NOT_FOUND - Raised when subnetName references a multiLayerSubnetwork object
that does not exist.
Compliance
TMF-defined.
3.9.12 getCTPsAndTopologicalLinks
Synopsis
void getCTPsAndTopologicalLinks(
in globaldefs::NamingAttributes_T sncName,
out terminationPoint::TerminationPointList_T ctpList,
out topologicalLink::TopologicalLinkList_T topologicalLinkList)
raises(globaldefs::ProcessingFailureException);
Description
The NMS provides the SNC name, and CTM returns ordered lists: one list for all CTPs/FTPs and another
for all topological links. CTM reports topological links and CTPs/FTPs of the working path for a 1+1,
2-fiber BLSR, or 4-fiber BLSR protected SNC. CTM reports topological links and CTPs/FTPs of both
the working and protect paths for a path-protection SNC. An SNC with the source or destination on
Ethernet equipment is also supported.
• For the ONS 15310, this method does not report STS-1 SNC on CTX using DS1 ports.
• For the ONS 15327, this method does not report STS-1 SNC on XTC using DS1 ports.
• For the ONS 15454 SONET, this method does not report STS-1 SNC on DS1 equipment.
• For the ONS 15454 SDH, this method does not report VC-4 SNC on E1 or E1_42 equipment.
This interface does not report VCAT SNCs.
The lists are unordered for circuits for which:
• The circuit state is not active.
• The circuit has DRI protection.
A processing failure exception is returned with an EXCPT_UNABLE_TO_COMPLY exception in all of
the preceding conditions.
Parameters
For details about the TerminationPoint_T structure, see 3.6.3 getAllSupportedPTPs, page 3-63.
For details about the TopologicalLink_T structure, see 3.3.5 getAllTopLevelTopologicalLinks,
page 3-23.
Name Type Input/Output Description
sncName globaldefs::NamingAttributes_T In Name of the subnetwork connection.
ctpList terminationPoint::TerminationPointList_T Out Ordered list of CTP/FTPs for this SNC.
topoList topologicalLink::TopologicalLinkList_T Out Ordered topological links through which this
SNC traverses.