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

This command has the following format:

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

Starts the agent or service in the background.

stop

Stops the agent or services.

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.

Options

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

--name=component-name

Specifies the name used to identify the component.

--instance=instance-name

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

--remote=remote-system

Name of the host to which this command applies.

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

Specifies the full path where the component is located.

--options=default-options

List of default options to be used when the component is started.

--type=component-type

Specifies the 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 password, specifies account under which the component is to be run.

--dependOn=list-of-components

Specifies components on which this component is dependent, and starts them when this component is started if they are not already 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.