pim holdtime join-prune

Function

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

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

By default, the holdtime value in Join/Prune messages sent by a 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 Join/Prune messages sent by a PIM interface.	The value is an integer ranging from 1 to 65535, in seconds.

Parameter

Description

Value

interval

Specifies the value of holdtime in Join/Prune messages sent by a PIM interface.

The value is an integer ranging from 1 to 65535, in seconds.

Views

100ge sub-interface view, 100GE interface view, 10GE sub-interface view, 10GE interface view, 200GE sub-interface view, 25GE sub-interface view, 25GE interface view, 400GE sub-interface view, 400GE interface view, 40GE sub-interface view, 40GE interface view, 50GE sub-interface view, 50GE interface view, Eth-Trunk sub-interface view, Eth-Trunk interface view, FlexE interface view, GE optical interface view, GE sub-interface view, GE interface view, GE electrical interface view, Global VE sub-interface view, Loopback interface view, PW-VE sub-interface view, Tunnel interface view, VBDIF interface view, VE sub-interface view, VLANIF interface view, Virtual template view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
pim	write

Usage Guidelines

Usage Scenario

After receiving a Join/Prune message from a downstream interface, an upstream Router determines the time period for keeping the join or prune state of a downstream interface based on the holdtime field carried in the Join/Prune message. To set a value for the holdtime field of Join/Prune messages sent by a specified PIM interface, run the pim holdtime join-prune command on the interface.

Generally, the holdtime is 3.5 times the interval (specified using the timer join-prune command) at which Join/Prune messages are sent.

Prerequisites

The multicast routing function has been enabled using the multicast routing-enable command in the public network instance view or VPN instance view.

Configuration Impact

If the pim holdtime join-prune command is run more than once, the latest configuration overrides the previous one.

Example

# Specify 280 seconds as the holdtime value in Join/Prune messages sent by GE 0/1/0.

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