dio_extended_status_menu_c

	status.i4.v = dio_extended_status_menu_c(top_row.i4.v,
						 left_column.i4.v,
						 num_lines.i4.v,
						 device_index.i4.v,
						 array_index.i4.v
						 [,raw_value.g.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 of device extended status.

	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 display status for
	array_index	desired array index (usually 0)
	[raw_value]	raw basic status data to scale
			(If a value of NULL is passed for this argument,
			 the raw data will be read from the device by this
			 routine.)
			(default is NULL)
	[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_STSMNU_OPT_NONE -> no options selected,
			 DIO_STSMNU_OPT_USER_FUNC_ON_TOP -> user-supplied
							    entries should come
							    first (default is
							    for them to come
							    last))

	This function returns ACNET status values as follows:

	OK			success
	DIO_NO_SUCH		no status property for this device
	CLIB_NO_SUCH		no status scaling 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_status_scaling_info_c, dio_raw_to_status_extended_c,
	dio_status_scaling_attributes_c, dio_is_status_attribute_value_c,
	dio_is_status_attribute_state_value_c,
	dio_is_status_attribute_value_by_id_c,
	dio_raw_to_status_attribute_value_by_id_c,
	dio_raw_to_status_state_value_by_id_c, dio_digital_control_menu_c,
	dio_digital_control_info_c, dio_get_raw(_c)

	C/C++ usage:

	char	user_text[] = "user 1      user 2      ";
	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 = 2;
	int	user_text_len = 12;
	unsigned int	options = DIO_STSMNU_OPT_NONE;
	void	user_func_1(void *dummy);
	void	user_func_2(void *dummy);
	status_menu_user_function	user_funcs[2];
	void	**func_data = (void **) NULL;

	user_funcs[0] = (status_menu_user_function) user_func_1;
	user_funcs[1] = (status_menu_user_function) user_func_2;

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