call "CBL_MONITOR_READ" using by value monitor-handle


  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.


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.