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

Function

The join-prune periodic-messages queue-size command sets the maximum number of (S, G) entries carried in a 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 Join/Prune message that is sent every second.

By default, a 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 Join/Prune message that is sent every second.	The value is an integer that ranges from 16 to 4096.

Views

PIM-IPv6 view

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

IPv6 multicast routing has been enabled globally using the multicast ipv6 routing-enable command in the system view.

Precautions

This command is valid for PIM-SM (IPv6) and PIM-DM (IPv6).

Example

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

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