unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 mpcstat(1M)							 mpcstat(1M)




 NAME
      mpcstat - display ATM MPOA Client configuration, status, and
      statistics.

 SYNOPSIS
      /usr/sbin/mpcstat -n net_interface -c

      /usr/sbin/mpcstat -n net_interface -s

 DESCRIPTION
      The mpcstat command displays the configuration, status, and statistics
      information for the ATM MPOA Client (MPC) tied to the ATM LAN
      Emulation Clients (LECs) for the specified ATM network interface.

    Options
      mpcstat recognizes the following options:

	   -n net_interface  The LEC interface. There is no default.  The
			     netstat -i command can be used to display the
			     name of each interface that is associated with
			     an ATM adapter (see netstat(1M)).

	   -c		     Display ATM MPOA Client configuration and
			     status information for the primary MPC tied to
			     the specified interface.  If a secondary MPC
			     has been configured, the same type of
			     information is also displayed.  Each field
			     displayed is as follows:

		Name		      Description

		==============================================================

		MPC Index	      Unique MPC identifier in the system.

		Card Instance	      Instance number of the ATM Adapter for
				      this ELAN interface.

		LEC Interfaces under MPC
				      List of ELAN interfaces controlled by
				      this MPC.	 Currently, an MPC can
				      control only one ELAN interface.

		Control ATM Address   MPC Control ATM Address used for the
				      MPS connection.

		Data ATM Address      A data ATM Address associated with
				      this MPC. This field can be used to
				      verify the identity of the sender of
				      packets over the shortcut VCC.




 Hewlett-Packard Company	    - 1 -	  Formatted:  August 2, 2006






 mpcstat(1M)							 mpcstat(1M)




		Actual State	      The actual state of the MPC.

		Actual Config Mode    Whether this MPC was auto-configured
				      or not when it was last initialized or
				      reinitialized.

		Discontinuity Time    The discontinuity time this MPC
				      experienced. If discontinuities have
				      not occurred since the last re-
				      initialization of the local system,
				      then this field contains a zero.

		Actual SC Setup Frame Count (MPC-p1)
				      Shortcut setup frame count. This is
				      measured in frames over Actual SC
				      Setup Frame Time. A value of 1 means
				      that resolutions for shortcuts are
				      attempted for all flows.

		Actual SC Setup Frame Time (MPC-p2)
				      Actual Shortcut setup frame time (in
				      seconds).

		Actual Initial Retry Time (MPC-p4)
				      Actual initial value for the retry
				      time out (in seconds).

		Actual Maximum Retry Time (MPC-p5)
				      The cumulative maximum value for Retry
				      Time (in seconds).

		Actual Hold Down Time (MPC-p6)
				      Minimum time to wait before
				      reinitiating a failed resolution
				      attempt (in seconds).

	   -s		     Display ATM MPOA Client statistics.

	   Two tables are displayed with this option:

	   +   Ingress/Egress Cache Statistics

	   +   MPOA Client statistics

	   The Ingress/Egress cache statistics table lists the statistics
	   for all of the MPCs on the system. Each field displayed is as
	   follows:

		Name		      Description





 Hewlett-Packard Company	    - 2 -	  Formatted:  August 2, 2006






 mpcstat(1M)							 mpcstat(1M)




		==============================================================

		Ingress Cache

		Total Tx Packets over shortcut
				      The total number of packets
				      transmitted over MPC shortcuts.

		Egress Cache

		Total Rx Packets over shortcut
				      The total number of packets received
				      by MPC shortcuts.

	   The MPOA Client statistics table lists the statistics information
	   for the primary MPC tied to the specified interface.	 If a
	   secondary MPC has been configured, the same type of information
	   is also displayed.  Each field displayed is as follows:

		Name		      Description

		==============================================================

		MPOA - Tx

		Resolve Requests      The number of MPOA Resolve Requests
				      transmitted by this MPC.

		Imposition Reply Acks The number of successful MPOA Cache
				      Imposition replies transmitted by this
				      MPC with an MPOA CIE Code of 0x00,
				      'Success'.

		Imposition Reply Insuf EC Resources
				      The number of MPOA Cache Imposition
				      Replies transmitted with an MPOA CIE
				      Code of 0x81, 'Insufficient resources
				      to accept egress cache entry'.

		Imposition Reply Insuf SC Resources
				      The number of MPOA Imposition Replies
				      transmitted with an MPOA CIE Code of
				      0x82, 'Insufficient resources to
				      accept shortcut'.

		Imposition Reply Insuf SC/EC Resources
				      The number of MPOA Imposition Replies
				      transmitted with an MPOA CIE Code of
				      0x83, 'Insufficient resources to
				      accept either shortcut or egress cache
				      entry'.



 Hewlett-Packard Company	    - 3 -	  Formatted:  August 2, 2006






 mpcstat(1M)							 mpcstat(1M)




		Imposition Reply Unsupported Internetwork Protocol
				      The number of MPOA Imposition Replies
				      transmitted with an MPOA CIE Code of
				      0x84, 'Unsupported Internetwork Layer
				      protocol'.

		Imposition Reply Unsupported MAC Encaps
				      The number of MPOA Imposition Replies
				      transmitted with an MPOA CIE Code of
				      0x85, 'Unsupported MAC Layer
				      encapsulation'.

		Imposition Reply Unspecified/Other
				      The number of MPOA Imposition Replies
				      transmitted with an MPOA CIE Code of
				      0x88, 'Unspecified/Other'.

		Egress Cache Purge Requests
				      The number of MPOA Egress Cache Purge
				      Requests transmitted by this MPC.

		Data Plane Purges     The number of MPOA Data Plane Purge
				      messages transmitted by this MPC.

		MPOA - Rx

		Resolve Reply Acks    The number of positively acknowledged
				      MPC Resolved Replies received by this
				      MPC with an MPOA CIE Code of 0x00
				      (Success).

		Resolve Reply Insuf EC Resources
				      The number of MPOA Resolution Replies
				      received with an MPOA CIE Code of
				      0x81,

		Resolve Reply Insuf SC Resources
				      The number of MPOA Resolution Replies
				      received with an MPOA CIE Code of
				      0x82,

		Resolve Reply Insuf SC/EC Resources
				      The number of MPOA Resolution Replies
				      received with an MPOA CIE Code of
				      0x83,

		Resolve Reply Unsupported Internetwork Protocol
				      The number of MPOA Resolution Replies
				      received with an MPOA CIE Code of
				      0x84,




 Hewlett-Packard Company	    - 4 -	  Formatted:  August 2, 2006






 mpcstat(1M)							 mpcstat(1M)




		Resolve Reply Unsupported MAC Encaps
				      The number of MPOA Resolution Replies
				      received with an MPOA CIE Code of
				      0x85,

		Resolve Reply Unspecified/Other
				      The number of MPOA Resolution Replies
				      received with an MPOA CIE Code of
				      0x88,

		Imposition Requests   The number of MPOA Cache Imposition
				      Requests received by this MPC.

		Egress Cache Purge Replies
				      The number of MPOA Egress Cache Purge
				      Replies received by this MPC.

		Keep Alives	      The number of MPOA Keep Alive messages
				      received by this MPC.

		Triggers	      The number of MPOA Trigger messages
				      received by this MPC.

		Data Plane Purges     The number of MPOA Data Plane Purge
				      messages received by this MPC.

		NHRP - Tx

		Purge Replies	      The number of Purge Replies
				      transmitted by this MPC.

		NHRP - Rx

		Purge Requests	      The number of Purge Requests received
				      by this MPC.

		Error Indication - Rx

		Unrecognized Extensions
				      The number of Error Indication packets
				      received by this MPC with the error
				      code

		Loop Detecteds	      The number of Error Indication packets
				      received by this MPC with the error
				      code 'Loop Detected'.

		Protocol Addr Unreachables
				      The number of Error Indication packets
				      received by this MPC with the error
				      code 'Protocol Address Unreachable'.



 Hewlett-Packard Company	    - 5 -	  Formatted:  August 2, 2006






 mpcstat(1M)							 mpcstat(1M)




		Protocol Errors	      The number of Error Indication packets
				      received by this MPC with the error
				      code

		SDU Size Exceededs    The number of Error Indication packets
				      received by this MPC with the error
				      code

		Invalid Extensions    The number of Error Indication packets
				      received by this MPC with the error
				      code

		Invalid Replies	      The number of Error Indication packets
				      received by this MPC with the error
				      code

		Authentication Failures
				      The number of Error Indication packets
				      received by this MPC with the error
				      code 'Authentication Failure'.

		Hop Count Exceededs   The number of Error Indication packets
				      received by this MPC with the error
				      code

 EXAMPLE
      To display MPOA Client configuration and status information for the
      MPC that is tied to a LEC interface "ela0":

	   /usr/sbin/mpcstat -n ela0 -c

       Primary MPOA Client configuration and status information

      MPC Index				      : 0x02
      Card Instance			      : 2
      LEC Interfaces under MPC		      : ela0
					      : ela1
					      : ela4

      Control ATM Address	  : 47000580ffe1000000f21a1e28.080009c6fc0a.00
      Data ATM Address		  : 47000580ffe1000000f21a1e28.080009c6fc0a.00

      Actual State			      : up
      Actual Config Mode		      : 1 (automatic)
      Discontinuity Time		      : 10:09 AM
      Actual SC Setup Frame Count (MPC-p1)    : 10
      Actual SC Setup Frame Time  (MPC-p2)    : 1 sec
      Actual Initial Retry Time	  (MPC-p4)    : 5 sec
      Actual Maximum Retry Time	  (MPC-p5)    : 40 sec
      Actual Hold Down Time	  (MPC-p6)    : 160 sec




 Hewlett-Packard Company	    - 6 -	  Formatted:  August 2, 2006






 mpcstat(1M)							 mpcstat(1M)




 EXAMPLE
      To display MPOA Client statistics information for the MPC that is tied
      to a LEC interface "ela0":

	   /usr/sbin/mpcstat -n ela0 -s

       Ingress/Egress Cache statistics of all of the MPCs on the system

      Ingress Cache
	  Total Tx Packets Over Shortcut	   : 1000

      Egress Cache
	  Total Rx Packets Over Shortcut	   : 1000


       Primary MPOA Client statistics

      MPOA - Tx
	  Resolve Requests			   : 1000
	  Imposition Reply Acks			   : 1000
	  Imposition Reply Insuf EC Resources	   : 5
	  Imposition Reply Insuf SC Resources	   : 7
	  Imposition Reply Insuf SC/EC Resources   : 50
	  Imposition Reply Unsupported Inet Prot   : 2
	  Imposition Reply Unsupported MAC Encaps  : 5
	  Imposition Reply Unspecified/Other	   : 9
	  Egress Cache Purge Requests		   : 500
	  Data Plane Purges			   : 500

      MPOA - Rx
	  Resolve Reply Acks			   : 1000
	  Resolve Reply Insuf EC Resources	   : 8
	  Resolve Reply Insuf SC Resources	   : 6
	  Resolve Reply Insuf SC/EC Resources	   : 5
	  Resolve Reply Unsupported Inet Proto	   : 2
	  Resolve Reply Unsupported MAC Encaps	   : 20
	  Resolve Reply Unspecified/Other	   : 5
	  Imposition Requests			   : 450
	  Egress CachePurge Replies		   : 500
	  Keep Alives				   : 1000
	  Triggers				   : 230
	  Data Plane Purges			   : 500

      NHRP - Tx
	  Purge Replies				   : 1000

      NHRP - Rx
	  Purge Requests			   : 1000

      Error Indication - Rx
	  Unrecognized Extensions		   : 4



 Hewlett-Packard Company	    - 7 -	  Formatted:  August 2, 2006






 mpcstat(1M)							 mpcstat(1M)




	  Loop Detecteds			   : 6
	  Protocol Address Unreachables		   : 56
	  Protocol Errors			   : 100
	  SDU Size Exceededs			   : 20
	  Invalid Extensions			   : 50
	  Invalid Replies			   : 54
	  Authentication Failures		   : 12
	  Hop Count Exceededs			   : 15


 DIAGNOSTICS
      mpcstat fails in the following cases:

      mpcstat: Incorrect usage

	   Command line input contained one or more syntax errors.  See the
	   SYNOPSIS section for the correct usage.

      mpcstat: net_interface:  Invalid argument

	   Unable to provide info corresponding to net_interface because
	   this net_interface does not exist.

 AUTHOR
      mpcstat was developed by HP.

 SEE ALSO
      mpcarp(1M), elstat(1M), netstats(1M)


























 Hewlett-Packard Company	    - 8 -	  Formatted:  August 2, 2006