User guide

3-29
Cisco Transport Manager Release 9.2 GateWay/CORBA User Guide and Programmer Manual
OL-20937-01
Chapter 3 Using CTM GateWay/CORBA Interfaces
3.3.9 createTopologicalLinkWithYCableProtection
[0] name = linkProtectionType value = PROT_UNPROTECTED
[1] name = linkCost value = 1024
[2] name = provType value = PATCHCORD
[3] name = zEndSecSrc value = name='EMS';value='Cisco
Systems/CTM';name='ManagedElement';value='15454-ANSI-68-8';name='PTP';value='/rack=1/shelf
=1/slot=13/port=10'
[4] name = aEndSecDst value = name='EMS';value='Cisco
Systems/CTM';name='ManagedElement';value='15454-ANSI-68-9';name='PTP';value='/rack=1/shelf
=1/slot=15/port=1'
In both of these examples, if the operator supplies any wrong parameters for secondary source/drop
ports, the CTM Gateway/CORBA interface returns an exception that reports the list of actual available
ports retrieved from the ME, such as the following:
java.lang.String errorReason=The secondary PTP /rack=1/shelf=1/slot=15/port=10 does not
belong to the list of available PTPs: /rack=1/shelf=1/slot=15/port=1,
/rack=1/shelf=1/slot=15/port=2, /rack=1/shelf=1/slot=15/port=3,
/rack=1/shelf=1/slot=15/port=4, /rack=1/shelf=1/slot=15/port=5,
/rack=1/shelf=1/slot=15/port=6, /rack=1/shelf=1/slot=15/port=7,
/rack=1/shelf=1/slot=15/port=8
If you do not provide a secondary source PTP, the primary link between the AendTP and the ZendTP is
successfully created. However, while creating the reverse link, the CTM Gateway/CORBA interface tries
using the secordary source as the first element from the list of available PTPs returned by the ME/NCP
layer (for example, /rack=1/shelf=1/slot=15/port=1). If such a PTP port is still available, the reverse link
is created properly; otherwise, CTM throws an exception.
It is recommended that you specify a secondary source PTP. If you do not specify the secondary source
PTP, CTM Gateway/CORBA, by default, uses the first item from the list of available PTPs. However,
the element may also be invalid.
You have to specify the desired PTP in the additional creation info list in case of the availability of
multiple choices.
Throws
globaldefs::ProcessingFailureException
EXCPT_NOT_IMPLEMENTED - Raised if input createData is not valid.
EXCPT_INVALID_INPUT - Raised if the EMS cannot support this service.
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
Compliance
CTM-defined.
3.3.9 createTopologicalLinkWithYCableProtection
Synopsis
void createTopologicalLinkWithYCableProtection(
in topologicalLink::MTLCreateData_T createData,
out topologicalLink::TopologicalLink_T topologicalLink)
raises(globaldefs::ProcessingFailureException);