Sun Microsystems V20Z Server User Manual


 
Appendix F Platform Commands 149
TABLE F-20 lists the arguments for this subcommand.
The subcommand platform set power state does not affect the platform if the
platform is already on; if the platform is off, it powers on and boots the OS. In other
words, the subcommand platform set power state ensures that the platform
is on, but does not reboot it if it is not on.
The subcommand platform set os state waits for the platform to boot; the
subcommand platform set power state only waits for the power to come on.
Return Codes
TABLE F-21 lists the return codes for this subcommand.
TABLE F-20 Arguments for Subcommand platform set power state
Arguments Description
{-W |--nowait} If specified, the command returns immediately instead of
waiting for the operation to complete.
{-f | --forced} Results in a hard power off.
{-t |--timeout} Specifies the maximum time to wait for the operation to
complete (in seconds).
{off | on | cycle} Specifies whether to turn the platform power on or off or to
cycle. Specifying the cycle argument causes platform power to
be turned off, then on.
TABLE F-21 Return Codes for Subcommand platform set power state
Return Code ID 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_NoPermission 6 Not authorized to perform this operation.
NWSE_MissingArgument 7 Missing argument(s).
NWSE_TimedOut 23 Operation timed out.