Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (n - r) PUT_BEGINTRANSACTION_EXT_(3)
NAME
PUT_BEGINTRANSACTION_EXT_ - Starts a new transaction associated with the current
process and current thread
LIBRARY
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yputdll
SYNOPSIS
#include <pthread.h>
short PUT_BEGINTRANSACTION_EXT_(
int *transaction-tag
int *timeout
long long *type-flags);
PARAMETERS
transaction_tag
Returns a value that identifies the new transaction among other transaction
identifiers that the calling process has begun. This parameter is optional for
single-threaded requesters, but mandatory for multi-threaded requesters.
timeout (Optional) Specifies the value in seconds that overrides the Auto Abort timer. A
value of 0 (zero) indicates use of the Auto Abort timer. A value of -1 indicates
that the transaction will never time out.
The timeout parameter can have a value in the range -1 through 21474836. The
parameter is optional and if omitted, the configured Auto Abort value is used.
type_flags (Optional) Specifies use of the transaction attribute. The Transaction Typing
parameter is passed by the application to TMF. The parameter is returned from
TMF to the application as a FIXED (64-bit) value, but is treated as a structure
within TMF. This parameter is optional.
DESCRIPTION
This function begins a new transaction associated with the current process and the current thread.
You can use this function with 32-bit applications or 64-bit applications on systems running
H06.24 or later H-series RVUs or J06.13 or later J-series RVUs.
To use this function in a 32-bit application, you must perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library.
To use this function in a 64-bit application, you must perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Compile the application using the -Wlp64 compiler command option.
527187-017 Hewlett-Packard Company 5−77