4.391 rept-meas

Use this command to generate measurement reports on demand. The reports display on the UI terminal, and are not transferred to the customer FTP server when the Measurements Platform feature is enabled.

Parameters

enttype (mandatory)
Entity type to report on.
Range:
idpr
Measurements for IDPR
link
Measurements for signaling links
lnkset
Measurements for linksets
lnp
Measurements for local number portability
lsdestni
Measurements for linkset destination network identifiers
lsonismt
Measurements for ISUP message type screening
lsorigni
Measurements for linkset originating network identifiers
mapscrn
Measurements for GSM MAP message screening
origni
Measurements for originating network identifiers greater than 5
origninc
Measurements for originating network identifiers (less than 5, small networks) for network clusters
sctpasoc
Measurements per association for the SCTP protocol (used to carry M3UA, M2PA, SUA and DIAM traffic)
sctpcard
Measurements per card for the SCTP protocol (used to carry M3UA, M2PA, SUA and DIAM traffic)
sip
Measurements for SIP
stp
Measurements pertaining to the Signaling Transfer Point in general or summarized totals recorded on the STP
tt
Measurements for translation types
ua
Measurements per application server/association for the M3UA and SUA protocols
type (mandatory)
Type of measurement report.
Range:
avl
Availability measurements
avld
Daily availability measurements
avldth
Day to hour availability measurements.
comp
Component measurements
gtwy
Internetwork gateway-related data from the STP for ANSI and ITU measurements. ANSI gateway measurements are pegged on a per-linkset, per-Network Indicator basis, whereas ITU measurements are pegged on a per-linkset basis.
mtcd
Daily maintenance measurements
mtcdth
Day-to-hour maintenance measurements
mtcs
Link/linkset maintenance status
nm
Network management, on-demand
rbase
Schedule-report type record base measurements
systot
STP system totals
aname (optional)
Association name. This parameter specifies the name assigned to the association in the IPAPSOCK table.
Range:
ayyyyyyyyyyyyyy

Up to 15 alphanumeric characters; the first character must be a letter

asname (optional)
Application server name. The name of the application server.
Range:
ayyyyyyyyyyyyyy

Up to 15 alphanumeric characters; the first character must be a letter.

day (optional)

Day of the week for daily measurement reports.

Range:
mon
tue
wed
thu
fri
sat
sun
Default:
The previous single day report is generated.
hh (optional)
Half-hour interval. The ending time for the collection interval; for example, hh=0300 generates a report for 2:30-3:00.
Range:
0000 - 2400

hhmm where hh= 00-24 (hour) and mm= 00 or 30 (minute)

Default:
The hh parameter value is not given.
link (optional)
The link on the card specified in the loc parameter
Synonym:
port
Range:
a, b, a1 - a31, b1 - b31

Not all card types support all link parameter values.

See Table A-1  for valid link parameter range values for each type of card that can have assigned signaling link ports.

Default:
none
loc (optional)
The card location as stenciled on the shelf of the system.
Range:
1101 - 1108, 1111 - 1112, 1201 - 1208, 1211 - 1218, 1301 - 1308, 1311 - 1318, 2101 - 2108, 2111 - 2118, 2201 - 2208, 2211 - 2218, 2301 - 2308, 2311 - 2318, 3101 - 3108, 3111 - 3118, 3201 - 3208, 3211 - 3218, 3301 - 3308, 3311 - 3318, 4101 - 4108, 4111 - 4118, 4201 - 4208, 4211 - 4218, 4301 - 4308, 4311 - 4318, 5101 - 5108, 5111 - 5118, 5201 - 5208, 5211 - 5218, 5301 - 5308, 5311 - 5318, 6101 - 6108, 6111 - 6118
Default:
none
lsn (optional)
Linkset name for the linkset where link or linkset measurements are reported.
Range:
ayyyyyyyyy

1 alphabetic character followed by up to 9 alphanumeric characters

Default:
none
nc (optional)
Network cluster for the specified GTWY measurement report.
Range:
0 - 255
Default:
none
ni (optional)
Network indicator for the specified GTWY measurement report.
Range:
0 - 255
Default:
none
nzo (optional)
Print non-zero measurements only.
Range:
yes
no
Default:
yes for types avl, avld, and avldth.

This parameter is not used with the other report types.

period (optional)
Relative time period to report.
Range:
last
The previous collection interval
specific
A specific half-hourly interval (specified with the hh parameter)
active
The current collection interval
all
All collection intervals.
Default:
none
qh (optional)
Quarter-hour interval. This parameter implies the ending time for the collection interval; for example, qh=0315 generates a report for 3:00-3:15.
Range:
0000 - 2400

hhmm where hh= 00-24 (hour) and mm= 00, 15, 30, or 45 (minute)

Default:
none
trm (optional)
Serial port (printer location) where the report is to be sent.
Range:
1 - 16
Default:
none
tt (optional)
Translation type to be reported.
Range:
0 - 255
Default:
none

Example

rept-meas:enttype=link:type=avl:loc=1201:link=a

rept-meas:type=systot:enttype=tt:tt=26

rept-meas:type=mtcd:enttype=sctpasoc:aname=assoc01

rept-meas:type=mtcdth:enttype=ua:aname=assoc01:asname=appserv01

rept-meas:enttype=sip:type=mtcd

Dependencies

This command cannot be used to specify a report type if that report type is currently printing.

Valid parameter combinations depend on the report type specified. These combinations are shown in Table 4-49. An X in a cell indicates that the parameter is valid for the report type shown.

Table 4-49 Valid Parameter Combinations for the type Parameter

Parameter Value Report Types (type parameter)
systot comp mtcd mtcdth mtch mtcs nm avl avld avldth gtwy rbase
enttype:
link X X X X X X X X X
Parameter Value Report Types (type parameter)
systot comp mtcd mtcdth mtch mtcs nm avl avld avldth gtwy rbase
linkset X X X X X X X
lnp X X
lsdestni X
lsonismt X
lsorigni X
mapscrn X X
origni X
origninc X
sctpasoc X X X
sctpcard X X X
sip X X
stp X X X X X X
tt X
ua X X X
period:
last X X X X X X X X X X
specific X X X X X
active X X X X X
all X X
nzo X X X

The entity specified by the loc parameter must be equipped in the database.

When enttype=link is specified, the card in the location specified by the loc parameter must be a LIM.

Quarter-hourly collection and report processing cannot be in progress when report type comp, systot, avl, or gtwy is specified.

The mtcdth report type is unavailable between midnight and 1:00 AM (0100).

Day-to-hour collection and report processing cannot be in progress when report type mtcd or mtcdth is specified.

Daily collection and report processing cannot be in progress when report type mtcd is specified.

Half-hourly collection and report processing cannot be in progress when report type comp, systot, avl, or gtwy is specified.

5-minute collection and report processing cannot be in progress when report type nm is specified.

If the nc parameter is specified for origin reports, then the ni parameter must be specified.

If the ni parameter is specified for origin reports, then measurements data must be available at the time the command is entered.

The day parameter can be specified only for report type mtcd and entity types lnp and mapscrn.

A primary MCPM card must be available when the Measurements Platform collection option is enabled and this command is entered.

The 15 Minute Measurements feature must be turned on and the 15 Minute Measurements collection option must be on before the qh parameter can be specified.

The hh parameter must specify a half-hourly boundary (the end of the requested half-hour for the report) for valid report types.

The hh and qh parameters cannot be specified together in the command.

When the period=last parameter is specified, the hh, qh, and day parameters cannot be specified.

If the period=active parameter is specified, then the hh and qh parameters cannot be specified.

When the period=specific parameter is specified, the hh, qh, or day parameter must be specified. The hh, qh, and day parameters can be specified only if the period=specific parameter is specified.

A quarter-hour boundary must be specified for the qh parameter.

The hh and qh parameters cannot be specified if a value of avld, mtcd, nm, rbase, or mtcs is specified for the type parameter.

If the link parameter is specified, the loc parameter must be specified.

The lsn and loc parameters cannot be specified together in the command.

If the enttype=link parameter is specified, then the loc and port parameters or the lsn parameter must be specified.

The period=active parameter cannot be specified when the enttype=stp parameter or the enttype=tt parameter is specified.

If a value of idpr, origni, origninc, stp, or tt is specified for the enttype parameter, or if the type=systot parameter is specified, then the lsn parameter cannot be specified.

For entity type avl, if period=all is specified, the loc and port parameters must be specified.

A value of avl, avld, or avldth must be specified for the type parameter before the nzo=yes parameter can be specified.

The appl and loc parameters cannot be specified in the same command.

The type=systot and loc parameters cannot be specified in the same command.

If the type=gtwy parameter is specified, and the value of the enttype parameter is lsorigni, lsdestni, or lsonismt, then the ni parameter cannot be specified for ITU linksets. The ni parameter is allowed only for ANSI linksets.

If the type=gtwy parameter is specified, and a value of lsdestni, lsonismt, or lsorigni is specified for the enttype parameter for an ITU linkset, then only the lsn parameter can be specified.

If the enttype=sctpcard parameter is specified, then the card in the location specified by the loc parameter must be an IPLIMx, IPGWx, or IPSG card.

The enttype=sctpasoc or enttype=ua parameter must be specified before the aname parameter can be specified.

The enttype=ua parameter must be specified before the asname parameter can be specified.

If the enttype=sctpcard parameter is specified, then the loc parameter must be specified.

If the enttype=sctpcard parameter is specified, then a card must be installed in the location specified by the loc parameter.

The enttype=link parameter must be specified before the link parameter can be specified.

The type=gtwy parameter and the enttype=origninc parameter must be specified before the nc parameter can be specified.

The type=gtwy parameter must be specified, and a value of lsdestni, lsonismt, lsorigni, origni, or origninc must be specified for the enttype parameter before the ni parameter can be specified.

The enttype=tt parameter must be specified before the tt parameter can be specified. If the enttype=tt parameter is specified, then the tt parameter must be specified.

If a value of sctpasoc or ua is specified for the enttype parameter, then the aname parameter must be specified.

The association specified by the aname parameter must be provisioned in the system.

If the enttype=ua parameter is specified, then the asname parameter must be specified.

The application server specified by the asname parameter must be provisioned in the system.

The association specified by the aname parameter must be assigned to the application server specified by the asname parameter.

The lsn and link parameters cannot be specified together in the command.

If the period=all parameter is specified, then the hh and qh parameters cannot be specified.

Either the specified Linkset does not exist or no link is configured for it.

The A-Port, G-Port, IS41 GSM Migration, or Prepaid SMS Intercept Ph1 feature must be enabled, or the INP, MO SMS IS41-to-GSM Migration, MO-based GSM SMS NP, or MO-based IS41 SMS NP feature must be turned on before the mtchnp=on parameter or the mtcdnp=on parameter can be specified.

The value specified for the appl parameter must be a supported GPL.

If the loc parameter is specified, then a value of , link, or sctpcard must be specified for the enttype parameter. If the enttype=lnkset parameter is specified, then the loc parameter cannot be specified.

If the enttype=link parameter is specified, then the values specified for the loc and link parameters must already exist in the database.

Period/type combinations:

  • If a value of rbase or mtcs is specified for the type parameter, then a value of active must be specified for the period parameter.
  • If a value of avld, avldth, mtcdth, or nm is specified for the type parameter, then the period=specific parameter cannot be specified.
  • If the period=active parameter is specified, then a value of avld, avldth, mtcd, mtcdth, or systot cannot be specified for the type parameter.
  • The type=avl parameter must be specified before the period=all parameter can be specified.

SIPNP Feature must be enabled before the enttype=sip and type=mtcd/systot parameters can be specified.

The location specified must be in the range from 1101 to 6118, except for MUX cards.

If the enttype=tt parameter is specified, then the tt parameter must be specified.

The type parameter must be one of the AVL, AVLD, AVLDTH, COMP, GTWY, MTCD, MTCDTH, MTCS, NM, RBASE, or SYSTOT range values.

An entity type (ENTTYPE) of DEIR, EIR, or VFLX requires the DAY parameter to be specified.

Retrievals with the rept-meas command for period= LAST, SPECIFIC, and ALL are rejected by the EAGLE if either measplat or integrated measurements is not enabled.

This command cannot be entered when CAT2 IPSM to OAM syncing is in progress.

Notes

INP, GSM MAP Screening, LNP, G-Port, A-Port, and IGM measurements are available via FTP transfer only.

If an on-demand report is requested while the collection for that interval is in progress, the requested report will not be generated. The rept-meas command must be entered again.

If this command is executed, and one or more cards did not respond to the request for measurements because the card was Out-Of-Service, then the following warning message may appear: 
Measurement data represents an incomplete interval

This message does not indicate that data was lost.

If this command is executed, and measurements data does not exist for the specified time, then the following message may appear: 
LINK-COMP MEASUREMENT:  LOC: 1201, LINK: A, LSN: (MTP2) 
Measurement data are not current.

Default values are shown for LOC, LINK, and LSN. These values always appear in the message, no matter what values were specified in command.

Output

Note:

Refer to Measurements Reference for rept-meas output examples.

Related Topics