HP Large Objects System Management Manual
HP Large Objects System Management Manual – 543599.001 
Table of Contents 
1.  Introduction............................................................................................................5 
1.1  Why Storing Large Objects with SQL has limitations?.................................5 
1.2  Product Description .......................................................................................5 
2  Quick Start Guide ..................................................................................................7 
2.1  What is provided? ..........................................................................................7 
2.2  OSS Installation .............................................................................................7 
2.3  Use in Guardian .............................................................................................7 
2.4  Creating Buddy Groups, Sets and Spaces......................................................8 
2.5  Using the Test Program .................................................................................8 
3  The Large Object scheme ......................................................................................9 
3.1  SQL Store Concepts.......................................................................................9 
3.1.1  BuddyGroup...........................................................................................9 
3.1.2  BuddySet................................................................................................9 
3.1.3  BuddySpace ...........................................................................................9 
3.1.4  Free Space Map (FSM)........................................................................10 
3.1.5  Objects .................................................................................................10 
3.1.6  Segments..............................................................................................10 
3.1.7  Parms....................................................................................................10 
3.2  Core APIs.....................................................................................................10 
3.2.1  OpenBuddyGroup................................................................................10 
3.2.2  CloseBuddyGroup................................................................................11 
3.2.3  GetBuddyObject ..................................................................................11 
3.2.4  PutBuddyObject...................................................................................12 
3.2.5  AllocateBuddyObject...........................................................................13 
3.2.6  DeleteBuddyObject..............................................................................13 
3.2.7  GetSystemErrorString..........................................................................14 
3.3  Management APIs........................................................................................14 
3.3.1  CreateBuddyGroup ..............................................................................14 
3.3.2  DeleteBuddyGroup ..............................................................................15 
3.3.3  CreateBuddySet ...................................................................................15 
3.3.4  DeleteBuddySet ...................................................................................16 
3.3.5  CreateBuddySpace...............................................................................17 
3.3.6  DeleteBuddySpace...............................................................................18 
3.3.7  SetBuddyGroupParm...........................................................................19 
3.3.8  UpdateBuddyGroupUsage...................................................................19 
3.4  Utility Programs...........................................................................................20 
3.4.1  ReportBuddyConsistency ....................................................................20 
3.4.2  ReloadBuddySet ..................................................................................20 
3.5  Required Program........................................................................................21 
3.5.1  BuddyGroupMonitor............................................................................21 
3.6  Shell Scripts .................................................................................................22 
3.6.1  .profile script........................................................................................23 
3.6.2  define.sh script.....................................................................................24 
3.6.3  createCatalog.sh script.........................................................................24 
3.6.4  createObjectStore.sh script ..................................................................24 
3.6.5  createPartition.sh script........................................................................25 
3.6.6  metaData.sh script................................................................................26 
Page 3 of 37 










