IFCMTR (HLI function): Difference between revisions
Jump to navigation
Jump to search
(Created page with "==IFCMTR call -mc== ===Function=== <dl> <dt>Description</dt> <dd>The IFCMTR call (COMMIT RELEASE) releases all record sets held by the thread and commits the current transact...") |
No edit summary |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
The conventions used on this page are described in [[HLI: Function summary#Function call notation conventions|Function call notation conventions]]. | |||
== | ==Summary== | ||
<dl> | <dl> | ||
<dt>Description</dt> | <dt>Description</dt> | ||
<dd>The IFCMTR call (COMMIT RELEASE) releases all record sets held by the thread and commits the current transaction.</dd> | <dd>The IFCMTR call (COMMIT RELEASE) releases all record sets held by the thread and commits the current transaction.</dd> | ||
<dt>Thread type</dt> | <dt>Thread type</dt> | ||
<dd>multiple cursor IFSTRT</dd> | <dd>multiple cursor IFSTRT</dd> | ||
<dt>IFCALL function number</dt> | <dt>IFCALL function number</dt> | ||
<dd>105</dd> | |||
</dl> | |||
== | ==Syntax== | ||
<p class="syntax">IFCMTR(RETCODE)</p> | <p class="syntax">IFCMTR(RETCODE)</p> | ||
<dl> | |||
<dt>Compile-only form</dt> | |||
<dd>Not available</dd> | |||
<dt>Execute-only form</dt> | |||
<dd>Not available</dd> | |||
</dl> | |||
<table> | <table> | ||
<tr class="head"> | <tr class="head"> | ||
| Line 34: | Line 31: | ||
</table> | </table> | ||
== | ==Usage notes== | ||
<p> | <p> | ||
Use the IFCMTR call to end the current transaction and release all records. The IFCMTR call is the equivalent of the SOUL COMMIT RELEASE statement in the host language multiple cursor environment. For more information, see [[Files, groups, and reference context#Using COMMIT and COMMIT RELEASE statements|Using COMMIT and COMMIT RELEASE statements]].</p> | Use the IFCMTR call to end the current transaction and release all records. The IFCMTR call is the equivalent of the SOUL COMMIT RELEASE statement in the host language multiple cursor environment. For more information, see [[Files, groups, and reference context#Using COMMIT and COMMIT RELEASE statements|Using COMMIT and COMMIT RELEASE statements]].</p> | ||
| Line 40: | Line 37: | ||
To ensure that all of the records and resource locks associated with a transaction are released after the IFCMTR call executes on one of the single cursor IFSTRT threads in a multithreaded transaction, issue IFCMTR on all of the other single cursor IFSTRT threads participating in the transaction.</p> | To ensure that all of the records and resource locks associated with a transaction are released after the IFCMTR call executes on one of the single cursor IFSTRT threads in a multithreaded transaction, issue IFCMTR on all of the other single cursor IFSTRT threads participating in the transaction.</p> | ||
==Coding example (COBOL)== | |||
<p class="code">WORKING-STORAGE SECTION. | <p class="code">WORKING-STORAGE SECTION. | ||
01 CALL-ARGS. | 01 CALL-ARGS. | ||
| Line 52: | Line 49: | ||
. | . | ||
CALL "IFCMTR" USING RETCODE.</p> | CALL "IFCMTR" USING RETCODE.</p> | ||
[[Category: HLI functions]] | |||
Latest revision as of 22:07, 12 July 2016
The conventions used on this page are described in Function call notation conventions.
Summary
- Description
- The IFCMTR call (COMMIT RELEASE) releases all record sets held by the thread and commits the current transaction.
- Thread type
- multiple cursor IFSTRT
- IFCALL function number
- 105
Syntax
IFCMTR(RETCODE)
- Compile-only form
- Not available
- Execute-only form
- Not available
| Parameter | Description |
|---|---|
| RETCODE | [O,i,r] The Model 204 return code is the only required parameter. The code is a binary integer value. |
Usage notes
Use the IFCMTR call to end the current transaction and release all records. The IFCMTR call is the equivalent of the SOUL COMMIT RELEASE statement in the host language multiple cursor environment. For more information, see Using COMMIT and COMMIT RELEASE statements.
To ensure that all of the records and resource locks associated with a transaction are released after the IFCMTR call executes on one of the single cursor IFSTRT threads in a multithreaded transaction, issue IFCMTR on all of the other single cursor IFSTRT threads participating in the transaction.
Coding example (COBOL)
WORKING-STORAGE SECTION. 01 CALL-ARGS. 05 RETCODE PIC 9(5) COMP SYNC. . . . PROCEDURE DIVISION. . . . CALL "IFCMTR" USING RETCODE.