# Diags Get State Subcommand

access: Administrators

Returns the state of the platform diagnostics control server.

> diags get state

If the return from the command is that the platform is up and ready for diagnostics, then you can submit platform diagnostic tests for execution.

The following success text messages may return:

> SP Diagnostics is ready to accept tests. Run 'diags get state' to determine availability of Platform Diagnostics.
> SP Diagnostics (in no-platform mode) is ready to accept tests.
> Platform and SP Diagnostics are ready to accept tests.

The following error text messages may return:

> Error. Verify that the platform state is 'off' and retry or use the 'diags start --forced' option to ignore the current state.
> Error. Platform CD Diagnostics is currently running.
> Error. Diagnostics is currently running. Run 'diags terminate' and try again.
> Error. Unable to load Platform Diagnostics. Diagnostics terminated.
> Error. Unable to load SP Diagnostics. Diagnostics terminated.
> Error. SP no-platform Diagnostics is already running.

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_ServiceNotAvailable | 24 | Requested service is not available. CD diagnostics are running, user is trying to run diagnostics on the Service Processor.
NWSE_DeviceError | 25 | Unable to read or write to the device.

Related Topics

System Management Commands

Diags Command