# Diags Cancel Tests Subcommand

access: Administrators

Cancels one or more diagnostic tests, resulting in the deletion of the results data.

> diags cancel tests { -t | --test} TEST HANDLE | {-a|--all} [{-H | --noheader}]

Argument | Description
--- | ---
{ -t | --test} | Specifies the test to cancel. (Note: The TEST HANDLE is the same TEST HANDLE that is output to the screen when you submit the test.)
{-a | --all} | Cancels all tests.
{-H | --noheader} | Suppresses header output.

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