IFCMTR (HLI function)

From m204wiki
Revision as of 21:10, 5 July 2016 by ELowell (talk | contribs) (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...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

IFCMTR call -mc

Function

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

Full syntax (105)

IFCMTR(RETCODE)

Compile-only syntax

A compile-only form of IFCMTR is not available.

Execute-only syntax

An execute-only form of IFCMTR is not available.

Parameters

Parameter Description
RETCODE [O,i,r] The Model 204 return code is the only required parameter. The code is a binary integer value.

Notes and tips

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.