IBGTS

NI-488.2

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.