HP Systems Insight Manager 6.0 Command Line Interface Guide

Return values
MeaningValue
HP SIM and TomCat started correctly.0
An error occurred during startup.>0
Example
To start the HP SIM daemons, enter mxstart.
mxstatus
mxstatus displays or returns (through the exit code) the current ready or not-ready state of HP SIM
Synopsis
mxstatus [ [ [-w [-t minutes] ] [-v] ] | [-l] | [-h] | [-v] ]
Description
The mxstatus command may be used to determine if Systems Insight Manager is running and in a ready
or accessable state. This command is primarily intended to be called from a HP SIM partner application that
wants to perform some installation or upgrade process on the HP SIM CMS, and needs to know if all HP
SIM communications interfaces are ready and accessable. HP SIM communications interfaces include all
SOAP APIs, CLIs and Portal URLs. You can also invoke this command through the standard command line
interface which supports online usage help and a verbose mode to display operation progress.
This command supports two main modes of operation. A WAIT mode and a NOWAIT mode.
When used in WAIT mode, the command will not return to the caller until HP SIM is determined to be in a
ready state or the internal safety timeout period has expired. This mode alleviates the calling application
the burden of providing the same looping/checking process as provided by the command's internal WAIT
loop process. The WAIT mode is enabled by using the -w option.
When used in NOWAIT mode, the command will return immediately to the caller with the current
ready/not-ready state of HP SIM. The command will not block, regardless of the state of HP SIM. This mode
then enables the calling application to provide its own looping and waiting process. The NOWAIT mode
is the default mode of operation for the command.
In normal operation, this command will not display any textual information through STDOUT. The calling
application must verify the exit code that is returned by mxstatus to determine the HP SIM running/ready
state. See the “Return values” for valid mxstatus exit values. The mxstatus command will display progress
and HP SIM running/ready information if you use the [-v] verbose option.
Options
-w
The WAIT option forces the command to wait or block (not return to caller) until HP SIM is
in a ready state, or a default or specified safety timeout period has expired. If the -w option
is not provided, then the normal default behavior for the command is the NOWAIT mode,
whereby the command will return immediately to the calling application with the current
HP SIM ready/not-ready state.
-t
The TIMEOUT option may be used to specify a safety timeout period that will be utilized
when the -w Wait option is used. The safety timeout provides a way for the command to
return to the calling application in case HP SIM never reaches a ready state. For example,
HP SIM is actually not running. The -t option requires an integer argument which specifies
the timeout to be used, in minutes. If the -t option is not provided, the default timeout period
that the command will use is 30 minutes.
-v
mxstatus 83