IFCMMT (HLI function)

The conventions used on this page are described in Function call notation conventions.

Summary

Description

The IFCMMT call (COMMIT) commits and ends the current update unit for the active thread or threads.

Thread type

multiple cursor IFSTRT, single cursor IFSTRT

IFCALL function number

72

Syntax

IFCMMT(RETCODE)

Compile-only form

Not available

Execute-only form

Not available

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

Usage notes

Use the IFCMMT call to end an update unit. IFCMMT applies to the active threads in a host language job. You can issue the IFCMMT call on the following types of threads:

• Single cursor IFSTRT update thread (thread type is 1)
• Multiple cursor IFSTRT thread

Note: If an IFCMMT call is encountered on a read-only single cursor IFSTRT thread, Model 204 returns an error completion code of 40.

Record locking behavior

IFCMMT releases the lock pending updates (LPU) exclusive lock on updated records and the single record enqueue (SRE) on the current record (if one exists) that were obtained by this thread. The transaction is ended for all participating threads and the backout and constraints logs are freed.

Found sets are not released and the current record does not change. In a multithreaded transaction the LPU and SRE locks obtained by other threads are still held. Also, you must issue IFCMMT on all of the single cursor IFSTRT threads participating in a multi-transaction if you issue the call on any one of the threads.

For more information about transaction management, see HLI: Transactions.

Coding example (COBOL)

WORKING-STORAGE SECTION. 01 ARGS-FOR-CALL. 05 RETCODE PIC 9(5) COMP SYNC. . . . PROCEDURE DIVISION. . . . CALL "IFCMMT" USING RETCODE.