dio_insert_reqlst

	status.i4.v = dio_insert_reqlst(device_indices.i4a.r, properties.i2a.r,
					num_devices.i4.r, errors.i2a.r
					[,ftds.i2a.r] [,lengths.i2a.r]
					[,offsets.i2a.r])

	This routine requests data for a list of devices to be read by
	subsequent calls to dio_get_raw(_c).  This allows the programmer
	to request a list of devices in an efficient fashion while
	allowing flexibility in the reading of the data.

	device_indices	list of device indices
	properties	list of property indices
			(If the first value is less than zero, all devices
			 will be requested with a property index which is
			 equal to the absolute value of this argument.)
			(constants are in 'dbprops')
	num_devices	number of devices
	errors		array of returned ACNET status values
	[ftds]		Frequency Time Descriptors
			(FTD_ONESHOT -> one shot (default),
			 FTD_DEFAULT -> use database default FTD,
			 FTD_1HZ -> 1 Hz request (Note: This value can be
				    multiplied by an integer constant to
				    retrieve data every "constant" seconds.),
			 FTD_EVENT_MASK OR'ed with TCLK event value -> read
			 on TCLK event (event constants are in 'tclk_events')
			 (can use the macro BUILD_EVENT_FTD(event) or
			  BUILD_EVENT_PLUS_DELAY_FTD(event,delay) in 'macro'))
	[lengths]	data lengths in bytes
			(default is database minimum size for each device (0))
	[offsets]	data offsets in bytes (default is 0 (0))

	This function returns ACNET status values as follows:

	OK			success
	DIO_BADARG		invalid number of devices passed
	DIO_MEMFAIL		memory allocation failure
	DIO_UNAVAIL		not valid in this context (MIO in use)
	negative value		other ACNET format error

	This function requires the following include files:

	dbprops_h, diolib_h, acnet_errors_h, tclk_events_h, macro_h

	Related functions:

	dio_get_raw(_c), dio_get_dev(_c), error_in_list(_c)

	C/C++ usage:

	short	errors[NUM_DEVICES];
	short	properties = -PRSET;
	static const short	ftds[NUM_DEVICES] = {FTD_1HZ, FTD_1HZ};
	static const short	lengths[NUM_DEVICES] = {0, 0};
	static const short	offsets[NUM_DEVICES] = {0, 0};
	int	status;
	int	num_devices = NUM_DEVICES;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};

	status = dio_insert_reqlst(device_indices,&properties,&num_devices,
				   errors,ftds,lengths,offsets);