nova_archive_get_db_channel_id (ul_nova)

	status.i4.v = nova_archive_get_db_channel_id(device_name.i1a.r,
						     channel_id.i4.r,
						     error_string.i1a.r)

	This routine returns the database channel ID corresponding
	to a device name.

	device_name	null terminated device name
	channel_id	returned corresponding channel ID
	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
	CLIB_NO_SUCH		device name not found in database

	This function requires the following include files:

	ul_nova_h:novalib_h, acnet_errors_h

	Related functions:

	nova_archive_get_db_channel_id_list_c, 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_name[] = "L:0101";
	char	error_string[NOVA_MAX_ERROR_STRING_LEN+1];
	int	status;
	int	channel_id;

	status = nova_archive_get_db_channel_id(device_name,&channel_id,
						error_string);