nova_archive_db_connect (ul_nova)

	status.i4.v = nova_archive_db_connect(connection.sp.r,
					      error_string.i1a.r)

	This routine makes a connection to the NOvA archive database.

	connection	returned database connection structure
			(structure of type PGconn)
	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

	This function requires the following include files:

	libpq-fe_h, ul_nova_h:novalib_h, acnet_errors_h

	Related functions:

	nova_archive_get_db_schema, nova_archive_get_db_channel_id,
	nova_archive_add_db_channel_id, nova_archive_get_db_channel_id_list_c,
	nova_archive_dump_db_channel_ids

	C/C++ usage:

	char	error_string[NOVA_MAX_ERROR_STRING_LEN+1];
	int	status;
	PGconn	*connection;

	status = nova_archive_db_connect(&connection,error_string);