vasistat command
Purpose
Shows virtual asynchronous services interface (VASI) device driver and device statistics.
Description
The vasistat command displays the statistics gathered by the specified VASI device driver. The user can optionally specify that the device-specific statistics be displayed in addition to the device generic statistics. This will display statistics for all the operations, such as migrations, in that VASI device. The user can also optionally specify to display statistics for a specific stream. If no flags are specified, only the device generic statistics are displayed.
Flags
Flag name | Description |
---|---|
-all | Displays all the statistics, including the device-specific statistics. |
-debug | Toggles internal debug tracing in device driver. |
-interval time_interval | Sets the monitoring time interval of the logical partition mobility in seconds. |
-reset | Resets all the statistics back to their initial values. |
-stream streamID | Displays statistics only for the specified stream. |
Parameters
Parameter | Description |
---|---|
Device | The name of the VASI device. For example, vasi0. |
Exit Status
- Device Type
- Displays the description of the adapter type.
- Elapsed Time
- Displays the real time period which has elapsed since last time the statistics were reset.
Transmit statistics fields
Statistic | Description |
---|---|
Packets | The number of packets transmitted successfully to PHYP by the device. |
Bytes | The number of bytes transmitted successfully to PHYP by the device. |
Transmit Errors | The number of output errors encountered on this device. This is a counter for unsuccessful transmissions due to errors returned by PHYP. |
Bad Packets | The number of outgoing packets that could not be sent because they were malformed (for example, packets exceeding the VASI MTU size). |
No Buffers | The number of times a packet could not be sent to PHYP because there were no transmit buffers available for sending. |
Interrupts | The number of transmit interrupts (for example, attempts at transmitting a packet to PHYP). |
Receive Statistics Fields
Statistic | Description |
---|---|
Packets | The number of packets received successfully from PHYP by the device. |
Bytes | The number of bytes received successfully from PHYP by the device. |
Receive Errors | The number of receive errors encountered on this device (for example, bad packets). |
Bad Packets | The number of incoming packets that could not be processed because they were malformed (for example, VASI could not figure out to which operation the data belonged to). |
No Buffers | The number of times VASI tried to allocate a system buffer but there was no memory to do so. This is a soft error since the data will still be delivered in the original buffer. |
Interrupts | The number of receive interrupts (for example, number of CRQ entries received by VASI). |
System Buffers | The number of system buffers allocated when the receive buffer pools are low on buffers. |
Miscellaneous Statistics Fields
Statistic | Description |
---|---|
Interrupt Processing Exceeded | The number of times this device attempted to process more packets on the interrupt context than the maximum allowed. |
Offlevel Interrupt Scheduled | The number of times an offlevel interrupt was scheduled on this device, in order to handle packets that could not be handled on the interrupt context. |
Maximum Operations | The maximum number of operations (for example, migrations) this device can handle simultaneously. |
Maximum Receive Pools | The maximum number of different receive pool sizes this device can handle. |
Active Operations | The number of operations (for example, migrations) that are currently active on this device. |
Operation-specific Statistics Fields
These statistics are displayed for each operation, either active or inactive. Inactive applications will have the text INACTIVE in the title header, and the text INVALID STREAM ID will appear in the Stream ID field. None of these statistics will be zeroed out by the -reset flag.
Statistic | Description |
---|---|
Operation Type | The type of this operation (for example, migration) as well as any pertinent information (for example, whether it is the source or target of the migration). |
Stream ID | The unique number that identifies this operation; the text INVALID STREAM ID denotes that this operation is no longer active. |
TOP/BOTTOM | The opaque identifiers used by the VASI device and PHYP to refer to this operation. |
Elapsed Time | Displays the real time period which has elapsed since the operation was started. This time will stop when the operation is terminated, so it can be used to measure how long the operation took to complete. |
Flags | Denotes values that may be used to describe
this operation:
|
Operation State | State the operation is in with regards to its
setup:
|
Stream State | State the stream (for example, migration) is
in; these values will vary depending on the operation in question.
For migration, these states are as follows:
|
Total Bytes to Transfer | The estimated total number of bytes to transfer for this operation |
Bytes Left to Transfer | The estimated number of bytes that are left to transfer for this operation |
Receive Buffer Usage Statistics Fields
These statistics are displayed only for operations that are currently active. For every receive buffer pool the following information is shown in tabular form:
Statistic | Description |
---|---|
Size | The size in bytes of the packets of the buffer pool. |
Reg | The number of buffers from the buffer pool that are currently registered with PHYP. |
Alloc | The number of buffers that have been allocated for the buffer pool. |
Max | The maximum number of buffers that could ever be allocated to this buffer pool. |
LowReg | The lowest number of buffers from this pool that have ever been registered with PHYP. |
Transmit Buffer Usage Statistics Fields
These statistics are displayed only for operations that are currently active.
Statistic | Description |
---|---|
Number of Buffers | The number of buffers that have been allocated for the transmit buffer pool. |
Buffer Size | The size in bytes of the packets of the transmit buffer pool. |
Mapped | The number of buffers in the transmit buffer pool that have been DMA-mapped. |
Next Available Buffer | The index of the next buffer to be used in the transmit buffer pool. |
In Use | The number of buffers in the transmit buffer pool that are currently being used. |
Maximum Used | The maximum number of buffers in the transmit buffer pool that have ever been used concurrently. |
Examples
- To display the device generic statistics for vasi0, type the command
as follows:
vasistat vasi0
This produces output similar to the following:
VASI STATISTICS (vasi0) : Device Type: Virtual Asynchronous Services Interface (VASI) Elapsed Time: 0 days 0 hours 10 minutes 38 seconds Transmit Statistics: Receive Statistics: -------------------- ------------------- Packets: 2 Packets: 179098 Bytes: 224 Bytes: 753605020 Transmit Errors: 0 Receive Errors: 0 Bad Packets: 0 Bad Packets: 0 No Buffers: 0 No Buffers: 0 Interrupts: 2 Interrupts: 214876 System Buffers: 0 Interrupt Processing Exceeded: 0 Offlevel Interrupt Scheduled: 0 Driver Flags: Up Running 64BitSupport Maximum Operations: 4 Maximum Receive Pools: 3 Active Operations: 1
- To display the VASI device generic statistics and the statistics
for all the operations for vasi0, type the command as follows:
vasistat -all vasi0
This produces results similar to the following:
VASI STATISTICS (vasi0) : Device Type: Virtual Asynchronous Services Interface (VASI) Elapsed Time: 0 days 0 hours 10 minutes 38 seconds Transmit Statistics: Receive Statistics: -------------------- ------------------- Packets: 2 Packets: 179098 Bytes: 224 Bytes: 753605020 Transmit Errors: 0 Receive Errors: 0 Bad Packets: 0 Bad Packets: 0 No Buffers: 0 No Buffers: 0 Interrupts: 2 Interrupts: 214876 System Buffers: 0 Interrupt Processing Exceeded: 0 Offlevel Interrupt Scheduled: 0 Driver Flags: Up Running 64BitSupport Maximum Operations: 4 Maximum Receive Pools: 3 Active Operations: 1 Statistics for each operation: ============================== Operation #0 (ACTIVE): ---------------------- Operation Type: Migration (Source) Stream ID: 0000000000000001 TOP/BOTTOM: 00000000/00040000 Elapsed Time: 0 days 0 hours 0 minutes 11 seconds Flags: <RUNNABLE> Operation State: Operational Stream State: Enabled Total Bytes to Transfer: 546832384 Bytes Left to Transfer: 360833024 Transmit Statistics: Receive Statistics: -------------------- ------------------- Packets: 1 Packets: 45415 Bytes: 112 Bytes: 191086638 Transmit Errors: 0 Receive Errors: 0 Bad Packets: 0 Bad Packets: 0 No Buffers: 0 No Buffers: 0 Interrupts: 1 Interrupts: 0 System Buffers: 0 Receive Buffer Usage: --------------------- Size Reg Alloc Max LowReg Pool #0 8192 198 256 256 193 Pool #1 2048 2048 2048 2048 2044 Transmit Buffer Usage: ---------------------- Number of Buffers: 64 Buffer Size: 16384 bytes Mapped: 64 Next Available Buffer: 0 In Use: 0 Maximum Used: 1 Operation #1 (INACTIVE): ------------------------ Operation Type: Unknown (Unknown) Stream ID: ** INVALID STREAM ID ** TOP/BOTTOM: 00000000/00000000 Elapsed Time: 0 days 0 hours 0 minutes 0 seconds Flags: Operation State: Not Operational Stream State: Unknown Total Bytes to Transfer: 0 Bytes Left to Transfer: 0 Transmit Statistics: Receive Statistics: -------------------- ------------------- Packets: 0 Packets: 0 Bytes: 0 Bytes: 0 Transmit Errors: 0 Receive Errors: 0 Bad Packets: 0 Bad Packets: 0 No Buffers: 0 No Buffers: 0 Interrupts: 0 Interrupts: 0 System Buffers: 0 Operation #2 (INACTIVE): ------------------------ Operation Type: Unknown (Unknown) Stream ID: ** INVALID STREAM ID ** TOP/BOTTOM: 00000000/00000000 Elapsed Time: 0 days 0 hours 0 minutes 0 seconds Flags: Operation State: Not Operational Stream State: Unknown Total Bytes to Transfer: 0 Bytes Left to Transfer: 0 Transmit Statistics: Receive Statistics: -------------------- ------------------- Packets: 0 Packets: 0 Bytes: 0 Bytes: 0 Transmit Errors: 0 Receive Errors: 0 Bad Packets: 0 Bad Packets: 0 No Buffers: 0 No Buffers: 0 Interrupts: 0 Interrupts: 0 System Buffers: 0 Operation #3 (INACTIVE): ------------------------ Operation Type: Unknown (Unknown) Stream ID: ** INVALID STREAM ID ** TOP/BOTTOM: 00000000/00000000 Elapsed Time: 0 days 0 hours 0 minutes 0 seconds Flags: Operation State: Not Operational Stream State: Unknown Total Bytes to Transfer: 0 Bytes Left to Transfer: 0 Transmit Statistics: Receive Statistics: -------------------- ------------------- Packets: 0 Packets: 0 Bytes: 0 Bytes: 0 Transmit Errors: 0 Receive Errors: 0 Bad Packets: 0 Bad Packets: 0 No Buffers: 0 No Buffers: 0 Interrupts: 0 Interrupts: 0 System Buffers: 0
- To display the VASI statistics for the vasi0
stream, type the command as follows:
vasistat -stream 0x3F7A vasi0
- To monitor all active operations for the vasi0
stream every 3 seconds, type the command as follows:
vasistat -interval 3 vasi0
- To monitor a specific operation for the vasi0
stream every 5 seconds, type the command as follows:
vasistat -interval 5 -stream 0x3F7A vasi0