sequencer_file_execute_c

	status.i4.v = sequencer_file_execute_c(sequencer_mode.i4.v,
					       file_number.i4.v,
					       sr_file.i4.v [,options.u4.v]
					       [,num_entries.i4.r]
					       [,entry_data.sp.r]
					       [,file_name.i1p.r]
					       [,num_bypassed.i4.r])

	This routine executes a requested Sequencer file.

	sequencer_mode	Sequencer mode
	file_number	desired file number
	sr_file		Save/Restore file number for restore commands
	[options]	file execution options
			(SEQ_OPT_NONE -> no options selected (default),
			 SEQ_OPT_ABORT_IF_BYPASSED ->  abort execution if there
						       are bypassed commands,
			 SEQ_OPT_SUPPRESS_SETTINGS -> suppress all settings,
			 SEQ_OPT_SUPPRESS_ACTIONS -> suppress all file actions)
	[num_entries]	returned number of entries found
	[entry_data]	returned Sequencer file entry data which contains the
			execution status for each command
			(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)
	[num_bypassed]	returned number of bypassed commands
			(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_NOTENB		some commands are bypassed
	CLIB_INVTYP		not a Sequencer file
	SQL_xxx			error reading database information
	positive number		number of commands which failed

	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_get_entries_c,
	sequencer_file_name_to_number_c, sequencer_file_number_exists_c,
	sequencer_file_find_device_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	sr_file = SR_FILE_NUMBER;
	int	num_entries;
	int	num_bypassed;
	unsigned int	options = SEQ_OPT_NONE;
	SEQUENCER_FILE_DEVICE_DATA	*entry_data;

	status = sequencer_file_execute_c(sequencer_mode,file_number,
					  sr_file,options,&num_entries,
					  &entry_data,&num_bypassed,file_name);