sr_get_device_raw_c

	status.i4.v = sr_get_device_raw_c(device_indices.i4a.r,
					  properties.i2a.r, file_number.i4.v,
					  data.i1a.r, errors.i2a.r
					  [,lengths.i2a.r] [,offsets.i2a.r]
					  [,num_devices.i4.v]
					  [,data_source.i4.v]
					  [,case_number.i4.v]
					  [,is_snapshot.i4.v] [,user_id.i4.v]
					  [,ret_lengths.i2a.r]
					  [,sda_usage.i1a.r]
					  [,options.u4.v])

	This routine returns raw data that has been previously saved by
	the save/restore system.  If "num_devices" is specified, information
	for a list of devices can be retrieved.

	device_indices	device index or array of device indices
	properties	property index or array of property indices
			(If the first value is less than zero, all devices
			 will be requested with a property index which is
			 equal to the absolute value of this argument.)
			(constants are in dbprops)
	file_number	file number from which to retrieve data
			(This is the subsystem number or user key 1 for
			 detached snapshot manager data.)
	data		returned device information
	errors		returned ACNET status or array of status values
	[lengths]	device length or array of lengths for support of
			array devices (default is NULL which results in
			using the database maximum size for each device)
	[offsets]	raw data offset or array of data offsets in bytes
			(default is NULL which results in the use of an
			 offset of 0 for all devices)
	[num_devices]	number of devices (default is 1)
	[data_source]	source of data
			(CLIB_DEFAULT_ARG -> use previously selected source
					     (default),
			 SRMNGR_NORMAL -> normal save/restore files,
			 SRMNGR_SDA_DATA -> SDA data,
			 SRMNGR_SNAP_DATA -> detached snapshot manager data)
	[case_number]	SDA case number  (This is the record number or
			user key 2 for detached snapshot data.)
			(default (CLIB_DEFAULT_ARG) is SDA_DEFAULT_CASE_NUMBER
			 for SDA data and 0 for detached snapshot data)
	[is_snapshot]	request is for snapshot data (default is FALSE unless
			the data source is SRMNGR_SNAP_DATA)
			(TRUE -> snapshot data,
			 FALSE -> normal data)
	[user_id]	user ID or SDA subcase (This is user ID for detached
			snapshot manager data or the subcase number for
			SDA data.)  (default (CLIB_DEFAULT_ARG) is
			SDA_DEFAULT_SUBCASE_NUMBER for SDA data and
			0 for detached snapshot manager data)
	[ret_lengths]	actual returned length or array of lengths in bytes
			(default is NULL)
	[sda_usage]	null terminated SDA usage string (This argument only
			has meaning if the data source is SDA.)
			(default is NULL which results in Collider shot access)
	[options]	retrieval options
			(SRMNGR_OPT_NONE -> no options selected (default),
			 SRMNGR_OPT_ALLOW_OBSOLETE -> allow access to values
						      for obsolete devices)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid data source or case number
	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_set_source_c, sr_data_length_c, sr_sda_data_lengths_c,
	sr_get_device_c, sr_status_c, sr_status_text_c, sr_is_on_c,
	sr_is_positive_c, sr_snapshot_header_c, sr_snapshot_info_c,
	sr_snapshot_info_list_c, sr_sda_snapshot_stats_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:

	char	data[RAW_LENGTH];
	char	*sda_usage = (char *) NULL;
	short	properties[NUM_DEVICES] = {PRSET};
	short	errors[NUM_DEVICES];
	short	lengths[NUM_DEVICES] = {RAW_LENGTH};
	short	offsets[NUM_DEVICES] = {0};
	short	ret_lengths[NUM_DEVICES];
	int	status;
	int	device_indices[NUM_DEVICES] = {14430};
	int	file_number = 0;
	int	num_devices = NUM_DEVICES;
	int	data_source = SRMNGR_NORMAL;
	int	case_number = SDA_DEFAULT_CASE_NUMBER;
	int	subcase_num = SDA_DEFAULT_SUBCASE_NUMBER;
	int	is_snapshot = FALSE;
	unsigned int	options = SRMNGR_OPT_NONE;

	status = sr_get_device_raw_c(device_indices,properties,file_number,
				     data,errors,lengths,offsets,
				     num_devices,data_source,case_number,
				     is_snapshot,subcase_num,ret_lengths,
				     sda_usage,options);