OpenTP1 Version 7 TP1/Client User's Guide TP1/Client/W, TP1/Client/P

[Contents][Index][Back][Next]

4.5.4 dc_trn_unchained_commit_s - Commit in unchained mode

Organization of this subsection
(1) Form
(2) Purpose
(3) Arguments set by UAPs
(4) Return values
(5) Notes

(1) Form

(a) _s version of the function
 
#include <dcvtrn.h>
DCLONG dc_trn_unchained_commit_s(DCCLT_ID cltid)
 
(b) Non-_s version of the function
 
#include <dcvtrn.h>
DCLONG dc_trn_unchained_commit()
 

(2) Purpose

Acquires the synchronous point of a transaction.

When the dc_trn_unchained_commit_s function terminates normally, the global transaction also terminates. No SPP can be executed as a transaction from outside the global transaction.

(3) Arguments set by UAPs

(4) Return values

Return Value Value (decimal) Meaning
DC_OK 0 Normal termination
DCCLTER_PROTO -2502 The function has been issued from an invalid context (for example, from outside a transaction).
DCCLTER_NO_BUFS -2504 Insufficient memory
DCCLTER_NET_DOWN -2506 Network error
DCCLTER_TIMED_OUT -2507 Timeout occurred during the dc_trn_unchained_commit_s function processing.
DCCLTER_OLTF_NOT_UP -2515 OpenTP1 has not been activated.
Alternatively, communication is impossible because the TP1/Client is disconnected from the server.
DCCLTER_NO_BUFS_AT_SERVER -2517 Memory became insufficient in a transaction process.
DCCLTER_SYSERR -2518 System error
DCCLTER_CONNFREE -2542 The permanent connection has been released.
DCCLTER_INVALID_CLTID -2544 The client ID specified for cltid differs from the one received by the dc_clt_cltin_s function.
DCTRNER_ROLLBACK -3402 Transaction was rolled back because it failed to be committed.
After this return value is returned, the process will be outside the global transaction.
DCTRNER_HEURISTIC -3403 Some or all transaction branches were rolled back with heuristic determination. See details on the message log file.
After this return value is returned, the process is outside the global transaction.
DCTRNER_HAZARD -3404 Transaction terminated with heuristic determination, but its result was not apparent because of the error. See details on the message log file. After this return value is returned, the process is outside the global transaction.

(5) Notes

To terminate a CUP process normally, issue the dc_trn_unchained_commit_s function to commit the transaction.