log_read_setup_c

	status.i4.v = log_read_setup_c(format.i4.v [,filter_type.i4.v]
				       [,filter_data.g.v] [,kbd_routine.f.v])

	This routine sets up parameters for future calls to log_read.

	format		display format
			(LOG_FULL -> 2 lines per log entry (default),
			 LOG_TEXT -> 1 line per log entry (text only),
			 LOG_DATETEXT -> 1 line per log entry (date and text))
	[filter_type]	type of log entry filter
			(LOG_NO_FILTER -> no filter (all entries displayed)
					  (default),
			 LOG_FILTER_ON_TYPE -> filter on type of entry,
			 LOG_FILTER_ON_PRIORITY -> filter on entry priority,
			 LOG_FILTER_ON_AUTHOR -> filter on author string,
			 LOG_FILTER_ON_MESSAGE -> filter on message text)
	[filter_data]	data corresponding to "filter_type"
			(If filter_type equals LOG_FILTER_ON_TYPE, data
			 should be an integer having a value of LOG_INF
			 or LOG_ERR.  If "filter_type" equals
			 LOG_FILTER_ON_PRIORITY, data should be an integer.
			 If "filter_type" equals LOG_FILTER_ON_AUTHOR, data
			 should be a null-terminated text string not
			 exceeding LOG_AUTLEN_FULL characters.  If "filter_type"
			 equals LOG_FILTER_ON_MESSAGE, data should be the
			 text substring to be found in the log entries.  It
			 should be a null-terminated string not exceeding
			 LOG_MATCHLEN characters.) (default is NULL)
	[kbd_routine]	routine to be invoked upon user interrupt on a log entry
			(The programmer should not write to the screen except
			 inside a pop-up window.  This window should be
			 deleted before returning.  The programmer must also
			 handle program interrupts.  The routine and return data
			 are prototyped in cbslib.  The routine is called
			 as follows:
			 callback(entry_kbd.s.r)
			 ("entry_kbd" is a structure of type LOG_KBD_INFO)
			 (default is NULL))

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid format or filter type

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	log_read, log_write, shared_log_printf_c

	C/C++ usage:

	int	status;
	int	format = LOG_FULL;
	int	filter_type = LOG_NO_FILTER;
	void	filter_data = (void *) NULL;
	void	kbd_routine(LOG_KBD_INFO *entry_kbd);

	status = log_read_setup_c(format,filter_type,filter_data,kbd_routine);