bpm_set_sample_mode_c

	status.i4.v = bpm_set_sample_mode_c(particle_plane.i4.v,
					    bunch_or_batch.i4.v
					    [,house.i1a.r])

	This routine sets up BPM uPs to sample a specified particle type
	(for the Tevatron) or plane (for Main Injector) and beam mode.
	See bpm_machine_c.

	For BPM_TEVATRON:
	For BPM_MI_ABORT_LINE:
	For BPM_P3_LINE:
	For BPM_A1_LINE:
	For BPM_RECYCLER:
	For BPM_RR_ABORT_LINE:
	For BPM_R20_LINE:
	For BPM_R30_LINE:
	For BPM_AP2_LINE:
	particle_plane	type of particle to sample
			(BPM_MODE_PROTON -> look at protons,
			 BPM_MODE_PBAR -> look at pbars)
	For BPM_MAIN_INJECTOR:
	particle_plane	selected detector plane
			(BPM_MODE_NORMAL -> select normal plane,
			 BPM_MODE_ORTHOGONAL -> select orthogonal plane)
	bunch_or_batch	beam mode to sample
			(BPM_MODE_BUNCH -> sample bunches of beam,
			 BPM_MODE_BATCH -> sample batches of beam)
			(Note: This argument is ignored for BPM_A1_LINE,
			 BPM_MI_ABORT_LINE, BPM_RECYCLER, BPM_RR_ABORT_LINE,
			 BPM_R20_LINE, and BPM_R30_LINE)
	[house]		optional specification for setting a single house
			(default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	CBS_NOTYET		not supported for the currently selected
				machine
	CBS_INVARG		invalid mode
	otherwise		ACNET error

	This function requires the following include files:

	ul_cbsaux/bpmuti.h, acnet_errors_h

	Related functions:

	bpm_machine_c, bpm_get_sample_mode, bpm_get_data_c, blm_get_data_c,
	bpm_get_intensity_c

	C/C++ usage:

	char	*house = (char *) NULL;
	int	status;
	int	particle_plane = BPM_MODE_PROTON;
	int	bunch_or_batch = BPM_MODE_BUNCH;

	status = bpm_set_sample_mode_c(particle_plane,bunch_or_batch,house);