Point-to-Point Transmitter Channel Object
Each point-to-point transmitter manages an arbitrary number of point-to-point transmitter channels which are bound to corresponding receiver channels in another node via a point-to-point link. The channels are labeled "channel [0]" through channel [n-1]", for transmitters with n channels. Point-to-point transmitter channels are children of a special object called a compound attribute object (CA object). The CA object is the value of the "channel" attribute of a point-to-point transmitter.
For more information about compound attributes, see Chapter 9 "Communication Mechanisms" on page 331.
Point-to-Point Transmitter Channel Object Attributes
The following table lists the built-in attributes of the point-to-point transmitter channel object.
Table 20: Point-to-Point Transmitter Channel Object Built-In Attributes
| Name | Data Type |
|---|---|
| bit capacity | double |
| data rate | double |
| packet formats | string |
| pk capacity | double |
Point-to-Point Transmitter Channel Object Statistics
The following table lists the statistics available for a point-to-point transmitter channel object.
Table 21: Point-to-Point Transmitter Channel Object Statistics
| Name | Units |
|---|---|
| busy | N/A |
| overflows | N/A |
| queue size (bits) | bits |
| queue size (packets) | packets |
| queuing delay | seconds |
| throughput (bits/sec) | bits/second |
| throughput (packets/sec) | packets/second |
| utilization | N/A |
The following table lists the events that update the indicated statistics of a point-to-point transmitter.
Table 22: Point-to-Point Transmitter Channel Object Statistic Events
| Event | Statistics Updated |
|---|---|
| packet arrival | queue size (bits), busy, queue size (packets), overflows |
| transmission start | busy |
| transmission complete | queue size (bits), throughput (bits/sec), busy, queuing delay, queue size (packets), throughput (packets/sec), utilization |
Each point-to-point transmitter channel object statistic is described below.
busy
This statistic is a Boolean value (0.0 or 1.0) that represents whether any packets are currently being transmitted on the transmitter channel. This statistic goes high at the instant that a packet first starts to be sent on the transmitter channel, and goes low when the trailing edge of the packet has completed transmission.
| Units | not applicable |
| Initial Value | 0.0 |
overflows
This statistic represents a running count of the number of times the transmission queue has had to drop a packet due to lack of capacity. overflows is monotonically increasing and is updated whenever a packet insertion fails.
| Units | not applicable |
| Initial Value | 0.0 |
queue size (bits)
This statistic represents the accumulated lengths (in bits) of the packets currently awaiting transmission in the channel's transmission queue. The transmitter channel maintains a queue to enforce disciplined utilization of the channel bandwidth while allowing arbitrary arrivals at its input. This statistic includes the bits of the packet currently in service, and is updated every time a new packet is given to the transmitter channel or whenever a packet completes transmission.
| Units | bits |
| Initial Value | 0.0 |
queue size (packets)
This statistic represents the current number of packets awaiting transmission in the channel's transmission queue. The transmitter channel maintains a queue to enforce disciplined utilization of the channel bandwidth while still allowing arbitrary arrivals at its input. This statistic includes the packet currently in service by the transmitter, and is updated every time a new packet is given to the transmitter channel or whenever a packet completes transmission.
| Units | packets |
| Initial Value | 0.0 |
queuing delay
This statistic represents instantaneous measurements of packet waiting times in the transmitter channel's queue. Measurements are taken from the time a packet enters the transmitter channel queue to the time the last bit of the packet is transmitted. A new sample of queuing delay is generated whenever a packet completes transmission.
| Units | seconds |
| Initial Value | undef |
throughput (bits/sec)
This statistic has two possible meanings, depending on collection method:
- When collected by statistic probe, this statistic represents the average number of bits forwarded over the transmitter channel per second. This statistic is computed by dividing the total number of bits transmitted to date by the current simulation time.
- When collected by statistic wire, this statistic has one of two values: 0 and the channel data rate. Instantaneous throughput is not accumulated.
New samples of throughput (bits/sec) are generated whenever a packet completes transmission. Packets awaiting transmission in the channel's queue do not contribute to this statistic until they complete transmission.
| Units | bits/second |
| Initial Value | 0.0 |
throughput (packets/sec)
This statistic has two possible meanings, depending on collection method:
- When collected by statistic probe, this statistic represents the average number of packets forwarded over the transmitter channel per unit time, in packets per second. It is computed by dividing the total number of packets transmitted to date by the current simulation time.
- When collected by statistic wire, this statistic has one of two values: 0 and the channel data rate. Instantaneous throughput is not accumulated.
New samples of throughput (packets/sec) are generated whenever a packet completes transmission. Packets awaiting transmission in the channel's queue do not contribute to this statistic until they complete transmission.
| Units | packets/second |
| Initial Value | 0.0 |
utilization
This statistic has two possible meanings, depending on collection method.
- When collected by statistic probe, this statistic is a measure of the consumption to date of available channel bandwidth. The value is expressed as a percentage, where 100 indicates full usage. It provides a value equivalent to the running time-average of the "busy" statistic. Utilization is computed by dividing the cumulative amount of time the transmitter has been busy to date by the current simulation time.
- When collected by statistic wire, this statistic has one of two values: 0 and 100. Instantaneous utilization is not accumulated.
New samples of utilization are generated whenever the transmitter channel completes a packet transmission.
| Units | not applicable |
| Initial Value | 0.0 |