8.6.3 hcmdssrv (starting and stopping JP1/AO, and displaying the status of JP1/AO)
Description
This command starts and stops the services and databases of JP1/AO. This command can also display the status of the JP1/AO services or change how to start the services.
Note that if you execute this command by specifying AutomationWebService for the /server option, you can start, stop, or display the status of, the services listed in the table below. Note that this command can also be used to start JP1/Base services JP1/Base and JP1/Base Event.
Service display name and process |
Starting |
Stopping |
Displaying status |
---|---|---|---|
HAutomation Engine Web Service |
Y |
Y |
Y |
HBase Storage Mgmt Common Service |
Y |
Y #1 |
Y |
HBase Storage Mgmt Web Service |
Y |
Y #1 |
Y |
HBase Storage Mgmt Web SSO Service |
Y |
Y #1 |
Y |
HAutomation Engine |
Y |
Y |
N |
HAutomation Engine Database _JF0 |
Y |
Y |
N |
JP1/Base |
Y |
N |
N |
JP1/Base Event |
Y |
N |
N |
Database process#2 |
Y |
Y #1 |
Y |
- Legend:
-
Y: The command works. N: The command does not work.
- #1:
-
The service does not stop while a service from the Hitachi Command Suite products is running.
- #2:
-
These are the JP1/AO internal processes. The hcmdssrv command does not start and stop HiRDB/EmbeddedEdition _HD0 that represents the database service.
Syntax
hcmdssrv {/start | /stop | /check| /status} [/server service-name]
- To see the status of services from JP1/AO and all the Hitachi Command Suite products:
hcmdssrv /statusall
- To change how to start a service or services:
hcmdssrv /starttype {auto | manual} {/server service-name | /all}
Arguments
- /start
-
This option causes the command to start the service and database specified in the /server option.
- /stop
-
This option causes the command to stop the service and database specified in the /server option.
- /check
-
This option causes the command to display the status of the service and database specified in the /server option.
- /status
-
This option causes the command to display the status of the service and database specified in the /server option.
- /server service-name
-
If you want to start and stop only the service, or display its status, of the JP1/AO product, specify AutomationWebService for service-name. If this option is omitted, the command has an effect on the services from JP1/AO and all Hitachi Command Suite products that are installed.
- /statusall
-
This option causes the command to display the status of the services and databases, and of the services from the Hitachi Command Suite products that are registered with Common Component.
- /starttype {auto | manual}
-
This option specifies the start type of the service specified in the /server option.
To start the service automatically, use auto. To start the service manually, use manual.
- /all
-
If this option is specified, the command has an effect on the services from JP1/AO and all Hitachi Command Suite products that are installed.
Located in
Common-Component-installation-folder\bin
Execute permission
Execute the command as a user with Administrator permissions.
Remarks
-
When you start and stop the services for JP1/AO in day-to-day operations, start and stop all the services without specifying the /server option. If you want to start only the services from the JP1/AO products with /server option, use HBase for the /server option to start the services from Common Component because these services must be started beforehand.
-
Executing the command with the /stop option while a task is being processed terminates any processing running on the connection destination. For this reason, if any task is in execution status (In Progress, Waiting for Response, Abnormal Detection, or Terminated), you need to wait the status transition of the task to one of the ended status (Completed, Failed, or Canceled) or stop the execution of all the tasks, and then use the command with the option.
-
If the service does not stop within three minutes after the command with the /stop option, the command terminates abnormally with a message indicating a timeout. In this case, wait a little while and then execute the command with the /stop option again.
Return code
The following table lists the return codes from the command with the /start or /stop option.
Return code |
Description |
---|---|
0 |
The command succeeded. |
1 |
The service has already started (with the /start option). The service has already stopped (with the /stop option). |
255 |
The command execution failed. |
The following table lists the return codes from the command with the /check, /status, or /statusall option.
Return code |
Description |
---|---|
0 |
The service is not running. |
1 |
The service is running. |
255 |
The command execution failed. |
The following table lists the return codes from the command with the /starttype option.
Return code |
Description |
---|---|
0 |
The command succeeded. |
255 |
The command execution failed. |
Example
The following commands show examples of how to use the command for each case.
-
To start the service from the JP1/AO products:
hcmdssrv /start /server AutomationWebService
-
To stop the service from the JP1/AO products:
hcmdssrv /stop /server AutomationWebService
-
To check the status of the service from the JP1/AO products:
hcmdssrv /status /server AutomationWebService
Related topic