The rmon2 hlhostcontroltable command creates or changes an entry in the hlHostControlTable.
The undo rmon2 hlhostcontroltable command deletes an entry from the hlHostControlTable or from the whole table.
rmon2 hlhostcontroltable index ctrl-index [ datasource interface interface-type interface-number ] [ maxentry maxentry-value ] [ owner owner-name ] [ status { active | inactive } ]
undo rmon2 hlhostcontroltable [ index ctrl-index ]
| Parameter | Description | Value |
|---|---|---|
ctrl-index |
Indicates the entry index, which uniquely identifies an entry in the host control table. |
The value is an integer that ranges from 1 to 65535. |
datasource interface interface-type interface-number |
Identifies an interface and a subnet, corresponding to hlHostControlDataSource. The parameter value, namely, the interface index, is the data source defining the entry. In this command, the data source is represented by interface type and number. |
- |
maxentry maxentry-value |
Indicates the maximum number of entries in the host table. |
The value is an integer that ranges from 1 to 100000. The default value is 50. If the host table contains too many entries, system performance is degraded. The default settings of host table are recommended. |
owner owner-name |
Indicates the owner. |
The value is a string of 1 to 127 characters and cannot be empty. |
status |
Indicates the status of an entry in the host control table, corresponding to hlHostControlStatus. |
- |
active |
Indicates that the hlHostControlStatus value in the host control table is active and this entry is available. |
- |
inactive |
Indicates that the hlHostControlStatus value in the host control table is not in service and this entry is inactive and unavailable. |
- |
Usage Scenario
To monitor traffic on the subnet connected to an interface of the managed device, run the rmon2 hlhostcontroltable command and specify the interface.
Precautions
When creating an entry, specify the datasource interface parameter to identify the interface, which specifies the subnet. The parameter value, namely, the interface index, is the data source defining the entry. Enter the interface type and number in the command. Only one entry can be created for each interface in the host control table.
The parameter status in the display rmon2 hlhostcontroltable command output matches the hlhostcontrolstatus value, which indicates the entry status.
When the hlhostcontrolstatus value is set to inactive, all related entries in the host table are deleted automatically.
When the hlhostcontrolstatus value is set to active, you cannot change the hlhostcontroldatasource and hlhostcontrolnlmaxdesiredentries values.
If an interface that corresponds to the hlhostcontroldatasource in an entry is deleted, the entry is deleted at the same time.
# Create an entry in the host control table.
<HUAWEI> system-view [HUAWEI] rmon2 hlhostcontroltable index 1 datasource interface gigabitethernet 0/0/1 maxentry 100 owner huawei status active
# Set the hlHostControlStatus value in the host control table to inactive.
<HUAWEI> system-view [HUAWEI] rmon2 hlhostcontroltable index 1 status inactive