This chapter describes procedures for monitoring the operation of an IRIS ATM subsystem.
A number of commands are provided to help monitor the IRIS ATM subsystem, as shown in the following list:
The atmconfig command (-s and -m options) provides information about the hardware (-i# specifies the port).
The atmstat command displays status and performance statistics (-i# specifies the port).
The ifatmconfig command displays logical IP subnetwork (LIS) information, such as an ATM address for the local endpoint, the ATMARP server, VC timeout, and transmission rate (atm# specifies the LIS, that is, the logical network interface).
Table 4-1, summarizes the information that can be displayed and the command line for each.
Table 4-1. Summary of IRIS ATM Status Information Displays
| Information | Command | More Info |
|---|---|---|---|
Hardware Information | Local MAC address | atmconfig -i# -m | |
| Local port's ATM address | ifatmconfig atm# | |
| Current rates for the transmission rate queues on IRIS ATM HIO board (only) | atmstat -i# -q | |
| Board's configuration | atmconfig -i# -s | |
| Version of the firmware currently loaded onto board | atmconfig -i# -V | |
| State of IRIS ATM board (up, down, etc.) | atmstat -i# -s | |
Port statistics | Status information about specific low-levels: receive and reassembly | atmstat -i# -r atmstat -i# -rv | |
| Transmit and fragmentation | atmstat -i# -t atmstat -i# -tv | |
| SONET layer | atmstat -i-S# atmstat -i# -Sv | |
| Complete listing of low-level status information (transmit, receive, and SONET) | atmstat -i# -a atmstat -i# -av | |
| Constantly updated complete listing of low-level status information (transmit, receive, and SONET). Display can be set to provide ongoing incremental statistics, 1 second totals (deltas), or start-from-now counts. | atmstat -i# -C |
|
| Local port's ATM address | ifatmconfig atm# | |
Driver information | IRIS ATM driver statistics | atmstat -i# -d | |
VC information | Currently active VCs (PVCs and SVCs), including those used by atmsigd and atmilmid for protocol overhead purposes | atmstat -i# -V | |
LIS information | Local ATM address for IP logical network interface | ifatmconfig atm# | |
| IP-to-PVC address resolution table, same information with ATM addresses | atmarp -a atmarp -al | |
| IP-over-SVC information for each LIS (ATMARP server, transmit rate, and timeout value) | ifatmconfig atm# |
You can display the following information about the board:
Board configuration information (see “Displaying Board Configuration Information”)
The firmware version (see “Displaying the Firmware Version”)
The board's current state (see “Displaying the Current Board State”)
Transmission rates on board queues (see “Displaying Transmission Rates on Board Queues”)
Receive and reassembly status information (see “Displaying Receive and Reassembly Status Information”)
Transmit and fragmentation status information (see “Displaying Transmit and Fragmentation Status Information”)
SONET layer status information (see “Displaying SONET Layer Status Information”)
All status information (see “Displaying All Status Information”)
A port's MAC address (see “Displaying the Port's MAC Address”)
A port's ATM address (see “Displaying the Port's ATM Address”)
The following sections describe how to access this information.
To display the settings of the board's operational parameters (that is, its configuration), use the command line below. Table 4-2, describes each of the parameters.
% /usr/etc/atmconfig -i# -s |
The # variable identifies the port number.
Table 4-2. Board Configuration Parameters
Field | Description |
|---|---|
sign | ATM-OC3c board's signature |
vers | ATM-OC3c board's / FLASH EEPROM's version |
xtype | Transmission type: 1 =XT_UNKNOWN 2 =XT_STS3C, SONET STS-3c physical layer at 155.52 Mbps 3 =XT_DS3=3, DS3 physical layer at 44.736 Mbps 4 =XT_4B5B=4, 4B/5B encoding physical layer at 100 Mbps 5 =XT_8B10B, 8B/10B encoding physical layer at 155.52 Mbps |
mtype | Media type: 1 =MT_UNKNOWN 2 =MT_COAX, Coax cable 3 =MT_SMF, Single-mode fiber 4 =MT_MMF, Multi-mode fiber 5 =MT_STP, Shielded twisted pair 6 =MT_UTP, Unshielded twisted pair |
maxvpibits | Maximum number of bits that can be used for a VPI. Range of possible values is 0 to 8. |
maxvcibits | Maximum number of bits that can be used by a VCI. Range of possible values is 0 to 16. |
xmt_large_size | Size (in bytes) of large-sized transmit buffers. |
xmt_large_bufs | Number of large-sized transmit buffers. |
xmt_small_size | Size (in bytes) of small-sized transmit buffers. |
xmt_small_bufs | Number of small-sized transmit buffers. |
rcv_large_size | Size (in bytes) of large-sized receive buffers. |
rcv_large_bufs | Number of large-sized receive buffers. |
rcv_small_size | Size (in bytes) of small-sized receive buffers. |
rcv_small_bufs | Number of small-sized receive buffers. This size buffer is only used for AAL3/4. |
To display the version of the firmware that is currently loaded into the board's dynamic random access memory (DRAM), use the following command line:
% /usr/etc/atmconfig -i# -V |
The # variable identifies the particular port's number.
The retrieved version was calculated originally with the formula below:
((((yy-92)*13+m)*32+d)*24+hr)*60+minute |
In this formula, yy is the final two digits from the year when the version was created (for example, 93 or 94), m is the numerical month (1-12), d is the numerical day (1-31), and hr and minute are the time (0-24 for hour and 0-60 for minute).
To display the ATM-OC3c board's current state, use the following command line. The board can be in any one of three states described in Table 4-3.
% /usr/etc/atmstat -i# -s |
The # variable identifies the particular port's number.
Table 4-3. ATM-OC3c Board States
State | Description |
|---|---|
DEAD | The board is not responding in any manner. It may not have power, it may be loose, or it may be dysfunctional. |
PRE-INIT | The board has power, but has not been initialized. |
DOWN | The board is initialized and can communicate with the host. The interface to the network (that is, the SONET components) are not operating, so no data is being transmitted or received. |
UP | The board is operating. |
To display the current rates for the eight rate queues on an ATM-OC3c board, use the following command lines. Figure 4-1, shows the display.
% /usr/etc/atmstat -i# -q |
The # variable identifies the particular port's number.
The displayed rates indicate both the number of ATM cells per second and the number of bits of user data per second that are transmitted by that rate queue.
 | Note: Each ATM cell contains 48-bytes (384 bits) of user data. |
To display information about the receive and reassembly functions, use the following command line:
% /usr/etc/atmstat -i# -r |
The # variable identifies the particular port's number. Table 4-4, describes the displayed information.
Table 4-4. Receive Statistics: atmstat -r
Screen Display | Possible Values | Description |
|---|---|---|
/hw/atm/#: interface HW state: state | # = 0 - 12 state = UP, DOWN, INIT, DEAD | # = port number state = current state of port |
Receive protocol data unit (PDU) statistics: |
|
|
PDUs received OK | 0 - count | Total PDUs received correctly. |
PDUs reassembly timeouts | 0 - count | PDU reassemblies that never completed. |
PDUs reassembly buffer size exceeded | 0 - count | PDU reassemblies that exceeded buffer size. |
PDUs AAL5 CRC-32 errors | 0 - count | PDUs that had AAL5 CRC errors. |
PDUs AAL5 length errors | 0 - count | PDUs that violated AAL5 size limit. |
PDUs unknown errors (none of the above) | 0 - count | PDUs that had errors that were not any of those listed above. |
Receive Cell Statistics: |
|
|
Cells OK | 0 - count | Total ATM cells received correctly. |
Cells dropped because invalid (unknown) VPI/VCI | 0 - count | ATM cells that were dropped due to unrecognized or bad VPI/VCI. |
Cells dropped due to no buffer available | 0 - count | ATM cells that were dropped due to lack of available (free) memory on the board. |
Cells unknown error (none of the above) | 0 - count | ATM cells that were dropped due to causes that are none of those listed above. |
Receive SONET Errors: |
|
|
SONET Section-layer BIP-8 errors | 0 - count | Section Overhead BIP-8 errors (B1 byte). |
SONET Line-layer BIP-24 errors | 0 - count | Line Overhead BIP-24 errors (that is, the BIP-8 [B2 byte] from the Line Overhead of each STS-1). |
SONET Path-layer BIP-8 errors | 0 - count | Path Overhead BIP-8 errors (B3 byte). |
Correctable ATM HEC errors | 0 - count | Correctable errors that were detected by an ATM cell's header-error-control (HEC) field. |
Uncorrectable ATM HEC errors | 0 - count | Errors detected by an ATM cell's header-error-control (HEC) field that could not be corrected. |
To display information about the transmit and fragmentation functions, use the following command line:
% /usr/etc/atmstat -i# -t |
The # variable identifies the particular port's number. Table 4-5, describes the displayed information.
Table 4-5. Transmit Statistics: atmstat -t
Screen Display | Possible Values | Description |
|---|---|---|
/hw/atm/#: interface HW state: state | # = 0 - 12 state = UP, DOWN, INIT, DEAD | # = port number state = current state of port |
Transmit PDU Statistics: |
|
|
PDUs transmitted OK | 0 - count | Total PDUs transmitted correctly. |
PDUs failed, unknown errors | 0 - count | All errors on transmitted PDUs. |
Transmit Cell Statistics: |
|
|
Cells ok | 0 - count | Total ATM cells transmitted correctly. |
Transmit SONET (far-end) Errors: |
|
|
SONET Line-layer FEBEs | 0 - count | Line-layer (FEBE bits in Z2 byte) far-end-block-errors (FEBEs). This information is contained within received SONET frames, but it describes the error rate on the transmit data stream. Reported errors could have occurred anywhere along the entire line. |
SONET Path-layer FEBEs | 0 - count | Path-layer (FEBE bits in G1 byte) far-end-block-errors. This information is contained within received SONET frames but it describes the error rate on the transmit data stream. Reported errors could have occurred anywhere along the entire path. |
To display information about the SONET layer functions, use either of the following command lines:
% /usr/etc/atmstat -i# -S % /usr/etc/atmstat -i# -Sv |
The # variable identifies the particular port's number, and -v provides additional explanation about the meaning of each item of status information.
Table 4-6. SONET Statistics: atmstat -Sv
Screen Display | Possible Values | Description |
|---|---|---|
/hw/atm/#: interface HW state: state | # = 0 - 12 state = UP, DOWN, INIT, DEAD | # = port's number state = current state of port |
SONET Level Statistics: |
|
|
Received Parity errors | 0 - count | Total of Section-layer BIP-8 errors (B1 byte), Path-layer BIP-8 errors (B3 byte), and Line-layer BIP-24 errors (that is, the BIP-8 [B2 byte] from the Line Overhead of each STS-1). |
Far End Bit Errors | 0 - count | Total of Line-layer (FEBE bits in Z2 byte) and Path-layer (FEBE bits in G1 byte) far-end-block-errors. This information is contained within received SONET frames but it describes the error rate on the transmit data stream. Reported errors could have occurred anywhere along the connection. |
Path Condition: state | OK or YELLOW | YELLOW = Path layer yellow-signal error state currently exists in the receiving hardware. |
Path Alarm: state | OK or ALARM | ALARM = Path layer alarm-indication-signal error state currently exists in the receiving hardware. |
Line Alarm: state | OK or ALARM | ALARM = Line layer alarm-indication-signal state currently exists in the receiving hardware. |
reg_contents SONET status bits: |
| Each SONET status item is one bit of an onboard register. reg_contents displays the value of that register. For each item: 0= not set; 1= set (event is current). |
Loss of Signal (LOS) | 0 or 1 | Section layer: loss-of-signal error state currently exists in the receiving hardware. |
Loss of Frame (LOF) | 0 or 1 | Section layer: loss-of-frame error state currently exists in the receiving hardware. |
Out of Frame (OOF) | 0 or 1 | Section layer: out-of-frame error state currently exists in the receiving hardware. |
Far End Receive Failure (FERF) | 0 or 1 | Line layer: far-end-receive-failure state currently exists in the receiving hardware. |
Line Alarm Indication Signal (LAIS) | 0 or 1 | Line layer: alarm-indication-signal state currently exists in the receiving hardware. |
Loss of Path (LOP) | 0 or 1 | Path layer: loss-of-pointer error state currently exists in the receiving hardware. |
Path Alarm Indication Signal (PAIS) | 0 or 1 | Path layer: alarm-indication-signal error state currently exists in the receiving hardware. |
Path Yellow Condition (Yel) | 0 or 1 | Path layer: yellow-signal error state currently exists in the receiving hardware. |
Out Of Cell Delineation | 0 or 1 | Out-of-cell-delineation state currently exists. The IRIS ATM receiving hardware is trying to synchronize with the cell boundaries in the SPE of the incoming SONET frame. |
Transmit Start of Cell error (TSOC) | 0 or 1 | Start-of-cell error has occurred on the IRIS ATM transmit hardware. |
Transmit FIFO overrun | 0 or 1 | FIFO overrun has occurred on the IRIS ATM transmit hardware. |
Receive FIFO overrun | 0 or 1 | FIFO overrun has occurred on the IRIS ATM receive hardware. |
Receive FIFO underrun | 0 or 1 | FIFO underrun has occurred on the IRIS ATM receive hardware. |
mask Path Signal Label (C2) | any | Path layer: contents of the Signal Label (C2 byte) on incoming frames. A new value is captured when three consecutive frames have the same value. For the IRIS ATM hardware, this value should be 0x13 (hex) at all times. |
To capture and display all the current status information (transmit, receive, and SONET), use the following command line:
% /usr/etc/atmstat -i# -av |
The # variable identifies the port's number. Table 4-4, Table 4-5, and Table 4-6, describe the displayed information.
To display a constantly updating window of the current status information (transmit, receive, and SONET), use the following command line:
< open a UNIX shell/window that is at least 80x60 > % /usr/etc/atmstat -i# -Cv < d = start a new count every second, r = display accumulating total since the last reboot, z = set all counters to 0 and start accumulating new totals> |
In this example, # identifies the port's number. Table 4-4, Table 4-5, and Table 4-6, describe the displayed information.
To display a medium access control (MAC) address, use the following command line:
% /usr/etc/atmconfig -i# -m |
The # variable identifies the particular port's (board's) unit number.
To display a port's ATM address in hexadecimal format, invoke the ifatmconfig or sigtest utility, as follows:
When the port is configured to support IP-over-ATM, use this command:
# ifatmconfig atm#
The atm# variable specifies one of the IP-over-ATM network interfaces associated with that port.
When the port does not support IP-over-ATM, use this command:
# /usr/lib/atm/bin/sigtest Menu selections: [0] Quit [1] Register to accept incoming calls [2] Attempt to setup a point-to-point call [3] Attempt to setup a point-to-multipoint call Enter choice: 2 Using calling address: address type = NSAP Address = 47000580ffe1000000f21a01600800690422e900 <terminate sigtest by pressing the CTRL and C keys> #
You can display the following information about the virtual channel:
Currently active VCS (see “Displaying Currently Active VCs”)
IP-to-VC address resolution table (see “Displaying IP-to-VC Address Resolution Table”)
The following sections describe how to access this information.
To display the table of currently active virtual circuits (VCs), use the following command line:
% /usr/etc/atmstat -i# -V |
The # variable identifies the particular port's number.
The flags column in the terminal display indicates operational information about each active VC, which can be any combination of the flags described in Table 4-7:
Table 4-7. Active Virtual Channel Information
Flag | Description |
|---|---|
READ | The channel is valid for reception. |
WRITE | The channel is valid for transmission. |
NOSNAP | The VC is not using LLC/SNAP encapsulation. This flag is only valid for PVCs. |
IP | The VC is servicing an IP stack. |
To display the contents of the IP-to-PVC address resolution table, use the following command line:
% /usr/etc/atmarp -a |
To display known remote ATM addresses, as well as the other contents of the IP-to-PVC address resolution table, use the following command line:
% /usr/etc/atmarp -al |
The flags column in the terminal display indicates status and information about each PVC, which can be any combination of the flags described in Table 4-8.
Table 4-8. ATMARP Address Resolution Table Flags
Flag | Description |
|---|---|
CONN | The connection has been established for the VC. |
COMPL | The ATM address for this IP address has been obtained. |
NOSNAP | The VC is not using LLC/SNAP encapsulation. This flag is only valid for PVCs. |
VALIDATE | The IP address has been validated with Inverse ARP. |
PVC | The VC is a permanent virtual channel (PVC), not a switched one. |
PEND | The connection has not yet been established; it is pending setup completion. |
NAK | The ATMARP server has responded that it does not recognize this endpoint. The entry will soon be removed from the table. |
To display IRIS ATM driver statistics, use either of the following command lines. Table 4-9, describes the parameters displayed.
% /usr/etc/atmstat -i# -d % /usr/etc/atmstat -i# -dv |
The # variable identifies the particular port's number, and -v provides additional driver statistics.
Table 4-9. Driver Statistics: atmstat -dv
Driver Statistic | Description |
|---|---|
/hw/atm/#: interface HW state | Specifies the indicated board's state. States are described in Table 4-3. |
Input packets | Count of incoming ATM packets. |
Input bytes | Count of total incoming bytes. |
Input packet drops | Count of packets that were dropped. The count includes packets dropped due to buffer overflows and unknown VCC addresses. |
Output packets | Count of outgoing ATM packets. |
Output bytes | Count of total outgoing bytes. |
Output errors | Currently unused. |
xcmd_dly | Count of commands that were delayed (not immediately placed on the command queue) due to heavy use of the command interface. |
xmit_dly | Count of transmit commands that were delayed (not immediately placed on the command queue) due to heavy use of the command interface. |
intrs | Count of host-to-board interrupts. |
b2hs | Count of board-to-host interrupts. |
xmit_reqs | Count of transmit requests. |
h2b_kicks | Number of times host has reset the board. |
xmit_intrs | Count of transmit interrupts. |
odone_intrs | Count of transmit done messages sent by board to host. When this count equals the xmit_reqs count, all data on the transmit queues has been processed. |
recv_intrs | Count of receive interrupts. |
fet_stat | Number of times host has retrieved board status. |
For each logical IP subnetwork (LIS), you can display the following information:
The local ATM address
Local LIS information
To display the ATM address for an endpoint (that is, an IP logical network interface) that is using IP-over-SVC, use the following command line:
% /usr/etc/ifatmconfig atm# |
The # variable identifies the IP network interface (for example, atm0 or atm1).
For information about displaying PVC information, see “Displaying Virtual Channel Information”.
The IRIS ATM management information database (MIB) is viewable with any simple network management protocol (SNMP) MIB browser, for example, the browsers included in Silicon Graphics' NetVisualyzer and IRIXPro applications. Complete instructions for using these applications are provided in the user documentation for these products (for example, in the NetVisualyzer User's Guide).
The path within the SNMP containment tree for the ATM UNI MIB is the following:
By name:
iso.organization.dod.internet.private.enterprises.atmForum.atmForumUni
By identification number:
1.3.6.1.4.1.353.2