SetRWLS

NI-488.2

SetRWLS


Purpose

Place devices in Remote With Lockout State.

Format

C

void SetRWLS (int boardID, const Addr4882_t *addrlist)

Visual Basic

CALL SetRWLS (boardID%, addrlist%())

Interactive Control (Usage Notes)

SetRWLS addrlist

Input

boardID The interface number
addrlist List of device addresses that is terminated by NOADDR

Description

SetRWLS places the devices described by addrlist in remote mode by asserting the Remote Enable (REN) GPIB line. Then those devices are placed in lockout state by the Local Lockout (LLO) GPIB message. You cannot program those devices locally until the Controller-In-Charge releases the Local Lockout by way of the EnableLocal call.

Possible Errors

EARG Either an invalid address appears in addrlist or the addrlist is empty; Ibcnt is the index of the first invalid address in the addrlist array.
EBUS No devices are connected to the GPIB.
ECIC The interface is not the Controller-In-Charge; see SendIFC.
EDVR The NI-488.2 driver is either configured incorrectly or is not properly installed.
EHDL boardID is 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.
ESAC The interface is not configured as System Controller.