selang Reference Guide › Classes and Properties › Classes in the Windows Environment › SERVICE Class

SERVICE Class

Each record in the SERVICE class defines a Windows service as listed in the Windows Control Panel, Services.

The key of the SERVICE class record is the name of the service being controlled.

The following definitions describe the properties contained in this class record. Most properties are modifiable and can be manipulated using selang or the administration interfaces. Non-modifiable properties are marked informational.

ACCOUNT

Changes the login account for the service. Although most services must log in to the system account, some services can be configured to log in to special user accounts. For more information, see the relevant Microsoft Windows documentation. The default value is LocalSystem.

Use the account parameter with the chres or editres commands to modify this property.

BINARY_NAME

The full path which points to the location of the service's executable.

IMAGEPATH

The fully qualified path for the specified executable module.

INTERACTIVE

Provides a user interface on the desktop that can be used by whoever is logged in when the service is started. This is available only if the service is running as a LocalSystem account.

Use the interactive parameter with the chres or editres commands to modify this property.

PROFILE

A string that specifies the path to the user's profile. This string can include a local absolute path, or a UNC path.

Use the profile parameter with the chusr, editusr, or newusr command to modify this property.

REG_KEY

This property points to the location of the service definition in Windows registry.

STARTUPTYPE

Defines how (when) the service is started. Options are:

• automatic-Starts automatically during system startup.
• disabled-Prevents users or dependent services from starting the service.
• manual-Allows the service to be started by a user or a dependent service.
• Use the startuptype parameter with the chres or editres commands to modify this property.

STATUS

Changes the current service state. Options are: started, stopped, and paused.

Use the status parameter with the chres or editres commands to modify this property.

Example: Configure a service to start manually

To change the service SeOSAgent to start manually, enter the selang command:

chres SERVICE "SeosAgent" starttype(manual)

Example: Change a directory login account

To change the login account of the Directory Replicator to ReplAdmin with password abcde, enter the selang command:

chres SERVICE directory replicator account(repladmin) domainpwd(abcde)