dio_is_rem_lst
status.i4.v = dio_is_rem_lst(list_id.i4.r, remote_status.i4a.r,
errors.i2a.r [,remote_text.i1a.r])
This routine retrieves remote/local status for a list of devices
previously requested by a call to dio_bld_get(_c).
list_id list ID returned from dio_bld_get(_c)
(Note: This value will be set to zero if the
list is deleted.)
remote_status returned array of remote/local status values
(TRUE -> device is in remote,
FALSE -> device is in local,
DIO_NOATT -> remote/local attribute is not defined)
errors returned ACNET status values for each item in list
[remote_text] returned status text ("REM " or "LOC ")
(4 bytes for each device) (default is NULL)
This function returns status values as follows:
OK success
DIO_MEMFAIL memory allocation failure
DIO_NOLIST requested list does not exist
DIO_NOSCALE no status scaling information found
negative value ACNET format error indicating overall failure
positive value number of devices in error indicating partial
success
This function requires the following include files:
diolib_h, acnet_errors_h
Related functions:
dio_bld_get(_c), dio_is_remote(_c), dio_sts_lst, dio_is_on_lst,
dio_is_rdy_lst, dio_is_pos_lst, dio_raw_to_status_c,
dio_raw_to_status_extended_c, dio_extract_read_list_status_c,
error_in_list(_c)
C/C++ usage:
char text[NUM_DEVICES][4];
short errors[NUM_DEVICES];
int status;
int list_id;
int remote_status[NUM_DEVICES];
status = dio_is_rem_lst(&list_id,remote_status,errors,(char *) text);