IBWAIT

Board-Level/Device-Level

---

Purpose

Wait for GPIB events.

Format

C

unsigned long ibwait (int ud, int mask)

Visual Basic

CALL ibwait (ud%, mask%)

or

status% = ilwait (ud%, mask%)

Interactive Control (Usage Notes)

ibwait mask

Input

ud	Board or device descriptor
mask	Bit mask of GPIB events to wait for

Output

Function Return

The value of Ibsta

Description

ibwait monitors the events specified by mask and delays processing until one or more of the events occurs. If the wait mask is zero, ibwait returns immediately with the updated Ibsta status word. If TIMO is set in the wait mask, ibwait returns when the timeout period has elapsed, if one or more of the other specified events have not already occurred. If TIMO is not set in the wait mask, the function waits indefinitely for one or more of the specified events to occur. The existing ibwait mask bits are identical to the Ibsta bits. If ud is a device descriptor, the only valid wait mask bits are TIMO, END, RQS, and CMPL. If ud is a board descriptor, all wait mask bits are valid except for RQS. You can configure the timeout period using the ibconfig function (option IbcTMO).

Possible Errors

EARG	The bit set in mask is invalid.
EBUS	Device-level: No devices are connected to the GPIB.
ECIC	Device-level: The access board is not CIC. See Device-Level Calls and Bus Management.
EDVR	The NI-488.2 driver is either configured incorrectly or is not properly installed.
EHDL	ud is invalid or out of range.
ELCK	The requested operation could not be performed because of an existing lock by another process.
ENEB	The interface is not installed or is not properly configured.
ESRQ	Device-level: If RQS is set in the wait mask, ESRQ indicates that the Stuck SRQ condition exists. For more information about serial polling, refer to the Serial Polling Overview.
EWIP	An ibwait call is already in progress on the specified unit descriptor.
ERST	The event notification was cancelled due to a reset of the interface.