x25stat(1)

Requires Optional LAN/X.25 Software

NAME

x25stat − display interface status, configuration information, and virtual circuit statistics.

SYNOPSIS

x25stat [-d dev_file] [-t] [-p] [-g] [-f] [-c] [-a] [-x] [-s] [-e]

DESCRIPTION

x25stat displays X.25 interface status information, configuration information, and virtual circuit statistics. If no options are provided, x25stat displays the virtual circuit types, the status of each virtual circuit, and the connections (local X.121 address and the foreign X.121 address) for all virtual circuits.

Default Operation

If no options are specified, the following information is produced:

LCI Logical Channel Index number for each virtual circuit. Assignment of LCI values to virtual circuits is based on an agreement between the local node subscriber to the network and the network administration at subscription time. Values are only significant for the local node and network provider interface.

Virtual circuit types Supported virtual circuit types are:

• SVC-inb (switched virtual circuits inbound),

• SVC-outb (switched virtual circuits outbound),

• PVC (permanent virtual circuits), and

• SVC -2way (switched virtual circuit − two way).

Local address The X.121 address of the local interface card.

Foreign address The X.121 address of the foreign host.

VC open time The length of time the VC has been open in
hours.minutes.seconds.

VC state Possible VC states are:

• disconnecting (in the process of disconnecting)

• connecting (a connect call has been issued but no acknowledgement has been received),

• connected (the VC is connected),

• inactive (the PVC has not been used, although the interface card has been initialized), or

• unknown (an error condition occurred on the VC).

Options

-d dev_file Obtain information for X.25 driver interface dev_file. If this option is not specified, the default value of /dev/x25_0 is assumed. X.25 subsystem device file are located in directory /dev.

-t Display virtual circuit data counters. Virtual circuit statistics for this option are cleared at the start of each connection. Counters are provided for the following categories:

LCI Logical Channel index number for each virtual circuit. Assignment of LCI values to virtual circuits is based on an agreement between the local node subscriber to the network and the network administration at subscription time. Values are only significant for the local node and network provider interface.

VC state possible VC states are:

• disconnecting (in the process of disconnecting)

• connecting (a connect call has been issued but no acknowledgement has been received),

• connected (the VC is connected),

• inactive (the PVC has not been used, although the interface card has been initialized), or

• unknown (an error condition occurred on the VC).

Imsgs number of inbound messages for this virtual circuit

Omsgs number of outbound messages for this virtual circuit

Ipackets number of inbound packets received by this virtual circuit (not displayed on Series 300/400)

Opackets number of outbound packets sent by this virtual circuit (not displayed on Series 300/400)

Ioctets number of inbound octets received by this virtual circuit

Ooctets number of outbound octets sent by this virtual circuit

-p Display non-data packet counts for each virtual circuit. Virtual circuit statistics for this option are cleared at the start of each connection.

VC state Possible VC states are:

• disconnecting (in the process of disconnecting)

• connecting (a connect call has been issued but no acknowledgement has been received),

• connected (the VC is connected),

• inactive (the PVC has not been used, although the interface card has been initialized), or

• unknown (an error condition occurred on the VC).

VC User Indicates the user of the VC. This can be level-3, internet protocol, or no current user ( PVC not being used).

Interrupt Msgs
Number of inbound interrupt messages received by this VC (not displayed on Series 300/400).

Inb. Resets
Number of inbound reset messages received by this VC (not displayed on Series 300/400).

-g Display a global summary of interface statistics for the specified device file. Statistics are cleared each time the interface card is initialized. Output reports a list of global statistics, level 3 access specific statistics, and IP specific statistics.

Global statistics shows activity since the card was initialized:

• Number of incoming calls cleared by the subsystem.

• Number of outgoing calls cleared by the network or the remote peer.

• Total number of packets sent (not displayed on Series 300/400).

• Total number of packets received (not displayed on Series 300/400).

• Total number of octets sent.

• Total number of octets received.

• Total number of resets received (not displayed on Series 300/400).

• Total number of restarts received (not displayed on Series 300/400).

• Total number of diagnostic packets received (not displayed on Series 300/400).

Level 3 Access Specific Statistics report Level 3 activity:

• number of outgoing calls: X.25 direct access

• number of incoming calls answered: X.25 direct access

• number of outgoing calls cleared by X.25 direct access users

• number of outgoing calls cleared due to user process abort

IP-specific statistics report activity related to IP:

• number of outgoing calls: IP access

• number of incoming calls answered: IP access

• number of VCs cleared due to IP idle timer expiration

• number of VCs cleared by IP due to lack of free VCs

• number of outbound messages dropped: Queue overflow

• number of outbound messages dropped: no VC available

• number of outbound messages dropped: no VC to next hop destination

• number of outbound messages dropped: no IP -to- X.121 address map entry

-f Display X.25 Level 2 and IP for dev_file.

Level 2 statistics describing Level 2 activity:

• number of RRs sent/received RR (Receive Ready) is a function of the S (link set up) frame.

number of RNRs sent/recv
RNR (Receive Not Ready) is a function of the S (link set up) frame.

number of REJs sent/recv
REJ (Reject) is a function of the S (link set up) frame.

number of frames received that were too long
The count reports how many frames were transmitted that contained a number of octets which exceeded the maximum frame size. The value of frame size is set when the subsystem is configured.

number of I-frames sent/recv
I (information) frames carry packets and therefore user’s data.

number of Data Carrier Detect changes
contains the number of DCD state changes.

number of Clear-To-Send changes
contains the number of CTS state changes.

number of CRC errors
In the event of packet retransmission, the Cyclic Redundancy Check reviews the data in duplicated packets. This count shows how many packets of which the data was corrupted.

number of T1 timer expirations
The T1 timer is used to specify the amount of time to wait for acknowledgement of a frame.

# of Aborted frames sent/recv
contains the number of incomplete packets that were sent and received.

Transmitter underruns
contains the number of times that a transmission was aborted because the data to be transmitted was not provided soon enough.

Receiver overruns
contains the number of times that a reception was aborted because the data was not processed by the interrrupt routine fast enough.

-c Display current X.25 configuration. Parameter values specified in the configuration file or through the x25init user interface are displayed. Refer to x25init_smpl(4) for a description of configuration file parameters.

-a Display information present in the IP mapping table:

IP Address
Internet Protocol address

X.121 Address
X.121 address corresponding to this IP address

PVC Logical Channel Identifier number of the permanent virtual circuit of this interface card

Use Reverse Charges
Shows whether reverse charge calls can be issued across this X.121 address

Accept Reverse Charges
Shows whether reverse charge calls are accepted from across this X.121 address

-e Display inbound/outbound effective size and class information (not displayed on Series 300/400):

Eff Ipkt/Opkt sizes
is the effective size of the inbound and outbound packet in octets. This value is the result of packet size negotiation on the VC.

Eff Iwin/Owin Sizes
is the effective size of the inbound and outbound window in octets. This value is the result of packet size negotiation on the VC.

Eff Ithr/Othr Sizes
is the effective inbound and outbound throughput class number. It indicates to the network the amount of resources to allocate to a virtual circuit. This value is the result of packet size negotiation on the VC.

-s Show status information for all virtual circuits (not displayed on Series 300/400).

Virtual Port #
mapping between the LCI and the connection-id.

Destination
Is 1 if the virtual circuit is being used for PAD support or by a user.

State The current state of the virtual circuit. Possible VC states are: disconnected, connecting, connected, inactive, unknown, reset, ready, reset indication, DTE waiting, DCE waiting, reset request, clear request, collision, PVC out of order.

Trace State
Shows whether VC path tracing is set for the virtual ciruit designated by the LCI number.

Fast Select
Value shown is one of the following:

with restriction
indicates that user data cannot be sent with CALL ACCEPTED packets. However, the called DTE (destination node) may send user data with a CLEAR REQUEST packet.

without restriction
indicates that full Fast select facilties may be used.

not set.
indicates that Fast select is not being used.

-x Display Level 3 X.25 protocol information for the interface specified by the -ddev_file parameter (not displayed on Series 300/400).

Interface state
This value reflects Level 2 information. The value shown is one of the following: UNINITIALIZED, UNINITIALIZED - Initialization failed, INITIALIZED, Lock-out is set, or DOWN.

Protocol state
Reflects Level 3 information. Value shown is one of the following: STOPPED, DISCONNECTED, RESTART REQUESTED, or READY.

Tracing state
Reflects Level 3 information. Value shown is one of the following: Not tracing, Tracing all VCs, Tracing reserved for DTC, or Tracing a specified VC.

Number of Hosts Connected Through This Interface
Total number of hosts communicating through the designated interface

Number of Switching Elements
Total number of switching elements through which all virtual circuits using this interface must pass

Number of Open SVCs
Number of currently open switched virtual circuits

Max. Number of Simultaneously Opened VCs
Maximum number of virtual circuits that may be open concurrently
Value is hardware dependent.

Number of VCs Opened
Total number of virtual vircuits that are currently opened

DIAGNOSTICS

x25stat: Could not get machine type.
Attempt to get the machine type through a system call resulted in an error.

x25stat: Could not open default subsystem device.
Attempt to use x25stat without the -d option failed because the default subsystem management device (x25_0) was not initialized, or the device file was not present.

x25stat: Could not read interface state.
Interface status information was not received. Check to ensure that the designated interface was initialized.

x25stat: NOTICE: X.25 subsystem is not currently active on device.
The x25init command was not executed for this device file. An attempt was unsuccessfully made to use x25stat on an interface name that was not initialized using x25init.

x25stat: Error on subsystem device read.
System returned an error while attempting to get information from the subsystem management device driver.

x25stat: No data returned from subsystem subsystem device.
No information was received from subsystem management device driver.

x25stat: NOTICE: Interface driver type is unknown.
The driver type specified was not an X.25 interface driver.

x25stat: IO error on access to card. (errno = EIO)
x25init may not have been executed for this interface.

x25stat: Cannot read interface configuration information.
System error occured while attempting to get information from the kernel.

Bad self test on interface card.
Hardware problem. If this messages is displayed continuously, the interface card may need to be replaced.

DEPENDENCIES

Series 300/400:

-e, -s, and -x options are not supported.

AUTHOR

x25stat was developed by HP.

FILES

x25stat.cat native language catalog file

Museum

Related Articles

x25stat(1)

NAME

SYNOPSIS

DESCRIPTION

Default Operation

Options

DIAGNOSTICS

DEPENDENCIES

Series 300/400:

AUTHOR

FILES

SEE ALSO