# Diags Run Tests Subcommand

access: Administrators

Submits one or more diagnostic tests for execution.

> diags run tests { -n | --name} TEST NAME | {-a| --all} [{-H | --noheader}] [{-P | --noprogress}] [{-m | --module} MODULE NAME] [{-v | --verbose}]

Argument | Description
--- | ---
{ -n | --name} | Specifies the specific test(s) to execute. Run diags get tests for a list of individual test names.
{-a | --all} | Specifies that all tests are to be executed. Run diags get tests for a list of all available tests.
{-H | --noheader} | Suppresses header output.
{-P | --noprogress} | Suppresses progress dots when waiting for test results.
{-m | --module} | Specifies that only tests for the specified module are to be executed. Run diags get tests for a list of modules.
[-v | --verbose] | If specified, Test Details display following the test result line.

The following data displays after a test is run:

- Submitted Test Name
- Test Handle
- Test Result (for example, Passed, Failed)
- Details (if you specify the -v option, Test Details displays indicating detailed information about the test such as high, low, and nominal values, actual values, etc.) Upon failure, Failure Details displays with a text message indicating the cause of failure.

If the output for certain tests wraps, you can redirect the output to a file and view it with an editor for better readability.

Return Codes

Following are the return values for this command:

Code | Numeric Code | Description
--- | --- | ---
NWSE_Success | 0 | Command successfully completed.
NWSE_InvalidUsage | 1 | Invalid usage: bad parameter usage, conflicting options specified.
NWSE_RPCTimeout | 2 | Request was issued, but was not serviced by the server. RPC procedure timed out and the request may or may not have been serviced by the server.
NWSE_RPCNotConnected | 3 | Unable to connect to the RPC server.
NWSE_InvalidArgument | 4 | One or more arguments were incorrect or invalid.
NWSE_NoPermission | 6 | Not authorized to perform this operation.
NWSE_MissingArgument | 7 | Missing argument(s).
NWSE_ServiceNotAvailable | 24 | Requested service is not available. CD diagnostics are running, user is trying to run diagnostics on the Service Processor.

Related Topics

System Management Commands

Diags Command