Award Winning Solutions
Xena has won multiple global awards for price/performance and technical innovation. Learn more.
Technical Expertise
Copyright © 20092023 Teledyne LeCroy Xena ApS, Denmark
Explanation 
Obtains statistics concerning all the packets received on a port. 
Parameters 
bps: long integer, number of bits received in the last second. pps: long integer, number of packets received in the last second. bytes: long integer, number of bytes received since statistics were cleared. packets: long integer, number of packets received since statistics were cleared. 
Summary 
get only, value types: L,L,L,L 
Example, get: 
0/0 PR_TOTAL 8000000000 15000000 12345678987654 123456789876 
Explanation 
Obtains statistics concerning the packets without a test payload received on a port. 
Parameters 
bps: long integer, number of bits received in the last second. pps: long integer, number of packets received in the last second. bytes: long integer, number of bytes received since statistics were cleared. packets: long integer, number of packets received since statistics were cleared. 
Summary 
get only, value types: L,L,L,L 
Example, get: 
0/0 PR_NOTPLD 800000 1000 1234567 12345 
Explanation 
Obtains statistics concerning special packets received on a port since receive statistics were cleared. 
Parameters 
fcserrors: long integer, number of packets with frame checksum errors. pauseframes: long integer, number of Ethernet pause frames. arprequests: long integer, number of ARP request packets received. arpreplies: long integer, number of ARP reply packets received. pingrequests: long integer, number of PING request packets received. pingreplies: long integer, number of PING reply packets received. gapcount: long integer, number of gap monitor gaps encountered. gapduration: long integer, combined duration of gap monitor gaps encountered, microseconds. 
Summary 
get only, value types: L* 
Example, get: 
0/0 PR_EXTRA 0 0 0 0 0 2 532 
Explanation 
Obtain the set of test payload IDs observed among the received packets since receive statistics were cleared. Traffic statistics for these test payload streams will have nonzero byte and packet count. tid: integer, identifier of test payload with nonzero packet count. 
Summary 
get only, value types: I* 
Example, get: 
0/0 PR_TPLDS 17 77 
Explanation 
Obtains traffic statistics concerning the packets with a particular test payload id received on a port. 
Parameters 
tid: integer, the identifier of the test payload. bps: long integer, number of bits received in the last second. pps: long integer, number of packets received in the last second. byt: long integer, number of bytes received since statistics were cleared. pac: long integer, number of packets received since statistics were cleared. 
Summary 
get only, test payload id, value types: L,L,L,L 
Example, get: 
0/0 PR_TPLDTRAFFIC [17] 80000000 150000 123456789876 1234567898 
Explanation 
Obtains statistics concerning errors in the packets with a particular test payload id received on a port.
The error information is derived from analysing the various fields contained in the embedded test payloads of the received packets, independent of which chassis and port may have originated the packets.
Note that packetlost statistics involve both a transmitting port and a receiving port, and in particular knowing which port originated the packets with a particular test payload identifier. This information requires knowledge of the global test environment, and is not supported at the portlevel. 
Parameters 
Index Values tid: integer, the identifier of the test payload
Data Values dummy: long integer, not used seq: long integer, number of nonincrementingsequencenumber events. mis: long integer, number of swappedsequencenumber misorder events. pld: long integer, number of packets with nonincrementing payload content. 
Summary 
get only, test payload id, value types: L,L,L,L 
Example, get: 
0/0 PR_TPLDERRORS [17] 0 1 0 0 
Explanation 
Obtains statistics concerning the latency experienced by the packets with a particular test payload id received on a port. The values are adjusted by the portlevel P_LATENCYOFFSET value.
A special value of 1 is returned if latency numbers are not applicable.
Latency is only meaningful when the clocks of the transmitter and receiver are synchronized. This requires the two ports to be on the same test module, and it requires knowledge of the global test environment to ensure that packets are in fact routed between these ports. 
Parameters 
tid: integer, the identifier of the test payload min: long integer, nanoseconds, minimum latency for test payload stream avg: long integer, nanoseconds, average latency for test payload stream max: long integer, nanoseconds, maximum latency for test payload stream avg1sec: long integer, nanoseconds, average latency over last 1second period min1sec*: long integer, nanoseconds, minimum latency during last 1second period max1sec*: long integer, nanoseconds, maximum latency during last 1second period 
Summary 
get only, test payload id, value types: L,L,L,L 
Example, get: 
0/0 PR_TPLDLATENCY [17] 2400 2900 3700 2800
*Note, the last two values were added in Release 57.0. 
Explanation 
Obtains statistics concerning the jitter experienced by the packets with a particular test payload id received on a port. The values are the difference in packettopacket latency, and the minimum will usually be zero.
A special value of 1 is returned if jitter numbers are not applicable. They are only available for TID values 0..31. 
Parameters 
tid: integer, the identifier of the test payload min: long integer, nanoseconds, minimum jitter for test payload stream avg: long integer, nanoseconds, average jitter for test payload stream max: long integer, nanoseconds, maximum jitter for test payload stream avg1sec: long integer, nanoseconds, average jitter over last 1second period min1sec*: long integer, nanoseconds, minimum jitter during last 1second period max1sec*: long integer, nanoseconds, maximum jitter during last 1second period 
Summary 
get only, test payload id, value types: L,L,L,L 
Example, get: 
0/0 PR_TPLDJITTER [17] 0 1234 2900 1345
*Note, the last two values were added in Release 57.0.

Explanation 
Obtains statistics concerning the packets satisfying the condition of a particular filter for a port. 
Parameters 
fid: integer, the subindex of the filter definition. bps: long integer, number of bits received in the last second. pps: long integer, number of packets received in the last second. bytes: long integer, number of bytes received since statistics were cleared. packets: long integer, number of packets received since statistics were cleared. 
Summary 
get only, filter index, value types: L,L,L,L 
Example, get: 
0/0 PR_FILTER [3] 80000000 150000 123456789876 1234567898 
Explanation 
Obtains statistics about received PFC packets on a port. 
Parameters 
packets: long integer. The total number of PFC packets received since statistics were cleared. quantaarray: Array of long integers, one for each priority level (0 – 7). The valid PFC quanta received on the port for that priority level since statistics were cleared. 
Summary 
get only, filter index, value types: L,L,L,L 
Example, get: 
0/0 PR_PFCSTATS 10 0 0 0 0 0 0 0 0 
Explanation 
Multiparameter query, obtaining all the receive statistics for a port. 
Summary 
get only. 
Example, get: 
0/0 PR_TOTAL 8000000000 15000000 12345678987654 123456789876 0/0 PR_NOTPLD 800000 1000 1234567 12345 0/0 PR_EXTRA 0 123 0 0 0 0 0 0/0 PR_TPLDS 17 77 0/0 PR_TPLDTRAFFIC [17] 80000000 150000 123456789876 1234567898 0/0 PR_TPLDERRORS [17] 0 1 0 0 0/0 PR_TPLDLATENCY [17] 2400 2900 3700 0/0 PR_TPLDTRAFFIC [77] 80000000 150000 123456789876 1234567898 . . 0/0 PR_FILTER [3] 80000000 150000 123456789876 1234567898 
Explanation 
Multiparameter query, obtaining all the test payload id error statistics for a port. 
Summary 
get only. 
Example, get: 
0/0 PR_TPLDS 17 77 0/0 PR_TPLDERRORS [17] 0 1 0 0 0/0 PR_TPLDERRORS [77] 2 3 0 7 
Explanation 
Calibrate the latency calculation for packets received on a port. The lowest detected latency value (across all TIDs) will be set as the new base. 
Summary 
set only. 
Example, set: 
0/1 PR_CALIBRATE 
Explanation 
Clear all the receive statistics for a port. The byte and packet counts will restart at zero. 
Summary 
set only. 
Example, set: 
0/0 PR_CLEAR 
Explanation 
Query the RX PFC counter and PFC quanta for each CoS 
Summary 
get only, value type: L* 
Example, set or get: 
0/1 PR_PFCSTATS 0 0 0 0 0 0 0 0 0 