pim holdtime join-prune

Function

The pim holdtime join-prune command sets the holdtime in a Join/Prune message sent by the PIM interface.

The undo pim holdtime join-prune command restores the default value of the holdtime.

By default, the holdtime in a Join/Prune message sent by the PIM interface is 210 seconds.

Format

pim holdtime join-prune interval

undo pim holdtime join-prune

Parameters

Parameter	Description	Value
interval	Specifies the value of holdtime in a Join/Prune message sent by the PIM interface.	The value is an integer that ranges from 1 to 65535, in seconds.

Views

GE interface view, XGE interface view, MultiGE interface view, 25GE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, GE sub-interface view, XGE sub-interface view, MultiGE sub-interface view, 25GE sub-interface view, 40GE sub-interface view, 100GE sub-interface view, Eth-Trunk sub-interface view, VLANIF interface view, loopback interface view, tunnel interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After receiving a Join/Prune message from the downstream device, the switch starts the holdtime timer. If the switch does not receive subsequent Join/Prune messages from the downstream device within the holdtime interval, the switch suppresses forwarding of Join/Prune messages carrying group join information on the downstream interface in the group. If Join/Prune messages carry group prune information, the downstream interface is restored.

The pim holdtime join-prune command sets the holdtime interval for Join/Prune messages.

Prerequisites

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

Precautions

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

The holdtime of Join/Prune messages must be larger than the interval for sending Join/Prune messages and is generally 3.5 times the interval for sending Join/Prune messages.

The pim holdtime join-prune command has the same function as the holdtime join-prune (IPv4) command in the PIM view. By default, if the pim holdtime 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 holdtime in a Join/Prune message sent by the interface VLANIF100 to 280 seconds.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] pim holdtime join-prune 280

# Set the holdtime in a Join/Prune message sent by the interface GE0/0/1 to 280 seconds.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] pim holdtime join-prune 280