This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

CMDBSetInstance function

The CMDBSetInstance function sets attribute values for a CI or relationship instance of the specified class.

Synopsis


#include "ar.h"
#include "arextern.h"
#include "cmdb.h"

int CMDBSetInstance(
      ARControlStruct *control,
      CMDBClassNameId *classNameId,
      ARNameType datasetId,
      ARNameType instanceId,
      CMDBAttributeValueList *attributeValueList,
      ARStatusList *status)

Input arguments



Input argument

Description

control

The control record for the operation, which contains information about the user requesting the operation and the server on which the operation is to be performed.

classNameId

The name of the class to which the instance to set belongs. The classNameID argument contains the namespace name and the unique class name.

datasetId

The unique identifier for the dataset. Instances in a dataset are modified based on the dataset ID specified in this parameter.

instanceId

The unique identifier for the instance (system-generated).

attributeValueList

A list of one or more attribute and value pairs (specified in any order) that identifies the data for the new attribute. You must specify values for all required attributes that do not have defaults defined. Values must be of the data type defined for the attributes or have a data type of 0. NULL values can be specified for optional attributes only. An error is generated if an attribute does not exist or the user specified by the control parameter does not have write permission for an attribute.

Return value



Return value

Description

status

A list of zero or more notes, warnings, or errors generated from a call of this function.

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

Comments