HP Systems Insight Manager 7.1 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 HP SIM 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” (page 101) 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
100 Command descriptions