CBL_MONITOR_READ

Acquires the specified monitor's read capability for the current thread/process, blocking until that capability can be acquired.

Note: This routine is not supported in JVM COBOL.

Syntax:

call "CBL_MONITOR_READ" using by value monitor-handle

Parameters:

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

On Entry:

monitor-handle

A monitor name.

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 monitor-handle is invalid.