User guide

3-269
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.5 getCTMHistoryPMData
• –3—The module in the physical location is unequipped or preprovisioned. The validity status is
Invalid.
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.
Parameters
CTM support for PMTPSelect_T structure for this method is as follows:
• globaldefs::NamingAttributes_T name
The name of the object to which this selection applies. CTM supports only ManagedElement, PTP,
or CTP name in this field. Note that ManagedElement must be in CTM’s management domain. For
example, if you change the name of the ME but you pass the old name to this call, no data is written
to the file.
• transmissionParameters::LayerRateList_T layerRateList
For a list of supported layer rates, see 2.2.1 Layer Rate, page 2-23.
• PMLocationList_T pMLocationList
CTM supports only PML_NEAR_END_RX and PML_FAR_END_RX.
• GranularityList_T granularityList
CTM supports 15-minute (15min) and 24-hour (24h) PM data. If this list is empty, data for all
granularities is reported.
CTM supports the PM parameter values listed in Table 3-5, Table 3-6, Tabl e 3-7, Table 3-9 , Tabl e 3-10,
and Ta ble 3-11.
Name Type Input/Output Description
client nmsSession::NmsSession_I In Reference to NMSSession. It cannot be null and it must be
registered with CTM using
emsSessionFactory::EmsSessionFactory_I::getEmsSession.
CTM notifies this client about the completion or failure
using methods defined in 3.12.1 historyPMDataCompleted,
page 3-208 and 3.12.2 historyPMDataFailed, page 3-208.
pmTPSelectList PMTPSelectList_T In This parameter specifies which historical PM data to return.
This list cannot be empty.
pmParameters PMParameterNameList_T In This parameter specifies which PM parameters within the
scope of the pmTPSelectList shall be contained in the file.
An empty list means to store all supported parameters. The
returned parameters are best effort; that is, among the
parameters specified, only the subset of supported
parameters will be stored.
startTime globaldefs::Time_T In Specifies the start of the time window for collection
(included).
endTime globaldefs::Time_T In Specifies the end of the time window for collection
(excluded).