dio_enum_value_setting_menu_c

	status.i4.v = dio_enum_value_setting_menu_c(top_row.i4.v,
						    left_column.i4.v,
						    num_lines.i4.v,
						    device_index.i4.v,
						    array_index.i4.v
						    [,num_user.i4.v]
						    [,user_text_len.i4.v]
						    [,user_text.i1a.r]
						    [,user_func.fa.r]
						    [,func_data.ga.r]
						    [,options.u4.v])

	This routine provides a menu for setting an enumerated value device.

	top_row		top row of menu (use WMNGR_CENTER for centering)
	left_column	left column of menu (use WMNGR_CENTER for centering)
	num_lines	maximum number of entries to display at a time
			(If a value of CLIB_DEFAULT_ARG is passed for this
			 argument, the routine will determine the size
			 of the menu.)
	device_index	device index of device to set
	array_index	desired array index (usually 0)
	[num_user]	optional number of additional user entries
			(default is 0)
	[user_text_len]	length of each user text entry including any nulls
	[user_text]	text for user-supplied entries
			("user_text_len" characters per entry)
			(default is NULL)
	[user_func]	user-supplied functions (default is NULL)
	[func_data]	pointers to data to be passed to "user_func"
			(default is NULL)
	[options]	menu options (Individual options can be ORed together.)
			(DIO_ENUMVAL_OPT_NONE -> no options selected,
			 DIO_ENUMVAL_OPT_USER_FUNC_ON_TOP -> user-supplied
							     entries should come
							     first (default is
							     for them to come
							     last),
			 DIO_ENUMVAL_OPT_CONTROLLED_SET -> observe controlled
							   setting restrictions,
			 DIO_ENUMVAL_OPT_ALLOW_CREW_CHIEF -> allow the MCR crew
							     chief to make
							     controlled settings)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_NO_SUCH		no enumerated value entries exist for this device
	CLIB_MEMFAIL		memory allocation failure
	CLIB_ABORT		user aborted input
	DIO_SETDIS		DIO settings are disabled
	negative value		other ACNET format error

	This function requires the following include files:

	diolib_h, acnet_errors_h

	Related functions:

	dio_enum_value_info_c, dio_enum_value_text_to_raw_data_c,
	dio_raw_to_enum_value_text_c, dio_set_raw(_c)

	C/C++ usage:

	char	*user_text = (char *) NULL;
	int	status;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	int	num_lines = 5;
	int	device_index = Z_ACLTST;
	int	array_index = 0;
	int	num_user = 0;
	int	user_text_len = 0;
	unsigned int	options = DIO_ENUMVAL_OPT_NONE;
	enum_setting_user_function	user_funcs = (enum_setting_user_function *) NULL;
	void	**func_data = (void **) NULL;

	status = dio_enum_value_setting_menu_c(top_row,left_column,num_lines,
					       device_index,array_index,
					       num_user,user_text_len,user_text,
					       user_funcs,func_data,options);