User guide

3-161
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.31 getValidSubnetworkConnectionsForMerge
EXCPT_ENTITY_NOT_FOUND - Raised when vcatName references an object that does not exist.
EXCPT_UNABLE_TO_COMPLY - Raised when deletion of member SNC(s) from the VCAT fails.
Compliance
CTM-defined.
3.9.31 getValidSubnetworkConnectionsForMerge
Synopsis
void getValidSubnetworkConnectionsForUpgrade(
in multiLayerSubnetwork::SncUpgradeInfo_T details,
in multiLayerSubnetwork::SncFilterCriteria_T filterCriteria,
in globaldefs::NamingAttributes_T masterSncName,
in globaldefs::NamingAttributesList_T candidateSncList,
in unsigned long how_many,
out subnetworkConnection::SubnetworkConnectionList_T mergeableSncList,
out subnetworkConnection::SNCIterator_I sncIt )
raises(globaldefs::ProcessingFailureException);
Description
This interface is used to get the list of SNCs for the Merge operation. The SncFilterCriteria specifies the
SNCs that are requested. These SNCs are lined up. The master SNC name specifies the name of the SNC
with which the candidates will merge. The how_many parameter provides the list of SNCs that will be
returned.
Note The valid SncUpgradeInfo value supported by CTM GateWay/CORBA is Merge. The valid
SncFilterCriteria value supported by CTM GateWay/CORBA is LINED_UP. The available values that
will be supported in the future are listed in the ENUM definitions in the following table.
Parameters
Name Type Input/Output Description
details multiLayerSubnetwork::SncUpgr
adeInfo_T
In Upgrade info for which the list of SNCs is
requested. Available values are:
• Merge
• Reconfigure
Note CTM GateWay/CORBA R9.2 supports
only Merge.
filterCriteria multiLayerSubnetwork::SncFilte
rCriteria_T
In The filter criteria can be used to specify if the
requested SNCs are LINED_UP or nonfiltered.
Note CTM GateWay/CORBA R9.2 supports
only LINED_UP.
masterSncName globaldefs::NamingAttributes_T In This parameter is used to specify the name of the
SNC to merge or upgrade with the following
candidate SNCs.
candidateSncList globaldefs::NamingAttributesLis
t_T
In This parameter gives a list of SNCs to merge
with the master SNC.