Guardian Procedure Calls Reference Manual

BINSEM_ISMINE_Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Considerations
Example
Summary
The BINSEM_ISMINE_procedure allows an application to query whether it is the current owner of
any of the semaphores it has obtained access to via a call to either the BINSEM_CREATE_procedure
or the BINSEM_OPEN_procedure.
The BINSEM_ISMINE_ procedure takes as its parameter the semaphore ID, returned by either the
BINSEM_CREATE_procedure or the BINSEM_OPEN_ procedure. The result is a Boolean value,
nonzero if this process owns the designated binary semaphore.
NOTE: The BINSEM_ISMINE_ procedure returns information without altering the state of the
binary semaphore. The BINSEM_ISMINE_ procedure is supported on systems running H06.12
and later H-series RVUs and J06.03 and later J-series RVUs.
Syntax for C Programmers
#include <kbinsem.h>
short BINSEM_ISMINE_ ( binSemID_t semID );
Syntax for TAL Programmers
ret-val := BINSEM_ISMINE_ ( semID ); ! i
Parameter
mysemid
INT (32):value
identifies the user semaphore from which the application prompts ownership information.
Returned Value
INT
Result of the query. The result is a Boolean value, nonzero if this process owns the designated
binary semaphore.
Considerations
• The Ismine operation and the state of the binary semaphore
If the binary semaphore is locked by the calling process and the semid is valid, the
BINSEM_ISMINE_ procedure returns a nonzero value.
• For more information about binary semaphores, see General Considerations for Binary
Semaphores (page 89).
BINSEM_ISMINE_Procedure 97