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.


Creates an overlay for a specified object, and sets the following information:

  • Name of the overlay object.
  • Type of overlaid object (active link, form, menu, and so on)
  • (Views and fields only) ID of the overlay object
  • (Views and fields only) Name of the form associated with the overlaid object
  • Overlay characteristics (from the inheritMask and extendMask object properties of the AROverlaidStruct parameter)

For more information about overlays, see About overlays.


BMC Remedy AR System administrator


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

int ARCreateOverlay(
   ARControlStruct *control
   AROverlaidStruct *overlaid
   Char objectModificationLogLabel
   ARNameType name
   ARInternalID *overlayID
   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, server, and overlayGroup fields are required.


To specify the overlay group, use the AR_SESS_CONTROL_PROP_DESIGN_ OVERLAYGROUP variable of the ARSetSessionConfiguration function (see ARSetSessionConfiguration). If that variable is set to a valid overlay group, this function creates an overlay object that belongs to that group.


Information about the object to be overlaid, including its type (active link, form, menu, and so on).


Version control label associated with an object in the object modification log. For more information, see Labeling a collection of objects.

Return values


Real name of the overlay object created by this function. The name is composed of the name of the overlaid object plus the suffix__o:

See Overlay object names


ID number of the overlay object if the overlaid object is a form view or a field.


A list of zero or more notes, warnings, or errors generated from a call to this function. See Error checking for a description of all possible values.

See also


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