bpm_file_link_info_c

	status.i4.v = bpm_file_link_info_c(file_number.i4.v, linked_to.sa.r,
					   num_links.i4.r, linked_by.s.r)

	This routine returns the links to and from the requested BPM file.
	The master file used is the last one set by a call to
	bpm_set_save_file or set by default by bpm_machine_c.

	file_number	number of file to return link information for
			(starts at 1)
	linked_to	returned information about other files linked to
			this one ("num_links" entries)
			(array of BPM_FILE_LINK_INFO structures)
	num_links	returned number of files linked to this one
	linked_by	returned information about the file (if any)
			linked to by this one  (If this file isn't
			linked to another file, the "machine_id" field
			in the returned structure will be set to a
			value of BPM_NULL_MACHINE.)
			(BPM_FILE_LINK_INFO structure)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid file number passed
	SQL_xxx			database error

	This function requires the following include files:

	ul_cbsaux/bpmuti.h, acnet_errors_h

	Related functions:

	bpm_machine_c, bpm_get_save_file, bpm_get_default_save_file,
	bpm_set_save_file, bpm_link_file_c, bpm_unlink_file_c,
	bpm_next_unlinked_file_c, bpm_rename_file_c, bpm_protect_file_c,
	bpm_file_menu_c, bpm_directory_info, bpm_find_oldest_file_number_c

	C/C++ usage:

	int		status;
	int		file_number = FILE_NUMBER;
	int		num_links;
	BPM_FILE_LINK_INFO	*linked_to = (BPM_FILE_LINK_INFO *) NULL;
	BPM_FILE_LINK_INFO	linked_by;

	status = bpm_file_link_info_c(file_number,linked_to,&num_links,
				      &linked_by);

	if ((status == OK) && (num_links > 0))
	    {
	    linked_to = (BPM_FILE_LINK_INFO *) malloc(num_links*(sizeof(BPM_FILE_LINK_INFO)));
	    status = bpm_file_link_info_c(file_number,linked_to,&num_links,
					  &linked_by);
	    }