IBM Support

Learning more about Onbar

Troubleshooting


Problem

Learning more about Onbar is the first step in the troubleshooting process. This document provides you with educational information that can help you learn more about this topic.

Resolving The Problem

Troubleshooting OnBar Archive and Restore




Last Modified: August 30, 2010


Overview of Onbar components
http://publib.boulder.ibm.com/infocenter/idshelp/v115/index.jsp?topic=/com.ibm.bar.doc/ids_bar_348.htm


Brief explanation of X/Open Backup Services Application Programmer's Interface (XBSA), the interface that facilitates communication between Onbar and a Storage Manager
http://publib.boulder.ibm.com/infocenter/idshelp/v115/index.jsp?topic=/com.ibm.bar.doc/ids_bar_351.htm


Explanation of the XBSA functions and how Onbar uses them
http://www.ibm.com/support/docview.wss?rs=630&uid=swg21403311


Examples of successful XBSA functions from the bar_debug.log
http://www.ibm.com/support/docview.wss?rs=630&uid=swg21394007


Format of Onbar activity log (bar_act.log)
Column Number
Description
Sample value from first line of example below
1
Date2009-05-07
2
Time10:41:34
3
Child process id26404
4
Parent process id26402
5
Message/opt/informix/bin/onbar_d -b -L 0

Here is an example of a bar_act.log:


2009-05-07 10:41:14 26404 26402 /opt/informix/bin/onbar_d -b -L 0

2009-05-07 10:41:34 26404 26402 Begin level 0 backup rootdbs.

2009-05-07 10:41:34 26404 26402 Successfully connected to Storage Manager.

2009-05-07 10:41:34 26404 26402 XBSA Error (BSACreateObject): A system error occurred. Aborting XBSA session.

2009-05-07 10:41:46 26404 26402 /opt/informix/bin/onbar_d: process exit 3 (0x03)

Format of Onbar Debug log (bar_debug.log)
Column Number
Description
Sample value from first line of example below
1
Date2009-05-07
2
Time10:41:34
3
Child process id26404
4
Parent process id26402
5
MessageBSACreateObject: enter

The Message always begins with the name of the function Onbar is running. Any function name not beginning with "BSA" is an Onbar function. If a function name begins with "BSA" then it is an XBSA function.

Here is an example of a bar_debug.log:


2009-05-07 10:41:34 26404  26402 BSACreateObject: enter

2009-05-07 10:41:34 26404  26402 BSACreateObject: object owner      name                          createTime

2009-05-07 10:41:34 26404  26402 BSACreateObject: INFORMIX informix /prod /prod/rootdbs 0  0  0  0  0  0

2009-05-07 10:41:34 26404  26402 BSACreateObject: copytype copyid        restoreOrder    size  resource type status desc objectInfo

2009-05-07 10:41:34 26404  26402 BSACreateObject: 3          0 0               0 0          0 52822016  R 4    1

2009-05-07 10:41:34 26404  26402 BSACreateObject: return 3 (0x03)



Format of an XBSA function in bar_debug.log
Any function name not beginning with "BSA" is an Onbar function. If a function name begins with "BSA" then it is an XBSA function.

An XBSA function in the bar_debug.log usually has a designated starting and ending point. The starting point is indicated by the function name followed by the word "enter". Essentially, this is Onbar telling the Storage Manager(SM) that it wants to run a particular function.

The ending point is indicated by the function name, followed by the word "return", then a number that is a status message from the SM. Essentially, this is the SM telling Onbar that it completed the function with the status returned. 0x00 indicates successful completion.


2009-09-24 14:52:30 602366  893162 BSAInit: enter     <-- starting point

2009-09-24 14:52:30 602366  893162 BSAInit: input tokenPtr  owner INFORMIX informix

2009-09-24 14:52:30 602366  893162 BSAInit: return 0 (0x00)     <-- ending point


Onbar return codes
http://publib.boulder.ibm.com/infocenter/idshelp/v115/index.jsp?topic=/com.ibm.bar.doc/ids_bar_447.htm

[{"Product":{"code":"SSGU8G","label":"Informix Servers"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"--","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF025","label":"Platform Independent"},{"code":"PF008","label":"DYNIX\/ptx"},{"code":"PF010","label":"HP-UX"},{"code":"PF015","label":"IRIX"},{"code":"PF016","label":"Linux"},{"code":"PF022","label":"OS X"},{"code":"PF026","label":"Reliant UNIX"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"11.1;11.5;11.7","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
16 June 2018

UID

swg21381464

Page Feedback