sr_sda_get_snapshot_list_c

	status.i4.v = sr_sda_get_snapshot_list_c(num_devices.i4.v,
						 device_indices.i4a.r,
						 properties.i2a.r,
						 array_indices.u4a.r,
						 sda_usage.i1a.r,
						 file_number.i4.v,
						 case_number.i4.v,
						 subcase_number.i4.v,
						 max_points.i4.v,
						 num_points.i4a.r,
						 points.sa.r, errors.i2a.r
						 [,data_events.sa.r])

	This routine retrieves snapshot plot data for a list of devices
	from an SDA save set.

	num_devices	number of devices
	device_indices	device index or array of device indices
	properties	property index or array 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	array index or array of array indices
	sda_usage	null terminated SDA usage string
	file_number	file (shot) number from which to retrieve data
	case_number	SDA case number
	subcase_number	SDA subcase (set) number
	max_points	maximum number of points to return per device
	num_points	returned array of number of valid points per device
	points		returned data points  (allow "max_points" per device)
			(array of structures of type SDA_SNAPSHOT_POINT)
	errors		array of ACNET status values
	data_events	returned data events on which the plots were taken
			(array of DATA_EVENT_DATA structures)
			(default is NULL)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_NOLIST		requested list does not exist
	DIO_BADARG		invalid number of points requested
	DIO_PEND		no new data is available
	DIO_TIMEOUT		no data has returned from a front end
				in the timeout period, list cancelled
	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, cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	sr_sda_get_raw_snapshot_list_c, sr_sda_get_snap_num_points_list_c,
	sr_sda_get_ftp_list_c, sr_sda_get_raw_ftp_list_c,
	sr_sda_get_ftp_num_points_list_c, sr_get_array_device_c,
	sr_sda_cases_present_c, sr_sda_num_subcases_c,
	sr_sda_subcases_present_c, sr_sda_case_times_c,
	dio_get_snapshot_list_c, dio_build_snapshot_list_c,
	dio_cancel_snapshot_list_c, dio_can_snapshot_c,
	dio_snapshot_class_info_c

	C/C++ usage:

	satic const char	sda_usage[] = "ColliderShot";
	short	properties = -PRREAD;
	short	errors[NUM_DEVICES];
	int	status;
	int	num_devices = NUM_DEVICES;
	int	device_indices[NUM_DEVICES] = {27235};
	int	file = 6216;
	int	case_number = SDA_CASE_CS_ACCELERATION;
	int	subcase_number = 0;
	int	max_points = MAX_POINTS;
	int	num_points[NUM_DEVICES];
	unsigned int	array_indices[NUM_DEVICES] = {0};
	SDA_SNAPSHOT_POINT	points[NUM_DEVICES*MAX_POINTS];
	DATA_EVENT_DATA	data_events[NUM_DEVICES];

	status = sr_sda_get_snapshot_list_c(num_devices,device_indices,
					    &properties,array_indices,sda_usage,
					    file,case_number,subcase_number,
					    max_points,num_points,
					    points,errors,data_events);