9.5.5 ServiceStart (start a service)

Purpose

Starts a service.

Syntax

ServiceStart(ServiceInfoName)

Argument

ServiceInfoName

Specify the service information name of the service to be started. Write a character string or a variable that stores this value.

Description

The ServiceStart command starts a service registered in the system, using the value stored in the keyword Name in the service information.

The execution result is stored in the _SVC_RTN_ reserved variable. The command returns True on successful execution, or LOGON_FAILED if the service fails to start due to an invalid account. False is returned for all other states.

Note

Execute the script file as a user who has administrator permissions. For details, see 1.8.3 Effect of the executing user on command behavior.

Important

Do not execute this command for services that cannot start. This command issues a start request to the specified service, and will not terminate until the specified service has started.

Example

' Register and start the JP1/Script service if it does
' not already exist.
ServiceSetValue("JSService", Name::"JP1_Script")
If  IsExistService("JSService") = False  Then
  OutDir = "C:\Program Files (x86)\Hitachi\Script\BIN\"
  ServiceSetValue("JSService", Name::"JP1_Script"   _
                   , DispName::"JP1/Script"   _
                   , Type::SERVICE_WIN32_OWN_PROCESS   _
                   , Start::SERVICE_AUTO_START   _
                   , Errctl::SERVICE_ERROR_NORMAL   _
                   , Path::OutDir+"SPTHSV.EXE")
  ServiceCreate("JSService")
End
ServiceStart("JSService")

JP1/Script version

Supported from JP1/Script 01-00.

To Page Top