目  录

1 系统基本配置与调试

1.1 系统基本配置命令

1.1.1 clock datetime

1.1.2 clock summer-time

1.1.3 clock timezone

1.1.4 quit

1.1.5 return

1.1.6 sysname

1.1.7 system-view

1.2 查看系统状态和系统信息命令

1.2.1 display clock

1.2.2 display debugging

1.2.3 display version

1.3 系统调试命令

1.3.1 debugging

1.3.2 display diagnostic-information

1.3.3 terminal debugging

1.4 命令行别名配置命令

1.4.1 command-alias enable

1.4.2 command-alias mapping

1.4.3 display command-alias

2 网络连通性测试命令

2.1 网络连通性测试命令

2.1.1 ping

2.1.2 tracert

3 设备管理命令

3.1 设备管理命令

3.1.1 boot boot-loader

3.1.2 boot bootrom

3.1.3 display boot-loader

3.1.4 display cpu

3.1.5 display device

3.1.6 display fan

3.1.7 display memory

3.1.8 display patch-information

3.1.9 display power

3.1.10 display schedule reboot

3.1.11 display transceiver alarm interface

3.1.12 display transceiver diagnosis interface

3.1.13 display transceiver interface

3.1.14 display transceiver manuinfo interface

3.1.15 patch activate

3.1.16 patch delete

3.1.17 patch load

3.1.18 patch run

3.1.19 port auto-power-down

3.1.20 reboot

3.1.21 schedule reboot at

3.1.22 schedule reboot delay

3.1.23 schedule reboot regularity

3.1.24 system-monitor enable

3.1.25 update fabric

3.1.26 xmodem get

4 定时执行任务命令

4.1 定时执行任务命令

4.1.1 display job

4.1.2 job

4.1.3 time at

4.1.4 time delay

4.1.5 view

 

1 系统基本配置与调试

1.1  系统基本配置命令

1.1.1  clock datetime

【命令】

clock datetime HH:MM:SS { YYYY/MM/DD | MM/DD/YYYY }

【视图】

用户视图

【参数】

HH:MM:SS：当前时间，即小时:分钟:秒。HH的取值范围为0～23，MM和SS取值范围为0～59。

YYYY/MM/DD、MM/DD/YYYY：表示年、月、日的两种格式。

l              YYYY表示年份，取值范围为2000～2099；

l              MM表示月份，取值范围为1～12；

l              DD表示日期，取值范围为1～31。

【描述】

clock datetime命令用来设置以太网交换机当前日期和时钟。

系统启动时缺省时间为23:55:00 04/01/2000。

在需要严格获取绝对时间的应用环境中，必须使用本命令设定以太网交换机的当前日期和时钟。

设置完成后，可以使用display clock命令进行查看。

【举例】

# 设置以太网交换机当前时间为2001年1月1日0时0分0秒。

<Sysname> clock datetime 0:0:0 2001/01/01

<Sysname> display clock

00:00:04 UTC Mon 01/01/2001

Time Zone : add 00:00:00

1.1.2  clock summer-time

【命令】

clock summer-time zone-name { one-off | repeating } start-time start-date end-time end-date offset-time

undo clock summer-time

【视图】

用户视图

【参数】

zone-name：夏令时名称，是一个长度为1～32个字符的字符串。

one-off：表示仅对某一年的夏令时时间进行设置。

repeating：表示对从某一年开始的以后每年的夏令时时间的设置。

start-time：起始时间，格式为HH:MM:SS（小时:分钟:秒）。

start-date：起始日期，格式为YYYY/MM/DD（年/月/日）或MM/DD/YYYY（月/日/年）。

end-time：结束时间，格式为HH:MM:SS。

end-date：结束日期，格式为YYYY/MM/DD或MM/DD/YYYY。

offset-time：夏令时与标准时间的偏移量，格式为HH:MM:SS。

【描述】

clock summer-time命令用来进行夏令时的相关设置，包括名称、起止时间和时间偏移量。undo clock summer-time命令用来取消当前设置。

设置完成后，可以使用display clock命令进行查看。

【举例】

# 设置夏令时abc1，从2005年8月1日的06:00:00开始，到2005年9月1日的06:00:00结束，时间增加1小时。

<Sysname> clock summer-time abc1 one-off 06:00:00 08/01/2005 06:00:00 09/01/2005 01:00:00

<Sysname> display clock

00:02:36 UTC Mon 01/01/2001

Time Zone : add 00:00:00

Summer-Time : abc1 one-off 06:00:00 08/01/2005 06:00:00 09/01/2005  01:00:00

# 设置夏令时abc2，从2005年开始，每年的8月1日的06:00:00到9月1日的06:00:00，时间增加1小时。

<Sysname> clock summer-time abc2 repeating 06:00:00 08/01/2005 06:00:00 09/01/2005 01:00:00

<Sysname> display clock

00:01:25 UTC Mon 01/01/2001

Time Zone : add 00:00:00

Summer-Time : abc2 repeating 06:00:00 08/01/2005 06:00:00 09/01/2005  01:00:00

1.1.3  clock timezone

【命令】

clock timezone zone-name { add | minus } HH:MM:SS

undo clock timezone

【视图】

用户视图

【参数】

zone-name：时区名称，长度的范围为1～32字符。

add：与UTC时间比较增加。

minus：与UTC时间比较减少。

HH:MM:SS：增加或减少的时间（小时/分钟/秒）。

【描述】

clock timezone命令用来对本地时区信息进行设置，undo clock timezone命令用来将本地时区恢复为缺省的UTC时区。

设置完成后，可以使用display clock命令进行查看。日志、调试等信息时间采用经过时区和夏令时调整过的本地时间。

相关配置可参考命令clock summer-time、display clock。

【举例】

# 设置本地时区名称为Z5，与UTC时间比较增加5小时。

<Sysname> clock timezone z5 add 05:00:00

<Sysname> display clock

05:03:17 z5 Mon 01/01/2001

Time Zone : z5 add 05:00:00

Summer-Time : abc1 one-off 06:00:00 08/01/2005 06:00:00 09/01/2005  01:00:00

1.1.4  quit

【命令】

quit

【视图】

任意视图

【参数】

无

【描述】

quit命令用来使用户从当前视图退回到低一级别的视图。

交换机视图分为三个级别，由低到高分别为：

l              用户视图

l              系统视图

l              VLAN视图、以太网端口视图等

如果当前视图是用户视图，则退出系统。

相关配置可参考命令return，system-view。

【举例】

# 从系统视图返回到用户视图。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] quit

<Sysname>

# 从以太网端口视图返回到系统视图。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface ethernet 1/0/1

[Sysname-Ethernet1/0/1] quit

[Sysname]

1.1.5  return

【命令】

return

【视图】

除用户视图外的其它视图

【参数】

无

【描述】

return命令用来从当前视图退回到用户视图，与return命令功能相同的是组合键<Ctrl+Z>。

相关配置可参考命令quit。

【举例】

# 从以太网端口视图返回到用户视图。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] return

<Sysname>

1.1.6  sysname

【命令】

sysname sysname

undo sysname

【视图】

系统视图

【参数】

sysname：交换机系统名，是长度为1～30个字符的字符串。缺省系统名为H3C。

【描述】

sysname命令用来设置以太网交换机的系统名称。undo sysname命令用来恢复以太网交换机的系统名称的缺省值。

修改以太网交换机的系统名称将影响命令行接口的提示符，如以太网交换机的缺省系统名称为H3C，用户视图下的提示符为<H3C>。

【举例】

# 设置以太网交换机的系统名称为LSW。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] sysname LSW

[LSW]

1.1.7  system-view

【命令】

system-view

【视图】

用户视图

【参数】

无

【描述】

system-view命令用来使用户从用户视图进入系统视图。

相关配置可参考命令quit，return。

【举例】

# 从用户视图进入系统视图。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname]

1.2  查看系统状态和系统信息命令

1.2.1  display clock

【命令】

display clock

【视图】

任意视图

【参数】

无

【描述】

用户可以执行display clock命令从终端显示内容中获取系统的日期、时间、时区和夏令时信息。如果发现系统时间有误，可及时调整。

本命令可以显示的时间的最大值是23:59:59 9999/12/31。

相关配置可参考命令clock datetime、clock timezone和clock summer-time。

【举例】

# 查看系统当前日期和时间。

<Sysname> display clock

18:36:31 beijing Sat 2002/02/02

Time Zone : beijing add 01:00:00

Summer-Time : bj one-off 01:00:00 2003/01/01 01:00:00 2003/08/08 01:00:00

表1-1 display clock命令显示信息描述表

字段	描述
18:36:31 beijing Sat 2002/02/02	系统当前时间和日期
Time Zone	用户配置的时区信息
Summer-Time	用户配置的夏令时信息

 

1.2.2  display debugging

【命令】

display debugging [ unit unit-id ] [ interface interface-type interface-number ] [ module-name ]

display debugging fabric [ by-module | interface interface-type interface-number [ module-name ] | module-name ]

【视图】

任意视图

【参数】

unit-id：设备的Unit编号。

interface-type：接口类型。

interface-number：接口编号。

module-name：功能模块的名称。

fabric：整个Fabric。

by-module：按模块显示。

【描述】

display debugging命令用来显示指定设备上或Fabric上已经打开的调试开关。

【举例】

# 显示设备Unit 1上已经打开的调试开关。

<Sysname> display debugging unit 1

IP icmp debugging is on

Rip packet debugging switch is on

Rip receive debugging switch is on

Rip send debugging switch is on

1.2.3  display version

【命令】

display version

【视图】

任意视图

【参数】

无

【描述】

display version命令用来显示系统的版本信息。

用户可以通过该命令查看软件的版本信息、发布时间、交换机的基本硬件配置等信息。

【举例】

# 显示系统的版本信息。

<Sysname> display version

H3C Comware Platform Software

Comware Software, Version 3.10, Alpha 1546

Copyright (c) 2004-2007 Hangzhou H3C Technologies Co., Ltd. All rights reserved.

E328 uptime is 0 week, 0 day, 0 hour, 41 minutes

 

E328 with 1 Processor

64M     bytes DRAM

8196K   bytes Flash Memory

Config Register points to FLASH

 

Hardware Version is REV.B

CPLD Version is CPLD 003

Bootrom Version is 511

[Subslot 0] 24 FE Hardware Version is REV.B

[Subslot 1] 4 GE  Hardware Version is REV.B

1.3  系统调试命令

1.3.1  debugging

【命令】

debugging module-name [ debugging-option ]

undo debugging { all | module-name [ debugging-option ] }

【视图】

用户视图

【参数】

module-name：模块名称。

debugging-option：调试选项。

all：表示关闭全部调试开关。

【描述】

debugging命令用来打开系统调试开关。undo debugging命令用来关闭系统调试开关。

缺省情况下，调试开关均处于关闭状态。

需要注意的是：

l              由于打开调试开关会产生大量的调试信息，导致系统效率的降低，建议不要同时开启多项功能的调试开关。如果用户需要一次性关闭全部调试开关，可以使用undo debugging all命令。

l              只有同时配置了debugging、terminal debugging和terminal monitor命令，才能在终端显示调试信息的具体内容。

l              如果需要显示已经打开的调试开关，可以使用display debugging命令。

有关terminal monitor命令的详细介绍，请参考“信息中心”命令手册。

【举例】

# 打开IP模块中Packet选项的调试开关。

<Sysname> debugging ip packet

<Sysname> display debugging

IP packet debugging is on

1.3.2  display diagnostic-information

【命令】

display diagnostic-information

【视图】

任意视图

【参数】

无

【描述】

display diagnostic-information命令用来显示或保存系统当前各个功能模块运行的统计信息。如果用户选择保存，则系统会将统计信息作为一个文件（扩展名为.diag）保存到Flash中。

【举例】

# 将系统的诊断信息保存为default.diag文件。

<Sysname> display diagnostic-information

 This operation may take a few minutes, continue?[Y/N]y

 Diagnostic-information is saved to Flash or displayed(Y=save N=display)?[Y/N]y

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

 The file is already existing, overwrite it? [Y/N]y

 

% Output information to file: flash:/default.diag.

Please wait......

保存完毕后，可以在用户视图下执行“more default.diag”命令，配合使用<Page Up>/<Page Down>键，即可查看该文件中记录的内容。

# 显示系统当前各个功能模块运行的统计信息。

<Sysname> display diagnostic-information

 This operation may take a few minutes, continue?[Y/N]y

 Diagnostic-information is saved to Flash or displayed(Y=save N=display)?[Y/N]n

 

-------------------- display version --------------------

……

<略>

1.3.3  terminal debugging

【命令】

terminal debugging

undo terminal debugging

【视图】

用户视图

【参数】

无

【描述】

terminal debugging命令用来开启终端显示调试信息功能。undo terminal debugging命令用来关闭终端显示调试信息功能。

缺省情况下，终端显示调试信息的功能处于关闭状态。

如果用户需要在终端上显示调试信息，可以执行terminal debugging命令。

需要注意的是：

l              用户只有同时配置了terminal monitor命令和terminal debugging命令，才能在当前终端显示调试信息。

l              当用户配置undo terminal monitor命令后，即同时关闭了当前终端对日志信息、告警信息和调试信息的监视功能。

l              terminal debugging命令配置的监视属性只对当前连接有效，当终端与设备的连接超时、重新建立连接后，监视属性将恢复到缺省情况。

有关terminal monitor命令的详细介绍，请参考“信息中心”命令手册。

相关配置可参考命令debugging。

【举例】

# 开启终端显示调试信息功能。

<Sysname> terminal debugging

% Current terminal debugging is on

1.4  命令行别名配置命令

1.4.1  command-alias enable

【命令】

command-alias enable

undo command-alias enable

【视图】

系统视图

【参数】

无

【描述】

command-alias enable命令用来开启交换机的命令行别名功能。undo command-alias enable命令用来关闭交换机的命令行别名功能。

缺省情况下，交换机的命令行别名功能处于关闭状态，即用户不能给命令行指定别名。

【举例】

# 在交换机上开启命令行别名功能。

<Switch> system-view

[Switch] command-alias enable

1.4.2  command-alias mapping

【命令】

command-alias mapping cmdkey alias

undo command-alias mapping alias

【视图】

系统视图

【参数】

cmdkey：需要被指定别名的交换机上原有命令行的第一关键字（或undo命令的第二关键字），且必须是完整的命令关键字形式。

alias：命令行的别名，该别名不能与交换机上原有命令行的第一个关键字相同，也不能以该关键字开头。

【描述】

command-alias mapping命令用来给指定的命令行配置别名。undo command-alias mapping命令用来取消命令行别名的配置。

缺省情况下，命令行没有配置别名。

需要注意的是：

l              配置命令行别名时，输入的cmdkey参数必须是完整的关键字，否则系统给出命令关键字不完整或不存在的错误提示信息，该配置不成功。

l              目前，设备最多支持配置20个命令行别名，且不同命令行必须配置不同的别名。

【举例】

# 在交换机上开启命令行别名功能，并配置关键字为display的命令，别名为show。

<Switch> system-view

[Switch] command-alias enable

[Switch] command-alias mapping display show

完成以上配置后，设备支持的原有命令中的以display关键字开头的命令行就可以用别名show来代替，同时display关键字仍然可以正常使用。比如：查看系统时间的原命令为display clock，通过以上配置后，执行show clock或display clock均可以查看系统时间。

1.4.3  display command-alias

【命令】

display command-alias

【视图】

所有视图

【参数】

无

【描述】

display command-alias命令用来显示当前用户设置的命令行及其别名。

【举例】

# 显示当前用户设置的命令行及其别名。

<Sysname> display command-alias

Command alias is enabled

index  alias                        command key

1      show                         display

 

2 网络连通性测试命令

2.1  网络连通性测试命令

2.1.1  ping

【命令】

ping [ -a ip-address ] [-c count ] [ -d ] [ -f ] [ -h ttl ] [ -i interface-type interface-number ] [ ip ] [ -n ] [ - p pattern ] [ -q ] [ -s packetsize ] [ -t timeout ] [ -tos tos ] [ -v ] string

【视图】

任意视图

【参数】

-a ip-address：设置发送ICMP ECHO-REQUEST报文的源IP地址，该地址必须是本地的接口IP地址。

-c：count为发送ICMP ECHO-REQUEST报文次数，范围1～4294967295，缺省为5次。

-d：设置socket为DEBUGGING模式，缺省为非DEBUGGING模式。

-f：当数据包长度大于接口MTU时不被分片，直接丢弃。

-h ttl：指定ICMP ECHO-REQUEST报文中的TTL数值，取值范围1～255。缺省为255。

-i interface-type interface-number：指定发送ICMP ECHO-REQUEST报文的接口的类型和编号。指定该参数后，报文的ttl值被自动设置为1以用来测试直连设备（即设备的IP地址和指定接口的IP地址在同一网段）。

ip：配置设备支持IPv4协议。缺省情况下，设备支持IPv4协议。

-n：将host参数直接作为IP地址，而不需作域名解析；缺省情况下，host首先被当作IP地址，如果不是IP地址则进行域名解析。

-p：pattern为ICMP ECHO-REQUEST报文填充字节，格式为16进制，如-p ff 将报文全部填充为ff，缺省填充方式为从0x01开始，逐渐递增，直到0x09为止，然后重复。

-q：除统计数字外，不显示其它详细信息，缺省为显示包括统计信息在内的全部信息。

-s packetsize：为ICMP ECHO-REQUEST报文长度（不包括IP和ICMP报文头），以字节为单位，取值范围为20～32000，缺省报文长度为56字节。

-t timeout：为发送完ICMP ECHO-REQUEST后，等待ICMP ECHO-REPLY的超时时间，以ms为单位，取值范围为0～65535，缺省超时时间为2000ms。

-tos tos：指定ICMP ECHO-REQUEST报文中的ToS数值，取值范围为0～255。缺省为0。

-v：显示接收到的非ECHO-REPLY的其它ICMP报文；缺省不显示其它非ECHO-REPLY的ICMP报文。

string：目的设备的主机名（长度为1～30个字符）或IP地址。

 

【描述】

ping命令用来检查指定目的设备是否可达，并输出相应的统计信息。

ping执行过程为：向目的地发送ICMP ECHO-REQUEST报文，如果到目的地网络连接工作正常，则目的主机接收到ICMP ECHO-REQUEST报文后，向源主机响应ICMP ECHO-REPLY报文。

可以用ping命令测试网络连接是否出现故障或网络线路质量等，其输出信息包括：

l              目的地对每个ICMP ECHO-REQUEST报文的响应情况，如果在超时时间内没有收到响应报文，则输出“Request time out.”，否则显示响应报文的字节数、报文序号、TTL和响应时间等。

l              最后的统计信息，包括发送报文个数、接收到响应报文个数、未响应报文数百分比和响应时间的最小、最大和平均值。

如果网络传输速度较慢，可以适当加大等待响应报文的超时时间。

相关配置可参考命令tracert。

【举例】

# 检查IP地址为202.38.160.244的主机是否可达。

<Sysname> ping 202.38.160.244

ping 202.38.160.244 : 56 data bytes, press CTRL_C to break

Reply from 202.38.160.244 : bytes=56 sequence=1 ttl=255 time = 1ms

Reply from 202.38.160.244 : bytes=56 sequence=2 ttl=255 time = 2ms

Reply from 202.38.160.244 : bytes=56 sequence=3 ttl=255 time = 1ms

Reply from 202.38.160.244 : bytes=56 sequence=4 ttl=255 time = 3ms

Reply from 202.38.160.244 : bytes=56 sequence=5 ttl=255 time = 2ms

--202.38.160.244 ping statistics--

5 packet transmitted

5 packet received

0% packet loss

round-trip min/avg/max = 1/2/3 ms

以上信息表明，目的主机可达，源设备发出的探测报文均能得到回应，报文往返的最短时间、平均时间和最长时间分别为1ms、2ms和3ms。

2.1.2  tracert

【命令】

tracert [ -a source-ip ] [ -f first-ttl ] [ -m max-ttl ] [ -p port ] [ -q num-packet ] [ -w timeout ] string

【视图】

任意视图

【参数】

-a source-ip：配置tracert命令使用的源接口IP地址。

-f first-ttl：设定tracert命令发出的报文中TTL的初始取值，作用为在输出信息中只显示网络路径中某一跳之后的网关地址。如first-ttl参数的取值为3，则在输出信息中，从以源地址开始第三跳的网关地址开始显示。first-ttl参数的取值范围为1～255，缺省取值为1。

-m max-ttl：设定tracert命令发出的报文中TTL取值的上限，当到达max-ttl之后，tracert命令将不再发送报文。-m参数的作用为收集路径中从源地址开始某一跳数之前的网关地址作为结果输出。如设定max-ttl的取值为5，则在输出信息中，只显示从源地址开始前五跳之内的网关地址。max-ttl的取值范围为1～255，缺省取值为30。

-p port：设定tracert发出的报文中目的主机的端口号，用户一般无须更改此选项；port的取值范围为0～65535，缺省取值为33434。

-q num-packet：设定tracer命令每次发送的探测数据包的个数。nqueries的取值范围为0～65535，缺省取值为3。

-w timeout：设定等待ICMP错误消息的超时时间，timeout取值范围为0～65535，单位为毫秒，缺省取值为5000。

string：目的设备的主机名（长度为1～20个字符）或IP地址。

 

【描述】

tracert命令用来测试数据包从源设备到目的设备所经过的网关，主要用于检查网络连接是否可达，以及辅助分析网络故障发生的具体位置。

tracert命令的执行过程：首先发送一个TTL为1的数据包，因此第一跳发送回一个ICMP错误消息以指明此数据包不能被发送（因为TTL超时），之后此数据包被重新发送，TTL为2，同样第二跳返回TTL超时，这个过程不断进行，直到到达目的地。执行这些过程的目的是记录每一个ICMP TTL超时消息的源地址，以提供一个IP数据包到达目的地所经历的路径。

当用ping命令测试发现网络出现故障后，可以用tracert命令分析出现故障的网络节点。

tracert命令的输出信息包括到达目的地所有网关的IP地址，如果某网关超时，则输出“* * *”。

【举例】

# 测试数据包到IP地址为18.26.0.115的目的主机所经过的网关。

<Sysname> tracert 18.26.0.115

tracert to 18.26.0.115 (18.26.0.115), 30 hops max,40 bytes packet

1 128.3.112.1 (128.3.112.1) 0 ms 0 ms 0 ms

2 128.32.216.1 (128.32.216.1) 19 ms 19 ms 19 ms

3 128.32.206.1 (128.32.206.1) 39 ms 19 ms 19 ms

4 128.32.136.23 (128.32.136.23) 19 ms 39 ms 39 ms

5 128.32.168.22 (128.32.168.22) 20 ms 39 ms 39 ms

6 128.32.197.4 (128.32.197.4) 59 ms 119 ms 39 ms

7 131.119.2.5 (131.119.2.5) 59 ms 59 ms 39 ms

8 129.140.70.13 (129.140.70.13) 80 ms 79 ms 99 ms

9 129.140.71.6 (129.140.71.6) 139 ms 139 ms 159 ms

10 129.140.81.7 (129.140.81.7) 199 ms 180 ms 300 ms

11 129.140.72.17 (129.140.72.17) 300 ms 239 ms 239 ms

12 * * *

13 128.121.54.72 (128.121.54.72) 259 ms 499 ms 279 ms

14 * * *

15 * * *

16 * * *

17 * * *

18 18.26.0.115 (18.26.0.115) 339 ms 279 ms 279 ms

3 设备管理命令

3.1  设备管理命令

3.1.1  boot boot-loader

【命令】

boot boot-loader [ backup-attribute ] { file-url [ fabric ] | device-name }

【视图】

用户视图

【参数】

backup-attribute：设定文件的备份属性。

file-url：Flash中主机软件的文件路径+文件名称，长度为1-64个字符。

fabric：在fabric模式下的文件路径。

device-name：以unit[NO.]>flash：的形式表示目标文件存放在其他设备的flash中。

【描述】

boot boot-loader命令用来指定交换机下次启动使用的主机软件。

此命令指定Flash的.bin文件作为下次启动使用的主机软件。

【举例】

# 指定交换机下次启动时使用的主机软件。

<Sysname> boot boot-loader bootfile.BIN

The specified file will be booted next time on unit 1!

3.1.2  boot bootrom

【命令】

boot bootrom { file-url | device-name }

【视图】

用户视图

【参数】

file-ulr：Flash中Bootrom的文件路径+文件名称，长度为1-64位的字符串。

device-name：以unit[NO.]>flash：的形式表示目标文件存放在其他设备的flash中。

【描述】

boot bootrom命令用来升级交换机的Bootrom，升级后的Bootrom将在下次启动时使用。

【举例】

# 使用名为bootrom.btm的文件升级交换机的Bootrom。

<Sysname> boot bootrom bootrom.btm

 This will update Bootrom on unit 1.  Continue? [Y/N] y

 Upgrading Bootrom, please wait...

 Upgrade Bootrom succeeded!

3.1.3  display boot-loader

【命令】

display boot-loader [ unit unit-id ]

【视图】

任意视图

【参数】

unit-id：设备的Unit编号

【描述】

display boot-loader命令用来显示交换机下次启动所采用的主机软件(.bin文件)。

【举例】

# 显示交换机下次启动所采用的主机软件。

<Sysname> display boot-loader

 Unit 1:

   The current boot app is: bootfile.bin

   The main boot app is:    bootfile.bin

   The backup boot app is:  bootfilebackup.bin

表3-1 display boot-loader命令显示信息描述表

字段	描述
The current boot app is	系统本次启动时使用的启动文件
The main boot app is	系统下次启动时将使用的主用启动文件
The backup boot app is	系统下次启动时将使用的备用启动文件

 

3.1.4  display cpu

【命令】

display cpu [ unit unit-id ]

【视图】

任意视图

【参数】

unit-id: 设备的Unit编号。

【描述】

display cpu命令用来显示CPU的使用状态。

【举例】

# 显示CPU的使用状态。

<Sysname> display cpu

Unit 1

Board 0 CPU busy status:

    12% in last 5 seconds

    12% in last 1 minute

    12% in last 5 minutes    

表3-2 display cpu命令显示信息描述表

字段	描述
CPU busy status	交换机CPU的占用率状态
12% in last 5 seconds 12% in last 1 minute 12% in last 5 minutes	最近5秒CPU占用率为12% 最近一分钟CPU占用率为12% 最近五分钟CPU占用率为12%

 

3.1.5  display device

【命令】

display device [ manuinfo [ unit unit-id ] | unit unit-id ]

【视图】

任意视图

【参数】

manuinfo：显示设备的制造信息。

unit-id：设备的Unit编号。

【描述】

display device命令用来显示各单板（主板和子板）的模块类型、工作状态信息。

用户可以通过此命令来显示各单板的模块类型、工作状态信息，这些信息包括物理板号、子物理板号、端口个数、PCB版本号、FPGA版本号、CPLD版本号、BOOTROM软件版本号、地址学习模式、接口板类型等。

【举例】

# 显示单板的信息。

<Sysname> display device

Unit 1

SlotNo SubSNo PortNum PCBVer FPGAVer CPLDVer BootRomVer AddrLM Type       State

0       0       24       REV.C   NULL    001      510         IVL    MAIN     Normal

0       1       4        REV.C   NULL    001      NULL        IVL    4 GE     Normal

表3-3 display device命令显示信息描述表

字段	描述
SlotNo	槽位编号
SubSNo	子槽位编号
PortNum	端口数量
PCBVer	PCB板版本号
FPGAVer	FPGA封装版本号
CPLDVer	硬件CPLD逻辑版本号
BootRomVer	BootRom版本号
AddrLM	MAC地址学习模式
Type	板卡类型
State	工作状态

 

3.1.6  display fan

【命令】

display fan [ unit unit-id [ fan-id ] ]

【视图】

任意视图

【参数】

unit-id：设备的Unit编号。

fan-id：风扇编号。

【描述】

display fan命令用来显示交换机风扇工作状态。

【举例】

# 显示当前交换机的风扇工作状态。

<Sysname> display fan

Unit 1

 Fan  1 State: Normal

以上信息表示当前交换机的风扇工作正常。

3.1.7  display memory

【命令】

display memory [ unit unit-id ]

【视图】

任意视图

【参数】

unit-id:设备的Unit编号。

【描述】

display memory命令用来显示交换机的内存使用状态。

【举例】

# 显示交换机的内存使用状态。

<Sysname> display memory

Unit 1

System Available Memory(bytes): 30045312

System Used Memory(bytes): 15698468

Used Rate: 52%

表3-4 display memory命令显示信息描述表

字段	描述
System Available Memory(bytes)	系统可用的内存总大小，单位为字节
System Used Memory(bytes)	系统已经使用的内存大小，单位为字节
Used Rate	已经使用的内存所占总内存的比例

 

3.1.8  display patch-information

【命令】

display patch-information

【视图】

任意视图

【参数】

无

【描述】

display patch-information命令用来显示系统已经加载的补丁文件的状态信息，其中包括：补丁版本号，补丁基线版本号和补丁的状态。

【举例】

# 显示系统已经加载的补丁文件的状态信息。

<Sysname> display patch-information

----------Patch information----------

  patch version          P001

  program version        1510

  patch  status          DEACTIVE

表3-5 display patch-information命令显示信息描述表

字段	描述
patch version	补丁版本号
program version	补丁基线版本
patch status	补丁状态：IDLE、DEACTIVE、ACTIVE、RUNNING

 

3.1.9  display power

【命令】

display power [ unit unit-id [ power-id ] ]

【视图】

任意视图

【参数】

unit-id：设备的Unit编号。

power-id：电源编号。

【描述】

display power命令用来显示交换机的电源工作状态。

【举例】

# 显示当前交换机的电源工作状态。

<Sysname> display power

Unit 1

  power    1

  State    : Normal

  Type     : AC  

上述信息表示，本机的电源为交流电源，当前工作正常。

3.1.10  display schedule reboot

【命令】

display schedule reboot

【视图】

任意视图

【参数】

无

【描述】

display schedule reboot命令用来查看交换机定时重启功能设置情况。

相关配置可参考命令schedule reboot at、schedule reboot delay。

【举例】

# 显示当前交换机的定时重启功能设置情况。

<Sysname> display schedule reboot

System will reboot at 16:00:00 2002/11/1 (in 2 hours and 5 minutes).

3.1.11  display transceiver alarm interface

【命令】

display transceiver alarm interface [ interface-type interface-number ]

【视图】

任意视图

【参数】

interface-type interface-number：表示接口类型和接口编号。

【描述】

display transceiver alarm interface命令用来显示可插拔模块的当前故障告警信息。

如果没有故障，则显示为“None”。

可能出现的故障告警信息见表3-6。

表3-6 display transceiver alarm interface命令输出信息描述表

字段	说明
GBIC/SFP
RX loss of signal	接收信号丢失
RX power high	接收光功率高告警
RX power low	接收光功率低告警
TX fault	发送错误
TX bias high	偏置电流高告警
TX bias low	偏置电流低告警
TX power high	发送光功率高告警
TX power low	发送光功率低告警
Temp high	温度高告警
Temp low	温度低告警
Voltage high	电压高告警
Voltage low	电压低告警
Transceiver info I/O error	模块信息读写错误
Transceiver info checksum error	模块信息校验和错误
Transceiver type and port configuration mismatch	模块类型和端口配置不匹配
Transceiver type not supported by port hardware	端口不支持该模块类型
XFP
RX loss of signal	接收信号丢失
RX not ready	接收状态未就绪
RX CDR loss of lock	RX CDR时钟失锁
RX power high	接收光功率高告警
RX power low	接收光功率低告警
TX not ready	发送状态未就绪
TX fault	发送错误
TX CDR loss of lock	TX CDR时钟失锁
TX bias high	偏置电流高告警
TX bias low	偏置电流低告警
TX power high	发送光功率高告警
TX power low	发送光功率低告警
Module not ready	模块状态未就绪
APD supply fault	APD（Avalanche Photo Diode,雪崩光电二极管）错误
TEC fault	TEC（Thermoelectric Cooler）错误
Wavelength unlocked	光信号波长失锁
Temp high	温度高告警
Temp low	温度低告警
Voltage high	电压高告警
Voltage low	电压低告警
Transceiver info I/O error	模块信息读写错误
Transceiver info checksum error	模块信息校验错误
Transceiver type and port configuration mismatch	模块类型和端口配置不匹配
Transceiver type not supported by port hardware	端口不支持该模块类型
XENPAK
WIS local fault	WIS（WAN Interface Sublayer）本地错误
Receive optical power fault	接收光功率错误
PMA/PMD receiver local fault	PMA/PMD（Physical Medium Attachment/Physical Medium Dependent）接收器本地错误
PCS receive local fault	PCS（Physical Coding Sublayer）接收本地错误
PHY XS receive local fault	PHY XS（PHY Extended Sublayer）接收本地错误
RX power high	接收光功率高告警
RX power low	接收光功率低告警
Laser bias current fault	激光器偏置电流错误
Laser temperature fault	激光器温度错误
Laser output power fault	激光器输出光功率错误
TX fault	发送器错误
PMA/PMD receiver local fault	PMA/PMD接收器本地错误
PCS receive local fault	PCS接收本地错误
PHY XS receive local fault	PHY XS接收本地错误
TX bias high	偏置电流高告警
TX bias low	偏置电流低告警
TX power high	发送光功率高告警
TX power low	发送光功率低告警
Temp high	温度高告警
Temp low	温度低告警
Transceiver info I/O error	模块信息I/O错误
Transceiver info checksum error	模块信息校验错误
Transceiver type and port configuration mismatch	模块类型和端口配置不匹配
Transceiver type not supported by port hardware	端口不支持该模块类型

 

 

【举例】

# 显示接口GigabitEthernet1/1/1上插入的可插拔模块的当前故障告警信息。

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

GigabitEthernet1/1/1 transceiver current alarm information:

  TX fault

表3-7 display transceiver alarm interface显示信息描述表

字段	说明
transceiver current alarm information	接口光模快当前故障告警信息
TX fault	发送错误

 

3.1.12  display transceiver diagnosis interface

【命令】

display transceiver diagnosis interface [ interface-type interface-number ]

【视图】

任意视图

【参数】

interface-type interface-number：表示接口类型和接口编号。

【描述】

display transceiver diagnosis interface命令用来显示H3C定制防伪可插拔光模块的数字诊断参数的当前测量值。

【举例】

# 显示接口GigabitEthernet1/1/2上插入的H3C定制防伪可插拔光模块的数字诊断参数的当前测量值。

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

GigabitEthernet1/1/2 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

表3-8 display transceiver diagnosis interface显示信息描述表

字段	说明
transceiver diagnostic information	接口携带的光模块的数字诊断信息
Current diagnostic parameters	当前的诊断参数
Temp.(°C)	数字诊断参数——温度，单位为°C，精确到1°C
Voltage(V)	数字诊断参数——电压，单位为V，精确到0.01V
Bias(mA)	数字诊断参数——偏置电流，单位为mA，精确到0.01mA
RX power(dBM)	数字诊断参数——接收光功率，单位为dBM，精确到0.01dBM
TX power(dBM)	数字诊断参数——发送光功率，单位为dBM，精确到0.01dBM

 

3.1.13  display transceiver interface

【命令】

display transceiver interface [ interface-type interface-number ]

【视图】

任意视图

【参数】

interface-type interface-number：表示接口类型和接口编号。

【描述】

display transceiver interface命令用来显示可插拔模块的主要特征参数。

【举例】

# 显示接口GigabitEthernet1/1/3上插入的可插拔模块的主要特征参数。

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

GigabitEthernet1/1/3 transceiver information:

  Transceiver Type              : 1000_BASE_LX_SFP

  Connector Type                : LC

  Wavelength(nm)                : 1310

  Transfer Distance(km)         : 10(9um)

  Digital Diagnostic Monitoring : YES

  Vendor Name                   : H3C

  Ordering Name                 : SFP-GE-LX10-SM1310

表3-9 display transceiver interface命令显示信息描述表

字段	说明
transceiver information	可插拔模块信息
Transceiver Type	可插拔模块的物理型号
Connector Type	可插拔模块的连接器类型，其中： l      光纤连接器包括SC（SC Connector，NTT公司推出的拔插锁紧式光纤连接器）、LC（LC Connector，Lucent公司推出的1.25mm/RJ45锁紧式光纤连接器）两种类型 l      其他连接器包括RJ-45、CX4等类型
Wavelength(nm)	l      光模块：显示发送激光中心波长，单位nm；对于支持多条不同波长光路的模块（例如10GBASE-LX4模块），各个波长值之间用逗号分隔 l      电模块：显示为“N/A”
Transfer distance(xx)	传输距离，对于单模模块，xx显示为km，其他模块xx显示为m。当模块支持多种传输介质时，各个传输距离值之间用逗号分隔。距离值后面括号里包含对应的“传输介质”。下面是各个介质的名称： l      9um：表示9/125um单模光纤 l      50um：表示50/125um多模光纤 l      62.5um：表示62.5/125um多模光纤 l      TP：表示双绞线 l      CX4：表示CX4电缆
Digital Diagnostic Monitoring	对数字诊断功能的支持情况，其中， l      YES：表示支持数字诊断 l      NO：表示不支持数字诊断
Vendor Name	模块生产或定制厂商名称，其中： l      H3C定制防伪模块：显示为H3C l      其他模块：显示模块的生产厂商名称
Ordering Name	可插拔模块的对外型号

 

3.1.14  display transceiver manuinfo interface

【命令】

display transceiver manuinfo interface [ interface-type interface-number ]

【视图】

任意视图

【参数】

interface-type interface-number：表示接口类型和接口编号。

【描述】

display transceiver manuinfo interface命令用于显示H3C定制防伪可插拔模块的部分电子标签信息。

【举例】

# 显示接口GigabitEthernet1/1/4上插入的H3C定制防伪可插拔模块的部分电子标签信息。

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

GigabitEthernet1/1/4 transceiver manufacture information:

  Manu. Serial Number  : 213410A0000054000251

  Manufacturing Date   : 2007-07-28

  Vendor Name          : H3C

表3-10 display transceiver manuinfo interface命令显示信息描述表

字段	说明
Manu. Serial Number	在调测（调试、测试）过程中生成的序列号
Manufacturing Date	调测日期，取值为调测平台计算机的系统日期
Vendor Name	定制厂商名称，即H3C

 

3.1.15  patch activate

【命令】

patch activate

【视图】

系统视图

【参数】

无

【描述】

patch activate命令用来将处于未激活状态的补丁置为激活状态，并替代原代码的运行。系统重启后，原处于激活状态的补丁变成未激活状态，不再生效。如果想再次使用该补丁，需要再次激活或者确认运行。

【举例】

# 加载补丁文件E352_1510_P001.pat。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] patch load E352_1510_P001.pat

# 加载完成后，激活该补丁。

[Sysname] patch activate

3.1.16  patch delete

【命令】

patch delete

【视图】

系统视图

【参数】

无

【描述】

patch delete命令用来删除补丁。

执行此命令后，补丁被删除，并进入IDLE状态。

 

【举例】

# 删除补丁。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] patch delete

3.1.17  patch load

【命令】

patch load filename

【视图】

系统视图

【参数】

filename：补丁文件名，是一个长度为1～142个字符的字符串。补丁文件的命名规则为：[ 产品名称 ]_[ 基线版本号 ]_[ 补丁版本号 ].pat，例如: E352_1510_P001.pat。

 

【描述】

patch load命令用来将Flash中的补丁文件加载到内存中。

【举例】

# 加载版本号为P001补丁文件，补丁文件名为E352_1510_P001.pat。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] patch load E352_1510_P001.pat

3.1.18  patch run

【命令】

patch run

【视图】

系统视图

【参数】

无

【描述】

patch run命令用来将处于激活状态的补丁置为运行状态。

该命令只对处于激活态的补丁有效，对于处于未激活状态的补丁，该命令无效。

系统重启后，原处于运行态的补丁仍将处于运行状态，继续发挥作用。

【举例】

# 加载补丁文件E352_1510_P001.pat。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] patch load E352_1510_P001.pat

# 加载完成后，激活该补丁。

[Sysname] patch activate

# 将处于激活状态的补丁置为运行状态。

[Sysname] patch run

3.1.19  port auto-power-down

【命令】

port auto-power-down

undo port auto-power-down

【视图】

以太网端口视图

【参数】

无

【描述】

port auto-power-down命令用来开启以太网端口的节能模式。undo port auto-power-down命令用来恢复缺省情况。

缺省情况下，交换机的以太网端口节能模式处于关闭状态。

需要注意的是，目前以太网端口节能模式的配置只对以太网电口生效。

【举例】

# 开启以太网端口Ethernet1/0/1的节能模式。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface ethernet1/0/1

[Sysname-Ethernet1/0/1] port auto-power-down

3.1.20  reboot

【命令】

reboot [ unit unit-id ]

【视图】

用户视图

【参数】

unit-id：设备的Unit编号。

【描述】

reboot命令用来重新启动以太网交换机。

 

【举例】

# 不保存当前配置，直接重启设备。

<Sysname> reboot

Start to check configuration with next startup configuration file,

 please wait......

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

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

 

<Sysname>

%Apr  2 00:06:01:148 2006 Sysname DEV/5/DEV_LOG:- 1 -

Switch is rebooting...

 

Starting......

3.1.21  schedule reboot at

【命令】

schedule reboot at hh:mm [ mm/dd/yyyy | yyyy/mm/dd ]

undo schedule reboot

【视图】

用户视图

【参数】

hh:mm：交换机重新启动的时间，即几点几分。其中hh的取值范围为0～23，mm的取值范围为0～59。

mm/dd/yyyy yyyy/mm/dd：交换机重新启动的日期，是表示年、月、日的两种格式。其中yyyy的取值范围为2000～2099；mm的取值范围为1～12；dd的取值与具体月份相关。注意设定的日期与系统当前日期相比，不能大于30天。

【描述】

schedule reboot at命令用来开启交换机的定时重启功能，并设置具体的重启时间。undo schedule reboot用来关闭交换机的定时重启功能。

缺省情况下，交换机定时重启功能处于禁止状态。

 

需要注意的是：

l              如果schedule reboot at命令指定了具体的日期（年月日）参数，且参数表示的是将来的日期，则交换机将在设定的时间点重新启动，误差在1分钟以内。

l              如果schedule reboot at命令没有指定具体的日期参数，则分为两种情况：若设置的时间点在当前时间之后，交换机在当天的该时间点重新启动；若设置的时间点在当前时间之前，交换机在第二天的该时间点重新启动。

l              配置该命令后，系统会提示您输入确认信息，只有键入“Y”或者“y”后，设置才能生效。如果以前配置过该命令，则新设置的重启时间将会生效。

l              如果在配置schedule reboot at命令后，又用clock datetime命令对系统时间进行了调整，则设置的重启时间将会失效。

相关配置可参考命令reboot、display schedule reboot。

【举例】

# 设置交换机在当天晚上22:00重新启动。

<Sysname> schedule reboot at 22:00

Reboot system at 22:00 2000/04/02(in 16 hours and 53 minutes)

confirm?[Y/N]:y

<Sysname>

3.1.22  schedule reboot delay

【命令】

schedule reboot delay { hh:mm | mm }

undo schedule reboot

【视图】

用户视图

【参数】

hh:mm：交换机重新启动的等待时延，格式为“小时：分钟”。hh的取值范围为0～720，mm的取值范围为0～59，hh:mm的取值不能超过720:00。

mm：交换机重新启动的等待时延，格式为“绝对分钟数”。取值范围为0～43200。

【描述】

schedule reboot delay命令用来开启交换机的延时重启功能，并设定延迟时间。undo schedule reboot用来取消设置的重启延迟时间。

缺省情况下，交换机延时重启功能处于关闭状态。

需要注意的是：

l              交换机定时器的精度为1分钟。在到达设定的重启时间时，交换机将在该时刻后一分钟内重启。

l              可以用两种格式来设置交换机延迟时间，即“小时:分钟”和“绝对分钟数”。但总的分钟数不能大于30×24×60分钟（即30天）。

l              配置该命令后，系统会提示输入确认信息，只有键入“Y”或“y”后，设置才能生效。如果以前配置过该命令，则新设置的延迟时间将会生效。。

l              如果配置schedule reboot delay命令后，又用clock datetime命令对系统时间进行了调整，则配置的重启延迟时间失效。

相关配置可参考命令reboot、schedule reboot at、undo schedule reboot、display schedule reboot。

【举例】

# 当前时间是05:15，配置交换机延迟70分钟重启。

<Sysname> schedule reboot delay 70

Reboot system at 06:25 2000/04/02(in 1 hours and 10 minutes)

confirm?[Y/N]:y

<Sysname>

3.1.23  schedule reboot regularity

【命令】

schedule reboot regularity at hh:mm period

undo schedule reboot regularity

【视图】

系统视图

【参数】

hh:mm：交换机重新启动的时间点，格式为“小时：分钟”。hh的取值范围为0～24；mm的取值范围为0～59。

period：交换机重新启动的周期，表示形式为period = { daily | { monday | tuesday | wednesday | thursday | friday | saturday | sunday }* }。daily表示重启周期为一天，即每天的指定时间进行重启。{ monday | tuesday | wednesday | thursday | friday | saturday | sunday }*表示在每周指定的日期进行重启操作。

【描述】

schedule reboot regularity命令用来设定交换机进行周期性的重启操作，并设定周期时间。undo schedule reboot regularity用来取消配置的交换机重启周期。

缺省情况下，没有配置交换机进行周期性的重启操作。

 

配置该命令后，系统会提示您输入确认信息，只有键入“Y”或“y”后，设置才能生效。如果以前有相应的设置，则直接覆盖原有信息。

如果配置schedule reboot regularity命令后，又用clock datetime命令对系统时间进行了调整，则原来配置的schedule reboot regularity参数将会失效。

相关配置可参考命令reboot、schedule reboot at、undo schedule reboot、display schedule reboot。

【举例】

# 设置交换机在每周四的10:00自动重启。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] schedule reboot regularity at 10:00 thursday

Schedule reboot regularity, are you sure?[Y/N]:y

[Sysname]

3.1.24  system-monitor enable

【命令】

system-monitor enable

undo system-monitor enable

【视图】

系统视图

【参数】

无

【描述】

system-monitor enable命令用来开启系统运行情况的实时监控功能。undo system-monitor enable命令用来关闭系统运行情况的实时监控功能。

该功能可以对CPU、中断等系统运行情况进行动态记录，以便于设备产生问题时的分析处理。

缺省情况下，系统运行情况的实时监控功能处于开启状态。

 

【举例】

# 关闭系统运行情况的实时监控功能。

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] undo system-monitor enable

3.1.25  update fabric

【命令】

update fabric { file-url | device-name }

【视图】

用户视图

【参数】

file-url：Flash中主机软件的文件路径+文件名称，长度为1-64位的字符串。

device-name：以unit[NO.]>flash：的形式表示目标文件存放在其他设备的flash中。

【描述】

update fabric命令用来升级Fabric内所有设备的主机软件。

【举例】

# 使用设备Unit2的FLASH中名称为bootfile.bin的文件，升级Fabric内所有设备的主机软件。

<Sysname> update fabric unit2>flash:/bootfile.bin

 This will update the Fabric. Continue? [Y/N] y

 The software is verifying ...

 The result of verification is :

 Unit ID   Free space(bytes)       Enough       Version comparison

    1          15281873              Y              Y

    2          15409873              Y              Y

 warning: the verification is completed, start the file transmission? [Y/N] y

 The fabric is being updated,  100%

 The bootfile.bin is stored on unit 1 successfully!

 The bootfile.bin is stored on unit 2 successfully!

 Do you want to set bootfile.bin to be running agent next time to boot?[Y/N] y

 The bootfile.bin is configured successfully!

3.1.26  xmodem get

【命令】

xmodem get { file-url | device-name }

【视图】

用户视图

【参数】

file-url：Flash Memory中主机软件的文件路径+文件名称。

device-name：以unit[NO.]>flash：的形式表示目标文件存放在本地文件存储器中。

【描述】

xmodem get命令通过XModem协议从连接到交换机Console口的本地设备上下载文件。本命令只能在通过Console口登录交换机的情况下配置。

需要注意的是：

交换机Console口和本地设备串口的通讯参数必须相同，且Console口的接口类型必须为AUX接口。

【举例】

# 通过XModem协议下载文件。

<Sysname> xmodem get flash:/config.cfg

                **** WARNING ****

xmodem is a slow transfer protocol limited to the current speed settings of the auxiliary ports.

During the course of the download no exec input/output will be available!

                ---- ******* ----

 

4 定时执行任务命令

4.1  定时执行任务命令

4.1.1  display job

【命令】

display job [ job-name ]

【视图】

任意视图

【命令级别】

1：监控级

【参数】

job-name：定时执行任务的名称，长度为1～32个字符的字符串。

【描述】

display job命令用来查看定时执行任务的相关配置。不带job-name参数时表示查看所有定时执行任务的配置；带job-name参数表示查看指定定时执行任务的配置。

【举例】

# 查看所有定时执行任务的配置。

<Sysname> display job

Job name: pc

  Specified view: Ethernet1/0/2

  Time 1: Execute command shutdown at 08:00 Mondays Tuesdays Wednesdays Thursdays Fridays

表4-1 display job命令显示信息描述表

字段	说明
Job name	定时执行任务名
Specified view	定时执行任务中命令所在视图
Time 1: Execute command	记录了在Time 1时定时执行的命令

 

4.1.2  job

【命令】

job job-name

undo job job-name

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

job-name：定时执行任务的名称，长度为1～32个字符的字符串。

【描述】

job命令用来创建定时执行任务并进入其视图。undo job命令用来删除指定的定时执行任务。

需要注意的是：设备可配多个定时执行任务，每个定时执行任务被该字符串唯一标识，最多可以创建100个定时执行任务。

【举例】

# 创建定时执行任务saveconfig，并进入其视图。

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig]

4.1.3  time at

【命令】

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

time time-id at time date command command

undo time time-id

【视图】

定时执行任务视图

【命令级别】

3：管理级

【参数】

time time-id：时间记录，time-id为1～10的整数，一个定时执行任务最多可配置10条时间记录。

one-off：指定命令仅执行一次。命令在该时间点到达时执行，执行后下次再到达该时间点时命令不再执行。

repeating：循环执行指定命令。

at time：执行指定命令的时间，格式为hh:mm (小时:分钟)。hh取值范围为0～23，mm取值范围为0～59。

week-day week-daylist：执行指定命令在一周中的哪（些）天被执行。week-daylist表示一周中任一天或几天的组合，取值范围为：Mon Tue Wed Thu Fri Sat Sun（星期一到星期日）。设置多天时，字符串之间用空格分开，最多可设置七天。

month-date month-day：执行指定命令在一个月中的哪天被执行。month-day表示日期，取值范围为1～31的整数。

date：执行指定命令的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日）。

l              YYYY的取值范围为2000～2035；

l              MM的取值范围为1～12；

l              DD的取值范围与具体月份有关。

指定该参数时，配置时间点必须在系统当前时间之后。

command command：需要定时执行的命令字符串，该字符串指定的命令必须为完整的、不需要进行交互的命令。

【描述】

time at命令用来配置在指定时间执行指定命令。undo time命令用来取消在指定时间执行的命令。

在定时执行任务视图下进行配置的规则如下：

l              同一个定时执行任务中包含的命令必须在同一视图下；

l              同一个定时执行任务中最多可以配置10条命令（对应10个time-id），如果多于10条命令，可分成多个定时执行任务。

【举例】

# 配置定时执行任务，使设备在星期一到星期五的上午八点开启以太网端口。

<Sysname> system-view

[Sysname] job phone

[Sysname-job-phone] time 1 repeating at 8:00 week-day Mon Tue Wed Thu Fri command undo shutdown

# 配置定时执行任务，使设备在2009年4月6号关闭以太网端口。

<Sysname> system-view

[Sysname] job phone

[Sysname-job-phone] time 2 at 8:00 2009/04/06 command shutdown

4.1.4  time delay

【命令】

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

undo time time-id

【视图】

定时执行任务视图

【命令级别】

3：管理级

【参数】

time time-id：时间记录，time-id为1～10的整数，一个定时执行任务最多可配置10条时间记录。

one-off：指定命令仅执行一次。命令在该时间点到达时执行，执行后下次再到达该时间点时命令不再执行。

repeating：循环执行指定命令。

delay time：执行指定命令的等待时延。格式为hh:mm (小时:分钟)或mm（分钟）。

l              使用hh:mm格式时，hh的取值范围为0～720，mm的取值范围为0～59，hh:mm的取值不能超过720:00；

l              使用mm格式时，mm的取值范围为1～43200，即定时器的最大定时时长为30天。

该参数与系统时间无关，即使系统时间变化命令也将在相应时延后执行。

command command：需要定时执行的命令字符串，该字符串指定的命令必须为完整的、不需要进行交互的命令。

【描述】

time delay命令用来配置延迟指定时间执行指定命令。undo time命令用来取消在指定时间执行的命令。

在定时执行任务视图下进行配置的规则如下：

l              同一个定时执行任务中包含的命令必须在同一视图下；

l              同一个定时执行任务中最多可以配置10条命令（对应10个time-id），如果多于10条命令，可分成多个定时执行任务。

【举例】

# 配置定时执行任务，使设备在延迟五个小时后关闭以太网端口。

<Sysname> system-view

[Sysname] job phone

[Sysname-job-phone] time 5 one-off delay 5:00 command shutdown

4.1.5  view

【命令】

view view

undo view

【视图】

定时执行任务视图

【命令级别】

3：管理级

【参数】

view：视图名称，长度为1～90个字符的字符串。配置定时执行任务中指定的命令在哪个视图下执行。

【描述】

view命令用来指定定时执行任务的命令执行视图。undo view命令删除已指定的定时执行任务的命令执行视图。

需要注意的是：

同一个定时执行任务中包含的命令必须在同一执行视图下、新配置的命令执行视图会替代原有的执行视图。

【举例】

# 指定、修改视图后查看 。

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig] view Ethernet1/0/2

[Sysname-job-saveconfig] display this

#

job saveconfig

  view Ethernet1/0/2

#

return

[Sysname-job-saveconfig] view system

[Sysname-job-saveconfig] display this

#

job saveconfig

  view system

#

return