User guide

3-139
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.16 createAndActivateSNCFromUserLabel
if any one of the specified MEs or PTPs does not exist. If the NMS specifies a PTP list, CTM verifies
whether PTPs are specified in pairs and each PTP of a PTP pair is associated with each end PTP of the
same topological link. CTM uses the first PTP of a PTP pair as the aEnd of the topological link, and uses
the second PTP of the same PTP pair as the zEnd of the topological link. CTM attempts to route the SNC
from the aEnd PTP of a PTP pair to the zEnd PTP of the same pair on a topological link. CTM returns
a processing failure exception if the SNC cannot be routed from the specified aEnd PTP to the zEnd PTP
of a topological link. The NMS then must interchange the aEnd PTP and zEnd PTP specified, or provide
a different PTP pair, or delete the PTP pair from the include or exclude list. CTM returns a processing
failure exception if at least one PTP is not associated with a topological link. The NMS must ensure that
the sequence of the object name list conforms to the sequence of the objects that exist in the network.
CTM returns a processing failure exception if the sequence is nonconforming.
In addition to specifying SNC creation parameters using the SNCCreateData_T structure, the NMS can
provide a complete list of CTP pairs representing the complete route of the SNC. Each CTP pair
represents the two endpoints of one span in the SNC route. A span represents a partial route of an SNC
with the endpoints specified on the endpoints of a topological link. CTM processes the input list in CTP
pairs. CTM assumes each pair represents the two endpoints of a span, and the CTP native names are the
same for the two endpoints (the STS numbers are the same for each CTP pair). The NMS must ensure
that the sequence of spans represented by the CTP pairs conforms to the sequence existing in the
network. CTM returns a processing failure exception if the sequence is nonconforming.
If you create an SNC with at least one endpoint on ML-series equipment, CTM identifies the SNC for a
new Layer 2 point-to-point topology. CTM creates a new Layer 2 point-to-point topology and an object
creation event is generated to notify for the creation of a new L2 point-to-point topology in CTM.
CTM provides support for the creation of open-ended path-protection circuits. There are two types of
SNCs that can be created for open-ended path-protection circuits.
For one source point and two destination endpoints, the NMS must specify the source point in
SNCCreateData_T.aEnd, and the two destination endpoints in SNCCreateData_T.zEnd.
For two source points and one destination endpoint, the NMS must specify two source points in
SNCCreateData_T.aEnd and one destination endpoint in SNCCreateData_T.zEnd.
CTM supports optical channel SNC creation on WDM cards through this method. See 2.2.7.4 SNC
Provisioning on WDM Equipment, page 2-43 for detailed information. The sncSize field in
additionalCreationInfo is used to specify the size of the optical channel SNC.
CTM supports OCH trail SNC creation on DWDM transponder/muxponder cards or ITU-T line cards
through a DWDM network. See 2.2.7.4 SNC Provisioning on WDM Equipment, page 2-43.
For the ONS 15454 SONET, this operation enables you to create an end-to-end STS-1 circuit using the
portless transmux interfaces of the transmux card as an intermediate connection point. Information about
the high-density portless transmux card (DS3XM-12) can be provided using the usePortlessTransmux,
portlessTransmuxMeName, portlessTransmuxSlot, and isSourceDS3MappedSTS attributes in the
additionalCreationInfo field.
Parameters
Name Type Input/Output Description
createData subnetworkConnection::SNCC
reateData_T
In Structure describing the SNC to create and
activate.
tolerableImpact subnetworkConnection::Grade
sOfImpact_T
In Maximum tolerable impact allowed.
emsFreedomLevel EMSFreedomLevel_T In Maximum level of freedom allowed to the EMS to
perform the creation and activation.