Visible to Intel only — GUID: GUID-94648E28-1182-40C0-B8DC-5F650F5DB19E
Visible to Intel only — GUID: GUID-94648E28-1182-40C0-B8DC-5F650F5DB19E
EVENT_QUERY
Intrinsic Subroutine (Generic): Queries the event count of an event variable.
Syntax
CALL EVENT_QUERY (event, count [, stat])
event |
(Input) Must be an event variable of type EVENT_TYPE, and must not be coindexed. The event variable is accessed atomically with respect to the execution of EVENT POST statements in unordered segments, in exact analogy to atomic subroutines. |
count |
(Output) Must be an integer scalar with a decimal range no smaller than that of default integer. If no error condition occurs, count is assigned the value of the count of event, otherwise it is assigned the value -1. |
stat |
(Output; optional) Must be an integer scalar with a decimal exponent range of at least four. It must not be coindexed. If the stat argument is present, it is assigned a processor-dependent positive value if an error condition occurs, or zero if no error occurs. If an error occurs and stat is not present, error termination is initiated. |
Example
Consider the following example:
CALL EVENT_QUERY (EVENT, COUNT)
If there have been six successful posts to EVENT, and 3 successful waits that did not specify UNTIL_COUNT= in the preceding segments, the variable COUNT will have the value 3. If there have been no successful posts or waits in the preceding segments, COUNT will have the value 0.