CBL_EVENT_POST

Posts the specified event.

Note: This routine is not supported in JVM COBOL.

Syntax:

call "CBL_EVENT_POST" using by value event-handle

Parameters:

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

On Entry:

event-handle

The event 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 any threads are waiting for the event to be posted in the CBL_EVENT_WAIT call, they are all allowed to run and hence return from their CBL_EVENT_WAIT calls. The call has no effect if the event was already posted. The call returns zero for success.

Behavior is undefined if event-handle is invalid.