Guardian Procedure Calls Reference Manual

BINSEM_GETSTATS_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manuals
Summary
The BINSEM_GETSTATS_ procedure returns counter statistics for one or more binary semaphores
for a specified process. Additionally, BINSEM_GETSTATS_ can clear counters and reset the
maximum number of contenders.
NOTE: The BINSEM_GETSTATS_ procedure is supported on systems running H06.25 and later
H-series RVUs and J06.14 and later J-series RVUs.
Syntax for C Programmers
#include <kbinsem.h>
short BINSEM_GETSTATS_ ( binSemPhan_p pHandleP
,binSemID_t semID
,binSemStatOpt_t options
,binSemStats_t _far * statsP
,uint32 statsLen );
Syntax for TAL Programmers
status := BINSEM_GETSTATS_ ( pHandleP ! i
,semID ! i
,options ! i
,statsP ! o
,statsLen ); ! i
Parameters
pHandleP
input
INT .EXT:ref:10
specifies a pointer to the process handle of the target process. In C/C++, this parameter is of
type binSemPhan_p, which can be either a pointer to an NSK_PHandle structure or a pointer
to a short. See the Binary Semaphore Interface Declarations section in the Guardian
Programmer's Guide.
semID
input
INT (32):value
specifies the context semaphore ID. The first call to BINSEM_GETSTATS_ must pass in
BINSEM_STAT_INIT_CONTEXT. Subsequent calls must pass in the BINSEM ID that was returned
in statsP.
BINSEM_GETSTATS_ Procedure 93