ARBeginClientManagedTransaction

Important

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

Enables you to start a client-managed database transaction. This function returns the transaction handle that other control records can use and allows both AR System and BMC Helix CMDB calls to be made in the same transaction.

Before using client-managed transaction functions, set the maximum number of client transactions and the transaction timeout parameters in one of the following ways:

Update the Maximum Concurrent Transactions and Transaction Timeout on the Advanced tab of the Server Information form. (See Setting-performance-and-security-options.)
Set the Client-Managed-Transaction-Timeout and Maximum-Concurrent-Client-Managed-Transactions options in the AR System Administration: AR System Configuration Generic UI form.

Synopsis

#include "ar.h"
#include "arextern.h"
int ARBeginClientManagedTransaction(
ARControlStruct*control,
char*transactionHandle,
ARStatusList*status)

Input arguments

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.

Return values

transactionHandle

The transaction handle ID of the database transaction.

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.