dio_build_set_array_list_c

	status.i4.v = dio_build_set_array_list_c(list_id.i4.r, num_devices.i4.v,
						 device_indices.i4a.r,
						 properties.i2a.r, errors.i2a.r,
						 num_elements.i4a.r,
						 start_elements.i4a.r)

	This routine builds a list of setting requests for array devices for
	later setting with dio_set_lst or dio_set_device_list_c.
	In general, lists should be segregated into setting lists and basic
	control lists.  Do not use this routine for table devices (ramp cards,
	etc).  Use the routine td_build(_c) instead.

	list_id		returned list ID for subsequent use by dio_set_lst
	num_devices	number of devices
	device_indices	device index array
	properties	device property array (If the first value is less
			than zero, all devices will be submitted with the
			same property.  The property value used will be the
			absolute value of this argument.)
			(constants are in 'dbprops')
			(PRSET -> setting property,
			 PRBCTL -> basic control property)
	errors		array of returned ACNET status values
			(one for each device in the list)
	num_elements	array of number of array elements to set (>= 1)
			(Note: If the first value is less than zero, all
			 devices will be submitted with the number of elements
			 requested equal to the absolute value of that value.)
			(If a value of NULL is passed for this argument,
			 the entire array for each device will be set.)
	start_elements	array of first elements to set (starting at 0)
			(Note: If the first value is less than zero, all
			 devices will be submitted with the starting element
			 requested equal to the absolute value of that value.)
			(If a value of NULL is passed for this argument,
			 an offset of 0 will be used for each device.)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVDEV		at least one entry is not a valid array device
	DIO_BADARG		invalid number of elements or starting element
	negative value		other ACNET format error
	positive value		number of devices in error

	This function requires the following include files:

	dbprops_h, diolib_h, acnet_errors_h, tclk_events_h

	Related functions:

	dio_bld_set(_c), dio_set_lst, dio_set_device_list_c,
	dio_build_get_array_list_c, dio_get_device_list_c,
	dio_set_array_device_c, dio_can_set_lst,
	dio_bld_set_raw(_c), dio_set_dev(_c), dio_set_raw(_c),
	td_build(_c), error_in_list(_c)

	C/C++ usage:

	short		errors[NUM_DEVICES];
	short		properties = -PRSET;
	int		status;
	int		list_id;
	int		num_devices = NUM_DEVICES;
	static int	device_indices[NUM_DEVICES] = {14430, 14431};
	static int	num_elements[NUM_DEVICES] = {1, 1};
	static int	start_elements[NUM_DEVICES] = {0, 0};

	status = dio_build_set_array_list_c(&list_id,num_devices,
					    device_indices,&properties,
					    errors,num_elements,
					    start_elements);