Table Of Contents

D Commands

description (EEM)

diagnostic bootup level

diagnostic clear result module

diagnostic ondemand action-on-failure

diagnostic ondemand iteration

diagnostic start

diagnostic stop

diagnostic test simulation

D Commands

---

This chapter describes the Cisco NX-OS system management commands that begin with the letter D.

description (EEM)

Use the description command to add a description to an Embedded Event Manager (EEM) applet.

To remove the description, use the no form of this command.

description description

no description

Syntax Description

description

Comment or a description that is added to an EEM applet.

Defaults

None

Command Modes

Embedded Event Manager

Supported User Roles

Super user
VDC administrator
VDC user

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to add a description to an EEM applet:

switch# configure terminal 

switch(config)# event manager applet counter-applet 

switch(config-applet)# action 1.2 counter name count1 value $variable op dec 

Switch(config-applet)# description "counter policy for acme" 

switch(config-applet)#

diagnostic bootup level

To configure the diagnostic bootup level to trigger diagnostics when the device boots, use the diagnostic bootup level command.

diagnostic bootup level {bypass | complete}

Syntax Description

bypass	Specifies to not perform any bootup diagnostics.
complete	Displays all bootup diagnostics. The default is complete.

Defaults

None

Command Modes

Any mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the diagnostic bootup level:

switch(config)# diagnostic bootup level bypass

switch#

Related Commands

Command	Description
show diagnostic bootup level	Displays the diagnostic bootup level.

diagnostic clear result module

To clear the diagnostic test result for the specified test, use the diagnostic clear result module command.

diagnostic clear result module [slot | all] test {test-id | all}

Syntax Description

slot	(Optional) Diagnostic clear module number. The range is from 1 to 10.
all	Displays the test result for all tests on all modules.
test	Displays the diagnostic test selection.
test-id	(Optional) TestID. The range is from 1 to 14.

Defaults

None

Command Modes

Any mode

Supported User Roles

network-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear a diagnostic test result:

switch# diagnostic clear result module 6 test 6

Related Commands

Command	Description
show diagnostic result	Displays a diagnostic test result for a specified test.

diagnostic ondemand action-on-failure

To configure the action to take if the ondemand test fails, use the diagnostic ondemand action-on-failure command.

diagnostic ondemand action-on-failure {continue failure-count num-fails | stop}

Syntax Description

continue failure-count num-fails	Displays the ondemand test until the test failure limit is reached. The range is from 1 to 999. The default is 1.
stop	Stops ondemand tests immediately if a test fails.

Defaults

None

Command Modes

Any mode

Supported User Roles

network-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the action if the ondemand test fails:

switch# diagnostic ondemand action-on-failure continue failure-count 992

switch# 

Related Commands

Command	Description
show diagnostic ondemand	Displays information about ondemand tests.

diagnostic ondemand iteration

To configure the number of times that the ondemand test runs, use the diagnostic ondemand iteration command.

diagnostic ondemand iteration number

Syntax Description

number

(Optional) Number of times that the ondemand test runs. The range is from 1 to 999. The default is 1.

Defaults

None

Command Modes

Any mode

Supported User Roles

network-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to configure the number of times that the ondemand test runs:

switch# diagnostic ondemand iteration 992

Related Commands

Command	Description
show diagnostic ondemand	Displays information about ondemand tests.

diagnostic start

To start the ondemand diagnostic test for a module, use the diagnostic start command.

diagnostic start module slot test [test-id | test-name | all | non-disruptive] [port port-number | all]

Syntax Description

slot	(Optional) Diagnostic start slot number. The range is from 1 to 10.
test	Displays the diagnostic test.
test-id	(Optional) TestID. The range is from 1 to 14.
test-name	(Optional) Test name. The name can be any case-sensitive alphanumeric string up to 32 characters.
all	(Optional) Displays all ports.
non-disruptive	(Optional) Displays the nondisruptive tests.
port	(Optional) Displays the port interface.
port-number	(Optional) Interface port number.

Defaults

None

Command Modes

Any mode

Supported User Roles

network-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to start the ondemand diagnostic test for a module:

switch# diagnostic start module 6 test all

Related Commands

Command	Description
diagnostic stop	Stops ondemand diagnostics.

diagnostic stop

To stop one or more diagnostic tests for a module, use the diagnostic stop command.

diagnostic stop module slot test [test-id | name | all]

Syntax Description

slot	(Optional) Displays the slot number. The slot range is from 1 to 10.
test	Displays the diagnostic test.
test-id	(Optional) TestID. The testid range is from 1 to 14.
test-name	(Optional) Test name. The name can be any case-sensitive alpha numeric string up to 32 characters.
all	(Optional) Displays the diagnostic test for all tests on all modules.

Defaults

None

Command Modes

Any mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to stop one or more diagnostic tests on a module:

switch# diagnostic stop module 6 test all 

switch# 

Related Commands

Command	Description
diagnostic start	Starts one or more diagnostic test.

diagnostic test simulation

To simulate a test result for a module, use the diagnostic test simulation command

diagnostic test simulation module slot test test-id {fail | random-fail| success} [port number | all]

Syntax Description

slot	Diagnostic test simulation slot number. The range is from 1 to 10.
test	Displays the diagnostic test.
test-id	TestID. The test range is from 1 to 14.
fail	Displays the failed test results.
random-fail	Displays the fail test results randomly.
success	Displays the pass test results.
port number	Displays the interface port number.
all	Displays the test result for all tests on all modules.

Defaults

None

Command Modes

Any mode

Supported User Roles

network-admin
vdc-admin

Command History

Release	Modification
4.0(1)	This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to simulate a test result:

switch# diagnostic test simulation module 2 test 2 fail 

switch#

Related Commands

Command	Description
diagnostic test simulation	Simulates a test result.