Description

Installs the specified service into the SCM (Service Control Manager) so that it can be started and stopped. Administrator privileges are usually required to perform this action. Services do not run on Windows 95/98/ME.

Declaration

<AMSERVICEINSTALL EXECUTABLE="text" DISPLAYNAME="text" USERNAME="text" PASSWORD="text" ERROR="text [options]" SERVICETYPE="text [options]" RUNTYPE="text [options]" INTERACTIVE="yes/no">

Example

<AMSERVICEINSTALL EXECUTABLE="c:\foldername\myservice" DISPLAYNAME="My Custom Service App" USERNAME="MyUserName" PASSWORD="">

General Tab Parameters

Executable: Specifies the service to resume.

Text, Required
MARKUP: EXECUTABLE="c:\foldername\servicename.exe"

Display name: Specifies the name of the service as it should appear in the list of services.

Text, Required
MARKUP: DISPLAYNAME="My Service"

Username: Specifies the username that service should use to log on. The Service automatically inherits the rights of the user specified in this field.

Text, Optional - None
MARKUP: EXECUTABLENAME="c:\foldername\servicename.exe"

Password: Specifies the password corresponding to the username.

Text, Optional - None
MARKUP: EXECUTABLENAME="c:\foldername\servicename.exe"

Error severity: If the service generates an error, specifies how the error should be written to the system event log.

• normal: Errors are logged as normal

• ignore: Errors are ignored.

• critical: Errors are logged as critical.

• severe: Errors are logged as severe.

Text [options], Optional
MARKUP: ERROR="critical"

Service type: If the service generates an error, specifies how the error should be written to the system event log.

• own_process: The service runs in its own process space.

• shared_process: The service runs in it a shared process space

• kernel_driver: The service is a kernel driver.

• file_system: The service is a file_system driver.

Text [options], Optional
MARKUP: SERVICETYPE="shared_process"

Run type: If the service generates an error, specifies how the error should be written to the system event log.

• automatic: The service starts automatically when the system starts.

• manual: The service is not automatically started, it must be started manually through the SCM

• disabled: The service is disabled.

• boot: Driver specific setting.

• system: Driver specific setting.

Text [options], Optional
MARKUP: RUNTYPE="manual"

Interactive service: Specifies that the service should be able to interact with the desktop.

Text [options], Optional Default - NO
MARKUP: INTERACT="YES"

See Also

Start Service. Stop Service, Pause Service, Resume Service, Remove Service