[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 3
mpcstat Command
Purpose
Displays operational information about a Multi-Protocol Over ATM (MPOA)
Client.
Syntax
mpcstat [ -a -c -e -i -m -r -s -t -v] [ Device_Name ]
Description
This command displays Multi-Protocol Over ATM (MPOA) Client operational
information gathered by a specified MPOA Client device. If a MPOA Client (MPC)
device name is not entered, information for the available MPC appear. You
can use the flags to narrow down your search to specify specific categories
of information such as Configuration, Egress Cache Entries, Ingress Cache
Entries, MPOA Servers, Shortcut Virtual Connections, and Statistics, or you
can elect to have all of the information categories display.
You can also toggle debug tracing on or off and reset statistics counters.
Parameters
Device_Name |
The name of the MPOA Client device name, for example, mpc0. |
Flags
-a |
Requests that all of the MPOA Client information appear. Note that
this flag does not reset statistics counters or toggle trace. If a flag
is not entered, the -a flag is the default flag. |
-c |
Requests the configuration |
-e |
Requests the egress (incoming) cache |
-i |
Requests the ingress (outgoing) cache. |
-m |
Requests the list of MPOA Servers in use. |
-r |
Resets the statistics counters after reading. |
-s |
Requests the statistics counters. |
-t |
Toggles full debug trace on or off. |
-v |
Requests the list of Shortcut Virtual Connections. |
The following information appears for all valid calls and contains the
following fields:
- Device Name
- Displays the device name of the MPOA Client.
- MPC State
- Displays the current state of the MPOA Client.
Example States:
Idle Registering with the ELAN.
Initializing Registering with the switch.
Operational Fully operational.
Network Down Network is currently unavailable.
- MPC Address
- Displays the MPOA Client's 20-byte ATM address for a specific ATM adapter
port device name. The adapter port device name is also displayed.
- Elapsed Time
- Displays the real time period which has elapsed since statistics were
last reset.
- MPC Configuration
- Selected with the -a or -c
flags. Displays the network administrator's pre-configured attributes for
the MPOA Client, or the values provided by a Lan Emulation Configuration Server
(LECS).
- MPC Egress Cache
- Selected with the -a or -e
flags. Displays the current egress cache entries. Included are the state
of the entry, its Level-3 address, and ATM shortcut address, as well as additional
descriptive values associated with each entry.
Example
States
-
-
Active Has active shortcut connection.
Purging Purging the egress MPOA Server entry.
DP Purge Purging the remote MPOA Client data plane.
Inactive No current activity on shortcut connection.
- MPC Ingress Cache:
- Selected with the -a or -i
flags. Displays the current ingress cache entries. Included are the state
of the entry, its Level-3 address, and ATM shortcut address, as well as additional
descriptive values associated with each entry.
Example
States
Flow Detect Waiting for packet threshold to enable shortcut.
Resolution Packet threshold reached, resolving shortcut.
Hold Down Shortcut resolution failed, waiting for retry.
Resolved Shortcut resolution sequence complete.
- MPOA Server List
- Selected with the -a or -m
flags. Displays a list of MPOA Servers currently known by this MPC. Included
in each entry are the name of the LE Client that identified the MPS, the MPS
ATM address, and the MPS LAN MAC address.
- MPC Statistics
- Selected with the -a or -s
flags. Displays the current Transmit, Receive, and General statistics for
this MPOA Client.
- Shortcut Virtual Connection
- Selected with the -a or -v
flags. Displays the current list of shortcut virtual circuits in use by the
MPOA client. Included are virtual path and channel values, VC state, ATM device
name, as well as additional descriptive values associated with each entry.
Example States:
Idle Call idle.
Signalling Call placed but not established.
Operational Call connected; data path valid.
Released Call released.
Retry Temporary call failure; will be retried.
Hold Down Call failure; will be suspended for hold down period.
Exit Status
If an invalid Device_Name is specified, this command
produces error messages stating that it could not connect to the device. Note
that MPOA is a protocol extension to the ATM LAN Emulation protocol, and must
have a corresponding and available LE Client to be operational. Examples of
an invalid device error message are:
MPCSTAT: Device is not an MPOA device.
MPCSTAT: No LEC device with MPOA enabled.
MPCSTAT: Device is not available.
Related Information
The atmstat command, entstat command, lecstat command, and tokstat command.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]