Award Winning Solutions
Xena has won multiple global awards for price/performance and technical innovation. Learn more.

Technical Expertise
Copyright © 2009-2023 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 non-zero byte and packet count. tid: integer, identifier of test payload with non-zero 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 packet-lost 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 port-level. |
Parameters |
Index Values tid: integer, the identifier of the test payload
Data Values dummy: long integer, not used seq: long integer, number of non-incrementing-sequence-number events. mis: long integer, number of swapped-sequence-number misorder events. pld: long integer, number of packets with non-incrementing 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 port-level 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 1-second period min1sec*: long integer, nanoseconds, minimum latency during last 1-second period max1sec*: long integer, nanoseconds, maximum latency during last 1-second 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 packet-to-packet 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 1-second period min1sec*: long integer, nanoseconds, minimum jitter during last 1-second period max1sec*: long integer, nanoseconds, maximum jitter during last 1-second 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 sub-index 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. quanta-array: 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 |
Multi-parameter 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 |
Multi-parameter 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 |