CBL_MONITOR_READ

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

Syntax:
call "CBL_MONITOR_READ" using by value monitor-handle
Parameters:
Using call prototype (see Library Routines - Key) Picture (32-bit systems)
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.

See Also: