Cisco Cisco Prime Optical 9.8 Developer's Guide

Page of 762
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”
 
FlowDomainFragment
 
name="EMS";value="CompanyName/EMSname" 
 
name="FlowDomain";value="FlowDomainName"
 
name="FlowDomainFragment";value="FlowDomainFragmentName"
 
TrafficConditioningProfil
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. 
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.  
Synopsis 
Description 
The how_many parameter determines the maximum number of response entries in the list 
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.  
•  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.