User guide

3-275
Cisco Transport Manager Release 9.2 GateWay/CORBA User Guide and Programmer Manual
OL-20937-01
Chapter 3 Using CTM GateWay/CORBA Interfaces
3.13.10 getAllCurrentPMData
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 3.13.5 getCTMHistoryPMData, page 3-268.
If the layer rate is L3_Optical_Channel (which requires a DWDM CTP), CTM 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.
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 2.2.1 Layer Rate, page 2-23.
Parameters
For detail of PMData_T structure, see 3.13.8 getTPHistoryPMData, page 3-271.
Throws
EXCPT_NOT_IMPLEMENTED - Raised when this operation is not supported by the EMS or not
supported for an ME type.
EXCPT_INTERNAL_ERROR - Raised in case of nonspecific EMS internal failure.
EXCPT_INVALID_INPUT - Raised when any input parameter is not well formed.
EXCPT_NE_COMM_LOSS - Raised when communication to the NE is lost.
EXCPT_TOO_MANY_OPEN_ITERATORS - Raised when the EMS reaches the maximum number of
iterators that it can support.
Compliance
TMF-defined.
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.