alarm_list_name_to_lists_c

	status.i4.v = alarm_list_name_to_lists_c(list_name.i1a.r,
						 num_lists.i4.r,
						 list_data.sp.r,
						 [,options.u4.v])

	This routine will return the alarm lists ultimately referenced
	by a requested alarm list.  These lists are maintained by page
	D59 (PA4087).  If only a system name is provided, all alarm lists
	for the requested system will be returned.

	list_name	requested list name ('{system}\{list name}')
			(If only the system name is provided, all alarm
			 lists from this system will be returned.)
	num_lists	returned number of alarm lists actually returned
	list_data	returned alarm list data or array of list data
			(structure of type USER_ALARM_LIST_DATA)
			(A value of NULL can be passed for this argument
			 if these values are not needed.  The memory for
			 this argument is allocated by this routine and
			 should be freed by the caller.) 
	[options]	retrieval options
			(ALARM_LIST_OPT_NONE -> no options selected (default))

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid system name passed
	CLIB_NO_SUCH		nonexistent list name requested
	SQL_xxx			error retrieving alarm list information

	This function requires the following include files:

	cnsparam_h, cbslib_h, nodedefs_h, acnet_errors_h

	Related functions:

	alarm_list_name_to_devices_c, alarm_list_names,
	alarm_list_find_device_c, alarm_callback_init_c,
	alarm_callback_term_c, alarm_find_alarms_daemon_c

	C/C++ usage:

	static const char	list_name[] = "Linac\Buncher";
	int	status;
	int	num_lists;
	unsigned int	options = ALARM_LIST_OPT_NONE;
	USER_ALARM_LIST_DATA	*list_data;

	status = alarm_list_name_to_lists_c(list_name,&num_lists,&list_data,
					    options);