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

	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];

	status = dio_sts_lst(&list_id,on,ready,remote,positive,errors,