XBSAREADER

Purpose:
The purpose of this utility is to measure how fast the Storage Manager can send data to ON-Bar through the XBSA protocol. The current XBSA protocol has a hard coded block size of ~64K this may limit the Storage Managers throughput capabilities. By running this utility you can measure the top speed in which a restore can be performed.
This utility can ONLY receive a backup object that was put there via the XBSAWriter Utility.

How To Use:
To use this utility you must first compile the C code to an executable. The suggested usage for running this utility is the following:
xbsareader -c -v 0
Options:
-c copy_ids This parameter should contain the copy id that was put in the copyfile by the XBSAwriter program.
-v Verbose mode. With verbose mode set to 0, the utility will dump the return values of some XBSA system call as well as the time it took for the entire data transferr to occur.
To use this utility simulate what onbar is doing you can create a script which will kick off a number of these process in parallel.

Sample Session
server>  ./xbsareader -c 21306.0 -v 0
Copyid            `21306.0'
BSAInit:                        Success
BSABeginTxn:            Success
BSAGetObject:           More data
BSAEndData              Success
After 1026 reads transfer rate is...
63488.0000 Kbytes in 20 seconds is 3174.4000 Kbytes/sec
BSAEndTxn:              Success
BSATerminate:           Success
server> 
server>

Download:
XBSAReader.tar
Not available yet. Please Email tiller@informix.com for an advanced copy.


Compiling the Source:
You must compile the source code to an executable. On Solaris platforms the complie line will look like the following:
cc xt_rest.c xt_error.c xt_xrtns.c /usr/lib/ibsad001.so -o xbsareader
Note: If you do not have a library called /usr/lib/ibsad001.so, then replace that library with what you have in the onconfig file for BAR_BSALIB_PATH parameter. 1