ARSetServerInfo

Important

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.

Description

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.

Synopsis

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

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

Input arguments

control

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.

serverInfo

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

Return values

status

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.
AR_SERVER_INFO_DB_PASSWORD:
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.