Transaction (tRFC & qRFC) API
[Public API]

---

Detailed Description

Functions for sending transactional and queued RFCs into R/3.

Classes
struct	_RFC_TRANSACTION_HANDLE
	Handle to a data container for a tRFC/qRFC LUW. More...
Functions
DECL_EXP RFC_RC SAP_API	RfcGetTransactionID (RFC_CONNECTION_HANDLE rfcHandle, RFC_TID tid, RFC_ERROR_INFO *errorInfo)
	Retrieves a unique 24-digit transaction ID from the backend.
DECL_EXP RFC_TRANSACTION_HANDLE SAP_API	RfcCreateTransaction (RFC_CONNECTION_HANDLE rfcHandle, RFC_TID tid, SAP_UC const *queueName, RFC_ERROR_INFO *errorInfo)
	Creates a container for executing a (multi-step) transactional call.
DECL_EXP RFC_RC SAP_API	RfcInvokeInTransaction (RFC_TRANSACTION_HANDLE tHandle, RFC_FUNCTION_HANDLE funcHandle, RFC_ERROR_INFO *errorInfo)
	Adds a function module call to a transaction.
DECL_EXP RFC_RC SAP_API	RfcSubmitTransaction (RFC_TRANSACTION_HANDLE tHandle, RFC_ERROR_INFO *errorInfo)
	Executes the entire LUW in the backend system as an "atomic unit".
DECL_EXP RFC_RC SAP_API	RfcConfirmTransaction (RFC_TRANSACTION_HANDLE tHandle, RFC_ERROR_INFO *errorInfo)
	Removes the TID contained in the RFC_TRANSACTION_HANDLE from the backend's ARFCRSTATE table.
DECL_EXP RFC_RC SAP_API	RfcDestroyTransaction (RFC_TRANSACTION_HANDLE tHandle, RFC_ERROR_INFO *errorInfo)
	Releases the memory of the transaction container.

---

Function Documentation

DECL_EXP RFC_RC SAP_API RfcConfirmTransaction	(	RFC_TRANSACTION_HANDLE	tHandle,
		RFC_ERROR_INFO *	errorInfo
	)

Removes the TID contained in the RFC_TRANSACTION_HANDLE from the backend's ARFCRSTATE table.

After RfcSubmitTransaction() has finally succeeded, call RfcConfirmTransaction() to clean up the transaction handling table in the backend.

Warning:

Attention: after this call, the backend is no longer protected against this TID. So another RfcSubmitTransaction() with the same transaction handle would result in a duplicate.

Parameters:

[in]	tHandle	A transaction handle that has successfully been submitted.
[out]	*errorInfo	Additional error information in case of a network problem.

Warning:

You may retry the Confirm step, if you get an error here, but do not retry the Submit step!

Returns:

RFC_RC

DECL_EXP RFC_TRANSACTION_HANDLE SAP_API RfcCreateTransaction	(	RFC_CONNECTION_HANDLE	rfcHandle,
		RFC_TID	tid,
		SAP_UC const *	queueName,
		RFC_ERROR_INFO *	errorInfo
	)

Creates a container for executing a (multi-step) transactional call.

If queueName is NULL, tRFC will be used, otherwise qRFC. Use RfcInvokeInTransaction() to add one (or more) function modules to the transactional call. When sending this transactional call to the backend via RfcSubmitTransaction(), the backend will then treat all function modules in the RFC_TRANSACTION_HANDLE as one LUW.

Parameters:

[in]	rfcHandle	Client connection to the backend, into which you want to send this tRFC/qRFC LUW.
[in]	tid	A unique 24 character ID.
[in]	*queueName	For tRFC set this to NULL, for qRFC specify the name of a qRFC inbound queue in the backend.
[out]	*errorInfo	Error information in case there is a problem with the connection.

Returns:

A data container that can be filled with several function modules.

DECL_EXP RFC_RC SAP_API RfcDestroyTransaction	(	RFC_TRANSACTION_HANDLE	tHandle,
		RFC_ERROR_INFO *	errorInfo
	)

Releases the memory of the transaction container.

Parameters:

[in]	tHandle	A transaction handle that is no longer needed.
[out]	*errorInfo	Not much that can go wrong here...

Returns:

RFC_RC

DECL_EXP RFC_RC SAP_API RfcGetTransactionID	(	RFC_CONNECTION_HANDLE	rfcHandle,
		RFC_TID	tid,
		RFC_ERROR_INFO *	errorInfo
	)

Retrieves a unique 24-digit transaction ID from the backend.

Parameters:

[in]	rfcHandle	Client connection to a backend.
[out]	tid	Will be filled with the transaction ID.
[out]	*errorInfo	Error information in case there is a problem with the connection.

Returns:

RFC_RC

DECL_EXP RFC_RC SAP_API RfcInvokeInTransaction	(	RFC_TRANSACTION_HANDLE	tHandle,
		RFC_FUNCTION_HANDLE	funcHandle,
		RFC_ERROR_INFO *	errorInfo
	)

Adds a function module call to a transaction.

Can be used multiple times on one tHandle.

Parameters:

[in]	tHandle	A transaction handle created via RfcCreateTransaction().
[in]	funcHandle	An RFC_FUNCTION_HANDLE, whose IMPORTING, CHANGING and TABLES parameters have been filled.

Note:

that tRFC/qRFC calls have no return values, so the EXPORTING parameters of this function handle will not be filled, nor will the changes to the CHANGING/TABLES parameters be returned.

Parameters:

[out]

*errorInfo

Actually there is nothing that can go wrong here except for invalid handles and out of memory.

Returns:

RFC_RC

DECL_EXP RFC_RC SAP_API RfcSubmitTransaction	(	RFC_TRANSACTION_HANDLE	tHandle,
		RFC_ERROR_INFO *	errorInfo
	)

Executes the entire LUW in the backend system as an "atomic unit".

This step can be repeated until it finally succeeds (RFC_OK). The transaction handling in the backend system protects against duplicates (until you remove the TID from the backend's status tables using RfcConfirmTransaction()).

Parameters:

[in]	tHandle	A transaction handle filled with one or several function modules.
[out]	*errorInfo	Additional error information in case anything goes wrong.

Returns:

RFC_RC