CBL_MONITOR_RELEASE

Releases any lock currently applied to the specified monitor by CBL_MONITOR_WRITE, CBL_MONITOR_READ or CBL_MONITOR_BROWSE.

Note: This routine is not supported in JVM COBOL.

Syntax:

call "CBL_MONITOR_RELEASE" using by value monitor-handle

Parameters:

	Using call prototype (see Key)	Picture
`monitor-handle`	cblt-pointer	usage pointer.

On Entry:

monitor-handle

The monitor handle.

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:

If the thread terminates abnormally, all monitors acquired by that thread are released. If the thread terminates normally with monitors acquired, then either these are released or a run-time system error is given, depending on the flag setting when the thread was created with CBL_THREAD_CREATE.

Behavior is undefined if either monitor-handle is invalid or no previous lock was obtained by this thread on the specified monitor.