4.103 chg-measopts
Use this command to:
- turn on the collection function for Integrated Measurements and Measurements Platform,
- turn the collection function for 15 Minute Measurements on or off
- turn on and off the unchannelized link label for high-speed MTP2 links
- turn the CLLI-based file name option for measurements reports files on or off
- activate or de-activate automatic generation and FTP transfer of scheduled measurements reports to the FTP server
Note:
After the Measurements Platform or Integrated Measurements collection function has been enabled, it cannot be disabled with this command.Caution:
Do not execute thechg-measopts:platformenable=on or
chg-measopts:oamhcmeas=on command near
a collection starting boundary. The best times for executing these commands are
xx07, xx17, xx37 and xx47, where
xx is any hour,
from 00-23.
Parameters
Note:
As of Release 45.0, the all, avldlink, avllink, cllibasedname, collect15min, complink, complnkset, compsctpasoc, compsctpcard, compua, gtwylnkset, gtwylsdestni, gtwylsonismt, gtwylsorigni, gtwyorigni, gtwyorigninc, gtwystp, nmlink, nmlnkset, nmstp, systotstp, systottt, systotsip and systotsfthrot parameters can be set using the individual parameters or as options for the on and off parameters.Note:
The options for the on and off parameters are described in the Notes section.- all (optional)
- Activates or deactivates the automatic generation
and FTP transfer of all scheduled measurements reports.
Note:
The all parameter does not change the setting of the platformenable, cllibasedname, collect15min, unchlinklabel, and oamhcmeas parameters.
- avldlink (optional)
- Activates or deactivates the automatic generation and FTP transfer of the scheduled daily availability measurement report for links.
- avllink (optional)
- Activates or deactivates the automatic generation and FTP transfer of the scheduled hourly availability measurement report for links.
- complink (optional)
- Activates or deactivates the automatic generation and FTP transfer of the scheduled component measurement report for links.
- complnkset (optional)
- Activates or deactivates the automatic generation and FTP transfer of the scheduled component measurement report for linksets.
- compsctpasoc (optional)
- Activates or deactivates the automatic generation and FTP transfer of the scheduled component measurement report for per association SCTP data.
- compsctpcard (optional)
- Activates or deactivates the automatic generation and FTP transfer of the scheduled component measurement report for per card SCTP data.
- compua (optional)
- Activates or deactivates the automatic generation and FTP transfer of the scheduled component measurement report for M3UA and SUA application server/association pairs.
- gtwylnkset (optional)
- Activates or deactivates the automatic generation and FTP transfer of scheduled GTWY measurement report for linksets.
- gtwylsdestni (optional)
- Activates or deactivates the automatic generation and FTP transfer of scheduled GTWY link set measurement report for destination NI
- gtwylsonismt (optional)
- Activates or deactivates the automatic generation and FTP transfer of scheduled GTWY linkset measurement report for ISUP message type per linkset per originating NI
- gtwylsorigni (optional)
- Activates or deactivates the automatic generation and FTP transfer of scheduled GTWY link set measurement report for originating NI
- gtwyorigni (optional)
- Activates or deactivates the automatic generation and FTP transfer of scheduled GTWY link measurement report for originating NI.
- gtwyorigninc (optional)
- Activates or deactivates the automatic generation and FTP transfer of scheduled GTWY link measurement report for originating NI and NC.
- gtwystp (optional)
- Activates or deactivates the automatic generation and FTP transfer of scheduled GTWY measurement report for STP.
- nmlink (optional)
- Activates or deactivates automatic generation and FTP transfer of the scheduled network management measurement report for links.
- nmlnkset (optional)
- Activates or deactivates automatic generation and FTP transfer of the scheduled network management measurement report for link sets.
- nmstp (optional)
- Activates or deactivates automatic generation and FTP transfer of scheduled network management measurement report for STP.
- oamhcmeas (optional)
- Turns on the Integrated Measurements collection
function on the E5-OAM card.
This function cannot be turned off after it has been turned on.
- off (optional)
- This parameter turns off the specified options. Up to 8 comma-separated unique options can be specified.
- on (optional)
- This parameter turns on the specified options. Up to 8 comma-separated unique options can be specified.
- platformenable (optional)
- Turns on the Measurements Platform collection
function.
This parameter cannot be turned off after it has been turned on.
- systotsfthrot (optional)
- Activates or deactivates automatic generation and FTP transfer of scheduled measurement report for GTT SFTHROT Action.
- systotsip (optional)
- Activates or deactivates automatic generation and FTP transfer of scheduled measurement report for SIP system totals.
- systotstp (optional)
- Activates or deactivates automatic generation and FTP transfer of scheduled measurement report for STP system totals.
Example
chg-measopts:platformenable=on
chg-measopts:platformenable=on:complink=on: complnkset=on:systottt=off:systotstp=off
chg-measopts:on=complink,complnkset,systottt,systotidpr: off=gtwylsonismt,compua,nmlink,nmstp
chg-measopts:systotsip=on
chg-measopts:systotsfthrot=on
Dependencies
The Measurements Platform feature must be turned on before the platformenable=on parameter can be specified.
An MCPM card must be in the IS-ANR Restrict state before the Measurements Platform collection option can be enabled.
The 15 Minute Measurements feature must enabled and turned on before the 15 Minute Measurements collection option can be turned on.
The platformenable=on or oamhcmeas=on parameter must be specified before the cllibasedname=on parameter can be specified.
This command is not allowed while in upgrade mode.
Half-hour collection and report processing cannot be in progress when collect15min=on is specified.
Quarter-hour collection and report processing cannot be in progress when collect15min=off is specified.
At least one SLK or SIP/DEIR connection must be configured, before the platformenable=on or oamhcmeas=on parameter is specified.
The oamhcmeas or platformenable parameter cannot be specified if an OAM/OAMHC to MCP or MCP to OAMHC transition is in progress.
The Integrated Measurements feature must be turned on before the oamhcmeas=on parameter can be specified.
The Integrated Measurements or Measurements Platform feature must be turned on before this command can be entered.
The platformenable and oamhcmeas parameters cannot be specified together in the command.
The same option cannot be specified for the on and off parameters in the same command.
Parameters cannot be specified individually and as options for the on or off parameter in the same command.
At least one GTT Action - SFTHROT must be provisioned before the systotsfthrot=on parameter is specified.
Notes
Activated scheduled reports are generated and transferred to the customer’s FTP server.
The
rept-ftp-meas command can be used to
manually generate and transfer one report at a time as needed.
The primary application of the
set-time command is for Daylight
Savings Time changes, setting the time forward or backward 1 hour. To reduce
effects of
set-time changes on measurements, the
time change should be done within the first 15 minutes of any hour.
The Maintenance Guide provides detailed information on measurements and measurement reports.
CLLI-Based Measurements Report File Name
When the CLLI-based file name option (cllibasedname) is turned on, the CLLI is added to the measurements report file name, and the year is removed from the file name to ensure that the file name is equal to or fewer than 39 characters.
15 Minute Measurements
When the SEAS feature is turned on and 15 Minute Measurements collection is turned from off to on with the collect15min=on parameter, the message "Disabling SEAS Measurements..." is displayed at the UI.
When the SEAS feature is turned on and 15 Minute Measurements collection is running (collect15min=on), EAGLE measurements output to the SEAS interface is disabled.
When the SEAS feature is turned on and 15 Minute Measurements collection is turned from on to off with the collect15min=off parameter, EAGLE measurements output to the SEAS interface is enabled again.
Note:
If SEAS reporting is turned on, for the 24 hours after the 15 Minute Measurements option is turned from on to off, 30-minute demand SEAS reports for time periods prior to the option status change will contain only 15 minutes of data, and SEAS will not support reporting at the xx15 and xx45 times.Some quarter-hour measurements data might not be available for 24 hours after turning 15 Minute Measurements collection on. This condition exists for quarter-hour intervals for which 15 Minute Measurements collection has not yet occurred. Data that was collected on a 30-minute basis is available for reporting for up to 24 hours after it is collected. After the 15 Minute Measurements collection option is turned on, this data remains available on a half-hour basis (xx00 and xx30) but is not available on a quarter-hour basis (xx15 and xx45) because no data was collected on the quarter hours. After the 15 Minute Measurements collection option has been turned on for 24 hours, all 15-minute measurements data is available on a quarter-hour basis (xx00, xx15, xx30, and xx45).
In addition, full 30-minute data coverage will not be available until 24 hours after turning off the 15 Minute Measurements collection option. Reports for specific periods will always contain the amount of data collected for that period.
The action of turning 15-minute measurements feature
control status on using the
chg-ctrl-feat command also has an
impact on the generation of measurements reports for
period=active. Specifically, if the
feature control status of 15-minute measurements is turned on and a report is
requested for the active interval prior to the next scheduled measurements
collection (based on the current 15-minute measurements status), the starting
time for the period shown in the report will be incorrect. As soon as the next
scheduled collection occurs, active reports will show the correct starting
time. For example, if 15-minute feature control status is turned on with the
chg-ctrl-feat command at 13:03, and
the 15-minute measurements collection option is turned on using the
chg-measopts command at 13:05, and a
comp-link report for
period=active is requested at 13:10,
that report will contain an incorrect interval start time. If the same report
is requested at 13:20, the start time shown in the report will be correct,
because a collection occurred at 13:15.
A similar limitation exists for period=last. If the feature control status of 15-minute measurements is turned on and a report is requested for the last interval prior to the next scheduled measurements collection (based on the current 15-minute measurements status), the start and end times for the period shown in the report will be incorrect. The data presented in the report will correspond to the start and end times. As soon as the next scheduled collection occurs, then period=last reports will show the correct start and end times and the corresponding data for that interval. To generate measurements from the last collected interval before the first collection with feature control status on, a period=specific report will need to be entered. In the example given in the previous paragraph, the first report requested at 13:10 would not give the last interval, but the data given would correspond to the interval shown in the report. The second report requested at 13:20 would show correct start and end times and the data would correspond to the interval.
If the 15 Minute Measurements collection option is turned from on to off in the first 15 minutes of a half-hour (xx00-xx15 or xx30-xx45) and a demand report is requested in the second 15 minutes of a half-hour (xx15-xx30 or xx45-xx60) for period=last or period not specified, the report that is displayed will be the last 15-minute interval (xx00-xx15 or xx30-xx45), not the last collected 15-minute interval (xx45-xx00 or xx15-xx30). Collection did not occur during this 15-minute period, and the message “Measurements data not current” will be displayed. To report the last collected 15-minute interval, period=specific must be specified in the command with the correct qh/hh value.
The time interval in each measurements report shows which collection option was on when the measurements were collected. (This might not be the option that is currently on if the option was changed in the last 24 hours).
- xx00-xx15—None. 15 minutes of data will be collected for the quarter-hour xx15.
- xx15-xx30—The xx15 interval will contain no data. The xx30 interval will contain 30 minutes of data.
- xx30-xx45—None. 15 minutes of data will be collected for the quarter-hour xx15.
- xx45-xx00—The xx45 interval will contain no data. The xx00 interval will contain 30 minutes of data.
on/off options
- all —Allows automatic generation and FTP transfer of all scheduled measurements reports. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This parameter does not change the setting of the platformenable, cllibasedname, collect15min, unchlinklabel, and oamhcmeas parameters. This option has a default of OFF
- avldlink —Allows automatic generation and FTP transfer of the scheduled daily availability measurement report for links. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- avllink —Allows automatic generation and FTP transfer of the scheduled hourly availability measurement report for links. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- cllibasedname —CLLI-based measurements report file name option. This option has a default of OFF.
- collect15min —15 Minute Measurements collection function. This option has a default of OFF.
- complink —Allows automatic generation and FTP transfer of the scheduled component measurement report for links. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- complnkset —Allows automatic generation and FTP transfer of the scheduled component measurement report for linksets. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- compsctpasoc —Allows automatic generation and FTP transfer of the scheduled component measurement report for per association SCTP data. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- compsctpcard —Allows automatic generation and FTP transfer of the scheduled component measurement report for per card SCTP data. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- compua —Allows automatic generation and FTP transfer of the scheduled component measurement report for M3UA and SUA application server/association pairs. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- gtwylnkset —Allows automatic generation and FTP transfer of scheduled GTWY measurement report for linksets. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- gtwylsdestni —Allows automatic generation and FTP transfer of scheduled GTWY link set measurement report for destination NI. If the 15 Minute Measurements feature is turned on and the, collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- gtwylsonismt —Allows automatic generation and FTP transfer of scheduled GTWY linkset measurement report for ISUP message type per linkset per originating NI. If the 15 Minute Measurements feature is turned on and the, collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- gtwylsorigni —Allows automatic generation and FTP transfer of scheduled GTWY link set measurement report for originating NI. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- gtwyorigni —Allows automatic generation and FTP transfer of scheduled GTWY link measurement report for originating NI. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- gtwyorigninc —Allows automatic generation and FTP transfer of scheduled GTWY link measurement report for originating NI and NC. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- gtwystp —Allows automatic generation and FTP transfer of scheduled GTWY measurement report for STP. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- nmlink —Allows automatic generation and FTP transfer of the scheduled network management measurement report for links. This option has a default of OFF.
- nmlnkset —Allows automatic generation and FTP transfer of the scheduled network management measurement report for link sets. This option has a default of OFF.
- nmstp —Allows automatic generation and FTP transfer of scheduled network management measurement report for STP. This option has a default of OFF.
- oamhcmeas —Turns ON the Integrated Measurements collection function on the E5-OAM card. This option cannot be turned OFF.
- platformenable —Turns ON the Measurements Platform collection function. This option cannot be turned OFF.
- systotidpr —Allows scheduled reports for IDPR Measurement Pegs on FTP to be generated every 30 minutes. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- systotsfthrot — Allows automatic generation and FTP transfer of scheduled measurement report for GTT SFTHROT actions system totals. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- systotsip — Allows automatic generation and FTP transfer of scheduled measurement report for SIP system totals. If the 15 Minute Measurements feature is turned on and the collect 15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- systotstp —Allows automatic generation and FTP transfer of scheduled measurement report for STP system totals. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- systottt —Allows automatic generation and FTP transfer of scheduled measurement report for translation type system totals. If the 15 Minute Measurements feature is turned on and the collect15min parameter is specified, then scheduled reports on FTP can be generated every 15 minutes. This option has a default of OFF.
- unchlinklabel —Turns ON/OFF a link label that identifies unchannelized (high-speed) MTP2 links. This option has a default of OFF.
Output
chg-measopts:platformenable=on:complink=on:complnkset=on:systottt=off:systotstp=off
tekelecstp 08-06-01 14:31:25 EST EAGLE 44.0.0
CHG-MEASOPTS: MASP A - COMPLTD
;
chg-measopts:on=systotidpr,systottt,complnkset,complink:off=avldlink,avllink
tekelecstp 10-12-01 12:15:25 EST EAGLE 44.0.0
CHG-MEASOPTS: MASP A – COMPLTD
;
chg-measopts:systotsip=on
tekelecstp 12-07-26 14:41:09 EST EAGLE 45.0.0
chg-measopts:systotsip=on
Command entered at terminal #4.
CHG-MEASOPTS: MASP A - COMPLTD
; chg-measopts:systotsfthrot=on
tekelecstp 15-08-26 14:41:09 EST EAGLE 46.3.0
chg-measopts:systotsfthrot=on
Command entered at terminal #4.
CHG-MEASOPTS: MASP A - COMPLTD
;