BEA Logo BEA Tuxedo Release 7.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy

 

   Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo C Function Reference

AEPisblocked(3c)

Name

AEPisblocked() - determine if a blocking call is in progress

Synopsis

#include <atmi.h>
int far pascal AEPisblocked(void)

Description

AEPisblocked() is an "ATMI Extension for OS/2 Presentation Manager" that allows a OS/2 PM task to determine if it is executing while waiting for a previous blocking call to complete.

Return Values

If there is an outstanding blocking function awaiting completion, AEPisblocked() returns 1. Otherwise, it returns 0.

Errors

No errors are returned.

Portability

This interface is supported only in OS/2 PM clients.

Comments

Although a blocking ATMI call appears to an application as though it "blocks," the OS/2 PM ATMI DLL has to relinquish the processor to allow other applications to run. This means that it is possible for the application which issued the blocking call to be re-entered, depending on the message(s) it receives. In this instance, the AEPisblocked() function can be used to ascertain whether the task has been re-entered while waiting for an outstanding blocking call to complete. Note that ATMI prohibits more than one outstanding call per thread.

See Also

AEMsetblockinghook(3c)