TL1 Command Reference Manual-Performance Monitoring
TL1 Command Reference Manual-Performance Monitoring
TL1 Command Reference Manual-Performance Monitoring
Retrieve Commands
RTRV-PM-{X}
Description
The RTRV-PM-{X} command instructs the network element (NE) to retrieve its current set of Performance
Monitoring data associated with the selected facility entity.
• Output lines are not generated for MONTYPES that are not valid for the given termination and format.
TMPER=1-DAY MONDAT and MONTM specify a register The acceptance does not depend
that is maintained in the NE (past 7 daily upon the availability of the data
registers). from the specified register.
• When ALL is used as a second modifier, possible value for AID can only be "ALL" or blank. In this case,
it will address all entities except for ODUk montypes.
• When ALL is used as a second modifier, possible value for AID can only be "ALL" or blank. In this case,
it will address all entities except for STSn and ODUk montypes.
• When no MONTYPE is specified, command response will include values for all MONTYPES supported
by the facility or equipment (except for STSn montypes).
• When the threshold level <thlev> parameter is set to 0 for a counter montype, then no automatic
message (TCA) is generated for this montype. Also, any TCAs announced during the time period, prior
to setting the parameter to 0 will still be visible via RTRV-TCA.
• NA is returned for PM parameters when the PM data is valid but not available due to provisioning such
as in the case where an ODUk is not mapped to an OTUk.
• When a supporting layer (for example, OCH-P) is taken OOS, the supported layers (for example, ODUx/
OTUx) will continue count UAS but will inhibit EB/CV, ES, SES counting.
• On OADMRS/OADMRS9, partial is returned for the PM parameters when the PM data is valid but
experienced the event of OPGAINRANGE value change on the module.
• The units for the retrieved delay value on an ODUk entity for DELAY-ODU(current value), DELAY-ODU-
F(floor value) and DELAY-ODU-C(ceiling value) are microseconds.
• PM is not supported for the ODUC2 and ODUC3 facilities on the OSM-4F module.
• Far-end PM is only applicable for OSM-4C and OSM-4F, and are applicable for the OTUC3, OTUC2,
OTU4, ODU4, ODU3, ODU2E, ODU2, ODU1, ODU0 and ODUF layers.
• The following PM are supported for each Module and facilities in this release: (Note: these figures
illustrate performance monitoring points for the various modules in the system. It is not intended to be
an exhaustive list of every performance parameter that is monitored. Please refer to the next 'Montypes
Supported' table for the details.)
• Register initialization (via INIT-REG command) is not supported for far-end PM.
• When far-end PM is enabled, 0 is always returned for the far end Errored Blocks montype.
Performance Monitoring
with OADMRS/OADMRS9
TDTN
LOSS,
SONET PM: TDTC
Section PM (CVS, ESS, SESS, SEFSS, UASS)
Line PM (CVL, ESL, SESL, FC-L, UASL)
Path PM (CVP, ESP, SESP, FCP, UASP,
PJCDIFFP, PJCSPDET, PJCSPGEN)
SONET PM:
Section PM (CVS, ESS, SESS, SEFS, UASS)
SSM-2S SONET/OTU
Line PM (CVL, ESL, SESL, FC-L, UASL)
Path PM (CVP, ESP, SESP, FCP, UASP, Section/RS
MFABs PM (OSC)
PJCDIFFP, PJCSPDET, PJCSPGEN)
OADMRS/OADMRS9
OCH-L/OMS/
OPT
LOSS,
BE-FEC, UBE-FEC,
CV-OTU, ES-OTU, OSM
SES-OTU, UAS-OTU
EB-ODU, ES-ODU, OPR,
SES-ODU, UAS-ODU, BE-FEC, UBE-FEC,
CVS, ESS, SESS, SEFSS, UASS, CV-OTU, ES-OTU,
SE, DROP, PKT, BCPKT, MCPKT, CRCAE SES-OTU, UAS-OTU,
EB-ODU, ES-ODU, SES-ODU, UAS-ODU,
USPKT, OSPKT, FRAG, JABR, UTIL PSC, PSD
PSC, PSD
For OSM-4C/OSM-4F, only external connections are supported. The following provides an overview of PM
supported on these modules. For details, refer to 'Montypes Supported' tables.
Performance Monitoring
with OSM-4C/OSM-4F TDTN
TDTC
OSM-4C/
OSM-4F
Backplane
Near-end (NEND)
LOSS, OPR, DGD, CD, OSNR
BE-FEC, UBE-FEC, BER-FEC
CV-OTU, ES-OTU, SES-OTU, UAS-OTU
DELAY-ODU
EB-ODU, ES-ODU, SES-ODU, UAS-ODU,
PSC, PSD
Far-end (FEND)
CV-OTU-FE, ES-OTU-FE, SES-OTU-FE, UAS-OTU-FE
EB-ODU-FE, ES-ODU-FE, SES-ODU-FE, UAS-ODU-FE
Montypes Supported
OADMRS/OADMRS9
OCH-L Optical Power Transmitted: OPT (gauge) NEND TDTN
OSM-1S
OTU1 Loss of Signal Seconds: LOSS NEND TDTN
OTU Bit Error Forward Error Correction: BE-FEC
OTU Uncorrected Block Error Forward Error Correction: UBE-
FEC
Errored Blocks on OTU: CV-OTU or EB-OTU
Errored Seconds on OTU: ES-OTU
Severely Errored Seconds on OTU: SES-OTU
Unavailable Seconds on OTU: UAS-OTU
OC48/STM16 SONET Section PM (CVS, ESS, SESS, SEFSS, UASS) NEND TDTN
OC12/STM4 Loss of Signal Seconds: LOSS
OC3/STM1
OSM-2S
OCH-P Optical Power Received: OPR (gauge) NEND TDTC
OTU Bit Error Forward Error Correction: BE-FEC
OTU Uncorrected Block Error Forward Error Correction: UBE-
FEC
Coding Violations on OTU: CV-OTU
Errored Seconds on OTU: ES-OTU
Severely Errored Seconds on OTU: SES-OTU
Unavailable Seconds on OTU: UAS-OTU
OSM-2C
OCH-P Optical Power Received: OPR (gauge) NEND TDTC
OTU Bit Error Forward Error Correction: BE-FEC
OTU Uncorrected Block Error Forward Error Correction:
UBE-FEC
OTU Bit Error Rate before Forward Error Correction: BER-
FEC (gauge)
Errored Block on OTU: CV-OTU (SONET mode)/EB-
OTU (SDH mode)
Errored Seconds on OTU: ES-OTU
Severely Errored Seconds on OTU: SES-OTU
Unavailable Seconds on OTU: UAS-OTU
Differential Group Delay: DGD (gauge)
Chromatic Dispersion: CD (gauge)
Optical Signal to Noise Ratio: OSNR (gauge)
SSM-2S
OCn SONET Section PM (CVS, ESS, SESS, SEFSS, UASS) NEND TDTN
Port side SONET Line PM (CVL, ESL, SESL, FC-L, UASL)
Loss of Signal Seconds: LOSS
Protection Switch Count/Duration: PSC, PSD (for 1+1 APS
only)
OCn SONET Section PM (CVS, ESS, SESS, SEFSS, UASS) NEND TDTC
Backplane side with virtual SONET Line PM (CVL, ESL, SESL, FC-L, UASL)
port
STSn SONET Path PM (CVP, ESP, SESP, FCP, UASP, PJCDIFFP, NEND TDTN
Port side PJCSPDET, PJCSPGEN)
STSn SONET Path PM (CVP, ESP, SESP, FCP, UASP, PJCDIFFP, NEND TDTC
Backplane side with virtual PJCSPDET, PJCSPGEN)
port
OSM-4C
OSM-4F
OSM-4S
OSM-5C
OTU4 Loss of Signal Seconds: LOSS NEND TDTN
OTU Bit Error Forward Error Correction: BE-FEC
OTU Uncorrected Block Error Forward Error Correction: UBE-
FEC
Errored Blocks on OTU: CV-OTU or EB-OTU
Errored Seconds on OTU: ES-OTU
Severely Errored Seconds on OTU: SES-OTU
Unavailable Seconds on OTU: UAS-OTU
Note: The following tables include Counter and Gauge values. For single value
montypes, they are considered counters (there are no ceiling/floor
thresholds). For multi-value montypes they are considered gauges and
include a base value, a max value and a min value.
Some gauges do not include a min value. Reference the Restrication and
Exceptions section for notes on Gauge limits for specific montypes.
Note: Register sizes for the supported far-end montypes are the same as the
corresponding near-end montypes.
BER-FEC (OCH-OS on 0.5 to 1E-11 0.5 to 1E-11 0.5 to 1E-11 and 0 0.5 to 1E-11 and
OSM-4F with 25% and 0 and 0 0
SDFEC)
Table 22.105 Default Thresholds for Data Signals (GBEP, TGLAN, FGE, HGE)
Threshold Threshold
OCH-P OPR OCH-P on 10G line side -18 dBm -5.0 dBm
Optical Power Receive interface
10G Line side Interface
OCH-OS OPR OCH-OS on 100G line side -18 dBm +15 dBm
Optical Power Receive interface, OSM-4C
100G Line side Interface,
OSM-4C
Pkts PKT 0 0
BroadcastPkts BCPKT 0 0
MulticastPkts MCPKT 0 0
CRCAlignErrors CRCAE 0 0
UndersizePkts USPKT 0 0
OversizePkts OSPKT 0 0
Fragments FRAG 0 0
Jabbers JABR 0 0
Utilization UTIL 0 0
Note:
* Per RFC 2819, the DropEvents statistic is a count of frames that are dropped due to a lack of resources and does not
include frames dropped due to errors.
Note: When the default threshold level value is set to 0 for a counter montype,
then no automatic message (TCA) is generated for this montype.
Command Format
RTRV-PM-{<fac_type>|ALL}:[tid]:[{<fac_aid>|ALL}]:ctag::
[<montype>],[<monlev>],[<locn>],[<dirn>],[<tmper>],[<mondat>] [,<montim>];
Proper System Response when the PM Mode is set to ON, but there are currently no register values:
<header>
M <ctag> COMPLD
Proper System Response when PM mode is set to ON, and there are values:
<header>
M <ctag> COMPLD
"<fac_aid>,<aidtype>:<montype>,<monval>,<vldty>,<locn>,<dirn>,<tmper>,
<mondat>,<montim>"
.
.
"<fac_aid>,<aidtype>:<montype>,<monval>,<vldty>,<locn>,<dirn>,<tmper>,
<mondat>,<montim>"
;
Proper System Response when the PM mode is currently OFF and has remained OFF for the entire collection period
(specified with the SET-PMMODE-{X} command):
<header>
M <ctag> COMPLD
Parameters
Refer to AID restrictions table in Section 2 for specific information on AID range restrictions.
montype x,x-C,x-F Specifies the type of performance monitoring for the specified
entity.
- x: To be used to specify current value for <montype> x.
- x-C: To be used to specify highest value for gauge <montype>
x. C=Ceiling.
- x-F: To be used to specify lowest value for gauge <montype>
x. F=Floor.
monlev LEV-DIRN. Where: LEV is a value Specifies the level at which the performance monitoring type is
within the range supported for each reported:
montype. DIRN is either UP or DN. - UP means that values equal to or greater than LEV are
reported.
- DN means that values less than LEV are reported.
The system defaults to -60-UP for OPR and OPT montypes.
The system defaults to 1-UP for all counters montypes. This
means that all counter with value=0 (with no accumulation) does
not be shown when default <monlev> value is selected.
tmper 15-MIN Specifies the time-period increments during which PM data are
1-DAY collected.
- Enter 15-MIN to specify 15-minute increments.
- Enter 1-DAY to specify daily increments.
The system defaults to 15-minute increments.
mondat MOY-DOM format:(1)MOY = 1 - Specifies the one day index during which PM data is collected.
12.(2)DOM = 1 - 31. The system defaults to the current date.
montim x-y format:(1). x is any number in the Specifies the beginning of the 15-minute performance
range 0-23. (2). y is one of the monitoring collection time period.
following 15-minute increments: 00, The system defaults to the current 15-minute collection time
15, 30, or 45. period.
monval (1)-60.0 to +60.0, LT+12.0, GT+20.0, This value specifies the value of a performance monitoring
1.9E-2 to 2.3E-11, -40000 to +40000 counter or gauge.
for gauges. (2)0 to - NA specifies that the parameter value is not available at the
18446744073709551615 for counters. time of retrieval.
(3)NA
Example 1
RTRV-PM-OTU2::OTU2-20-1-2:ctag::,,,,,,;
"OTU2-20-1-2,OTU2:SES-OTU,NA,NA,NEND,TDTN,15-MIN,11-04,14-45"
"OTU2-20-1-2,OTU2:UAS-OTU,NA,NA,NEND,TDTN,15-MIN,11-04,14-45"
;
Example 2
RTRV-PM-OTUC2::OTUC2-20-1-1:ctag::,-100-UP;
Example 3
RTRV-PM-ODU4::ODU4-20-1-1:ctag::,-100-UP,FEND;
Error Messages
Error codes are defined and explained in Section 3, Error Codes for TL1 Output Responses.
Related Commands
INH-PMREPT-{X}
RTRV-PMMODE-{X}
SET-PMMODE-{X}