Cisco Cisco Prime Optical 10.6 Developer's Guide
Cisco Prime Optical 10.6 GateWay/CORBA Programmer Reference Guide
272
3.9.33 createRoll
Synopsis
Description
Prime Optical supports roll creation on optical CTPs. Electrical CTPs and FTPs are not supported for
bridge and roll creation.
Prime Optical generates an Object Creation event for the roll created and subnetwork connections created
as part of the roll creation. The subnetwork connections that are created as part of the roll creation will be
named as nativeEMSName of the SNC appended with _ROLL** where ** is a number.
The creation of bridge and roll is an asynchronous process. If the operation fails, Prime Optical cleans up
all resources. For example, if Prime Optical fails to create a bridge and roll on one node, it also cleans up
resources on other nodes.
Parameters
Name
Prime Optical supports roll creation on optical CTPs. Electrical CTPs and FTPs are not supported for
bridge and roll creation.
Prime Optical generates an Object Creation event for the roll created and subnetwork connections created
as part of the roll creation. The subnetwork connections that are created as part of the roll creation will be
named as nativeEMSName of the SNC appended with _ROLL** where ** is a number.
The creation of bridge and roll is an asynchronous process. If the operation fails, Prime Optical cleans up
all resources. For example, if Prime Optical fails to create a bridge and roll on one node, it also cleans up
resources on other nodes.
Parameters
Name
Type
Input/
Output
Output
Description
rollCreateData multiLayerSubnetwork::RollCreateData_T In
Structure describing the roll
to create.
to create.
For details about the Roll_T structure, see
Prime Optical support for RollCreateData_T is as follows:
• multiLayerSubnetwork::RollType_T rollType
– Supported.
• multiLayerSubnetwork::RollMode_T rollMode
– Supported.
• globaldefs::NamingAttributesList_T sncNames
– Supported. This refers to the name of the SNC to roll partially or fully. If two SNCs are
specified, the first SNC will be the RollFromSNC and the second SNC will be the
RollToSNC.
RollToSNC.
• globaldefs::NamingAttributesList_T fixCTPs
– Supported. This refers to the fully qualified name of the CTP of the SNC. This CTP is the
fixed point of the roll. In cases where the rollType is DUAL, there will be two fixed points in
the roll. The first fixCTP indicates the first fixed point in the roll object and the second
fixCTP indicates the second fixed point of the roll.
the roll. The first fixCTP indicates the first fixed point in the roll object and the second
fixCTP indicates the second fixed point of the roll.
• globaldefs::NamingAttributesList_T rollFromCTP
– Supported. This refers to the fully qualified name of the CTP of the SNC. This CTP is either
the source or destination or any other associated CTP of the SNC. In cases where the rollType
is DUAL, the first element in the array indicates the first rollFromCTP point and the second
element in the array indicates the second rollFromCTP point. If the rollFromCTP can be
determined from the fixed CTP, the value is ignored.
is DUAL, the first element in the array indicates the first rollFromCTP point and the second
element in the array indicates the second rollFromCTP point. If the rollFromCTP can be
determined from the fixed CTP, the value is ignored.
• globaldefs::NamingAttributesList_T rollToCTP
– Supported. This refers to the fully qualified name of the CTP where the roll occurs. In cases
where the rollType is DUAL, the first element in the array indicates the first rollToCTP point
and the second element in the array indicates the second rollToCTP point.
and the second element in the array indicates the second rollToCTP point.
• subnetworkConnection::ResourceList_T neTpInclusions
– Supported. Prime Optical expects a list of managed element names or PTP names of the
endpoint of a topological link or CTP name pair representing the endpoints of the span to
include in the subnetwork connection route. For complete manual routing, Prime Optical
include in the subnetwork connection route. For complete manual routing, Prime Optical