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.

Table 8-4 List of services that can be targets of this command

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