Table of Contents

Related Documents

06-Device Management Commands

Title	Size	Download
06-Device Management Commands	124.18 KB

l The models listed in this document are not applicable to all regions. Please consult your local sales office for the models applicable to your region.

l Support of the H3C WA series WLAN access points (APs) for commands may vary by AP model. For more information, see Feature Matrix.

l The interface types and the number of interfaces vary by AP model.

1 Device Management Commands

In this document, an application file is named as test.bin, which is for reference only.

Device Management Commands

boot-loader

Syntax

boot-loader file file-url

View

User view

Default Level

2: System level

Parameters

file file-url: Specifies a file name, a string of 1 to 63 characters. If you enter a relative path here, the system automatically converts it to an absolute path. The absolute path should contain no more than 63 characters; otherwise, the command cannot be successfully executed. The file name is in the format of [drive:/]file-name, where

l The items in square brackets [ ] are optional.

l drive specifies the storage medium of the file. The value is the name of the storage medium. If a device has only one storage medium, you can execute this command without providing this argument.

l file-name specifies the filename, which is suffixed by .bin.

Description

Use the boot-loader command to specify a boot file of the AP.

To execute the boot-loader command successfully, you must first save the file for the next device boot in the root directory of the storage media.

Related commands: display boot-loader.

Examples

# Specify the boot file to be used at the next boot of the AP as test.bin.

<Sysname> boot-loader file test.bin

This command will set boot file, Continue? [Y/N]:y

The specified file will be used as the boot at the next reboot on slot 1!

bootrom

Syntax

bootrom { backup | read | restore | update file file-url } [ all | part ]

View

User view

Default Level

2: System level

Parameters

read: Reads Boot ROM, that is, copies the Boot ROM program from the normal partition of the Boot ROM memory to the flash as the backup, which will be used to restore the Boot ROM when the Boot ROM memory is broken.

restore: Restores Boot ROM, that is, restores the Boot ROM codes from the backup partition to the normal partition of the Boot ROM memory. When the current Boot ROM is broken, and you have backed up the codes, you can restore the Boot ROM by performing the restore operation.

backup: Backs up Boot ROM, that is, backs up the Boot ROM codes in the normal partition to the backup partition of the Boot ROM memory. When the current Boot ROM is broken, you can restore the Boot ROM program from the backup partition. You are recommended to back up the Boot ROM before upgrading it.

update file file-url: Upgrades Boot ROM, where file-url represents name of the file to be used for Boot ROM upgrade. For more information about the file-url argument, see boot-loader.

all: Operates all contents of Boot ROM.

part: Operates only the extended part of Boot ROM (Boot ROM includes the basic part and the extended part, the basic part provides the basic operation items and the extension part provides more Boot ROM operation items).

Description

Use the bootrom command to read, restore, back up, or upgrade the Boot ROM program of the system.

To execute the bootrom command successfully, you must first save the Boot ROM program in the root directory of the storage media.

If the keywords all and part are not specified, all contents of the Boot ROM program are operated.

Examples

# Use file boot.btm to upgrade the Boot ROM of the AP.

<H3C> bootrom update file boot.btm

This command will update bootrom file, Continue? [Y/N]:y

Now updating bootrom, please wait...

Updating basic bootrom!

Update basic bootrom success!

Updating extended bootrom!

Update extended bootrom success!

Update bootrom success!

<H3C>

display boot-loader

Syntax

display boot-loader

View

Any view

Default Level

2: System level

Parameters

None

Description

Use the display boot-loader command to display information of the boot file.

Related commands: boot-loader.

Examples

# Display the file adopted for the current and next boot of the AP.

<Sysname> display boot-loader

The boot file used this time:flash:/test.bin attribute:Main

The boot file used next time:flash:/test.bin attribute:Main

Failed to get the backup boot file used next time!

Failed to get the secure boot file used next time!

Table 1-1 display boot-loader command output description

Field	Description
The boot file used this time	File used for the current boot of the system
attribute	Attributes of a boot file: main/backup
The boot file used next time	Boot file used for the next boot of the AP

display cpu-usage

Syntax

display cpu-usage [entry-number [ offset ] [ verbose ] [ from-device ] ]

View

Any view

Default Level

1: Monitor level

Parameters

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

offset: Offset between the sequence number of the first CPU usage statistics record to be displayed and that of the last CPU usage record to be displayed. It is in the range of 0 to 59. For example, the idx of the latest statistics record is 12, if the offset is set to 3, the system will display the statistics records from the one with the idx of 9. idx represents the serial number of the period for the statistics, and its value ranges from 0 to 60 cyclically. The system makes CPU usage statistics periodically; after each period, the system records the average CPU usage during this period, and the idx value is added by 1 automatically.

verbose: Specifies to display detailed information of CPU usage statistics. If this keyword is not provided, the system displays the brief information of the CPU usage statistics; if this keyword is provided, the system displays the average CPU usage statistics for each task in the specified period.

from-device: Displays external storage devices such as Flash and hard disk. The AP currently does not support the from-device keyword.

Description

Use the display cpu-usage command to display the CPU usage statistics.

The system takes statistics of CPU usage at intervals (usually every 60 seconds) and saves the statistical results in the history record area. display cpu-usage entry-number indicates the system displays entry-number records from the newest (last) record. display cpu-usage entry-number offset indicates the system displays entry-number records from the last (offset+1)th record.

Examples

# Display information of the current CPU usage statistics.

<Sysname> display cpu-usage

Uint CPU usage:

14% in last 5 seconds

12% in last 1 minute

8% in last 5 minutes

# Display the last fifth and sixth records of the CPU usage statistics history.

<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 : 2006-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 : 2006-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 1-2 display cpu-usage command output description

Field	Description
Unit CPU usage	CPU usage information
xx % in last 5 seconds	The AP calculates average CPU usage every 5 seconds and records the result. This field displays the most current recoreded result.
xx % in last 1 minute	The AP calculates average CPU usage every 1 minute and records the result. This field displays the most current recoreded result.
xx % in last 5 minutes	The AP calculates average CPU usage every 5 minutes and records the result. This field displays the most current recoreded result.
CPU usage info (no: idx:)	Information of CPU usage records (no: The (no+1)th record is currently 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 CPU usage record is displayed, no and idx are not displayed.
CPU Usage Stat. Cycle	CPU usage measurement interval, in seconds. For example, if the value is 41, it indicates that the average CPU usage during the last 41 seconds is calculated. The value range of this field is 1 to 60.
CPU Usage	Average CPU usage in percentage in a measurement period
CPU Usage Stat. Time	CPU usage 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 measurement period 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 records may differ slightly.
TaskName	Task name
CPU	Average CPU usage of the current task during the measurement period

display cpu-usage history

Syntax

display cpu-usage history [ task task-id ]

View

Any view

Default Level

1: Monitor level

Parameters

task task-id: Displays the CPU usage history statistics of the specified task, where task-id represents the task number, in the range of 1 to 180. If the task-id argument is not provided, the system displays the history statistics of the CPU usage of the entire system (the CPU usage of the entire system is the sum of CPU usages of all tasks).

Description

Use the display cpu-usage history command to display the history statistics of the CPU usage in a chart. If no argument is specified, the CPU usage of the whole system is displayed.

The system takes statistics of the CPU usage at an interval and saves the statistical results in the history record area. You can use the display cpu-usage history command to display the CPU usage statistics records in the last 60 minutes. The statistical results are displayed through geographical coordinates. In the output information:

l Latitude indicates the CPU usage, which is displayed based on the step. For example, if the step of the CPU usage is 5%, then the actual statistics value 53% is displayed as 55%, and actual statistics value 52% is displayed as 50%.

l Longitude indicates the time.

l Consecutive pond marks (#) indicate the CPU usage at a certain moment. The value of the latitude corresponding to the # mark on the top of a moment is the CPU usage at this moment.

Examples

# Display the CPU usage statistics of the whole system.

<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 above output information indicates the CPU usage of the whole system (with the task name SYSTEM) in the last 60 minutes: 5% in the twelfth minute, 10% in the thirteenth minute, 15% in the fourteenth minute, 10% in the fifteenth minute, 5% in the sixteenth and seventeenth minute, 10% in the eighteenth minute, 5% in the nineteenth minute, and 2% or lower than 2% at other times.

# Display the CPU usage statistics of 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 above output information indicates the CPU usage of task 6 (with the task name T03M) in the last 60 minutes: 5% in the twentieth minute, and 2% or lower than 2% at other times.

display device

Syntax

display device [ verbose ]

View

Any view

Default Level

1: Monitor level

Parameters

verbose: Displays detailed information.

Description

Use the display device command to display information about the AP.

Examples

# Display brief information of the AP. (The output of board type varies with AP models.)

<Sysname> display device

Slot No. Board Type Status Max Ports

1 WA2200 Board Normal 5

# Display detailed information of the AP.

<Sysname> display device verbose

Slot No. Board Type Status Max Ports

1 WA2200 Board Normal 5

Slot 1

Status: Normal

Type: WA2200 Board

Hardware: Ver.A

Driver: 1.0

Table 1-3 display device command output description

Field	Description
Slot No.	Slot number of the AP
Board Type	Hardware type of the AP
Status	Device status
Max Ports	Maximum number of physical ports that the AP supports
Type	Type of the device board
Hardware	Hardware version of the AP
Driver	Driver version of the AP

display device manuinfo

Syntax

display device manuinfo

View

Any view

Default Level

3: Manage level

Parameters

None

Description

Use the display device manuinfo command to display electrical label information about the AP.

Electrical label information is also called permanent configuration data or archive information, which is written to the storage device of a device during debugging or test of a card or device. The information includes name of the AP, device serial number, and vendor name. This command displays part of the electrical label information of the AP.

Examples

# Display electrical label information of the AP.

<Sysname> display device manuinfo

DEVICE_NAME: WA2220X-AGP

DEVICE_SERIAL_NUMBER: 1234567890

MAC_ADDRESS: 000f-e2c0-0100

MANUFACTURING_DATE: 2007-09-20

VENDOR_NAME: H3C

Table 1-4 display device manuinfo command output description

Field	Description
DEVICE_NAME	Device name
DEVICE_SERIAL_NUMBER	Device serial number
MAC_ADDRESS	MAC address of the AP
MANUFACTURING_DATE	Manufacturing date of the AP
VENDOR_NAME	Vendor name

display environment

Syntax

display environment

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

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

Examples

# Display the temperature information of the AP.

<Sysname> display environment

System Temperature information (degree centigrade):

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

SlotNo Temperature Lower limit Upper limit

0 41 5 60

Table 1-5 display environment command output description

Field	Description
System Temperature information (degree centigrade)	Temperature information of system cards (degree centigrade)
SlotNO	Number of the slot in which the card resides
Temperature	Current temperature
Lower limit	Lower limit of temperature
Upper limit	Upper limit of temperature

display job

Syntax

display job [ job-name ]

View

Any view

Default Level

1: Monitor level

Parameters

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

Description

Use the display job command to display the detailed information of the scheduled tasks to be automatically executed.

Details about all the scheduled tasks are displayed if no argument is specified.

Related commands: job, time, and view.

Examples

# Display detailed information of the scheduled task saveconfig.

<Sysname> display job saveconfig

Job name: saveconfig

Specified view: monitor

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

As shown above, current configurations will be automatically saved to the configuration file 1.cfg 40 minutes later.

Table 1-6 display job command output description

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

display memory

Syntax

display memory

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display memory command to display the AP memory usage information.

Examples

# Display the usage of the memory of a device.

display memory

System Total Memory(bytes): 35506944

Total Used Memory(bytes): 19185480

Used Rate: 54%

Table 1-7 display memory command output description

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 reboot-type

Syntax

display reboot-type

View

Any view

Default Level

2: System level

Parameters

None

Description

Use the display reboot-type command to display the reboot type of the system.

Examples

# Display the reboot type of the AP.

<Sysname> display reboot-type

The rebooting type this time is: Cold

The above information indicates that the last reboot type of the AP is Cold boot (cold boot is to restart 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 schedule reboot

Syntax

display schedule reboot

View

Any view

Default Level

3: Manage level

Parameters

None

Description

Use the display schedule reboot command to display the AP reboot time set by the user.

Related commands: schedule reboot at and schedule reboot delay.

Examples

# Display the reboot time of the AP.

<Sysname> display schedule reboot

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

The above information indicates the system will reboot at 16:00:00 on March 10, 2006 (in two hours and five minutes).

display system-failure

Syntax

display system-failure

View

Any view

Default Level

3: Manage level

Parameters

None

Description

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

Related commands: system-failure.

Examples

# Display the exception handling method.

<Sysname> display system-failure

System failure handling method: reboot

job

Syntax

job job-name

undo job job-name

View

System view

Default Level

3: Manage level

Parameters

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

Description

Use the job command to create a scheduled task and enter job view, or enter this view directly if a task is ready.

Use the undo job command to remove the task.

By default, no scheduled task is created.

After creating a scheduled task, you can configure the task in job view. For example, you can specify the execution time for the commands in the task.

This command can be repeatedly executed to create multiple independent scheduled tasks.

Related commands: view and time.

Examples

# Create a scheduled task or enter the scheduled task saveconfiguration.

<Sysname> system-view

[Sysname] job saveconfiguration

[Sysname-job-saveconfiguration]

reboot

Syntax

reboot

View

User view

Default Level

2: System level

Parameters

None

Description

Use the reboot command to reboot a device.

l Device reboot may result in the interruption of the ongoing services. Use the command with caution.

l If a main boot file fails or does not exist, the AP cannot be rebooted with this command. In this case, you can re-specify a main boot file to reboot the AP, or you can power off the AP, and then power it on and the system automatically uses the backup boot file to restart the AP.

l If you are performing file operations when the AP is to be rebooted, the system does not perform the reboot operation for the sake of security.

Examples

# Reboot the AP (the current configuration does not change).

<Sysname> reboot

Start to check configuration with next startup configuration file, please wait.........DONE!

This command will reboot the device. Continue? [Y/N]:y

Now rebooting, please wait....

# Reboot the AP (the current configuration changes).

<Sysname> reboot

Start to check configuration with next startup configuration file, please wait.........DONE!

This command will reboot the device. Current configuration will be lost in next startup if you continue. Continue? [Y/N]:y

Now rebooting, please wait....

reset unused porttag

Syntax

reset unused porttag

View

User view

Default Level

1: Monitor level

Parameters

None

Description

Use the reset unused porttag command to clear the 16-bit index saved but not used in the current system.

A confirmation is required when you carry out this command. If you fail to make a confirmation within 30 seconds or enter “N” to cancel the operation, the command will not be carried out.

Examples

# Clear the 16-bit index saved but not used in the current system.

<Sysname> reset unused porttag

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

schedule reboot at

Syntax

schedule reboot at hh:mm [ date ]

undo schedule reboot

View

User view

Default Level

3: Manage level

Parameters

hh:mm: Reboot time of a device, in the format of hh:mm (hours:minutes). The value of the hh argument ranges from 0 to 23, and the value of the mm argument ranges from 0 to 59.

date: Reboot date of a device, in the format mm/dd/yyyy (month/day/year) or in the format yyyy/mm/dd (year/month/day) The yyyy value ranges from 2000 to 2035, the mm value ranges from 1 to 12, and the dd value range depends on a specific month.

Description

Use the schedule reboot at command to enable the scheduled reboot function and specify a specific reboot time and date.

Use the undo schedule reboot command to disable the scheduled reboot function.

By default, the scheduled reboot function is disabled.

There are two cases if no specific reboot date is specified:

l When the specified reboot time is later than the current time, the AP will be rebooted at the reboot time of the current day.

l When the specified reboot time is earlier than the current time, the AP will be rebooted at the reboot time the next day.

Note that:

l The precision of the device timer is 1 minute. One minute before the reboot time, the AP will prompt “REBOOT IN ONE MINUTE” and will be rebooted in one minute.

l The difference between the reboot date and the current date cannot exceed 30 × 24 hours (namely, 30 days).

l After you execute the above command, the AP will prompt you to confirm the configuration. You must enter Y or y to make the configuration take effect. The original configuration will be overwritten at the same time.

l If a date (month/day/year or year/month/day) later than the current date is specified for the schedule reboot at command, the AP will be rebooted at the reboot time.

l If you use the clock command to adjust the system time after you configure the schedule reboot at command, the reboot time set by the schedule reboot at command will become invalid.

l If you are performing file operations when the AP is to be rebooted, the system does not perform the reboot operation for the sake of security.

This command reboots the AP in a future time, thus resulting in service interruption. Please use it with caution.

Examples

# Configure the AP to reboot at 12:00 AM (supposing that the current time is 11:43).

<Sysname> schedule reboot at 12:00

Reboot system at 12:00 06/06/2008(in 0 hour(s) and 16 minute(s)) confirm? [Y/N]:

# If you have used the terminal logging command to enable the terminal display function of the system logs before setting a reboot time, the system will automatically display related log information after you enter y. By default, the terminal display of the log information is enabled.

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

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

schedule reboot delay

Syntax

schedule reboot delay { hh:mm | mm }

undo schedule reboot

View

User view

Default Level

3: Manage level

Parameters

hh:mm: Device reboot wait time, in the format of hh:mm (hours:minutes). The value of the hh argument ranges of is 0 to 720, and the value of the mm argument ranges from 0 to 59, and the value of the hh:mm argument cannot exceed 720:00.

mm: Device reboot wait time in minutes, in the range of 0 to 43,200.

Description

Use the schedule reboot delay command to enable the scheduled reboot function and set a reboot wait time.

Use the undo schedule reboot command to disable the scheduled reboot function.

By default, the scheduled reboot function is disabled.

Note that:

l The reboot wait time can be in the format of hh:mm (hours:minutes) or mm (absolute minutes). The absolute minutes cannot exceed 30 × 24 × 60 minutes, namely, 30 days.

l The precision of the device timer is 1 minute. One minute before the reboot time, the AP will prompt “REBOOT IN ONE MINUTE” and will be rebooted in one minute.

l If you use the clock command to adjust the system time after the schedule reboot delay command, the reboot wait time set by the schedule reboot delay command will become invalid.

l If you are performing file operations when the AP is to be rebooted, the system does not perform reboot operation for the sake of security.

This command reboots the AP after the specified delay time, thus resulting in service interruption. Please use it with caution.

Examples

# Configure the AP to reboot in 88 minutes (supposing the current time is 11:48).

<Sysname> schedule reboot delay 88

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

# If you have used the terminal logging command to enable the terminal display function of system logs before setting a reboot time, the system will automatically display related log information after you enter y. By default, the terminal display of the log information is enabled on the terminal.

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

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

system-failure

Syntax

system-failure { maintain | reboot }

undo system-failure { maintain | reboot }

View

System view

Default Level

3: Manage level

Parameters

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

reboot: Specifies that when the system detects any software abnormality, it recovers itself through automatic reboot.

Description

Use the system-failure command to configure the exception handling method.

By default, the system adopts the reboot method to handle exceptions.

Examples

# Set the exception handling method to maintain.

<Sysname> system-view

[Sysname] system-failure maintain

Change the system failure handling method from reboot to maintain. Continue? [Y/N]: y

temperature-limit

Syntax

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

undo temperature-limit slot-number

View

System view

Default Level

2: System level

Parameters

slot-number: Specifies a card by its slot number. The value range varies with devices.

lower-value: Lower temperature limit in Celsius degrees, in the range of 0 to 70.

upper-value: Upper temperature limit in Celsius degrees, in the range of 20 to 90.

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

Description

Use the temperature-limit command to set the temperature alarm threshold on a card.

Use the undo temperature-limit command to restore the temperature alarm threshold to the default.

By default, the lower temperature alarm threshold on a card is set to 5 Celsius degrees while the upper temperature limit is set to 60 Celsius degrees.

Examples

# Set the lower temperature limit on card 1 to 10 Celsius degrees and the upper temperature limit to 75 Celsius degrees.

<Sysname> system-view

[Sysname] temperature-limit 0 10 75

Setting temperature limit succeeded.

time

Syntax

time timeID at time1 date command command

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

time timeID { one-off | repeating } delay time2 command command

undo time timeID

View

Job view

Default Level

3: Manage level

Parameters

timeID: Time index, an integer between 1 to 10.

at time1: Specifies the execution time, in the format of hh:mm (hour:minute), where hh is in the rage of 0 to 23 and mm is in the range of 0 to 59.

date: Specifies the execution date, in the format of MM/DD/YYYY (month/date/year) or YYYY/MM/DD (year/month/date), where the year is in the range of 2000 to 2035, the month is in the range of 1 to 12, and the date range depends on the specified month. Note that the specified execution date must be ahead of the current date.

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 automatically executed. Therefore, ensure the correctness of the configuration.

one-off: Indicates that the command will be executed only once.

repeating: Indicates that the command will be repeatedly executed.

month-date month-day: Specifies the date in a month for executing the command. month-day specifies the date, in the range of 1 to 31.

week-day week-daylist: Specifies the day(s) in a week for executing the command. week-daylist specifies one day or up to seven days, which can be a 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.

delay time2: Specifies the delay time for executing the command, in the format of hh:mm (hour:minute) or mm (minute). In the case of hh:mm, hh is in the range of 0 to 719 and mm is in the range of 0 to 59. In the case of mm, mm is in the range of 0 to 43200. This parameter is not related to the system time, that is, the command will be executed after the delay time, if specified, even if the system time changes.

Description

Use the time command to bind the execution time with a command, meaning to specify the execution time for the command in a task.

Use the undo time command to remove the binding for the command.

timeID is used to uniquely identify the binding between the execution time and a command. A scheduled task can have up to 10 bindings.

l Use time timeID at time1 date command command to specify the execution time to the exact minute for the command. The time must be ahead of the current time of the system.

l Use time timeID one-off at time1 command command to specify the time on the current day for executing the command. If the specified time has passed, this command will be executed on the second day. This command will be executed only once.

l Use time timeID one-off at time1 month-date month-day command command to specify the time on the specified day in the current month for executing the command. If the specified time has passed, this command will be executed at the specified time on the specified day in the next month. This command will be executed only once.

l Use time timeID one-off at time1 week-day week-daylist command command to specify the time on the specified day(s) in the current week for executing the command. If the time has passed, this command will be executed at the specified time on the specified day(s) in the next week. This command will be executed only once.

l Use time timeID repeating at time1 command command to specify the time for repeating the command every day.

l Use time timeID repeating at time1 month-date month-day command command to specify the time on a specific day for repeating the command every month.

l Use time timeID repeating at time1 week-day week-daylist command command to specify the time on a specified day or days for repeating the command every week.

l Use time timeID one-off delay time2 command command to specify the time delay for executing the command. This command will be executed only once.

l Use time timeID repeating delay time2 command command to specify the time interval for executing the command periodically.

l Use undo time timeID to remove the specified execution time.

Examples

# Configure to save the configuration file a.cfg at 24:00 on May 18, 2009.

<Sysname> system-view

[Sysname] job saveconfig