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

OSS Library Calls (s) SPT_BEGINTRANSACTION_EXT_(3)
NAME
SPT_BEGINTRANSACTION_EXT_ - Starts a new transaction associated with the current
process and current thread
LIBRARY
H-series and J-series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
#include <spthread.h>
short SPT_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.
RETURN VALUES
A status word is returned. The value is one of the following:
0 (zero) The SPT_BEGINTRANSACTION_EXT_( ) operation completed successfully.
Nonzero values
The Guardian file-system error with this error number occurred.
RELATED INFORMATION
Functions: SPT_BEGINTRANSACTION(3).
527187-017 Hewlett-Packard Company 6−91