ARGetListApplicationState

Note

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

Retrieves the list of application states (maintenance, test, or production) that an application on this server can assume. This list is server-dependent.

Privileges

All users.

Synopsis

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

int ARGetListApplicationState(
  ARControlStruct *control,
  ARNameList *stateNameList,
  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.

Return values

stateNameList

The list of states an application on this server can assume. There is one entry in the list for every field name on the BMC Remedy AR System Role Mapping from where the field ID resides in the Application State reserved range (2000-2999).

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.