dio_bld_calc_buffer_list_c (ul_calc_device)

	status.i4.v = dio_bld_calc_buffer_list_c(list_id.i4.r, num_devices.i4.v,
						 device_indices.i4a.r,
						 properties.i2a.r,
						 array_indices.u4a.r,
						 convert_type.i2.v,
						 errors.i2a.r
						 [,data_event.i1a.r]
						 [,start_time.u4.v]
						 [,options.u4.v])

	This routine builds a calculation value request list, the values can be
	retrieved by a subsequent call to dio_get_calc_buffer_list_c.

	list_id		returned list ID for use by subsequent data
			retrieval routines
	num_devices	length of list
	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')
	array_indices	index into array device (starts at 0)
	convert_type    calculation type
			(DIO_CALC_TYPE_SIMPLE_AVERAGE -> arithmetic average
			 DIO_CALC_TYPE_PRIMARY_SIMPLE_AVERAGE -> arithmetic
								 average
								 (primary value)
			 DIO_COMMON units only:
			 DIO_CALC_TYPE_INTEGRAL_AVERAGE -> integral average		
			 DIO_CALC_TYPE_INTEGRAL -> integral value of F(x)	
		  	 DIO_CALC_TYPE_INTEGRAL_ABSOLUTE -> integral value of
							    abs(F(x))
			 DIO_CALC_TYPE_RMS  -> Root Mean Square 
			 DIO_CALC_TYPE_INTEGRAL_RMS  -> integral Root Mean Square 
		  	 DIO_CALC_TYPE_STANDARD_DEVIATION -> standard deviation
			 DIO_CALC_TYPE_SPEED_IN_PERCENT -> speed in percentage)		
	errors		array of returned ACNET status values
	[data_event]	data event string (to define the update frequency)
			(default is "p,5000,true")
	[start_time]	start of time interval in seconds
			from now to past (default is 1800 seconds)
	[options]	0, not in use at the moment

	This function returns status values as follows:

	DIO_OK			success
	DIO_BADARG		invalid number of devices passed
	DIO_MEMFAIL		memory allocation failure
	DIO_INVARG		invalid data event string
	DIO_NOTYET		data event value not supported
	DIO_GENERR		generic error
	negative value		other ACNET format error
	positive value		number of devices in error
				indicating partial success

	This function requires the following include files:

	ul_calc_device_h:calclib_h, dbprops_h, diolib_h, acnet_errors_h

	Related functions:

	dio_get_calc_buffer_list_c, dio_can_calc_buffer_list_c,
	dio_get_calc_buffer_device_c, dio_can_calc_buffer_device_c,
	dio_get_calc_value_c, dio_cancel_all_calc_devices

	C/C++ usage:

	static const char	data_event[] = "p,10000,true";
	static const short	properties[NUM_DEVICES] = {PRREAD, PRREAD};
	short	convert_type = DIO_COMMON;
	short	errors[NUM_DEVICES];
	int	status;
	int	list_id;
	int	num_devices = NUM_DEVICES;
	static const int	device_indices[NUM_DEVICES] = {131563, 131564};
	static const unsigned int	array_indices[NUM_DEVICES] = {0,0};
	unsigned int	options = 0;

       status =  dio_bld_calc_buffer_list_c(&list_id,num_devices,
					     device_indices,properties,
					     array_indices,convert_type,
					     errors,data_event,options);