This documentation supports the 18.08 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.



You can continue to use C APIs to customize your application, but C APIs are not enhanced to support new capabilities provided by Java APIs and REST APIs.


Updates the indicated configuration information for the specified server.

If you perform a set operation on an overlay and you provide values for an inherited grain, the values are ignored. Only values for extended or overwritten grains of the overlay are set.


BMC Remedy AR System administrator.


#include "ar.h"
#include "arerrno.h"
#include "arextern.h"

int ARSetServerInfo(
   ARControlStruct *control,
   ARServerInfoList *serverInfo,
   ARStatusList *status)

Input arguments


The control record for the operation. It contains information about the user requesting the operation, where that operation is to be performed, and which session is used to perform it. The user and server fields are required.


The information to update on the server (see the following Server options section). The system returns error messages for server options not updated due to error.

Return values


A list of zero or more notes, warnings, or errors generated from a call to this function. For a description of all possible values, see Error checking.

Server options

Some server options can be set and retrieved. Others can only be retrieved and still others can only be set.

  • For a complete list of options that can be set with the ARSetServerInfo call and retrieved with the ARGetServerInfo call, see the server options descriptions for ARGetServerInfo.
  • For a complete list of options that can only be retrieved, see the server option descriptions for ARGetServerInfo.
  • You can set the value of the AR_SERVER_INFO_DB_PASSWORD option, but you cannot retrieve its value.
    The database password associated with the ARSystem (applicable to Oracle, Microsoft SQL Server, and Sybase databases). The encrypted password value is stored in the configuration file.

See also

ar.conf file, ARGetServerInfo. See FreeAR for: FreeARServerInfoList, FreeARStatusList.

Was this page helpful? Yes No Submitting... Thank you