logger_find_deleted_device_c

	status.i4.v = logger_find_deleted_device_c(device_name.i1a.r,
						   event_string.i1a.r,
						   num_found.u4.r,
						   deleted_devices.sp.r
						   [,node.i4.v]
						   [,start_date.u4.v]
						   [,end_date.u4.v]
						   [,options.u4.v])

	This routine returns information about data loggers that
	have logged a device in the past.  Searches can also be
	made including the data event on which the device was 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
	deleted_devices	returned data logging information
			(array of LOGGER_SEARCH_DELETED_DATA structures)
			(Note: This is a pointer to a buffer allocated by
			 this routine and should be freed by the caller.)
	[node]		requested Lumberjack node
			(default is 0 which results in returning data from all
			 nodes which have logged the requested device)
	[start_date]	start date (in clinks)
			(default is 0)
	[end_date]	end date (in clinks)
			(default is 0)
	[options]	retrieval options
			(LOGGER_OPT_NONE -> no options selected,
			 LOGGER_OPT_EXACT_DEVICE_MATCH -> only match the
							  exact passed string)

	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
	SQL_xxx			error retrieving information from the 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	start_date = 0;
	unsigned int	end_date = 0;
	unsigned int	options = LOGGER_OPT_NONE;
	LOGGER_SEARCH_DELETED_DATA	*deleted_devices;

	status = logger_find_deleted_device_c(device_name,event_string,
					      &num_found,&deleted_devices,node,
					      start_date,end_date,options);