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

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

2.7.2 Interactive service time monitoring

Any time monitoring for interactive service communication must follow the value specified in the OpenTP1 definitions.

A timeout error of interactive service occurs when any of the following is expired:

Organization of this subsection
(1) Timeout of maximum response waiting time
(2) Timeout of maximum time interval in permanent connection
(3) Timeout of transaction branch expiration time

(1) Timeout of maximum response waiting time

The CUP and the CUP execution process detect expiration of the maximum response waiting time. For the CUP, specify the value for monitoring in DCWATCHTIM of the client environment definition. For the CUP execution process, specify the watch_time operand of the client service definition.

The value of DCWATCHTIM in the client environment definition must be greater than the value of the watch_time operand of the client service definition to keep consistency of the system. If the CUP detects a timeout error earlier than the CUP execution process, communication is disabled until the dc_rpc_close_s function is issued. In this case, the CUP execution process forcibly rolls back the transaction (only when the transaction is active) after the timeout of maximum time interval in inquiry response, and then disconnects the connection with the CUP.

(2) Timeout of maximum time interval in permanent connection

The CUP execution process detects expiration of the maximum time interval in permanent connection. Specify the value for monitoring in the DCCLTINQUIRETIME of the client environment definition, or in the clt_inquire_time of the client service definition. The priority of the definitions is as follows:

 
Client environment definition > Client service definition
 

The maximum time interval in permanent connection means the maximum time interval between inquiries (including the tpsend function) from the CUP to the CUP execution process.

The CUP execution process that detects a timeout error forcibly rolls back the transaction (only when the transaction is active), and then disconnects the connection with the CUP.

(3) Timeout of transaction branch expiration time

The CUP execution process detects the transaction branch expiration time. Specify the value for monitoring in the DCCLTTREXPTM of the client environment definition, or in the trn_expiration_time of the client service definition. The priority of the definitions is as follows:

 
Client environment definition > Client service definition
 

The transaction branch expiration time means the time between generation of a transaction and synchronous point acquisition.

The CUP execution process that detects a timeout error terminates abnormally. In this case, all connections are forcibly disconnected and the transaction is rolled back.

You can specify to have the system wait infinitely without detecting timeout except for the transaction branch expiration time. The timeout error due to expiration of the transaction branch expiration time will occur regardless of specification in the definitions.