Specifying the location of the XBSA Library

By default, ON-Bar looks for the XBSA shared library in $INFORMIXDIR/lib/ibsad001.s[ol] on UNIX™. To specify a different name or location of the XBSA shared library, use the BAR_BSALIB_PATH configuration parameter.

UNIX

You can also make $INFORMIXDIR/lib/ibsad001.s[ol] a symbolic link to the correct library.

For example, if you are using ISM, you can do either of the following:
  • Link $INFORMIXDIR/lib/ibsad001.so to $INFORMIXDIR/lib/libbsa.so
  • Set BAR_BSALIB_PATH to $INFORMIXDIR/lib/libbsa.so
For example, if you are using TSM, you can do either of the following:
  • Link $INFORMIXDIR/lib/ibsad001.so to $INFORMIXDIR/lib/libtxbsa.so
  • Set BAR_BSALIB_PATH to $INFORMIXDIR/lib/libtxbsa.so

Windows™

On Windows, because no default XBSA shared library name exists, you must specify its name and location in the BAR_BSALIB_PATH configuration parameter. For example:
  • If you are using ISM, set BAR_BSALIB_PATH to %ISMDIR%\bin\libbsa.dll.
  • If you are using TSM, set BAR_BSALIB_PATH to %DIR%\bin\libtxbsa.dll.

If you are using a third-party storage manager, ON-Bar must use the version of the XBSA library that the storage-manager manufacturer provides. For more information, see BAR_BSALIB_PATH configuration parameter and your release notes.

Important: To set the path name of the XBSA library with the BAR_BSALIB_PATH configuration parameter in the onconfig file, specify the absolute path name. If you specify a relative path name, then the following message is written to the ON-Bar activity log: BAR_BSALIB_PATH in ONCONFIG is not an absolute path name.