Previous Topic Next topic Print topic


CBL_MUTEX_ACQUIRE

Acquires a mutex for the specified thread.
Note: This routine is not supported in JVM COBOL.

Syntax:

call "CBL_MUTEX_ACQUIRE" using by value mutex-handle
                               by value nowait-flag

Parameters:

  Using call prototype (see Key) Picture
mutex-handle cblt-pointer. usage pointer.
nowait-flag cblt-os-flags. pic x(4) comp-5

or

pic x(8) comp-5 (64-bit native programs only)

On Entry:

mutex-handle
Mutex handle
nowait-flag
A number that determines what happens if the mutex cannot be acquired immediately:
Bit 0
0 The routine blocks the thread/process until the mutex can be acquired .
1 The routine returns immediately with a non-zero return value.
Remaining bits
Reserved. Must be set to zero.

On Exit:

return-code
A value of 0 indicates that the call was successful. Any other value indicates an error. See RETURN-CODE Values For Synchronization Routines.

Comments:

Behavior is undefined if mutex-handle is invalid.

Previous Topic Next topic Print topic