Cisco Cisco Prime Optical 10.6 Developer's Guide

Page of 665
Cisco Prime Optical 10.6 GateWay/CORBA Programmer Reference Guide 
 
 
385
 
Compliance 
TMF-defined. 
 
3.13.10 getAllCurrentPMData 
Synopsis 
Description 
This interface enables an NMS to request a filtered set (scoped by the input parameter pmParameters) of 
the current PM data for a list of TP measurement points. Within the request for each measurement point, 
granularity (15 min, 24 hr, N/A) and location (nearEnd, farEnd, bidirectional) can be specified. The 
operation mode is best effort. 
Current data is generally marked as incomplete, as the current bin is not completed. If no PM data is 
available as specified, an empty list is returned. 
This interface uses an iterator to allow the NMS to handle a large number of objects. 
For a list of supported layer rates and PM parameters, see 
. 
If the layer rate is L3_Optical_Channel (which requires a DWDM CTP), Prime Optical uses the naming 
convention defined in the TMF for the CTP.  
The CTP format description differs depending on whether it is related to the DWDM. 
L3_Optical_Channel is the only layer rate that requires it. If the list of requested layer rates is composed 
of one element only equal to LR_Optical_Channel, the CTP is considered a DWDM CTP. 
For CPT 200, CPT 200 SDH, CPT 600, and CPT 600 SDH, a subset of ONS 15454 SONET and ONS 
15454 SDH parameters is supported. The supported parameters match the parameters associated to the 
port equipment supported by CPT. 
The getAllCurrentPMData interface returns values with a 15-minute granularity if the requested 
granularity is 24 hour. For a list of supported layer rates, see 
. 
Parameters 
Name 
Type 
Input/ 
Output 
Description 
pmTPSelectList  PMTPSelectList_T 
In 
Specifies which real-time PM data to return. 
This list cannot be empty. 
pmParameters 
PMParameterNameList_T  In 
Specifies which PM parameters within the 
scope of the pmTPSelectList are contained in 
the file. An empty list means to store all 
supported parameters. The returned parameters 
are best effort, meaning among the parameters 
specified, only the subset of supported 
parameters is stored. 
how_many 
unsigned long 
In 
Maximum number of PM data to return in the 
first batch. 
pmDataList 
PMDataList_T 
Out 
First batch of PM data. 
pmIt 
PMDataIterator_I 
Out 
Iterator used to retrieve the remaining PM data. 
For detail of PMData_T structure, see 
.