status.i4.v = bpm_name_to_index_c(name.i1a.r, plane.i4.v,
					  data_view.u4.v, index.i4.r)

	This routine returns the data array index corresponding
	to a BPM name for the currently selected machine.
	See bpm_machine_c.

	name		BPM detector name
			(up to DEVICE_NAME_LEN characters)
	plane		plane selection
			(BPM_HORZ -> horizontal plane,
			 BPM_VERT -> vertical plane)
	data_view	data view requested which may result in data being
			returned for multiple machines
			(BPM_VIEW_DEFAULT -> single machine view,
			 BPM_VIEW_P1_ONLY -> P1 line only (P1 line),
			 BPM_VIEW_P1_P2 -> P1 and P2 lines (P1 line),
			 BPM_VIEW_P1_P2_AP1 -> P1, P2, and AP1 lines (P1 line),
			 BPM_VIEW_P1_P2_AP1_AP3	-> P1, P2, AP1, amd AP3 lines
						   (P1 line),
			 BPM_VIEW_P1_P2_AP1_AP2	-> P1, P2, AP1, amd AP2 lines
						   (P1 line),
			 BPM_VIEW_AP1_ONLY -> AP1 line only (AP1 line),
			 BPM_VIEW_AP1_AP2 -> AP1 and AP2 lines (AP1 line),
			 BPM_VIEW_AP1_AP3 -> AP1 and AP3 lines (AP1 line))
	index		returned corresponding data array index

	This function returns status values as follows:

	OK			success
	CBS_INVARG		invalid plane passed
	CBS_NOTYET		not yet supported for the active machine
	CBS_NO_SUCH		requested name doesn' exist

	This function requires the following include files:

	cnsparam_h, ul_cbsaux/bpmuti.h

	Related functions:

	bpm_machine_c, bpm_get_names, bpm_query, bpm_get_data_c,
	bpm_get_intensity_c, bpm_get_detector_status,

	C/C++ usage:

	char		name[] = "I:HP100";
	int		status;
	int		plane = BPM_HORZ;
	int		index;
	unsigned int	data_view = BPM_VIEW_DEFAULT;

	status = bpm_name_to_index_c(name,plane,data_view,&index);