op_prg_mt_global_unlock()
Abstract
Unlocks the global mutex.
Syntax
op_prg_mt_global_unlock ()
| Argument | Type | Description |
|---|---|---|
| no arguments |
Return Type
Compcode
OPC_COMPCODE_SUCCESS if the global mutex could be unlocked; OPC_COMPCODE_FAILURE otherwise.
Example
/* Unless it is already done, initialize the receiver */
/* channel's state information. */
if (op_ima_obj_state_get (rx_obid) == OPC_NIL)
{
/* Channel state information doesn't exist. Lock */
/* the global mutex before continuing. */
op_prg_mt_global_lock ();
/* Check again, because another thread may have */
/* already set up the state information. */
if (op_ima_obj_state_get (rx_obid) == OPC_NIL)
{
/* Create and set the initial state information */
/* for the receiver channel. */
rxch_state_ptr = (DraT_Rxch_State_Info *)
op_prg_mem_alloc (sizeof (DraT_Rxch_State_Info));
rxch_state_ptr->signal_lock = OPC_FALSE;
op_ima_obj_state_set (rx_obid, rxch_state_ptr);
}
/* Unlock the global mutex. */
op_prg_mt_global_unlock ();
}
Details
None.
Purpose
Provides a way to unlock the global mutex.
Errors
- Recoverable Error: Null mutex pointer
- Recoverable Error: Mutex (
prg_global_mutex) is not locked by this thread
Reference
- Use the KP op_prg_mt_global_lock() to lock the global mutex
- Use the KP op_prg_mt_mutex_unlock() to unlock a specific mutex