ATMI C Function Reference
tpgblktime()
—Retrieves a previously set, per second, blocktime value
#include <atmi.h>
inttpgblktime(TPBLK_NEXT
,TPBLK_ALL
long flags)
tpgblktime()
retrieves a previously set, per second, blocktime value.
If tpgblktime()
specifies a blocktime flag value, and no such flag
value has been set, the return value is 0. A blocktime flag value less than 0 produces an error.
The following is a list of valid flags:
Note: When a workstation client calls a tpgblktime()
0
flag, the system-wide default blocktime value cannot be returned. A 0 value is returned instead.
Upon success, tpgblktime()
returns a positive integer indicating the blocking time value currently in effect for the corresponding flag value. A 0 return value indicates that no such blocking time override is currently in effect.
This function returns -1 on error and sets tperrno
to indicate the error condition. The failure does not affect the existing transaction, if one exists.
Upon failure, tpgblktime()
sets tperrno
to one of the following values:
Invalid arguments were given. For example, the flags
value is negative or more than one blocktime flag value (TPBLK_NEXT
, TPBLK_ALL
, or 0)
was specified.
tpcall(3c), tpcommit(3c), tprecv(3c), tpsblktime(3c), UBBCONFIG(5)