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.


Sets the application state (maintenance, test, or production) in the BMC Remedy AR System Application State form.

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.


All users.


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

int ARSetApplicationState(
   ARControlStruct *control,
   ARNameType applicationName,
   ARNameType stateName,
   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 name of the application.


The value for the state field, currentStateName, on the BMC Remedy AR System Application State form. There is one entry per application.

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

ARGetApplicationState, ARGetListApplicationState.

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