logger_find_device_list_entries_c

	status.i4.v = logger_find_device_list_entries_c(device_name.i1a.r,
							event_string.i1a.r,
							num_found.u4.r,
							found_devices.sp.r
							[,node.i4.v]
							[,options.u4.v])

	This routine returns data logger list entries for a given device.
	Searches can also be made including the data event on which the
	device is being logged.

	device_name	requested device name (can be null terminated)
			(up to C_STYLE_LONG_DEVICE_NAME_LEN characters)
			(example: "M:OUTTMP")
	event_string	requested event (a value of NULL may be passed if
			a data event search is not needed)
			(up to DATA_EVENT_MAX_LEN characters)
			(example: "p,10000,true")
	num_found	returned number of entries found
	found_devices	returned data logging information
			(array of LOGGER_SEARCH_DATA structures)
			(Note: This is a pointer to a buffer allocated by
			 this routine. The caller should neither allocate
			 nor free this buffer.)
	[node]		requested Lumberjack node
			(default is 0 which results in returning data from all
			 nodes which have the requested device in a list)
	[options]	search options
			(LOGGER_OPT_NONE -> no options selected,
			 LOGGER_OPT_NO_CLIENT_EVENTS -> don't match entries that
							have a client
							data event,
			 LOGGER_OPT_NEGATE_DATA_EVENT -> don't match entries
							 that have a specified
							 data event,
			 LOGGER_OPT_WILDCARD_NAME -> perform a wildcard match on
						     the device name,
			 LOGGER_OPT_WILDCARD_ARRAY_INDEX -> perform a wildcard
							    match on any
							    array indices)

	This function returns ACNET status values as follows:

	OK			success
	LJ_MEMFAIL		dynamic memory allocation failure
	LJ_INVARG		requested device name is blank or NULL
	LJ_NO_SUCH		requested Lumberjack does not have the
				requested device
	ACNET_xxx		error in communicating with Database

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, clib_h, acnet_errors_h

	Related functions:

	logger_find_device_c, logger_devices_from_node_c, logger_get_device_c,
	logger_get_device_by_name_c, logger_get_device_list_c,
	logger_return_data, logger_setnode, logger_return_names,
	logger_check_alive, logger_restart_lists, logger_shutdown,
	logger_name_to_node, logger_available_device_dates_c,
	logger_available_device_data_entries_c, logger_get_list_data_events_c,
	logger_find_lists_by_data_event_c, logger_find_devices_by_data_event_c

	C/C++ usage:

	static const char device_name[C_STYLE_LONG_DEVICE_NAME_LEN+1] = "M:OUTTMP";
	static const char event_string[DATA_EVENT_MAX_LEN+1] = "p,10000,true";
	int	status;
	int	node = 0;
	unsigned int	num_found;
	unsigned int	options = LOGGER_OPT_NONE;
	LOGGER_SEARCH_DATA	*found_devices;

	status = logger_find_device_list_entries_c(device_name,event_string,
						   &num_found,&found_devices,
						   node,options);