[Machine] Service Control
Q100016: [Machine] Service Control
Starts/Stops/Restarts a specified service
| Parameter | In/Out | Description | Other Info |
|---|---|---|---|
| Service name | In | The name of the system service. | |
| Operation to perform | In | Choices: Stop, Start, RestartThe operation to be performed on the named service. |
Default: Start |
| Timeout seconds | In | Timeout in seconds for the operation to complete, with a minimum of 30 seconds. Defaults to 180 seconds which is the same as the normal desktop Control Panel applet. | Default: 180 |
| Log output level | In | Choices: Minimal, VerboseThe level of execution detail you want to appear in the log. |
Default: Minimal |
| Result | Out | Returns zero if the operation cannot complete within the specified timeout period. Otherwise returns the elapsed number of whole seconds it took for completion. |
(Italics = required parameters)
Notes
The [Machine] Service Control module provides you with a method for starting, stopping or restarting a Windows Service on the server that the JobServer is running on. This can be handy for helping a service which may be very memory hungry when running over time to periodically release resources and allow the service to restart with a lower memory footprint. Other times it might be helpful to temporarily shutdown services while a system backup is running. It can sometimes result in backups running much faster when some certain large services are temporarily stopped. Then just have the services start back up after backups have completed.
These types of actions can help boost the performance of a server which might be resource starved at certain times or during certain operations.
When configuring the job to control a service, the name of the system service must be entered exactly as it appears in the list of services. A typographical error in the name will look like the module was unable to complete the requested operation.