snp_start_plot_c

	status.i4.v = snp_start_plot_c(console_number.i4.v, sa_slot.i4.v,
				       mode.i4.v, x_time.s.r, y_devices.sa.r,
				       num_y_devices.i4.v, frequency.r4.v,
				       time_base.i4.v, arm_events.i4a.r,
				       plot_scaling.i4.v, setup_type.i4.v,
				       setup_data.g.v, option_data.s.r)

	This routine starts up a snapshot plot.

	console_number	console number to run Snapshot Plot on
			(A value of zero can be used for the local console.)
	sa_slot		SA slot to run Snapshot Plot in
			(SA_SLOT -> SA secondary application slot,
			 SB_SLOT -> SB secondary application slot,
			 SC_SLOT -> SC secondary application slot,
			 SD_SLOT -> SD secondary application slot,
			 SE_SLOT -> SE secondary application slot,
			 AVAILABLE_SA_SLOT -> choose available SA slot)
	mode		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		X axis time specification
			(structure of type SNP_DEVICE_DATA)
	y_devices	Y axis device specifications
			(array of structures of type SNP_DEVICE_DATA)
	num_y_devices	number of Y devices (maximum is SNP_MAX_Y_DEVICES)
	frequency	plot sample frequency  (Passing a value of
			SNP_AUTO_FREQUENCY results in automatic plot frequency
			selection.)
	time_base	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	plot arm events  (This argument is only used if
			a time base value of SNP_ARM_EVENT is selected.
			A maximum of 8 events can be specified, and the list
			of selected resets should be terminated by a value of
			EVENT_NULL or EVENT_NOOP.  A value of NULL can be
			passed for this argument if it's not needed.)
	plot_scaling	plot scaling selection
			(CLIB_DEFAULT_ARG -> linear plot of common
					     (engineering) units,
			 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	type of setup data
			(SNP_SETUP_NONE -> no setup data supplied,
			 SNP_SETUP_EXT_TRIGGER -> setup data for external
						  trigger supplied
						  (structure of type
						   SNP_EXT_TRIGGER_DATA),
			 SNP_SETUP_FRIG -> setup data for frig plot supplied
					   (structure of type
					    SNP_FRIG_PLOT_DATA),
			 SNP_SETUP_SNAPMGR -> setup data for a detached
					      snapshot manager plot
					      (structure of type
					       SNP_SNAPMGR_PLOT_DATA),
			 SNP_SETUP_SDA -> setup data for an SDA plot
					  (structure of type SNP_SDA_PLOT_DATA))
	setup_data	plot setup data  (The type of data supplied should
			be indicated by "setup_type".  If this data is not
			needed for a particular mode, a value of NULL can be
			passed for this argument.)
			(SNP_MODE_PLOT_ONCE -> structure of type
					       SNP_FRIG_PLOT_DATA for frig
					       plots or structure of type
					       SNP_EXT_TRIGGER_DATA for
					       externally triggered plots
					       or not needed,
			 SNP_MODE_PLOT_MULT -> structure of type
					       SNP_FRIG_PLOT_DATA for frig
					       plots or structure of type
					       SNP_EXT_TRIGGER_DATA for
					       externally triggered plots
					       or not needed,
			 SNP_MODE_VIEW -> not needed,
			 SNP_MODE_SNAPMGR -> structure of type
					     SNP_SNAPMGR_PLOT_DATA,
			 SNP_MODE_SDA -> structure of type SNP_SDA_PLOT_DATA,
			 SNP_MODE_MAIL_DATA -> not needed)
	option_data	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		invalid number of Y axis devices or
				time base selected requiring events, but
				no events were supplied
	CLIB_NO_SUCH		no program slot available

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, tclk_events_h, cbslib_h, acnet_errors_h

	Related functions:

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

	C/C++ usage:

	int	status;
	int	console_number = LOCAL_CONSOLE;
	int	sa_slot = AVAILABLE_SA_SLOT;
	int	mode = SNP_MODE_PLOT_ONCE;
	int	num_y_devices = NUM_Y_DEVICES;
	int	time_base = SNP_ARM_SUPERCYCLE;
	int	plot_scaling = SNP_SCALING_COMMON;
	int	setup_type = SNP_SETUP_NONE;
	int	*arm_events = (int *) NULL;
	float	frequency = SNP_AUTO_FREQUENCY;
	void	*setup_data = (void *) NULL;
	static const SNP_DEVICE_DATA	x_time =
	{0, 0, 0, MIN_TIME, MAX_TIME};
	static const SNP_DEVICE_DATA	y_devices[NUM_Y_DEVICES] =
	{{27235, 0, 0, MIN_VALUE, MAX_VALUE}};
	static const SNP_OPTION_DATA	option_data =
	{SNP_OPT_NONE};

	status = snp_start_plot_c(console_number,sa_slot,mode,&x_time,
				  y_devices,num_y_devices,frequency,time_base,
				  arm_events,plot_scaling,setup_type,
				  setup_data,&option_data);