display pim control-message counters

Function

The display pim control-message counters command displays the number of sent, received, and invalid PIM control messages.

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] control-message counters message-type { probe | register | register-stop | crp }

display pim [ vpn-instance vpn-instance-name | all-instance ] control-message counters [ message-type { assert | graft | graft-ack | hello | join-prune | state-refresh | bsr } | interface interface-type interface-number ] ^*

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Displays PIM control message statistics of a VPN instance that has the specified name.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance	Displays PIM control message statistics of all instances.	-
message-type	Displays PIM control message statistics of the specified type.	-
probe	Displays Probe message statistics.	-
register	Displays Register message statistics.	-
register-stop	Displays Register-Stop message statistics.	-
crp	Displays Candidate-Rendezvous Point (C-RP) message statistics.	-
assert	Displays Assert message statistics.	-
graft	Displays Graft message statistics.	-
graft-ack	Displays Graft-Ack message statistics.	-
hello	Displays Hello message statistics.	-
join-prune	Displays Join/Prune message statistics.	-
state-refresh	Displays State-Refresh message statistics.	-
bsr	Displays BootStrap router (BSR) message statistics.	-
interface interface-type interface-number	Displays PIM control message statistics of an interface that has the specified type and number.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When the display pim control-message counters command is used, the following situations occur:

If you specifyvpn-instance or all-instance, you can view the public network instance only.
If you specify interface interface-type interface-number, you can view the number of various PIM control packets that were sent and received on the interface only.
If you specify message-type, you can view the number of PIM control packets of this type sent and received on all interfaces of the FW.

Example

# Display the number of PIM control messages that were sent, received, or invalid on GE 1/0/0 in the public network instance.

<sysname> display pim control-message counters interface GigabitEthernet 0/0/0
 VPN-Instance: public net
 PIM control-message counters for interface: GigabitEthernet0/0/0
 Message Type     Received         Sent             Invalid      Filtered
 Assert           0                0                0            0
 Graft            0                0                0            0
 Graft-Ack        0                0                0            0
 Hello            328              331              0            0
 Join-prune       2                0                0            0
 State-Refresh    0                0                0            0
 BSR              9778             0                0            0

# Display the number of sent, received, invalid PIM control messages in the public network instance.

<sysname> display pim control-message counters

 VPN-Instance: public net                                                       
 Register* - Register Anycast-RP, Probe* - Probe Anycast-RP                     
 ----------------------------------------------------------------------------   
 PIM global control-message counters:                                           
 Message Type     Received         Sent             Invalid          Filtered   
 Register         0                0                0                0          
 Register-Stop    0                0                0                0          
 Probe            0                0                0                0          
 C-RP             0                0                0                0          
 Register*        0                0                0                0          
 Probe*           0                0                0                0          
                                                                                
 PIM control-message counters for interface: GigabitEthernet0/0/0               
 Message Type     Received         Sent             Invalid          Filtered   
 Assert           0                0                0                0          
 Graft            0                0                0                0          
 Graft-Ack        0                0                0                0          
 Hello            0                19               0                0          
 Join-prune       0                0                0                0          
 State-Refresh    0                0                0                0          
 BSR              0                0                0                0

**Table 1** Description of the **display pim control-message counters** command output
Item	Description
VPN-Instance	VPN instance to which the statistics of PIM messages belong
PIM control-message counters for interface	Name of the interface for collecting statistics on PIM control messages
PIM global control-message counters	Statistics about PIM control messages in the public network
Message Type	Type of the control message NOTE: If Join-prune is displayed in the Message Type field and the value of the Received field does not increase, check the Sent field: If the value of the Sent field increases, the downstream device has sent out Join/Prune messages, and a communication failure has occurred between the PIM neighbors. If the value of the Sent field does not increase, the downstream device is faulty. Locate and troubleshoot faults on the downstream device.
Received	Statistics about control messages received by the current interface -: Control messages statistics are not collected.
Sent	Statistics about control messages sent by the current interface
Invalid	Statistics about invalid control packets
Filtered	Statistics about control messages filtered out by the current interface
Assert	Statistics about Assert messages
Graft	Statistics about Graft messages
Graft-Ack	Statistics about Graft-Ack messages
Hello	Statistics about Hello messages
Join-prune	Statistics about Join/Prune messages
State-Refresh	Statistics about State-Refresh messages
BSR	Statistics about Bootstrap messages
Register	Statistics about Register messages
Register-Stop	Statistics about Register-Stop messages
Probe	Statistics about Probe messages
C-RP	Statistics about CRP messages
Register*	Statistics about Register messages in the Anycast-RP scenario
Probe*	Statistics about Probe messages in the Anycast-RP scenario