IBONL

NI-488.2

IBONL

Board-Level/Device-Level


Purpose

Place the device or interface online or offline.

Format

C

unsigned long ibonl (int ud, int v)

Visual Basic

CALL ibonl (ud%, v%)

or

status% = ilonl (ud%, v%)

Interactive Control (Usage Notes)

ibonl v

Input

ud Board or device descriptor
v Indicates whether the board or device is to be placed online or offline

Output

Function Return The value of Ibsta

Description

ibonl resets the board or device and places all its software configuration parameters in their pre-configured state. In addition, if v is zero, the device or interface is placed offline. If v is non-zero, the device or interface is left operational, or online.

If a device or an interface is taken offline, the board or device descriptor (ud) is no longer valid. You must execute an ibdev or ibfind to access the board or device again.

Possible Errors

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.