beautypg.com

Ibonl, Ibonl -29 – Measurement Computing GPIB-488 User Manual

Page 42

background image

Chapter 3

GPIB 488.1 Library Reference

GPIB-488

3-29

Programming Reference Manual

IBONL

Enables/Disables a device/interface board for operation.

Syntax

C

ibonl (int boarddev, int online)

Parameters

boarddev

is an integer containing the device/board handle.

online

defines whether the device/board is to be enabled/disabled. If

online

is non-zero,

the device/board is enabled for operation (placed on-line). This restores the board/device to
its default settings. Otherwise, the board/device is placed off-line.

Returns

ibsta

will contain a 16-bit status word as described in Appendix B,

IBSTA

.

iberr

will contain an error code, if an error occurred.

Usage Notes

When a device is placed off-line, it is "closed". This means that in order to perform any other
operations with this device, you will need to re-open it by calling the

ibfind

or

ibdev

routine.

Example

This example restores the configuration of a device at PAD 1.

C

int Dev;

Dev = ibdev (0,1,0,13,1,0);

ibonl (Dev, 1);