snp_read_plot_setup_file_c

	status.i4.v = snp_read_plot_setup_file_c(system_name.i1a.r, file.g.v,
						 options.u4.v, mode.i4.r,
						 x_time.s.r,
						 y_devices.sa.r,
						 num_y_devices.i4.r,
						 frequency.r4.r,
						 time_base.i4.r,
						 arm_events.i4a.r,
						 setup_type.i4.r,
						 setup_data.g.v,
						 plot_options.s.r)

	This routine reads a saved fast time plot setup file.

	system_name	null terminated file system name
	file		file to plot which depends upon the option selected
			(SNP_OPT_NONE -> null terminated file name,
			 SNP_OPT_BY_FILE_NUMBER -> file number (starts at 1))
	options		plot options
			(SNP_OPT_NONE -> no options selected ("file" is
					 interpreted as a file name),
			 SNP_OPT_BY_FILE_NUMBER -> file specified by
						   file number)
	mode		returned plot mode
			(SNP_MODE_PLOT_ONCE -> plot once,
			 SNP_MODE_PLOT_MULT -> plot multiple times,
			 SNP_MODE_VIEW -> replot last data retrieved,
			 SNP_MODE_SNAPMGR -> plot snapshot manager data,
			 SNP_MODE_SDA -> plot SDA data,
			 SNP_MODE_MAIL_DATA -> mail last retrieved data to
					       a user)
	x_time		returned X axis time specification
			(structure of type SNP_DEVICE_DATA)
	y_devices	returned Y axis device specifications
			(array of structures of type SNP_DEVICE_DATA)
	num_y_devices	returned number of Y devices
			(maximum is SNP_MAX_Y_DEVICES)
	frequency	returned plot sample frequency
			(SNP_AUTO_FREQUENCY -> automatic plot frequency
					       selection)
	time_base	returned plot time base
			(SNP_ARM_SUPERCYCLE -> arm plot on Supercycle reset,
			 SNP_ARM_MI_CYCLE -> arm plot on Main Injector reset,
			 SNP_ARM_RR_CYCLE -> arm plot on Recycler reset,
			 SNP_ARM_BOOSTER_CYCLE -> arm plot on Booster reset,
			 SNP_ARM_EVENT -> arm plot on one or more specific
					  clock events,
			 SNP_ARM_EXTERNAL -> arm plot on an external trigger)
	arm_events	returned plot arm events  (These values are only used if
			a time base value of SNP_ARM_EVENT is selected.
			A maximum of SNP_MAX_ARM_EVENTS events can be
			specified, and the list of selected resets should be
			terminated by a value of 0.  A value of NULL can be
			passed for this argument if it's not needed.)
	plot_scaling	returned plot scaling selection
			(SNP_SCALING_COMMON -> linear plot of common
					       (engineering) units,
			 SNP_SCALING_PRIMARY -> linear plot of primary units,
			 SNP_SCALING_LOG -> semilog plot of common
					    (engineering) units)
	setup_type	returned type of setup data
			(SNP_SETUP_NONE -> no setup data available,
			 SNP_SETUP_EXT_TRIGGER -> setup data for external
						  trigger available
						  (structure of type
						   SNP_EXT_TRIGGER_DATA),
			 SNP_SETUP_FRIG -> setup data for frig plot available
					   (structure of type
					    SNP_FRIG_PLOT_DATA),
			 SNP_SETUP_SNAPMGR -> setup data for a detached
					      snapshot manager plot available
					      (structure of type
					       SNP_SNAPMGR_PLOT_DATA),
			 SNP_SETUP_SDA -> setup data for an SDA plot available
					  (structure of type SNP_SDA_PLOT_DATA))
	setup_data	returned plot setup data  (The type of data returned
			is indicated by "setup_type".  If this data is not
			needed, a value of NULL can be passed for this
			argument.)
	plot_options	returned optional plotting parameters  (If no optional
			plotting information is needed, a value of NULL
			can be passed for this argument.)
			Options which can be selected in the options
			field of this structure are:
			(SNP_OPT_NONE -> no plotting options selected,
			 SNP_OPT_CONNECT_POINTS -> connect points,
			 SNP_OPT_PLOT_CHARACTERS -> plot characters,
			 SNP_OPT_BLINK_NEW_DATA -> blink most recent plot trace,
			 SNP_OPT_NO_ERASE -> don't erase current plot before
					     starting new plot)
			(structure of SNP_OPTION_DATA)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		null pointers were passed for either the
				system name or file specification
	CLIB_NO_SUCH		requested file doesn't exist
	SQL_xxx			error reading file

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, tclk_events_h, cbslib_h, acnet_errors_h

	Related functions:

	snp_file_menu_c, snp_start_plot_from_file_c, snp_start_plot_c,
	snp_start, snp_setup, snpplt, snp_set_sda_info_c, snp_export_data,
	ftp_file_menu_c, ftp_read_plot_setup_file_c,
	ftp_start_plot_from_file_c, ftp_start_plot_c, ftp_start_plot_by_name_c,
	ftp_setup, ftp_start, fstplt, ftp_calculated_trace_c


	C/C++ usage:

	static const char	system_name[] = "Recycler";
	static const char	file[] = "bunch rotation";
	char	setup_data[sizeof(SNP_SNAPMGR_PLOT_DATA)];
	int	status;
	int	mode;
	int	num_y_devices;
	int	time_base;
	int	arm_events[SNP_MAX_ARM_EVENTS];
	int	plot_scaling;
	int	setup_type;
	unsigned int	options = SNP_OPT_NONE;
	float	frequency;
	SNP_DEVICE_DATA	x_time;
	SNP_DEVICE_DATA	y_devices[SNP_MAX_Y_DEVICES];
	SNP_OPTION_DATA	plot_options;

	status = snp_read_plot_setup_file_c(system_name,(void *) file,
					    options,&mode,&x_time,
					    y_devices,&num_y_devices,
					    &frequency,&time_base,
					    arm_events,&plot_scaling,
					    &setup_type,setup_data,
					    &plot_options);