This documentation supports the 9.1 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.


Performs server- and network-specific initialization operations for each BMC Remedy AR System session. All API programs that interact with the BMC Remedy AR System must call this function before calling any other BMC Remedy AR System API functions. Your program can call this function again to create additional sessions.


All users.


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

int ARInitialization(
   ARControlStruct *control,
   ARStatusList *status)

Input arguments


The control record for the operation. The control parameter must be the first input argument. 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 sessionId field, which you must supply in the control record for most other functions, is returned by this function.

To use Unicode (UTF-8) as the client character set, set the ARControlStruct localInfo.charSet field as follows:

memset(&control, '\0', sizeof(control));
strcpy(control.localeInfo.charSet, "UTF-8");
if (ARInitialization(&control, &status) >= AR_RETURN_ERROR)

Pass an empty string as localeInfo.charSet to get the normal API behavior. That is, the client character set is the character set implied by the client's locale.

The other fields of ARControlStruct may safely be null-valued, and ARInitialization automatically fills them in.

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.

See also

See FreeAR for: FreeARStatusList.

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