nova_archive_get_db_channel_id_list_c (ul_nova)

	status.i4.v = nova_archive_get_db_channel_id_list_c(num_devices.i4.v,
							    device_names.i1a.r,
							    channel_ids.i4a.r,
							    error_string.i1a.r)

	This routine returns the database channel IDs corresponding
	to a list of device names.

	num_devices	number of devices to retrieve
	device_names	null terminated device names
			(allow DEVICE_NAME_LEN + 1 characters per entry)
	channel_ids	returned corresponding channel IDs
			(A value of CLIB_NO_SUCH is returned for
			 device names that were not found.)
	error_string	returned null terminated error string
			(allow for NOVA_MAX_ERROR_STRING_LEN + 1 characters)

	This function returns status values as follows:

	OK			success
	CLIB_NOT_OPEN		could not connect to the database server or
				could not open the password file
	CLIB_BUGCHK		program environment not set up correctly
	CLIB_SYNTAX		password file syntax error
	SQL_GENERIC_ERROR	error accessing database

	This function requires the following include files:

	ul_nova_h:novalib_h, acnet_errors_h

	Related functions:

	nova_archive_get_db_channel_id, nova_archive_dump_db_channel_ids,
	nova_archive_add_db_channel_id, nova_archive_db_connect,
	nova_archive_get_db_schema

	C/C++ usage:

	static const char	device_names[NUM_DEVICES][DEVICE_NAME_LEN+1] =
	"L:0101";
	char	error_string[NOVA_MAX_ERROR_STRING_LEN+1];
	int	status;
	int	num_devices = NUM_DEVICES;
	int	channel_ids[NUM_DEVICES];

	status = nova_archive_get_db_channel_id_list_c(num_devices,device_names,
						       channel_ids);