1.6.4 hcmds64srv (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.

Table 1‒5: 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 64 Storage Mgmt SSO Service	Y	Y ^#1	Y
HBase 64 Storage Mgmt Web Service	Y	Y ^#1	Y
HBase 64 Storage Mgmt Web SSO Service	Y	Y ^#1	Y
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 hcmds64srv command does not start and stop HiRDB/EmbeddedEdition _HD1 that represents the database service.

Syntax

hcmds64srv
     {/start | /stop | /check| /status}
     [/server service-name]

To see the status of services from JP1/AO and all the Hitachi Command Suite products:

hcmds64srv
     /statusall

To change how to start a service or services:

hcmds64srv
     /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

In Windows:: Common-Component-installation-folder\bin
In Linux:: /opt/HiCommand/Base64/bin

Execute permission

Execute the command as a user with Administrator or root 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 Input, In Progress (with Error), In Progress (Terminating), or Long Running), 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

The command succeeded.

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 examples show how to use the command for each case.

To start, in Windows, the services from the JP1/AO products:

hcmds64srv /start /server AutomationWebService
To stop, in Windows, the services from the JP1/AO products:

hcmds64srv /stop /server AutomationWebService
To check, in Windows, the status of the services from the JP1/AO products:

hcmds64srv /status /server AutomationWebService