Cisco Cisco Prime Optical 9.8 Developer's Guide
Cisco Prime Optical 9.8 GateWay/CORBA Programmer Reference Guide
OL-29218-01
485
Entity
Naming Hierarchy
MatrixFlowDomain
name="EMS";value="CompanyName/EMSname"
name="ManagedElement";value="ManagedElementName"name="MatrixFl
owDomain";value=MatrixFlowDomainName”
name="ManagedElement";value="ManagedElementName"name="MatrixFl
owDomain";value=MatrixFlowDomainName”
FlowDomainFragment
name="EMS";value="CompanyName/EMSname"
name="FlowDomain";value="FlowDomainName"
name="FlowDomainFragment";value="FlowDomainFragmentName"
TrafficConditioningProfil
e
e
name="EMS";value="CompanyName/EMSname"
name="tcprofile";value="TCProfileName"
4.3.2 Entity Iterators
The NMS uses iterators to retrieve large amounts of data. Iterators provide a mechanism for
retrieving data in batches. The NMS specifies the ideal size of a batch. When the NMS requests
a list of objects, it specifies the maximum number of objects it can handle in the first reply. The
number sent by the EMS can be less than this number.
retrieving data in batches. The NMS specifies the ideal size of a batch. When the NMS requests
a list of objects, it specifies the maximum number of objects it can handle in the first reply. The
number sent by the EMS can be less than this number.
The EMS gets a snapshot of the current objects to be returned. The response contains a list
with the specified number of objects and a reference to an iterator. The NMS uses this iterator
to access other objects in the snapshot.
with the specified number of objects and a reference to an iterator. The NMS uses this iterator
to access other objects in the snapshot.
Synopsis
Description
The how_many parameter determines the maximum number of response entries in the list
output parameter.
output parameter.
The iteratorReference parameter provides access to the remaining objects, if any.
• If the list contains the complete set of ObjectName objects, then the iteratorReference is a
reference to a CORBA::Object::_nil object.
• If there are more objects, the list output parameter contains the first batch of objects
known to the EMS and the iteratorReference parameter provides access to the other
objects.
objects.
• If you specify 0 in the how_many parameter, no objects are returned in the list and all
objects must be retrieved from the iteratorReference parameter.