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.

Login and session information in C API functions

Almost every BMC Remedy AR System C API function has a control parameter as its first input argument. This parameter contains the login and session information required to connect to an BMC Remedy AR System server and, thus, required for almost every operation.

Note

The control parameter was optional in BMC Remedy AR System version 3.x and earlier. Therefore, you must add the control parameter to recompiled pre-4.x API programs if you use these programs with later versions of the BMC Remedy AR System API.



The control parameter is a pointer to an ARControlStruct structure (see the following figure).

Structure used to provide required login information 


This structure has the following elements:

ElementDescription 

Cache ID

Identifier of the cache area allocated by the server to store user information. Before the first API call, initialize it to zero. The server assigns this value; do not change it. It enables the server to use the cache instead of reloading user information for each API call.

Operation Time

Timestamp specifying the date and time the operation occurred on the server. The server assigns this value for each API call.

User

(Required) Login name to connect to the server. The privileges associated with the user determine whether the API function call can be performed.

Password

(Required) Password for the specified user name, in clear text. The API encrypts this parameter before sending it to the server.

Locale Information

(Required) String that specifies the language for returning error messages (if a message catalog exists), formatting date and time information, sorting or comparing values, and locale information. The locale information is in the following form:
language[_territory[.codeset]][@modifier]
For example: en_US.ISO8859-15@euro
The string must match the language strings used by the setlocale function. The default is a C or an empty string.

Session ID

Identifier for the session control block, a structure containing all data needed to maintain the state of API operations. Each API session has a unique session control block, created when you initialize the session by calling ARInitialization.

Server

(Required) String specifying the name of the server to connect to.

Authentication String

Client-provided authentication string, such as the domain.


Nearly all function calls require the login and session information that ARControlStruct contains (stored in both single- and multiple-server environments) because the API does not always maintain a server connection between calls.

When a program calls ARInitialization at the beginning of its execution, the BMC Remedy AR System C API returns the data in a ARControlStruct. This is the structure that the program passes as an input parameter in subsequent API calls.

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

Comments