dio_sts_lst

	status.i4.v = dio_sts_lst(list_id.i4.r, on.i4a.r, ready.i4a.r,
				  remote.i4a.r, positive.i4a.r, errors.i2a.r
				  [,status_text.sa.r] [ramping.i4a.r])

	This routine retrieves basic status (and text) for a list of devices
	previously requested by a call to dio_bld_get(_c).  The status fields
	are not boolean.  If a given attribute is not defined, a value of
	DIO_NOATT is returned.  If any of the returned attributes are not
	needed, a value of NULL can be passed for that argument.

	list_id		list ID returned from dio_bld_get(_c)
			(Note:  This value will be set to zero if the
			 list is deleted.)
	on		returned array of on/off status values
			(TRUE -> device is on,
			 FALSE -> device is off,
			 DIO_NOATT -> on/off attribute is not defined)
	ready		returned array of ready/tripped status values
			(TRUE -> device is ready,
			 FALSE -> device is tripped,
			 DIO_NOATT -> ready/tripped attribute is not defined)
	remote		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)
	positive	returned array of polarity status values
			(TRUE -> device is in positive mode,
			 FALSE -> device is in negative mode,
			 DIO_NOATT -> polarity attribute is not defined)
	errors		returned ACNET status values for each device in list
	[status_text]	returned status text (DIO_NUM_STATUS_TYPES characters
			of XCHAR format color coded text (XCHAR structures)
			for each device)
	[ramping]	returned array of ramp/DC status values
			(TRUE -> device is ramping,
			 FALSE -> device is DC,
			 DIO_NOATT -> ramp/DC attribute is not defined)

	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:

	cnsparam_h, cns_data_structs_h, diolib_h, acnet_errors_h

	Related functions:

	dio_bld_get(_c), dio_status(_c), dio_raw_to_status_c,
	dio_raw_to_status_extended_c, dio_sts_txt_lst,
	dio_raw_to_status_text, dio_raw_to_status_text_extended_c,
	dio_is_on_lst, dio_is_rdy_lst, dio_is_rem_lst, dio_is_pos_lst,
	dio_extract_read_list_status_c, error_in_list(_c)

	C/C++ usage:

	short	errors[NUM_DEVICES];
	int	status;
	int	list_id;
	int	on[NUM_DEVICES];
	int	ready[NUM_DEVICES];
	int	remote[NUM_DEVICES];
	int	positive[NUM_DEVICES];
	int	ramping[NUM_DEVICES];
	XCHAR	status_text[NUM_DEVICES][DIO_NUM_STATUS_TYPES];

	status = dio_sts_lst(&list_id,on,ready,remote,positive,errors,
			     status_text,ramping);