HP-UX

NAME

ivxiws − sends a word-serial command to a VXI device

SYNOPSIS

#include <sicl.h>
int ivxiws(
           INST id,
           unsigned short wscmnd,
           unsigned short *wsresp,
           unsigned short *rpe
          );

DESCRIPTION

ivxiws sends the word-serial command specified by wscmd to the VXI device corresponding to this device session. If *wsresp contains ((unsigned short *)0), then no word serial response is read. If *wsresp points to an unsigned short, then a word serial response will be read and stored into that variable. 

id is an INST identifier of an iopen VXI device file obtained from an iopen(3) call.  This routine only works on device sessions. 

RETURN VALUE

ivxiws returns (0) for success and a non-zero error code otherwise. 

If the routine returns a (0) (good complete), then the word-serial command completed successfully and the *rpe parameter will contain garbage. 

If this routine returns the error I_ERR_IO, then the remote device generated a word-serial error. In this case, the *wsresp parameter will be garbage, and the *rpe parameter will contain the response of a Read Protocol Error word-serial command. If the *rpe parameter contains ((unsigned short *)0), then the Read Protocol Error response is discarded. 

ERRORS

ivxiws fails under the following circumstances, and sets the return value to one of the following:
 

­[I_ERR_BADID] id does not refer to an open INST, or a valid VXI INST id. 

­[I_ERR_IO] remote device generated a word-serial error (see above). 

­[I_ERR_PARAM] parameter contains an invalid value. 

­[I_ERR_BADADDR] id refers to a device that is not present, or is not a message-based device. 

­[I_ERR_TIMEOUT] A timeout occured. 
 

SEE ALSO

igeterrno(3), igeterrstr(3)
 

AUTHOR

ivxiws was developed by HP. 

Hewlett-Packard Company  —  September 29, 1999