dio_build_ftp_list_c

	status.i4.v = dio_build_ftp_list_c(list_id.i4.r, num_devices.i4.v,
					   device_indices.i4a.r,
					   properties.i2a.r, rate.u4.v,
					   reference_event.i4.v, errors.i2a.r
					   [,options.u4.v]
					   [,array_indices.i4a.r])

	This routine builds a request for fast time plot data for a list
	of devices.  This data can be retrieved by subsequent calls to
	dio_get_ftp_list_c.  This routine should be called frequently
	since data will be streaming in from the front end(s) constantly at
	about a 2 Hz rate.

	list_id		returned list ID (used to retrieve data)
	num_devices	number of devices in list
	device_indices	list of device indices
	properties	list of property indices (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)
	rate		data acquisition rate in Hz
	reference_event	event to reference timestamps to
			(If a value of EVENT_NULL is supplied, timestamps
			 will be absolute.  A value of EVENT_MI_RESET can
			 be used to reference the timestamps to any Main
			 Injector reset.)
	errors		array of returned ACNET status values
	[options]	request options (not used)
			(default is DIO_FTP_OPT_NONE)
	[array_indices]	array of array indices to return (starting at 0)
			(Note: If the first value is less than zero, all
			 devices will be submitted with the array index
			 requested equal to the absolute value of that value.)
			(If a value of NULL is passed for this argument,
			 an array index of 0 will be used for each device.)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_BADARG		invalid number of devices
	DIO_INVALID_RATE	requested rate exceeds the capability of at
				least one requested device
	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, dbprops_h, diolib_h, acnet_errors_h, tclk_events_h

	Related functions:

	dio_get_ftp_list_c, dio_get_raw_ftp_list_c, dio_get_status_ftp_list_c,
	dio_cancel_ftp_list_c, dio_can_read_using_ftp_c, dio_can_ftp_c,
	dio_ftp_class_info_c, dio_build_snapshot_list_c,
	dio_get_snapshot_list_c, dio_get_raw_snapshot_list_c,
	dio_cancel_snapshot_list_c, dio_rearm_snapshot_list_c,
	dio_can_read_using_snapshot_c, dio_can_snapshot_c,
	dio_can_trigger_snapshot_c, sr_sda_get_ftp_list_c,
	sr_sda_get_raw_ftp_list_c, error_in_list(_c)

	C/C++ usage:

	short	properties = -PRREAD;
	short	errors[NUM_DEVICES];
	int	status;
	int	list_id;
	int	num_devices = NUM_DEVICES;
	static const int	device_indices[NUM_DEVICES] = {7085, 7046};
	int	rate = 200;
	int	reference_event = EVENT_NULL;
	int	*array_indices = (int *) NULL;
	unsigned int	options	 = 0;

	status = dio_build_ftp_list_c(&list_id,num_devices,device_indices,
				      &properties,rate,reference_event,errors,
				      options,array_indices);