sr_file_save_errors_c

	status.i4.v = sr_file_save_errors_c(file_number.i4.v, num_devices.i4.r
					    [,device_indices.i4p.r]
					    [,properties.i2p.r] 
					    [,save_errors.i2p.r]
					    [,match_error.i4.v])

	This routine returns all save errors from a save/restore file.

	file_number	 file number from which to retrieve data
			 (This is the subsystem number or user key 1 for
			  detached snapshot manager data.)
	num_devices	 returned number of error devices
	[device_indices] returned device indices in error
			 (The memory for these values is allocated by
			  this routine and should be freed by the caller.)
			 (A value of NULL can be passed for this argument
			  if these values are not needed.)
			 (default is NULL)
	[properties]	 returned property indices in error
			 (The memory for these values is allocated by
			  this routine and should be freed by the caller.)
			 (A value of NULL can be passed for this argument
			  if these values are not needed.)
			 (default is NULL)
	[save_errors]	 returned save errors
			 (The memory for these values is allocated by
			  this routine and should be freed by the caller.)
			 (A value of NULL can be passed for this argument
			  if these values are not needed.)
			 (default is NULL)
	[match_error]	 specific error to match
			 (constants are in 'acnet_errors')
			 (default is OK which returns all errors)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVLEN		too much data requested
	negative value		ACNET format error indicating overall failure
	positive value		number of devices in error indicating partial
				success

	This function requires the following include files:

	cnsparam_h, dbprops_h, cbslib_h, acnet_errors_h

	Related functions:

	sr_get_save_error_c, sr_set_source_c, sr_get_device_raw_c,
	sr_get_device_c, sr_data_length_c, sr_sda_data_lengths_c,
	sr_status_c, sr_status_text_c, sr_is_on_c, sr_is_positive_c,
	sr_sda_snapshot_stats_c, sr_snapshot_header_c,
	sr_snapshot_info_c, sr_snapshot_info_list_c, sr_get_snapshot_c,
	sr_read_snapshot_c, sr_disconnect, sr_sda_cases_present_c,
	sr_sda_num_subcases_c, sr_sda_subcases_present_c, sr_sda_case_times_c

	C/C++ usage:

	short	*properties;
	short	*save_errors;
	int	status;
	int	file_number = FILE_NUMBER;
	int	num_devices;
	int	match_error = OK;
	int	*device_indices;

	status = sr_file_save_errors_c(file_number,num_devices,&device_indices,
				       &properties,&save_errors,match_error);