User guide

3-129
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.6 getAllSubnetworkConnectionsWithTP
Description
This interface enables an NMS to request a list of the SNCs using the specified TP at the specified
connection rates. A TP might be a PTP that requires a full list of SNCs using any of its contained CTPs.
A TP might be a CTP or FTP that only requires the SNCs using that CTP or FTP. Both end CTPs and
intermediate CTPs at the same layer are considered. In all cases, only SNCs that also match the specified
connection rate filter are returned.
• For the ONS 15310 MA SONET, this method does not report STS-1 SNC on DS1 ports of DS1_xx
cards.
• For the ONS 15310 MA SDH, this method does not report VC4 SNC on E1 ports of E1_63_E3_3
cards.
• 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 SNCs with duplicate names.
Note For ONS 15600 SONET and ONS 15600 SDH NEs, if bridge-and-roll is applied, one CTP may be
associated with two SNCs during a transient phase. If CTM invokes this method during this phase, it
reports both SNCs.
Parameters
For details about the SubnetworkConnection_T structure, see 3.8.2 getAllSNCs, page 3-83.
Throws
globaldefs::ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
EXCPT_INVALID_INPUT - Raised if tpName does not reference a termination point object.
EXCPT_ENTITY_NOT_FOUND - Raised when tpName references an object that does not exist.
EXCPT_TOO_MANY_OPEN_ITERATORS - Raised when the maximum number of iterators reaches 128.
Compliance
TMF-defined.
Name Type Input/Output Description
tpName globaldefs::NamingAttributes_
T
in Termination point for which to report SNCs.
connectionLayerRateList transmissionParameters::Layer
RateList_T
in List of rates of the SNCs to report. If an empty
list is specified, all SNCs of all rates are
reported.
how_many unsigned long in Maximum number of SNCs to report in the first
batch.
sncList subnetworkConnection::Subne
tworkConnectionList_T
out First batch of SNCs.
sncIt subnetworkConnection::SNCIt
erator_I
out Iterator to retrieve the remaining SNCs.