OpenTP1 Version 7 Programming Guide

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

5.2.4 Comparison with transaction control functions of OpenTP1 (dc_trn_ ~)

Organization of this subsection
(1) Correspondence between TX_ functions and transaction control functions of OpenTP1 (dc_trn_ ~)
(2) Time monitoring with TX_ function

(1) Correspondence between TX_ functions and transaction control functions of OpenTP1 (dc_trn_ ~)

The table below shows the relationship between TX_ functions and transaction control functions of OpenTP1 (dc_trn_ ~).

Table 5-8 Relationship between TX_ functions and transaction control functions of OpenTP1 (dc_trn_ ~)

TX_ function name OpenTP1 transaction control function (dc_trn_ ~)
tx_begin() dc_trn_begin()
tx_close() No corresponding function
tx_commit() (TX_CHAINED specified) dc_trn_chained_commit()
tx_commit()
(TX_UNCHAINED specified)
dc_trn_unchained_commit()
tx_info() dc_trn_info()
tx_open() No corresponding function
tx_rollback()
(TX_CHAINED specified)
dc_trn_chained_rollback()
tx_rollback()
(TX_UNCHAINED specified)
dc_trn_unchained_rollback()
tx_set_commit_return() No corresponding function
tx_set_transaction_control() No corresponding function
tx_set_transaction_timeout() No corresponding function

(2) Time monitoring with TX_ function

Elapsed time of a transaction can be monitored with tx_set_transaction_timeout(). In this case, the transaction_timeout characteristic set by tx_set_transaction_timeout() has priority over the value of trn_expiration_time defined by the system.

(a) Range of time monitoring

For time monitoring from tx_begin() to the synchronization point (tx_commit() or tx_rollback()), the following can be selected:

Whether or not the time until the function dc_rpc_call() called in the transaction returns is to be included. The range of transaction monitoring time can be specified by trn_expiration_time_suspend in the user service definition, user service default definition, or transaction service definition. For details on the value to be assigned to trn_expiration_time_suspend and transaction time monitoring, see the manual OpenTP1 System Definition.