Explanation

Creates a dataset definition with the specified sub-index value.

Parameters

did: integer, the sub-index value of the dataset definition to create.

Summary

set only, dataset index.

Example, set:

0/1 PD_CREATE [0]

Explanation

Whether a dataset is currently active on a port.

When turned on, all the bucket counts are cleared to zero. Subsequently each packet matching the dataset source criteria is counted into one of the buckets. While a dataset is enabled its parameters cannot be changed. did: integer, the sub-index value of the dataset definition.

Parameters

onoff: coded integer, whether the dataset is enabled: OFF ON

Summary

set and get, dataset index, value types: B

Example, set or get:

0/1 PD_ENABLE [0] ON

Explanation

The source criteria specifying what is counted, and for which packets, by a dataset of a port.

Parameters

did: integer, the sub-index value of the dataset definition.

type: coded integer, specifying what is counted and for which packets:

• TXIFG ( inter-frame gap of transmitted packets, measured in bytes)
• TXLEN ( length of transmitted packets, measured in bytes)
• RXIFG ( inter-frame gap of received packets, measured in bytes)
• RXLEN ( length of received packets, measured in bytes)
• RXLAT ( latency of received packets, measured in nanoseconds)

which: coded integer, specifying a further detail on which packets to count: ALL ( all packets specified by the type) TPLD ( only those packets with a particular test payload) FILTER ( only those packets satisfying a particular filter)

id: integer, test payload id or filter id for wanted packets.

Summary

set and get, dataset index, value types: I,I,I

Example, set or get:

0/1 PD_SOURCE [0] RXLEN TPLD 17

Explanation

The bucket ranges used for classifying the packets counted by a dataset of a port.

The packets are either counted by length, measured in bytes, by inter-frame gap to the preceding packet, also measured in bytes, or by latency in transmission measured in nanoseconds.

There are a fixed number of buckets, each middle bucket covering a fixed-size range of values which is a power of two. The first and last buckets count all the packets that don’t fit within the ranges of the midlle buckets. The buckets are placed at a certain offset by specifying the first value that should be counted by the first middle bucket.

Parameters

did: integer, the sub-index value of the dataset definition.

start: integer, first value going into the second bucket.

step: the span of each middle bucket:

• 1,2,4,8,16,32,64,128,256,512 (bytes, non-latency datasets)
• 16,32,64,128,…,1048576, 2097152 (nanoseconds, latency datasets)

count: integer, the total number of buckets

Summary

set and get, dataset index, value types: I,I,I

Example, get:

0/1 PD_RANGE [0] 100 8 256

Explanation

The current set of counts collected by a dataset for a port.

There is one value for each bucket, but any trailing zeros are left out. The list is empty if all counts are zero.

Parameters

did: integer, the sub-index value of the dataset definition.

value: long integer, the number of packets counted for a bucket.

Summary

get only, dataset index, value types: L*

Example, get:

0/1 PD_SAMPLES[0]342567809534 756767654 3124532463 687

Explanation

Multi-parameter query, obtaining all the parameters for a specific dataset.

Parameters

did: integer, the sub-index value of the dataset definition.

Summary

get only, dataset index.

Example, get:

• 0/1 PD_ENABLE [0] ON
• 0/1 PD_SOURCE [0] RXLEN 17
• 0/1 PD_RANGE [0]100 8 256