db_table_name_parse_c

	status.i4.v = db_table_name_parse_c(source_string.ch.d,
					    source_length.i4.v,
					    database_string.i1a.r,
					    database_length.i4.v,
					    owner_string.i1a.r,
					    owner_length.i4.v,
					    table_string.i1a.r,
					    table_length.i4.v, options.u4.v)

	This routine will parse a database table name into its component pieces.

	source_string	database table name string to parse
	source_length	length of database table name string
			(a value of zero will result in this routine
			 determining the length of the string)
	database_string	returned null terminated database string
			(A value of NULL can be passed for this argument
			 if the database string is not needed.)
	database_length	maximum length of database string to return
	owner_string	returned null terminated owner string
			(A value of NULL can be passed for this argument
			 if the owner string is not needed.)
	owner_length	maximum length of owner string to return
	table_string	returned null terminated table string
			(A value of NULL can be passed for this argument
			 if the table string is not needed.)
	table_length	maximum length of table string to return
	options		parsing options (not used)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid length

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	db_column_info_c, db_ctime_to_db_date_c, file_name_parse_c,
	str_find_character_c, db_retrieve_rows_c

	C/C++ usage:

	static const char	source_string[] = "apvdb.ivanov.d44_default_export";
	char	database_string[MAX_DATABASE+1];
	char	owner_string[MAX_OWNER+1];
	char	table_string[MAX_TABLE+1];
	int	status;
	int	database_length = MAX_DATABASE;
	int	owner_length = MAX_OWNER;
	int	table_length = MAX_TABLE;
	unsigned int	options = 0;

	status = db_table_name_parse_c(source_string,source_length,
				       database_string,database_length,
				       owner_string,owner_length,
				       table_string,table_length,options);