window_write_scroll_xchar_c

	status.i4.v = window_write_scroll_xchar_c(window_id.i2.v, text.sa.r,
						  num_chars.i4.v
						  [,num_lines.i4.v])

	This routine writes the "text" string to the indicated window
	in scrolling terminal fashion.  Successive calls to this routine
	for a given window will cause the scrolling region of the window
	to be filled from top to bottom.  When the window is full, the
	next and subsequent calls will cause the window to scroll up by
	one line with the current "text" string being written on the bottom
	line of the window's scrolling region.  If multiple lines of varying
	lengths are to be displayed, "num_chars" should be set to zero, and
	each successive line's text should be separated by a single null
	character.  If the window is erased or for any reason it is desired
	to start writing at the top of the scrolling region again, a call to
	window_init_sequential_write_c is required.

	window_id	window ID (use WMNGR_BACKGROUND for background window)
	text		text string to be displayed (array of XCHAR structures)
	num_chars	number of characters in string (If this has a
			value of 0, characters will be displayed until
			a null character is encountered.)
	[num_lines]	number of lines of text (default is 1)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid number of characters (<0)
	CBS_NO_WINDOW		requested window does not exist
	CBS_MEMFAIL		failed in allocating dynamic memory
	CBS_TOO_MANY		scroll buffer is full

	This function requires the following include files:

	cnsparam_h, cbslib_h, acnet_errors_h

	Related functions:

	window_init_sequential_write_c, window_write_scroll_c,
	window_write_line_c, window_write_xchar_line_c,
	window_sequential_write_c, window_tvm(_c),
	window_write_with_carriage_control_c, window_write_string_c,
	window_scroll(_c), window_set_scroll_region_c,
	window_set_scroll_limit_c, intro_tv_windows

	C/C++ usage:

	short	window_id;
	int	status;
	int	num_chars = NUM_CHARS;
	int	num_lines = 1;
	static const XCHAR	text[NUM_CHARS] =
	{{'U', RED}, {'S', WHITE}, {'A', BLUE}};

	status = window_write_scroll_xchar_c(window_id,text,num_chars,
					     num_lines);