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

Item	Description
Device_Name	The name of the MPOA Client device name, for example, mpc0.

Flags

Item	Description
-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.