text_message_c

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

	This routine will display a preformatted message window.

	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 textt (>= 1)
	text		text to display ("num_rows" * "num_columns" characters)
	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)
	text_color	text color (constants are in cnsparam)

	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:

	horz_scrolling_text_message_c, xchar_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	text[NUM_ROWS*NUM_COLUMNS] =
	"This is a two linetext message.     ";
	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;
	int	text_color = CYAN;

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