Many types of storage media are available, such as Flash, compact Flash (CF), universal serial bus (USB) disk, and hard disk. Different devices support different types of storage media. For more information, see About the H3C Access Controllers Configuration Guides. CF card is used for the examples in this chapter.

clock datetime

Use clock datetime to set the system time and date.

Syntax

clock datetime time date

Views

User view

Default command level

3: Manage level

Parameters

time: Specifies a time, in the hh:mm:ss format. The value range for the hh value is 00 to 23, the value range for the mm value is 00 to 59, and the value range for the ss value is 00 to 59. You can omit zeros unless you specify 00:00:00.

date: Specifies a date, in the MM/DD/YYYY or YYYY/MM/DD format. The value range for the YYYY value is 2000 to 2035, the value range for the MM value is 1 to 12, and the value range for the DD value is 1 to 31.

Usage guidelines

You can leave the ss field blank when you specify the time parameters.

Examples

# Set the current system time to 14:10:20 08/01/2012.

<Sysname> clock datetime 14:10:20 8/1/2012

# Set the current system time to 00:06:00 01/01/2012

<Sysname> clock datetime 0:6 2012/1/1

Related commands

· clock summer-time one-off

· clock summer-time repeating

· clock timezone

· display clock

clock summer-time one-off

Use clock summer-time one-off to adopt daylight saving time from the start-time of the start-date to the end-time of the end-date. Daylight saving time adds the add-time to the standard time of the device.

Use undo clock summer-time to cancel the configuration of the daylight saving time.

Syntax

clock summer-time zone-name one-off start-time start-date end-time end-date add-time

undo clock summer-time

Default

Daylight saving time is disabled and the UTC time zone applies.

Views

System view

Default command level

3: Manage level

Parameters

zone-name: Specifies a daylight saving time schedule by a zone name, a case-sensitive string of 1 to 32 characters.

start-time: Specifies a start time, in the hh:mm:ss format. You can omit zeros unless you specify 00:00:00.

start-date: Specifies a start date, in the MM/DD/YYYY or YYYY/MM/DD format.

end-time: Specifies an end time, in the hh:mm:ss format. You can omit zeros unless you specify 00:00:00.

end-date: Specifies an end date, in the MM/DD/YYYY or YYYY/MM/DD format.

add-time: Specifies a time to be added to the standard time of the device, in the hh:mm:ss format. You can omit zeros unless you specify 00:00:00.

Usage guidelines

The interval between start-time start-date and end-time end-date must be longer than one day and shorter than one year. If the current system time is in the specified daylight saving days, the add-time value automatically adds to the system time.

To verify the setting, use the display clock command.

The timestamps in system messages are adjusted in reference to the time zone and daylight saving schedule.

Examples

# Set the system time ahead one hour for the period between 06:00:00 on 08/01/2012 and 06:00:00 on 09/01/2012.

<Sysname> system-view

[Sysname] clock summer-time abc1 one-off 6 08/01/2012 6 09/01/2012 1

Related commands

· clock datetime

· clock summer-time repeating

· clock timezone

· display clock

clock summer-time repeating

Use clock summer-time repeating to set a recurring daylight saving schedule.

Use undo clock summer-time to cancel the configuration of the daylight saving time.

Syntax

clock summer-time zone-name repeating start-time start-date end-time end-date add-time

undo clock summer-time

Default

Daylight saving time is disabled and UTC time zone applies.

Views

System view

Default command level

3: Manage level

Parameters

zone-name: Specifies a daylight saving time schedule by a zone name, a case-sensitive string of 1 to 32 characters.

start-time: Specifies a start time, in the hh:mm:ss format. You can omit zeros unless you specify 00:00:00.

start-date: Specifies a start date, which can be set in the following ways:

· Enter the year, month and date at one time, in the MM/DD/YYYY or YYYY/MM/DD format.

· Enter the year, month and date one by one, separated by spaces. The year range is 2000 to 2035; the month can be January, February, March, April, May, June, July, August, September, October, November or December; the start week can be the first, second, third, fourth, fifth or last week of the month; the start date is Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.

end-time: Specifies an end time, in the hh:mm:ss format. You can omit zeros unless you specify 00:00:00.

end-date: Specifies an end date, which can be set in the following ways:

· Enter the year, month and date at one time, in the MM/DD/YYYY or YYYY/MM/DD format.

· Enter the year, month and date one by one, separated by spaces. The year range is 2000 to 2035; the month can be January, February, March, April, May, June, July, August, September, October, November or December; the end week can be the first, second, third, fourth, fifth or last week of the month; the end date is Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.

add-time: Specifies a time to be added to the standard time of the device, in the hh:mm:ss format. You can omit zeros unless you specify 00:00:00.

Usage guidelines

To verify the setting, use the display clock command.

The timestamps in system messages are adjusted in reference to the time zone and daylight saving schedule.

Examples

# Set the system time ahead one hour every year after 2012 (inclusive) for the period from August 1 at 06:00:00 to September 1 at 06:00:00.

<Sysname> system-view

[Sysname] clock summer-time abc2 repeating 06:00:00 08/01/2012 06:00:00 09/01/2012 01:00:00

Related commands

· clock datetime

· clock summer-time one-off

· clock timezone

· display clock

clock timezone

Use clock timezone to set the local time zone.

Use undo clock timezone to restore the local time zone to the default UTC time zone.

Syntax

clock timezone zone-name { add | minus } zone-offset

undo clock timezone

Default

The local time zone is UTC zone.

Views

System view

Default command level

3: Manage level

Parameters

zone-name: Specifies a time zone by its name, a case-sensitive string of 1 to 32 characters.

add: Adds a specified offset to UTC.

minus: Subtracts a specified offset to UTC.

zone-offset: Specifies an offset to the UTC, in the hh:mm:ss format. You can omit zeros unless you specify 00:00:00.

Usage guidelines

To verify the setting, use the display clock command.

The timestamps in system messages are adjusted in reference to the time zone and daylight saving schedule.

Examples

# Set the local time zone to add five hours to UTC time.

<Sysname> system-view

[Sysname] clock timezone z5 add 5

Related commands

· clock datetime

· clock summer-time one-off

· clock summer-time repeating

· display clock

collection-interval

Use collection-interval to set the interval for collecting CPU/memory usage statistics.

Use undo collection-interval to restore the default.

Syntax

collection-interval collection-interval

undo collection-interval

Default

The interval for collecting CPU/memory usage statistics is 0 seconds. That is, the AC does not collect CPU/memory usage statistics.

Views

System view

Default command level

3: Manage level

Parameters

collection-interval: Specifies the interval in seconds for collecting CPU/memory usage rates. The value range is 0 to 60 seconds.

Usage guidelines

The alarm resend interval must be larger than or equal three times of the interval for collecting CPU/memory usage statistics. Because the alarm resend interval is 0 seconds If the AC uses this default configuration, you must set the alarm resend interval before setting the interval for collecting CPU/memory usage statistics.

Examples

# Set the interval for collecting CPU/memory usage statistics to 60 seconds.

<Sysname> system-view

[Sysname] collection-interval 60

Related commands

resend-interval

configure-user count

Use configure-user count to configure the maximum number of users allowed to enter system view at the same time.

Use undo configure-user count to restore the default.

Syntax

configure-user count number

undo configure-user count

Views

System view

Default command level

2: System level

Parameters

number: Specifies the maximum number of concurrent users. The value range varies with devices. For more information, see About the H3C Access Controllers Command References.

Usage guidelines

Two users are allowed to enter system view by default.

When multiple users enter system view to configure attributes, only the most recent configuration applies.

When the number of users has already reached the limit, other users cannot enter system view.

Examples

# Configure to allow up to four users to enter system view concurrently.

<Sysname> system-view

[Sysname] configure-user count 4

Related commands

display configure-user

copyright-info enable

Use copyright-info enable to enable displaying the copyright statement.

Use undo copyright-info enable to disable displaying the copyright statement.

Syntax

undo copyright-info enable

Default

This feature is enabled.

Views

System view

Default command level

3: Manage level

Examples

# Enable displaying the copyright statement.

<Sysname> system-view

[Sysname] copyright-info enable

· When a Telnet user logs in, the following statement appears:

******************************************************************************

* Without the owner's prior written consent, *

* no decompiling or reverse-engineering shall be allowed. *

******************************************************************************

· When a console user quits user view, the following message appears:

******************************************************************************

* Without the owner's prior written consent, *

* no decompiling or reverse-engineering shall be allowed. *

******************************************************************************

User interface con0 is available.

Please press ENTER.

# Disable displaying the copyright statement.

<Sysname> system-view

[Sysname] undo copyright-info enable

· When a Telnet user logs in, the user view prompt appears:

· When a console user quits user view, the following message appears:

User interface con0 is available.

Please press ENTER.

cpu-usage threshold

Use cpu-usage threshold to set the CPU usage rate threshold for a specific AP.

Use undo cpu-usage threshold to restore the default.

Syntax

cpu-usage threshold cpu-threshold

undo cpu-usage threshold

Default

The default value is 90%.

Views

AP template view

Default command level

2: System level

Parameters

cpu-threshold: Specifies the CPU usage rate threshold in percentage, in the range of 0 to 100.

Usage guidelines

When the CPU usage rate of an AP is larger than or equals the specified threshold, the AC considers that the CPU usage rate of the AP is too high.

Examples

# Set the CPU usage rate threshold of AP ap1 to 80%.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2620-AGN

[Sysname-wlan-ap-ap1] cpu-usage threshold 80

display clock

Use display clock to display the system time and date.

Syntax

display clock [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

The current system time and date are decided by the clock datetime, clock summer-time one-off, or clock summer-time repeating, and clock timezone commands. For more information about how the system time and date are decided, see Fundamentals Configuration Guide.

Examples

# Display the system time and date.

<Sysname> display clock

09:41:23 UTC Thu 12/15/2012

Related commands

· clock datetime

· clock summer-time one-off

· clock summer-time repeating

· clock timezone

display configure-user

Use display configure-user to display online users that are not in user view.

Syntax

display configure-user [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display online users that are not in user view.

<Sysname> display configure-user

The information of current configuration user(s):

Idx UI Delay Type Userlevel

+ 178 VTY 0 01:10:16 TEL 3

+ 179 VTY 1 00:00:00 TEL 3

Following are more details.

VTY 0 :

Location: 192.168.1.59

VTY 1 :

Location: 192.168.1.54

+ : User-interface is active.

F : User-interface is active and work in async mode.

Table 1 Command output

Field	Description
The information of current configuration user(s)	Information of the users that have logged in and are not in user view.
Idx	Absolute ID of the user interface.
UI	Type and relative ID of the user interface that the user used for login.
Delay	Delay between the last CLI input and the execution of the display configure-user command, in the format hh:mm:ss
Type	User type, telnet or SSH.
Userlevel	User level, level 0 (visit level), level 1 (monitor level), level 2 (system level), or level 3 (manage level)
Following are more details.	Detailed information about the login user.
Location	IP address of the login user.
+ : User-interface is active.	User interface that is being used.
F : User-interface is active and work in async mode.	User interface that is being used and operating in asynchronous mode.

Related commands

configure-user count

display copyright

Use display copyright to display the software and hardware copyright statements.

Syntax

display copyright [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

With this command, you can view the software and hardware copyright statements, and third-party software license agreements.

Examples

# Display the software and hardware copyright statements. (The output is omitted here.)

<Sysname> display copyright

display cpu-usage

Use display cpu-usage to display CPU usage statistics.

Syntax

display cpu-usage [ entry-number [ offset ] [ verbose ] ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

entry-number: Specifies the number of entries to be displayed, in the range of 1 to 60.

offset: Specifies the offset between the serial number of the first CPU usage rate record to be displayed and that of the last CPU usage rate record to be displayed. The value range is 0 to 59.

For example, the idx of the latest statistics record is 12. If the offset is set to 3, the system displays the statistics records from the one with the idx of 9, where idx represents the serial number of the period for the statistics, and its value range is 0 to 60 cyclically. The system collects CPU usage rates periodically, and the system records the average CPU usage rate during this period, and the idx value is added by 1 automatically.

verbose: Displays the average CPU usage statistics for each task in the specified period. If this keyword is not provided, this command displays the brief information of the CPU usage statistics.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

The system regularly (typically at 60-second intervals) collects CPU usage statistics and saves the statistical results in the history record area. The maximum number of records that can be saved depends on your device model.

The display cpu-usage entry-number command displays entry-number latest records, starting from the latest record. The display cpu-usage entry-number offset command displays number latest records, starting from the last (offset+1)th record.

Examples

# Display the current CPU usage statistics.

<Sysname> display cpu-usage

Unit CPU usage:

1% in last 5 seconds

1% in last 1 minute

1% in last 5 minutes

# Display the last fifth and sixth record entries in CPU usage statistics.

<Sysname> display cpu-usage 2 4

===== CPU usage info (no: 0 idx: 58) =====

CPU Usage Stat. Cycle: 60 (Second)

CPU Usage : 3%

CPU Usage Stat. Time : 2012-07-10 10:56:55

CPU Usage Stat. Tick : 0x1d9d(CPU Tick High) 0x3a659a70(CPU Tick Low)

Actual Stat. Cycle : 0x0(CPU Tick High) 0x95030517(CPU Tick Low)

===== CPU usage info (no: 1 idx: 57) =====

CPU Usage Stat. Cycle: 60 (Second)

CPU Usage : 3%

CPU Usage Stat. Time : 2012-07-10 10:55:55

CPU Usage Stat. Tick : 0x1d9c(CPU Tick High) 0xa50e5351(CPU Tick Low)

Actual Stat. Cycle : 0x0(CPU Tick High) 0x950906af(CPU Tick Low)

Table 2 Command output

Field	Description
Unit CPU usage	CPU usage rates.
1% in last 5 seconds	After a boot, the system calculates and records the average CPU usage rate every five seconds. This field displays the average CPU usage rate in the last five seconds.
1% in last 1 minute	After a boot, the system calculates and records the average CPU usage rate every one minute. This field displays the average CPU usage rate in the last minute.
1% in last 5 minutes	After a boot, the system calculates and records the average CPU usage rate every five minutes. This field displays the average CPU usage rate in the last five minutes.
CPU usage info (no: idx:)	Information of CPU usage rate records (no: The (no+1)th record is displayed. no numbers from 0, a smaller number equals a newer record. idx: index of the current record in the history record table). If only the information of the current record is displayed, no and idx are not displayed.
CPU Usage Stat. Cycle	CPU usage rate measurement interval, in seconds. For example, if the value is 41, it indicates that the average CPU usage rate during the last 41 seconds is calculated. The value range of this field is 1 to 60.
CPU Usage	Average CPU usage rate in a measurement interval, in percentage.
CPU Usage Stat. Time	CPU usage rate statistics time in seconds, that is, the system time when the command is executed.
CPU Usage Stat. Tick	System runtime in ticks, represented by a 64-bit hexadecimal. CPU Tick High represents the most significant 32 bits and the CPU Tick Low the least significant 32 bits.
Actual Stat. Cycle	Actual CPU usage rate measurement interval in ticks, represented by a 64-bit hexadecimal. CPU Tick High represents the most significant 32 bits and the CPU Tick Low the least significant 32 bits. Owing to the precision of less than one second, the actual measurement periods of different CPU usage rate records might differ slightly.

display cpu-usage history

Use display cpu-usage history to display historical CPU usage statistics in charts.

Syntax

display cpu-usage history [ task task-id ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

task task-id: Displays the historical CPU usage statistics for the specified task, where task-id represents the task number. If the task-id argument is not provided, this command displays the historical CPU usage statistics for the entire system (the CPU usage rates of the entire system is the sum of CPU usage rates of all tasks).

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If no argument is provided, this command displays the historical CPU usage statistics for the whole system.

The system regularly collects CPU usage statistics and saves the statistics in the history record area. The display cpu-usage history command displays the CPU usage statistics for the last 60 minutes in axes, where:

· The vertical axis represents the CPU usage. If a statistic is not a multiple of the usage step, it is rounded up or down to the closest multiple of the usage step, whichever is closer. For example, if the CPU usage step is 5%, the statistic 53% is rounded up to 55%, and the statistic 52% is rounded down to 50%.

· The horizontal axis represents the time.

· Consecutive pound signs (#) indicate the CPU usage at a specific time. The value on the vertical axis for the topmost # sign at a specific time represents the CPU usage at that time.

Examples

# Display historical CPU usage statistics.

<Sysname> display cpu-usage history

100%|

95%|

90%|

85%|

80%|

75%|

70%|

65%|

60%|

55%|

50%|

45%|

40%|

35%|

30%|

25%|

20%|

15%| #

10%| ### #

5%| ########

------------------------------------------------------------

10 20 30 40 50 60 (minutes)

cpu-usage last 60 minutes(SYSTEM)

The output shows the historical CPU usage statistics (with the task name SYSTEM) in the last 60 minutes:

· 5%: 12 minutes ago

· 10%: 13 minutes ago

· 15%: 14 minutes ago

· 10%: 15 minutes ago

· 5%: 16 and 17 minutes ago

· 10%: 18 minutes ago

· 5%: 19 minutes ago

· 2% or lower than 2%: other time

# Display the historical CPU usage statistics for task 6.

<Sysname> display cpu-usage history task 6

100%|

95%|

90%|

85%|

80%|

75%|

70%|

65%|

60%|

55%|

50%|

45%|

40%|

35%|

30%|

25%|

20%|

15%|

10%|

5%| #

------------------------------------------------------------

10 20 30 40 50 60 (minutes)

cpu-usage last 60 minutes(T03M)

The output shows the historical CPU usage statistics of task 6 (with the task name T03M) in the last 60 minutes:

· 5%: 20 minutes ago

· 2% or lower than 2%: other time

display device

Use display device to display device information.

Syntax

display device [ cf-card | usb ] [ serial-number ] [ subslot subslot-number | verbose ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

cf-card: Displays CF card information. Support for the cf-card keyword depends on your device model. For more information, see About the H3C Access Controllers Command References.

usb: Displays USB interface-connected device information. Support for the usb keyword depends on your device model. For more information, see About the H3C Access Controllers Command References.

serial-number: Specifies a device serial number.

subslot subslot-number: Displays information about the specified subcard. The subslot-number represents the subslot of a subcard. Support for this option depends on the device model. For more information, see About the H3C Access Controllers Command References.

verbose: Displays detailed information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If no CF card or USB disk is specified, this command displays information about all cards.

Examples

# Display device information.

<Sysname> display device

Slot No. Subslot No. Board Type Status Max Ports

1 0 LSU3WCMD0 Normal 3

Table 3 Command output

Field	Description
Subslot No.	Number of the subslot where the subcard resides.
Board Type	Hardware type of the card.
Status	Card status: · Fault—Error occurred, and the card cannot start normally. · Normal—The card is operating normally.
Max Ports	Maximum number of physical ports that the card supports.

display device manuinfo

Use display device manuinfo to display the electronic label data for the device.

Syntax

display device manuinfo [ subslot subslot-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

3: Manage level

Parameters

subslot subslot-number: Displays the electronic label data for the specified subcard. The subslot-number represents the subslot of a subcard. Support for this option depends on the device model. For more information, see About the H3C Access Controllers Command References.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

An electronic label is a profile of a device or card and contains the permanent configuration including the serial number, manufacturing date, MAC address, and vendor name. The data is written to the storage component during debugging or testing.

This command displays part of the electronic label data.

Examples

# Display the electronic label data for the device.

<Sysname> display device manuinfo

Slot 1:

Subslot 0

DEVICE_NAME : LSUM3WCMD0

DEVICE_SERIAL_NUMBER : 210231A1GHB123000001

MAC_ADDRESS : C4CA-D9DD-A440

MANUFACTURING_DATE : 2012-03-13

VENDOR_NAME : H3C

display diagnostic-information

Use display diagnostic-information to display or save running status data for multiple feature modules.

Syntax

display diagnostic-information [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

For diagnosis or troubleshooting, you can use separate display commands to collect running status data module by module, or use the display diagnostic-information command to bulk collect running data for multiple modules.

Examples

# Save running status data for multiple feature modules.

<Sysname> display diagnostic-information

Save or display diagnostic information (Y=save, N=display)?[Y/N]y

Please input the file name(*.diag)[cfa0:/default.diag]:aa.diag

Diagnostic information is outputting to cfa0:/aa.diag.

Please wait...

Save succeeded.

To view the content of file aa.diag, execute the more.aa.diag command in user view, in combination of the Page Up and Page Down keys.

# Display running status data for multiple feature modules.

<Sysname> display diagnostic-information

Save or display diagnostic information (Y=save, N=display)? [Y/N]:n

=================================================

===============display clock===============

=================================================

08:54:16 UTC Fri 10/15/2012

===================================================

===============display version===============

===================================================

……Part of the output is not shown.……

display environment

Use display environment to display temperature information, including the current temperature and temperature thresholds of cards.

Use display environment cpu to display temperature information for all CPUs.

Syntax

display environment [ cpu ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

cpu: Displays CPU temperature information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

Support for this command depends on your device model. For more information, see About the H3C Access Controllers Command References.

Examples

# Display temperature information (on devices supporting advanced temperature threshold configuration).

<Sysname> display environment

System temperature information (degree centigrade):

-----------------------------------------------------------------------------

Slot Sensor Temperature LowerLimit WarningLimit AlarmLimit Shutdown

Limit

1 inflow 1 27 3 50 58 N/A

1 hotspot 1(cpu) 43 0 86 92 N/A

1 hotspot 2 35 0 74 80 N/A

Table 4 Command output

Field	Description
sensor	Temperature sensor: · hotspot—Hotspot sensor. · inflow—Air intake sensor. · outflow—Air exhaust sensor.
Slot	A number in this field indicates a device. The "vent" in this field indicates a sensor on the chassis or fan tray.
Temperature	Current temperature.
LowerLimit	Temperature lower limit.
WarningLimit	Warning temperature threshold.
AlarmLimit	Alarming temperature threshold.
ShutdownLimit	Shut-down temperature threshold. When the sensor temperature reaches this limit, the system shuts down automatically.

# Display temperature information (on devices supporting basic temperature threshold configuration).

<Sysname> display environment

System Temperature information (degree centigrade):

----------------------------------------------------

SlotNo Temperature Lower limit Upper limit

1 27 0 90

Related commands

temperature-limit

display fan

Use display fan to display the operating states of fans.

Syntax

display fan [ fan-id ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Usage guidelines

Support for this command depends on your device model. For more information, see About the H3C Access Controllers Command References.

Parameters

fan-id: Displays the operating state of the specified fan, where fan-id represents the built-in fan number. Support for this argument and the value range depend on your device model. For more information, see About the H3C Access Controllers Command References.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display the operating states of all fans.

<Sysname> display fan

Fan 1 State: Normal

Fan 2 State: Normal

Fan 3 State: Normal

Fan 4 State: Normal

Fan 5 State: Normal

display job

Use display job to display information about scheduled jobs configured by using the job command.

Syntax

display job [ job-name ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

job-name: Specifies the job name, which is a string of 1 to 32 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If no job is specified, this command displays information about all scheduled jobs.

Examples

# Display detailed information about the scheduled job saveconfig.

<Sysname> display job saveconfig

Job name: saveconfig

Specified view: monitor

Time 1: Execute command save 1.cfg after 40 minutes

The output shows that the current configuration will be automatically saved to the configuration file 1.cfg in 40 minutes.

Table 5 Command output

Field	Description
Job name	Name of the scheduled job.
Specified view	View containing the commands in the job.
Time timeID	Execution time of each command in the job.
Execute command	Command string.

Related commands

· job

· time

· view

display memory

Use display memory to display memory usage statistics.

Syntax

display memory [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display memory usage statistics.

<Sysname> display memory

System Total Memory(bytes): 431869088

Total Used Memory(bytes): 71963156

Used Rate: 16%

Table 6 Command output

Field	Description
System Total Memory(bytes)	Total size of the system memory (in bytes)
Total Used Memory(bytes)	Size of the memory used (in bytes)
Used Rate	Percentage of the memory used to the total memory.

display power

Use display power to display power supply information.

Syntax

display power [ power-id ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

power-id: Displays information about the specified power supply, where power-id represents the power supply number. The value varies with devices. For more information, see About the H3C Access Controllers Command References.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

Support for this command depends on your device model. For more information, see About the H3C Access Controllers Command References.

Examples

# Display power supply information.

<Sysname> display power

Power 1 State: Normal

Power 2 State: Absent

display reboot-type

Use display reboot-type to display the mode of the last reboot.

Syntax

display reboot-type [ subslot subslot-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

subslot subslot-number: Displays the mode of the last reboot for a subcard. The subslot-number represents the subslot number of a subcard. Support for this option depends on the device model. For more information, see About the H3C Access Controllers Command References.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If no subcard is specified, this command displays the mode of the last reboot of the device.

Examples

# Display the mode of the last reboot.

<Sysname> display reboot-type

The rebooting type this time is: Cold

The output shows that the last reboot mode is Cold boot (cold boot restarts a device by powering it on). (The display of Warm represents a warm boot, which means to restart a device by using the commands like reboot).

display rps

Use display rps to display RPS status information.

Syntax

display rps [ rps-id ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

rps-id: Displays the status of the specified RPS, where rps-id represents the RPS number. The value varies with devices.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

Support for this command depends on your device model. For more information, see About the H3C Access Controllers Command References.

Examples

# Display RPS status information.

<Sysname> display rps

RPS 2 State: Normal

The output shows that RPS 2 works normally.

display schedule job

Use display schedule job to display the job configured by using the schedule job command.

Syntax

display schedule job [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display the configuration of the job configured by using the schedule job command.

<Sysname> display schedule job

Specified command: execute 1.bat

Specified view: system view

Executed time: at 12:00 10/31/2012 (in 0 hours and 16 minutes)

If you change the system time within 16 minutes after you execute the schedule job command, the scheduled task becomes invalid. Then, if you execute the display schedule job command again, the command displays nothing.

Table 7 Command output

Field	Description
Specified command	Command to be executed.
Specified view	View for the command to be executed.
Executed time	Execution time of the command and the difference between the current system time and scheduled time.

Related commands

schedule job

display schedule reboot

Use display schedule reboot to display the reboot schedule.

Syntax

display schedule reboot [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

3: Manage level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display the reboot schedule.

<Sysname> display schedule reboot

System will reboot at 16:00:00 03/10/2012 (in 2 hours and 5 minutes).

Related commands

· schedule reboot at

· schedule reboot delay

display system-failure

Use display system-failure to display the exception handling method.

Syntax

display system-failure [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

3: Manage level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display the exception handling method.

<Sysname> display system-failure

System failure handling method: reboot

Related commands

system-failure

display transceiver

Use display transceiver to display the key parameters of transceiver modules.

Syntax

display transceiver interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

interface [ interface-type interface-number ]: Displays the key parameters of the transceiver module in an interface. The interface-type interface-number argument specifies an interface by its type and number. If no interface is specified, this command displays the key parameters of the transceiver modules in all interfaces.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

Support for this command depends on your device model. For more information, see About the H3C Access Controllers Command References.

Examples

# Display the key parameters of the transceiver module in interface GigabitEthernet 1/0/1.

<Sysname> display transceiver interface gigabitethernet 1/0/1

GigabitEthernet1/0/1 transceiver information:

Transceiver Type : 1000_BASE_SX_SFP

Connector Type : LC

Wavelength(nm) : 850

Transfer Distance(m) : 550(50um),270(62.5um)

Digital Diagnostic Monitoring : YES

Vendor Name : H3C

Ordering Name : SFP-GE-SX-MM850

Table 8 Command output

Field	Description
transceiver information	Transceiver module information.
Transceiver Type	Transceiver module type.
Connector Type	Connector type options: · SC—Fiber connector developed by NTT. · LC—1.25 mm/RJ-45 fiber connector developed by Lucent. · RJ-45. · CX 4.
Wavelength(nm)	· Fiber transceiver: central wavelength (in nm) of the transmit laser. If the transceiver supports multiple wavelengths, every two wavelength values are separated by a comma. · Copper transceiver: displayed as N/A.
Transfer Distance(xx)	Transfer distance, with xx representing km for single-mode transceiver modules and m for other transceiver modules. If the transceiver module supports multiple transfer media, every two transfer distance values are separated by a comma. The corresponding transfer medium is included in the bracket following the transfer distance value. The following are the supported transfer media: · 9 um—9/125 um single-mode fiber. · 50 um—50/125 um multi-mode fiber. · 62.5 um—62.5/125 um multi-mode fiber. · TP—Twisted pair. · CX4—CX4 cable.
Digital Diagnostic Monitoring	Support for the digital diagnosis function: · YES—Supported. · NO—Not supported.
Vendor Name	Vendor name.
Ordering Name	Product code.

display transceiver alarm

Use display transceiver alarm to display alarms on transceiver modules.

Syntax

display transceiver alarm interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

interface [ interface-type interface-number ]: Displays the alarms on the transceiver module in an interface. The interface-type interface-number argument specifies an interface by its type and number. If no interface is specified, this command displays alarm information for the transceiver modules in all interfaces.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

Support for this command depends on your device model. For more information, see About the H3C Access Controllers Command References.

If no error occurs, None is displayed. Table 9 describes the transceiver module alarms that might occur. Support for the transceiver modules depends on your device model.

Table 9 Common transceiver module alarms

Field	Remarks
SFP
RX loss of signal	Incoming (RX) signal is lost.
RX power high	Incoming (RX) power is high.
RX power low	Incoming (RX) power is low.
TX fault	Transmit (TX) fault.
TX bias high	TX bias current is high.
TX bias low	TX bias current is low.
TX power high	TX power is high.
TX power low	TX power is low.
Temp high	Temperature is high.
Temp low	Temperature is low.
Voltage high	Voltage is high.
Voltage low	Voltage is low.
Transceiver info I/O error	Transceiver information read and write error.
Transceiver info checksum error	Transceiver information checksum error.
Transceiver type and port configuration mismatch	Transceiver type does not match port configuration.
Transceiver type not supported by port hardware	The port does not support the transceiver type.

Examples

# Display the alarms on the transceiver module in interface GigabitEthernet 1/0/1.

<Sysname> display transceiver alarm interface gigabitethernet 1/0/1

GigabitEthernet1/0/1 transceiver current alarm information:

RX loss of signal

RX power low

Table 10 Command output

Field	Description
transceiver current alarm information	Alarms on the transceiver module.
RX loss of signal	Incoming (RX) signal is lost.
RX power low	Incoming (RX) power level is low.

display transceiver diagnosis

Use display transceiver diagnosis to display the measured values of the digital diagnosis parameters for transceiver modules.

Syntax

display transceiver diagnosis interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

interface [ interface-type interface-number ]: Displays the measured values of the digital diagnosis parameters for the transceiver module in an interface. The interface-type interface-number argument specifies an interface by its type and number. If no interface is specified, this command displays the measured values of the digital diagnosis parameters for the transceiver modules in all interfaces.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

Support for this command depends on your device model. For more information, see About the H3C Access Controllers Command References.

The display transceiver diagnosis command cannot display information for some transceiver modules.

Examples

# Display the measured values of the digital diagnosis parameters for the transceiver module in interface GigabitEthernet 1/0/1.

<Sysname> display transceiver diagnosis interface gigabitethernet 1/0/1

GigabitEthernet1/0/1 transceiver diagnostic information:

Current diagnostic parameters:

Temp(°C) Voltage(V) Bias(mA) RX power(dBM) TX power(dBM)

36 3.31 6.13 -35.64 -5.19

Table 11 Command output

Field	Description
transceiver diagnostic information	Digital diagnosis information of the transceiver in the interface.
Current diagnostic parameters	Current diagnostic parameters.
Temp.(°C)	Digital diagnosis parameter-temperature, in °C, with the precision to 1°C.
Voltage(V)	Digital diagnosis parameter-voltage, in V, with the precision to 0.01 V.
Bias(mA)	Digital diagnosis parameter-bias current, in mA, with the precision to 0.01 mA.
RX power(dBM)	Digital diagnosis parameter-RX power, in dBM, with the precision to 0.01 dBM.
TX power(dBM)	Digital diagnosis parameter-TX power, in dBM, with the precision to 0.01 dBM.

display transceiver manuinfo

Use display transceiver manuinfo to display the electronic label data for transceiver modules.

Syntax

display transceiver manuinfo interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

interface [ interface-type interface-number ]: Displays the electronic label data for the transceiver module in an interface. The interface-type interface-number argument specifies represents interface type and interface number. If no interface is specified, this command displays the electronic label data for the transceiver modules in all interfaces.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

Support for this command depends on your device model. For more information, see About the H3C Access Controllers Command References.

The display transceiver manuinfo command cannot display information for some transceiver modules.

Examples

# Display the electronic label data for the transceiver module in interface GigabitEthernet 1/0/1.

<Sysname> display transceiver manuinfo interface gigabitethernet 1/0/1

GigabitEthernet1/0/1 transceiver manufacture information:

Manu. Serial Number : 213410A0000054000251

Manufacturing Date : 2012-09-01

Vendor Name : H3C

Table 12 Command output

Field	Description
Manu. Serial Number	Serial number generated during debugging and testing of the transceiver module.
Manufacturing Date	Debugging and testing date. The date takes the value of the system clock of the computer that performs debugging and testing.
Vendor Name	Vendor name of the transceiver module.

display version

Use display version to display system version information, including the system software version, chassis model, and basic MPU and interface card data.

Syntax

display version [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display system version information.

<Sysname> display version

header

Use header to create a banner.

Use undo header to clear a banner.

Syntax

header { incoming | legal | login | motd | shell } text

undo header { incoming | legal | login | motd | shell }

Views

System view

Default command level

2: System level

Parameters

incoming: Configures the banner displayed before a modem dial-in user accesses user view.

legal: Configures the banner displayed before a user inputs the username and password to access the CLI.

motd: Configures the greeting banner displayed before the legal banner appears.

shell: Configures the banner displayed before a non-modem dial-in user accesses user view.

text: Banner message, which can be input in two formats. For more information, see Fundamentals Configuration Guide.

Usage guidelines

Banners are greeting or alert messages that the system displays during the login process of a user.

Examples

# Configure banners.

<Sysname> system-view

[Sysname] header incoming %

Please input banner content, and quit with the character '%'.

Welcome to incoming(header incoming)%

[Sysname] header legal %

Please input banner content, and quit with the character '%'.

Welcome to incoming(header incoming)%

[Sysname] header legal %

Please input banner content, and quit with the character '%'.

Welcome to legal (header legal)%

[Sysname] header login %

Please input banner content, and quit with the character '%'.

Welcome to login(header login)%

[Sysname] header motd %

Please input banner content, and quit with the character '%'.

Welcome to motd(header motd)%

[Sysname] header shell %

Please input banner content, and quit with the character '%'.

Welcome to shell(header shell)%

In this example, the percentage sign (%) is the starting and ending characters of text. Entering % after the displayed test quits the header command. As the starting and ending characters, % is not part of the banners.

# Verify the configuration by using Telnet. (The login authentication is not configured.)

******************************************************************************

* Without the owner's prior written consent, *

* no decompiling or reverse-engineering shall be allowed. *

******************************************************************************

Welcome to legal (header legal)

Press Y or ENTER to continue, N to exit.

Welcome to motd(header motd)

Welcome to shell(header shell)

# Verify the configuration by using Telnet. (Password authentication is configured.)

******************************************************************************

* Without the owner's prior written consent, *

* no decompiling or reverse-engineering shall be allowed. *

******************************************************************************

Welcome to legal (header legal)

Press Y or ENTER to continue, N to exit.

Welcome to motd(header motd)

Welcome to login(header login)

Password:

Welcome to shell(header shell)

job

Use job to create a job or enter job view.

Use undo job to delete a scheduled job.

Syntax

job job-name

undo job job-name

Default

No job is created.

Views

System view

Default command level

3: Manage level

Parameters

job-name: Specifies the name for a job, a string of 1 to 32 characters.

Usage guidelines

You can add commands in job view to execute at certain times.

You can use the job command to create multiple jobs.

Examples

# Create the job saveconfiguration or enter its view.

<Sysname> system-view

[Sysname] job saveconfiguration

[Sysname-job-saveconfiguration]

Related commands

· time

· view

memory-usage threshold

Use memory-usage threshold to set the memory usage threshold for a specific AP.

Use undo memory-usage threshold to restore the default.

Syntax

memory-usage threshold memory-threshold

undo memory-usage threshold

Default

The default value is 90%.

Views

AP template view

Default command level

2: System level

Parameters

memory-threshold: Specifies the memory usage threshold in percentage, in the range of 0 to 100.

Usage guidelines

When the memory usage of an AP is larger than or equals the specified threshold, the AC considers that the memory usage of the AP is too high.

Examples

# Set the memory usage threshold of AP ap1 to 80%.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2620-AGN

[Sysname-wlan-ap-ap1] memory-usage threshold 80

nms monitor-interface

Use nms primary monitor-interface to configure the primary monitored interface.

Use nms secondary monitor-interface to configure the secondary monitored interface.

Use undo nms primary monitor-interface to remove the primary monitored interface configuration.

Use undo nms secondary monitor-interface to remove the secondary monitored interface configuration.

Syntax

nms { primary | secondary } monitor-interface interface-type interface-number

undo nms { primary | secondary } monitor-interface

Default

A network management system (NMS) does not monitor any interface on the device.

Views

System view

Default command level

3: Manage level

Parameters

primary: Specifies the primary monitored interface.

secondary: Specifies the secondary monitored interface.

interface-type interface-number: Specifies the type and number of the interface to be monitored.

Usage guidelines

If you configure only the primary monitored interface or the secondary monitored interface, the device monitors the IP address of the configured interface. If the interface gets or changes its IP address when the interface status is up, the device sends traps to the NMS to inform it of the available IP address.

If you configure both the primary and secondary monitored interfaces, the device monitors the primary one first.

Examples

# Configure GigabitEthernet 1/0/1 as the primary monitored interface.

<Sysname> system-view

[Sysname] nms primary monitor-interface gigabitethernet 1/0/1

reboot

Use reboot to reboot the device or the specified subcard.

Syntax

reboot

Views

User view

Default command level

3: Manage level

Usage guidelines

CAUTION:

· Device reboot can interrupt network services.

· If the main system software image file has been corrupted or does not exist, the device cannot reboot. You must re-specify a main system software image file, or power off the device and then power it on so the system can reboot with the backup system software image file.

For data security, if you are performing file operations at the reboot time, the system does not reboot.

Examples

# Reboot the device.

<Sysname> reboot

The output is not shown.

resend-interval

Use resend-interval to set the alarm resend interval.

Use undo resend-interval to restore the default.

Syntax

resend-interval resend-interval

undo resend-interval

Default

The alarm resend interval is 0 seconds. That is, the AC does not resend alarms.

Views

System view

Default command level

3: Manage level

Parameters

resend-interval: Specifies the alarm resend interval. The value range is 0 to 3600 seconds.

Usage guidelines

When you set a non-zero value for the alarm resend interval and the interval for collecting CPU/memory statistics, set the alarm resend interval first and make sure its value is larger than or equal to three times the interval for collecting CPU/memory statistics. When you restore the alarm resend interval and the interval for collecting CPU/memory statistics to their default, set the interval for collecting CPU/memory statistics first. Otherwise, you cannot execute the commands successfully.

Examples

# Set the alarm resend interval to 800 seconds.

<Sysname> system-view

[Sysname] resend-interval 800

Related commands

collection-interval

reset unused porttag

Use reset unused porttag to clear unused 16-bit interface indexes.

Syntax

reset unused porttag

Views

User view

Default command level

1: Monitor level

Usage guidelines

A confirmation is required when you execute this command. The command does not run if you enter N to cancel the operation or fail to make a confirmation within 30 seconds.

Examples

# Clear unused 16-bit interface indexes.

<Sysname> reset unused porttag

Current operation will delete all unused port tag(s). Continue? [Y/N]:y

schedule job

Use schedule job to schedule a job in the non-modular approach.

Use undo schedule job to remove the scheduled job.

Syntax

schedule job { at time1 [ date ] | delay time2 } view view-name command

undo schedule job

Views

User view

Default command level

3: Manage level

Parameters

at time1 [ date ]: Specifies the time and/or date to execute a command.

· time1: Sets time to execute the command, in the hh:mm format. The value range for the hh value is 0 to 23, and the value range for the mm value is 0 to 59.

· date: Sets the date to execute the command, in the MM/DD/YYYY or YYYY/MM/DD format. The value range for the YYYY value is 2000 to 2035, the value range for the MM value is 1 to 12, and the value range for the DD value is 1 to 31.

delay time2: Runs the job after a delay. The time2 argument specifies the delay in one of the following formats:

· hh:mm format—The value range for the hh value is 0 to 720, and the value range for the mm value is 0 to 59. When the hh value is 720, the mm value cannot be more than 0.

· mm format—The value range is 0 to 432000 minutes, with 0 indicating that the command is executed immediately.

view view: Specifies the view in which the command is executed. The view argument represents the view name, and it can take only one of the following keywords:

· shell—Represents user view.

· system—Represents system view.

command: Command to execute.

Usage guidelines

You can schedule a job to automatically run a command or a set of commands without administrative interference. The commands in a job are polled every minute. When the scheduled time for a command is reached, the job automatically executes the command. If a confirmation is required while the command is running, the system automatically enters Y or Yes. If characters are required, the system automatically enters a default character string or an empty character string when no default character string is available.

Follow these guidelines when you schedule a job in the non-modular approach:

· You can schedule only one job and run only one command in this approach. If you perform the schedule job command multiple times, the last configuration takes effect.

· To have the command successfully executed, check that the specified view and command are valid. The system does not verify their validity.

· If you specify both the time1 and date arguments, the execution time or date must be later than the current system time or date.

· If you specify the time1 argument, but not the date argument:

? When time1 is earlier than the current system time, the command runs at time1 the next day.

? When time1 is later than the current system time, the command runs at time1 of the current day.

· The interval between the scheduled time and the current system time cannot exceed 720 hours, or 30 days.

· Changing any clock setting can cancel the job set by using the schedule job command.

· After job execution, the configuration interface, view, and user status that you have before job execution restore even if the job has run a command that changes the user interface (for example, telnet, ftp, and ssh2), the view (for example, system-view and quit), or the user status (for example, super).

Examples

# Schedule a job to execute the batch file 1.bat in system view in 60 minutes (assuming that the current time is 11:43).

<Sysname> schedule job delay 60 view system execute 1.bat

Info: Command execute 1.bat in system view will be executed at 12:43 10/31/2012 (in 1 hours and 0 minutes).

# Schedule a job to execute the batch file 1.bat in system view at 12:00 (assuming that the current time is 11:43).

<Sysname> schedule job at 12:00 view system execute 1.bat

Info: Command execute 1.bat in system view will be executed at 12:00 10/31/2012 (in 0 hours and 16 minutes).

schedule reboot at

Use schedule reboot at to schedule a device reboot to occur at a specific time and date.

Use undo schedule reboot to disable the scheduled reboot function.

Syntax

schedule reboot at hh:mm [ date ]

undo schedule reboot

Default

The scheduled reboot function is disabled.

Views

User view

Default command level

3: Manage level

Parameters

hh:mm: Specifies a reboot time, in the hh:mm format. The value range for the hh value is 0 to 23, and the value range for the mm value is 0 to 59.

date: Specifies a reboot date, in the MM/DD/YYYY or YYYY/MM/DD format. The value range for the YYYY value is 2000 to 2035, the value range for the MM value is 1 to 12, and the value range for the DD value is 1 to 31.

Usage guidelines

CAUTION:

· Device reboot can interrupt network services.

· Changing any clock setting can cancel the reboot schedule.

The interval between the reboot date and the current date cannot exceed 30 x 24 hours, or 30 days.

When no reboot date is specified:

· If the reboot time is later than the current time, a reboot occurs at the reboot time of the current day.

· If the reboot time is earlier than the current time, a reboot occurs at the reboot time the next day.

The device supports only one device reboot schedule. If you configure the schedule reboot at command multiple times, the last configuration takes effect. The schedule reboot at command and the schedule reboot delay command overwrite each other, and whichever is configured last takes effect.

The alert "REBOOT IN ONE MINUTE" appears one minute before the reboot time.

For data security, if you are performing file operations at the reboot time, the system does not reboot.

Examples

# Configure the switch to reboot at 12:00 AM. This example assumes that the current time is 11:43.

<Sysname> schedule reboot at 12:00

Reboot system at 12:00 06/06/2012(in 0 hour(s) and 16 minute(s))

confirm? [Y/N]:

Enter y at the prompt. If you have used the terminal logging command to enable the log display function (enabled by default) on the terminal, the system automatically displays a reboot schedule log message.

%Jun 6 11:43:11:629 2012 Sysname CMD/4/REBOOT:

vty0(192.168.1.54): Set schedule reboot parameters at 11:43:11 06/06/2012, and system will reboot at 12:00 06/06/2012.

Related commands

schedule reboot delay

Use schedule reboot delay to schedule a device reboot to occur after a delay.

Use undo schedule reboot to disable the scheduled reboot function.

Syntax

schedule reboot delay { hh:mm | mm }

undo schedule reboot

Default

The scheduled reboot function is disabled.

Views

User view

Default command level

3: Manage level

Parameters

hh:mm: Specifies a delay for the device reboot, in the hh:mm format. The value range for the hh value is 0 to 720, and the value range for the mm value is 0 to 59. When the hh value is 720, the mm value cannot be more than 0.

mm: Specifies a delay for the device reboot in minutes, in the range of 0 to 43200.

Usage guidelines

CAUTION:

· Device reboot can interrupt network services.

· Changing any clock setting can cancel the reboot schedule.

The reboot delay cannot exceed 30 x 24 x 60 minutes, or 30 days.

The device supports only one device reboot schedule. If you configure the schedule reboot delay command multiple times, the last configuration takes effect. The schedule reboot at command and the schedule reboot delay command overwrite each other, and whichever is configured last takes effect.

The alert "REBOOT IN ONE MINUTE" appears one minute before the reboot time.

For data security, if you are performing file operations at the reboot time, the system does not reboot.

Examples

# Schedule a device reboot in 88 minutes. This example assumes that the current time is 11:48 on June 6, 2012.

<Sysname> schedule reboot delay 88

Reboot system at 13:16 06/06/2012(in 1 hour(s) and 28 minute(s)). confirm? [Y/N]:

%Jun 6 11:48:44:860 2012 Sysname CMD/4/REBOOT:

vty0(192.168.1.54): Set schedule reboot parameters at 11:48:44 06/06/2012, and system will reboot at 13:16 06/06/2012.

Related commands

schedule reboot at

shutdown-interval

Use shutdown-interval to set the port status detection timer.

Use undo shutdown-interval to restore the default.

Syntax

shutdown-interval time

undo shutdown-interval

Default

The port status detection timer is 30 seconds.

Views

System view

Default command level

2: System level

Parameters

time: Specifies the port status detection timer in seconds, in the range of 0 to 300.

Usage guidelines

Some protocols might shut down ports under specific circumstances. For example, MSTP shuts down a BPDU guard-enabled port when the port receives a BPDU. In this case, you can set the port status detection timer. If the port is still down when the detection timer expires, the protocol module automatically cancels the shutdown action and restores the port to its original physical status.

· If you change the detection timer to T1 during port detection, the interval from when you change the timer to the time when the protocol module shuts down the port is T. If T<T1, the down port will be recovered after T1-T seconds. If T>=T1, the down port will be recovered immediately. For example, if the detection timer is set to 30 seconds and you change it to 10 seconds (T1=10) two seconds after the port is shut down (T=2), this port will be recovered 8 seconds later. If the detection timer is set to 30 seconds and you change it to 2 seconds ten seconds after the port is shut down, this port will be recovered immediately.

· If the detection timer is set to 0, the protocol module never automatically recovers the port. You must bring up the port by using the undo shutdown command or change the detection timer to a non-zero value.

Examples

# Set the port status detection timer to 100 seconds.

<Sysname> system-view

[Sysname] shutdown-interval 100

sysname

Use sysname to set the device name.

Use undo sysname to restore the default.

Syntax

sysname sysname

undo sysname

Default

The default name is H3C.

Views

System view

Default command level

2: System level

Parameters

sysname: Specifies the name of the device, a string of 1 to 64 characters.

Usage guidelines

A device name identifies a device in a network and works as the user view prompt at the CLI. For example, if the device name is Sysname, the user view prompt is <Sysname>.

Examples

# Set the name of the device to R2000.

<Sysname> system-view

[Sysname] sysname R2000

[R2000]

system-failure

Use system-failure to configure the exception handling method.

Use undo system-failure to restore the default.

Syntax

system-failure { maintain | reboot }

undo system-failure

Default

The system adopts the reboot method to handle exceptions.

Views

System view

Default command level

3: Manage level

Parameters

maintain: Configures the system to maintain the current situation, and not take any measure to recover itself when it detects any software abnormality.

reboot: Configures the system to recover itself through automatic reboot when it detects any software abnormality.

Examples

# Set the exception handling method to reboot.

<Sysname> system-view

[Sysname] system-failure reboot

temperature-limit (advanced)

Use temperature-limit to set the temperature alarm thresholds for a card.

Use undo temperature-limit to restore the default.

Syntax

temperature-limit slot slot-number { hotspot | inflow } sensor-number lowerlimit warninglimit [ alarmlimit ]

undo temperature-limit slot slot-number { hotspot | inflow } sensor-number

Default

The temperature alarm thresholds depend on your device model. For more information, see About the H3C Access Controllers Command References.

Views

System view

Default command level

2: System level

Parameters

slot slot-number: Specifies a card by its slot number.

hotspot: Specifies a hotspot sensor, which is used for temperature monitoring and is typically placed near the chip that generates a great amount.

inflow: Specifies an intake sensor, which is placed near the air inlet for temperature monitoring.

sensor-number: Specifies the sensor number. It is an integer starting from 1, and each number represents a temperature sensor of a device or card.

lowerlimit: Specifies the lower temperature threshold in Celsius degrees. The value range is 30°C to 100°C (86°F to 212°F).

warninglimit: Specifies the warning temperature threshold in Celsius degrees. The value range is 0°C to 100°C (32°F to 212°F).

alarmlimit: Specifies the alarming temperature threshold in Celsius degrees. The value range is 0°C to 100°C (32°F to 212°F), and the value must be higher than the warning threshold. If you do not specify this argument, the current configuration is used.

Usage guidelines

Support for this command depends on your device model. For more information, see About the H3C Access Controllers Command References.

When the device temperature drops below the lower temperature threshold or reaches the warning threshold, the device logs the event and outputs a log message and a trap.

When the device temperature reaches the alarming threshold, the device logs the event and outputs a log message and a trap repeatedly, and alerts users through the LED on the device panel.

Examples

# Set the lower temperature threshold for the intake sensor 1 on the card in slot 0 to –10°C (14°F), the warning threshold to 70°C (158°F), and the alarming threshold to 100°C (212°F).

<Sysname> system-view

[sysname] temperature-limit slot 0 inflow 1 -10 70 100

Related commands

display environment

temperature-limit (basic)

Use temperature-limit to set the temperature alarm thresholds for a card.

Use undo temperature-limit to restore the default.

Syntax

temperature-limit slot-number lower-value upper-value

undo temperature-limit slot-number

Default

The temperature alarm thresholds depend on device models. For more information, see About the H3C Access Controllers Command References.

Views

System view

Default command level

2: System level

Parameters

slot-number: This argument is reserved.

lower-value: Specifies the lower temperature threshold in Celsius degrees. The value range is 0°C to 70°C (32°F to 158°F).

upper-value: Specifies the upper temperature threshold in Celsius degrees. The value range is 20°C to 90°C (68°F to 194°F).

The upper-value must be larger than the lower-value.

Usage guidelines

Support for this command depends on your device model. For more information, see About the H3C Access Controllers Command References.

Examples

# Set the lower temperature threshold for card 1 to 10°C (50°F) and the upper temperature threshold to 75°C (167°F).

<Sysname> system-view

[Sysname] temperature-limit 1 10 75

Setting temperature limit succeeded.

Related commands

display environment

time at

Use time at to add a command to run at a specific time and date in the job schedule.

Use undo time to remove a command from the job schedule.

Syntax

time time-id at time date command command

time time-id { one-off | repeating } at time [ month-date month-day | week-day week-daylist ] command command

undo time time-id

Views

Job view

Default command level

3: Manage level

Parameters

time timeid: Specifies the time setting entry, an integer in the range of 1 to 10.

at time: Specifies an execution time, in the hh:mm format. The value range for the hh value is 0 to 23 and that for the mm value is 0 to 59.

one-off: Specifies that the specified command is executed for once.

repeating: Specifies a recurring time schedule.

date: Specifies an execution date, in the MM/DD/YYYY or YYYY/MM/DD format. The value range for the YYYY value is 2000 to 2035, the value range for the MM value is 1 to 12, and the value range for the DD value is 1 to 31. The specified execution date must be ahead of the current date.

month-date month-day: Specifies the date for executing the command. The value range is 1 to 31.

week-day week-daylist: Specifies the day or days for executing the command. The week-daylist argument specifies one day or up to seven days, which can be any combination of Sun, Mon, Tue, Wed, Thu, Fri, and Sat. For example, to have a command executed on Monday, you can enter week-day Mon; to have a command executed on Friday and Saturday, enter week-day Fri Sat. Use a space between every two days for separation.

command command: Specifies the command to be automatically executed, in the text format. The command must be executable in the view specified by the view command. Otherwise this command cannot be executed automatically.

Usage guidelines

A job can have up to 10 commands. The commands in a job must belong to the same view.

The time ID (time-id) must be unique in a job. If two time and command bindings have the same time ID, the one configured last takes effect.

Changing a clock setting does not affect the schedule set by using the time at command.

Use Table 13 when you add commands in a job.

Table 13 Command schedule options

Command	Description
time timeid at time date command command	Schedules a command to run at a specific time and date. The time or date must be later than the current system time or date.
time timeid one-off at time command command	Schedules a command to run at a specific time on the current day. If the specified time has passed, the command runs the next day. The command runs only once.
time timeid one-off at time month-date month-day command command	Schedules a command to run at a specific day in the current month. If the specified time or day has passed, the command runs in the next month. The command runs only once.
time timeid one-off at time week-day week-daylist command command	Schedules a command to run at a specific time on a specific day or days in the current week. If the specified time or day has passed, the command runs in the next week. The command runs only once.
time timeid repeating at time command command	Schedules a command to run at a specific time every day.
time timeid repeating at time month-date month-day command command	Schedules a command to run on a specific day every month.
time timeid repeating at time week-day week-daylist command command	Schedules a command to run at a specific time in a specific day or days every week.

Examples

# Schedule a job to save the configuration file a.cfg at 3:00 on May 18, 2012.

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig] view monitor

[Sysname-job-saveconfig] time 1 at 3:00 2012/05/18 command save a.cfg

# Schedule a job to save the configuration file at 12:00 every day.

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig] view monitor

[Sysname-job-saveconfig] time 1 repeating at 12:00 command save a.cfg

# Schedule a job to save the configuration file at 8:00 AM on 5^th in the current month, which might be executed in the second month if the time has passed.

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig] view monitor

[Sysname-job-saveconfig] time 1 one-off at 8:00 month-date 5 command save a.cfg

# Schedule a job to save the configuration file at 8:00 AM on 5^th every month.

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig] view monitor

[Sysname-job-saveconfig] time 1 repeating at 8:00 month-date 5 command save a.cfg

# Schedule a job to save the configuration file at 8:00 AM on Friday and Saturday in the current week, which might be delayed to the next week if the time has passed.

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig] view monitor

[Sysname-job-saveconfig] time 1 one-off at 8:00 week-day fri sat command save a.cfg

# Schedule a job to save the configuration file at 8:00 every Fridays and Saturdays.

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig] view monitor

[Sysname-job-saveconfig] time 1 repeating at 8:00 week-day fri sat command save a.cfg

Related commands

· job

· view

time delay

Use time delay to add a command to run after a delay in the job schedule.

Use undo time to remove a command from the job schedule.

Syntax

time time-id { one-off | repeating } delay time command command

undo time time-id

Views

Job view

Default command level

3: Manage level

Parameters

time timeid: Specifies the time setting entry, an integer in the range of 1 to 10.

one-off: Specifies that the specified command is executed for once.

repeating: Specifies a recurring time schedule.

delay time: Specifies the delay time for executing the command, in the hh:mm format or mm format.

· When the time argument is in the hh:mm format, the value range for the hh value is 0 to 720, and the value range for the mm value is 0 to 59. When the hh value is 720, the mm value can be only 00.

· When the time argument is in the mm format, the value range for the mm value is 1 to 43,200. That is, the maximum value of the delay timer is 30 days.

command command: Specifies the command to be automatically executed, in the text format. The specified command must be a complete command without interactive input.

Usage guidelines

A job can have up to 10 commands. The commands in a job must belong to the same view.

The time ID (time-id) must be unique in a job. If two time and command bindings have the same time ID, the one configured last takes effect.

Changing a clock setting does not affect the schedule set by using the time delay command.

Use Table 14 when you add commands in a job.

Table 14 Command schedule options

Command	Description
time timeid one-off delay time2 command command	Schedules a command to run after a delay time. The command runs only once.
time timeid repeating delay time2 command command	Schedules a command to run every the delay time.

Command

Description

time timeid one-off delay time2 command command

Schedules a command to run after a delay time.

The command runs only once.

time timeid repeating delay time2 command command

Schedules a command to run every the delay time.

NOTE:

· The commands in a scheduled job must be in the same view.

· Every job can have up to 10 commands.

· The time ID (time-id) must be unique in a job. If two time and command bindings have the same time ID, the one configured last takes effect.

· Changing a clock setting does not affect the schedule set by using the time delay command.

Examples

# Save the configuration file five minutes later.

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig] view monitor

[Sysname-job-saveconfig] time 1 one-off delay 5 command save a.cfg

# Save the configuration file every five minutes.

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig] view monitor

[Sysname-job-saveconfig] time 1 repeating delay 5 command save a.cfg

Related commands

· job

· view

usb-power-supply enable

Use usb-power-supply enable to enable USB power supply.

Use undo usb-power-supply enable to disable USB power supply.

Syntax

usb-power-supply enable

undo usb-power-supply enable

Default

USB power supply is enabled.

Views

AP group view

AP template view

Default command level

2: System level

Examples

# Disable USB power supply for AP1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320H-ACN

[Sysname-wlan-ap-ap3] undo usb-power-supply enable

# Disable USB power supply for AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] undo usb-power-supply enable

view

Use view to specify a view for a job.

Use undo view to remove the view of a job.

Syntax

view view-name

undo view

Default

No view is specified for a job.

Views

Job view

Default command level

3: Manage level

Parameters

view-name: Specifies a view in which commands in the job run. A view name is a string of 1 to 90 characters.

Usage guidelines

Every job can have only one view. If you specify multiple views, the one specified the last takes effect.

Enter a view name in its complete form and make sure the view name is available on the device. Most commonly used view names include monitor for user view, system for system view, GigabitEthernetx/x/x for Ethernet interface view, and Vlan-interfacex for VLAN interface view.

Examples

# Specify system view for the job creatvlan.

<Sysname> system-view

[Sysname] job creatvlan

[Sysname-job-creatvlan] view system

Related commands

· job

· time

01-Fundamentals Command Reference

clock datetime

clock summer-time one-off

display clock

display job

job

schedule job

usb-power-supply enable

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us