join-prune periodic-messages queue-size (IPv4)

Function

The join-prune periodic-messages queue-size command sets the maximum number of (S, G) entries carried in a PIM-SM Join/Prune message that is sent every second.

The undo join-prune periodic-messages queue-size command restores the default maximum number of (S, G) entries carried in a PIM-SM Join/Prune message that is sent every second.

By default, a PIM-SM Join/Prune message that is sent every second contains 1020 entries.

Format

join-prune periodic-messages queue-size queue-size

undo join-prune periodic-messages queue-size

Parameters

Parameter	Description	Value
queue-size	Specifies the maximum number of (S, G) entries carried in a PIM-SM Join/Prune message that is sent every second.	The value is an integer ranging from 16 to 4096.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer device has a low throughput, reduce the length of a queue for periodically sending messages to control the number of (S, G) entries. This setting allows the local device to send Join/Prune messages with a small number of (S, G) entries multiple times, preventing packet loss or route flapping.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command.

Precautions

This command is valid for PIM-SM and PIM-DM.

Example

# Allow each PIM-SM Join/Prune message that is sent every second to carry a maximum of 2000 (S, G) entries.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] pim
[HUAWEI-pim] join-prune periodic-messages queue-size 2000