xchar_text_message_c

	status.i4.v = xchar_text_message_c(top_row.i4.v, left_column.i4.v,
					   num_rows.i4.v, num_columns.i4.v,
					   text.sa.r, exit_switch.i4.v,
					   resize_screen.i4.v, title.i1a.r,
					   synchronous.i4.v)

	This routine will display a message window.  The text should
	be a block of text in XCHAR format.

	top_row		top row of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	left_column	left column of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	num_rows	number of rows of text (>= 1)
	num_columns	number of columns of text (>= 1)
	text		text to display ("num_rows" * "num_columns" characters)
			(array of XCHAR structures)
	exit_switch	determine whether or not to display an exit switch
			(Note: This argument has no effect if "synchronous"
			 has a value of FALSE.)
			(TRUE -> display exit ("OK") switch,
			 FALSE -> no exit switch)
	resize_screen	determine whether or not to resize the background
			window to accommodate this window
			(Note: This argument has no effect if "synchronous"
			 has a value of FALSE.)
			(TRUE -> resize screen to fit large windows,
			 FALSE -> don't resize screen)
	title		window title (A value of NULL can be passed for this
			argument if no title is desired.)
	synchronous	declares the handling of the window
			(TRUE -> window will remain open until closed by user
				 action and then control will return to
				 the caller,
			 FALSE -> routine will return immediately after
				  drawing the window and will return the
				  window ID for deletion by the caller)

	This function returns status values as follows:

	OK			success
	CBS_INVARG		invalid number of rows or columns
	CBS_WINDOW_TOO_BIG	message window won't fit on the TV screen
	CBS_INVSIZ		image is too large for TV screen
	otherwise		window ID if asynchronous mode is selected

	This function requires the following include files:

	cnsparam_h, cbslib_h, macro_h, acnet_errors_h

	Related functions:

	text_message_c, horz_scrolling_text_message_c, tvmess(_c), timmes(_c),
	post_message(_c), meswin(_c), window_tvdisp(_c), dialog_setup_c,
	window_restore_hint_c

	C/C++ usage:

	static const char	title[] = "Title";
	int	status;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	int	num_rows = NUM_ROWS;
	int	num_columns = NUM_COLUMNS;
	int	exit_switch = TRUE;
	int	resize_screen = TRUE;
	int	synchronous = TRUE;
	XCHAR	text[NUM_ROWS*NUM_COLUMNS];

	status = xchar_text_message_c(top_row,left_column,num_rows,num_columns,
				      text,exit_switch,resize_screen,title,
				      synchronous);