Show TOC

SAP Host Agent Reference - Command Line Options of the saphostexec ExecutableLocate this document in the navigation structure

Usually SAP Host Agent is automatically started when the operating system is booted. You can also manually control it using the saphostexec program.

Prerequisites

You are logged on as a user with the required authorization:

Windows As a member of the local Administrators group
UNIX As a user with root authorization
IBM i As a user profile with special authorities *SECADM and *ALLOBJ, for example as user profile QSECOFR
Features

You call the program from the command line with the following syntax:

Windows %ProgramFiles%\SAP\hostctrl\exe\saphostexec.exe -[option] [pf=<ProfilePath>]
UNIX, IBM i /usr/sap/hostctrl/exe/saphostexec -[option] [pf=<ProfilePath>]

where <ProfilePath> is path to the profile file ( host_profile) of SAP Host Agent. By default the host_profile file is located in the executable directory.

You can execute saphostexec with the following command line options:

Option

Meaning

-help

Lists all command line options of saphostexec with documentation

-install

Installs SAP Host Agent

-upgrade

Upgrades SAP Host Agent

-uninstall

Uninstalls SAP Host Agent

-restart

Starts or restarts SAP Host Agent

-stop

Stops a running SAP Host Agent

-status

Returns the status of SAP Host Agent

-version

Returns the version of SAP Host Agent with detailed information