timer join-prune (IPv4)

Function

The timer join-prune command configures the interval at which Join/Prune messages are sent to an upstream device.

The undo timer join-prune command restores the default interval.

By default, the interval at which Join/Prune messages are sent to an upstream device is 60 seconds.

Format

timer join-prune interval

undo timer join-prune

Parameters

Parameter	Description	Value
interval	Specifies the interval for sending Join/Prune messages.	The value is an integer that ranges from 1 to 18000, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The switch sends join information to the upstream device, requesting the upstream device to forward multicast data. The switch sends prune information to the upstream device, requesting the upstream device to stop forwarding multicast data. Join information and prune information are encapsulated in Join/Prune messages. The PIM router periodically sends Join/Prune messages to the upstream router to update the forwarding status.

Prerequisites

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

Precautions

This command is valid only for PIM-SM.

The interval configured using the timer join-prune command must be shorter than the interval configured using the holdtime join-prune (IPv4) command.

The timer join-prune command has the same function as the pim timer join-prune command in the interface view. By default, if the pim timer join-prune command is not used, the value configured in the PIM view is used; otherwise, the value configured in the interface view is used.

Example

# Set the interval at which Join/Prune messages are sent to 80s in the PIM view of public network instance.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] pim
[HUAWEI-pim] timer join-prune 80