OpenTP1 Version 7 Programming Reference COBOL Language
TXCLOSE - Close a set of resource managers
Format
DATA DIVISION. * Include TX definitions. 01 TX-RETURN-STATUS. COPY TXSTATUS. PROCEDURE DIVISION. CALL "TXCLOSE" USING TX-RETURN-STATUS. |
Description
TXCLOSE closes a set of resource managers in a portable manner. It invokes a transaction manager to read information specific to the resource manager in a manner specific to the transaction manager and pass this information to the resource managers linked to the caller.
TXCLOSE closes all resource managers to which the caller is linked. This function is used in place of close calls specific to the resource manager and allows an application program to be free of calls, which may hinder portability. Since resource managers differ in their termination semantics, the specific information needed to close a particular resource manager must be published by each resource manager.
TXCLOSE should be called when an application thread of control no longer wishes to participate in global transactions. TXCLOSE fails (returning TX-PROTOCOL-ERROR) if the caller is in transaction mode. That is, no resource managers are closed even though some may not be participating in the current transaction.
When TXCLOSE sets success (TX-OK), all resource managers linked to the calling thread are closed.
<<Data areas>>
<<TX-RETURN-STATUS
The results of TXCLOSE execution are returned to this area.>>
Return value
Upon successful completion, TXCLOSE sets TX-OK, a non-negative value. <<0 is returned.>> <<The set of resource managers linked to the TXCLOSE caller is closed.>>
Errors
Under the following conditions, TXCLOSE fails and sets one of these negative values:
See also
TXOPEN.
<<Notes on use with OpenTP1>>
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.