IBGTS
Board-Level
Purpose
Go from Active Controller to Standby.
Format
C
unsigned long ibgts (int ud, int v)
Visual Basic
CALL ibgts (ud%, v%)
or
status% = ilgts (ud%, v%)
Interactive Control (Usage Notes)
ibgts v
Input
ud | Board descriptor |
v | Determines whether to perform acceptor handshaking |
Output
Function Return | The value of Ibsta |
Description
ibgts causes the GPIB interface at ud to go to Standby Controller and the GPIB ATN line to be unasserted. If v is non-zero, acceptor handshaking or shadow handshaking is performed until END occurs or until ATN is reasserted by a subsequent ibcac call. With this option, the GPIB interface can participate in data handshake as an acceptor without actually reading data. If END is detected, the interface enters a Not Ready For Data (NRFD) handshake holdoff state which results in hold off of subsequent GPIB transfers. If v is 0, no acceptor handshaking or holdoff is performed.
Before performing an ibgts with shadow handshake, call the IbcEOS option in ibconfig to establish proper EOS modes.
For details on the IEEE 488.1 handshake protocol, refer to the ANSI/IEEE Standard 488.1-1987, IEEE Standard Digital Interface for Programmable Instrumentation and ANSI/IEEE Standard 488.1-2003, IEEE Standard for Higher Performance Protocol for the Standard Digital Interface for Programmable Instrumentation.
Possible Errors
EADR | v is non-zero, and either ATN is low or the interface is a Talker or a Listener. |
ECIC | The interface is not Controller-In-Charge. |
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. |
EOIP | Asynchronous I/O is in progress. |