ftp_start_plot_by_name_c

	status.i4.v = ftp_start_plot_by_name_c(console_number.i4.v,
					       sa_slot.i4.v, x_device.s.r,
					       y_devices.sa.r,
					       num_y_devices.i4.v,
					       frequency_code.i4.v,
					       update_event.i4.v,
					       time_base.i4.v,
					       reset_events.i4a.r,
					       plot_scaling.i4.v,
					       option_data.s.r)

	This routine starts up a fast time plot using device names
	rather than device indices to specify what to plot.

	console_number	console number to run Fast Time Plot on
			(A value of zero can be used for the local console.)
	sa_slot		SA slot to run Fast Time 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)
	x_device	X axis device specification  (To specify a time
			plot, use the string "TIME" as the device name.)
			(structure of type FTP_DEVICE_NAME_DATA)
	y_devices	Y axis device specifications
			(array of structures of type FTP_DEVICE_NAME_DATA)
	num_y_devices	number of Y devices (maximum is FTP_MAX_Y_DEVICES)
	frequency_code	plot update frequency
			(CLIB_DEFAULT_ARG -> automatic plot frequency selection,
			 FTP_FREQ_AUTO -> automatic plot frequency selection,
			 FTP_FREQ_1HZ -> 1 Hz update,
			 FTP_FREQ_15HZ -> 15 Hz update,
			 FTP_FREQ_50HZ -> 50 Hz update,
			 FTP_FREQ_100HZ -> 100 Hz update,
			 FTP_FREQ_200HZ -> 200 Hz update,
			 FTP_FREQ_360HZ -> 360 Hz update,
			 FTP_FREQ_720HZ -> 720 Hz update,
			 FTP_FREQ_1440HZ -> 1440 Hz update,
			 FTP_FREQ_EVENT -> update on a TCLK event)
	update_event	event to acquire data on if FTP_FREQ_EVENT
			has been selected as the frequency code,
			otherwise this argument is ignored
	time_base	plot time base
			(FTP_PLOT_ONCE -> plot data once only,
			 FTP_PLOT_SCROLLING -> plot data in a continuously
					       scrolling window,
			 FTP_REPEAT_SUPERCYCLE -> plot restarts at the
						  beginning of every
						  super cycle,
			 FTP_REPEAT_MI_CYCLE -> plot restarts at the
						beginning of every
						Main Injector cycle,
			 FTP_REPEAT_RR_CYCLE -> plot restarts at the
						beginning of every
						Recycler cycle,
			 FTP_REPEAT_SELECTED_MI -> plot restarts at the
						   beginning of selected
						   Main Injector cycle(s),
			 FTP_REPEAT_SELECTED_RR -> plot restarts at the
						   beginning of selected
						   Recycler cycle(s),
			 FTP_REPEAT_EVENT -> plot restarts every time a
					     selected TCLK event occurs)
	reset_events	plot restart events  (This argument is only used if
			a time base value of FTP_REPEAT_SELECTED_MI
			or FTP_REPEAT_EVENT is selected.  If the time base
			value is FTP_REPEAT_SELECTED_MI, a maximum of 8 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	plot scaling selection
			(CLIB_DEFAULT_ARG -> linear plot of common
					     (engineering) units,
			 FTP_SCALING_COMMON -> linear plot of common
					       (engineering) units,
			 FTP_SCALING_PRIMARY -> linear plot of primary units,
			 FTP_SCALING_LOG -> semilog plot of common
					    (engineering) units)
	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:
			(FTP_OPT_NONE -> no plotting options selected,
			 FTP_OPT_CONNECT_POINTS -> connect points,
			 FTP_OPT_PLOT_CHARACTERS -> plot characters,
			 FTP_OPT_BLINK_NEW_DATA -> blink most recent plot trace,
			 FTP_OPT_NO_ERASE -> don't erase current plot before
					     starting new plot,
			 FTP_OPT_X_SETTING -> plot the reading of the setting
					      property for the X axis device)
			(structure of FTP_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:

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

	C/C++ usage:

	static const char	x_device[FTP_DEVICE_NAME_LEN] = "TIME";
	static const char	y_devices[NUM_Y_DEVICES][FTP_DEVICE_NAME_LEN] =
				"M:OUTTMP";
	int	status;
	int	console_number = LOCAL_CONSOLE;
	int	sa_slot = AVAILABLE_SA_SLOT;
	int	num_y_devices = NUM_Y_DEVICES;
	int	frequency_code = FTP_FREQ_AUTO;
	int	update_event = EVENT_NULL;
	int	time_base = FTP_REPEAT_SUPERCYCLE;
	int	plot_scaling = FTP_SCALING_COMMON;
	int	*reset_events = (int *) NULL;
	static const FTP_DEVICE_NAME_DATA	x_device =
	{"TIME", FTP_NO_OPERATION, MIN_TIME, MAX_TIME};
	static const FTP_DEVICE_NAME_DATA	y_devices[NUM_Y_DEVICES] =
	{{"M:OUTTMP", FTP_NO_OPERATION, MIN_VALUE, MAX_VALUE}};
	static const FTP_OPTION_DATA	option_data =
	{FTP_OPT_NONE, 0, 0.0, 0.0};

	status = ftp_start_plot_by_name_c(console_number,sa_slot,&x_device,
					  y_devices,num_y_devices,
					  frequency_code,update_event,time_base,
					  reset_events,plot_scaling,
					  &option_data);