User guide

3-192
Cisco Transport Manager Release 9.2 GateWay/CORBA User Guide and Programmer Manual
OL-20937-01
Chapter 3 Using CTM GateWay/CORBA Interfaces
3.10.12 getAllAssociatedSNCs
EXCPT_TOO_MANY_OPEN_ITERATORS - Raised when the EMS reaches the maximum number of
iterators that it can support.
Compliance
CTM-defined.
3.10.12 getAllAssociatedSNCs
Synopsis
void getAllAssociatedSNCs(
in globaldefs::NamingAttributes_T l2TopologyName,
in unsigned long how_many,
out subnetworkConnection::SubnetworkConnectionList_T sncList,
out subnetworkConnection::SNCIterator_I sncIt,
out subnetworkConnection::VCATList_T vcatList,
out subnetworkConnection::VCATIterator_I vcatIt)
raises(globaldefs::ProcessingFailureException);
Description
This interface allows CTM to report all the underlying Layer 1 SONET/SDH SNCs that are being used
by the specified L2 topology.
Parameters
For details about the SubnetworkConnection_T structure, see 3.8.2 getAllSNCs, page 3-83.
For details about the VCAT_T structure, see 3.9.21 getVCATSNC, page 3-150.
Throws
globaldefs::ProcessingFailureException
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
EXCPT_INVALID_INPUT - Raised when l2TopologyName does not reference an L2 topology object.
EXCPT_ENTITY_NOT_FOUND - Raised when l2TopologyName references an L2 topology object that
does not exist.
EXCPT_TOO_MANY_OPEN_ITERATORS - Raised when the maximum number of iterators reaches 128.
Name Type Input/Output Description
l2TopologyName globaldefs::NamingAttributes_T In L2 topology name for which to obtain all the
SNCs.
how_many unsigned long In Maximum number of SNCs to return in the
first batch.
sncList subnetworkConnection::SubnetworkCon
nectionList_T
Out First batch of SNCs.
sncIt subnetworkConnection::SNCIterator_I Out Iterator to retrieve the remaining SNCs.
vcatList subnetworkConnection::VCATList_T Out First batch of VCAT SNCs.
vcatIt subnetworkConnection::VCATIterator_I Out Iterator to retrieve the remaining VCAT
SNCs.