sequencer_file_get_entries_c

	status.i4.v = sequencer_file_get_entries_c(sequencer_mode.i4.v,
						   file_number.i4.v,
						   num_entries.i4.r
						   [,entry_data.sp.r]
						   [,file_name.i1p.r])

	This routine returns the contents of a given Sequencer file.

	sequencer_mode	Sequencer mode
	file_number	desired file number
	num_entries	returned number of entries found
	[entry_data]	returned Sequencer file entry data
			(array of structures of type
			 SEQUENCER_FILE_DEVICE_DATA)
			(The memory for these structures is allocated by
			 this routine and should be freed by the caller.)
			(A value of NULL can be passed for this argument
			 if no file entry data is desired.)
			(default is NULL)
	[file_name]	returned file name
			(allow SEQ_FILE_NAME_LEN + 1 characters)
			(A value of NULL can be passed for this argument
			 if no file name is desired.)
			(default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid Sequencer mode or file number
	CLIB_INVTYP		not a parameter page file
	SQL_xxx			error reading database information

	This function requires the following include files:

	ul_cbsaux_h:auxlib_misc_h, acnet_errors_h

	Related functions:

	sequencer_file_get_directory_info_c, sequencer_file_name_to_number_c,
	sequencer_file_number_exists_c, sequencer_file_find_device_c,
	sequencer_file_execute_c, sequencer_file_num_bypassed_commands_c,
	sequencer_file_has_sr_restore_commands_c, sequencer_name_to_mode,
	sequencer_mode_to_name_c, sequencer_maximum_mode_number

	C/C++ usage:

	char	file_name[SEQ_FILE_NAME_LEN+1];
	int	status;
	int	sequencer_mode = SEQ_MODE_STUDIES;
	int	file_number = 1;
	int	num_entries;
	SEQUENCER_FILE_DEVICE_DATA	*entry_data;

	status = sequencer_file_get_entries_c(sequencer_mode,file_number,
					      &num_entries,&entry_data,
					      file_name);