servicectrl-Component Dependencies Control Utility

Agent Technology Commands › servicectrl-Component Dependencies Control Utility

servicectrl-Component Dependencies Control Utility

Valid on UNIX/Linux, Windows, z/OS

servicectrl controls awservices configuration information by specifying the component name, path, and configuration options. servicectrl can also be used to control agents and services remotely. The awservices process must be active on the related host (local or remote).

Windows

servicectrl lets you define any Windows executable as a dependency for any Agent Technology component. For example, you can define a dependency such that OpenIngres must be running before the OpenIngres agent can start.

Windows

install-path\services\bin

UNIX/Linux, z/OS

install-path/services/bin

Syntax

servicectrl {install|installauto|remove|update|start|stop|status|version} <coptions>

install: Installs the agent or service as a registered Agent Technology component.
installauto: Installs the agent or service and specifies that it must start automatically when awservices is started.
remove: Removes the agent or services as a registered Agent Technology component.
update: Removes the agent or service from the registry and then installs it.
start
stop
status: Lists the operational status (running or stopped) of the agent or service.
version: Lists the name of the agent or service, its version information, and the name of its executable file.

Options

Note: These options have a double-dash(--) prefix.

--name=component-name

Name that is used to identify the component.

--instance=instance-name

Name for an instance of a component that has multiple instances with the same component name.

--remote=remote-system

Host to which this command applies.

--image=full-path-name-of-component

Full path where the component is located.

--options=default-options

Default options to be used when the component is started.

--type=component-type

Type of component. For Agent Technology components, the type is AWEXE. To install a component that is not a part of Agent Technology, the type is EXE. (Windows only)

--user=user-name

With the password, specifies account under which the component is run.

--dependOn=list-of-components

Components that this component depends on, and starts them when this component is started if they are not running. Separate multiple component names with commas.

--autoStart=yes|no

Starts this component when awservices is started.

--andDependOn=yes|no

Stops a component even though components depending on it are still running. Stops the dependent components first.

install

Installs the agent or service as a registered Agent Technology component.

installauto: Installs the agent or service and specifies that it is to start up automatically when awservices is started.
remove: Removes the agent or service as a registered Agent Technology component.
update: Removes the agent or service from the registry and then installs it.
start: Starts the agent or service in the background.
stop: Stops the agent or service.
status: Lists the operational status of the agent or service (that is, whether it is running or stopped).
version: Lists the name of the agent or service, its version information, and the name of its executable file.