HP Large Objects System Management Manual

HP Large Objects System Management Manual – 543599.001
This API would run periodically by the system administrator to monitor the usage of
storage both at BuddySet and BuddySpace level. When a BuddySpace becomes close
to full, additional BuddySpace files should be created using the CreateBuddySpace
API.
Notes:
1) This is a stand-alone API and does not require an application to previously call
OpenBuddyGroup or subsequently call CloseBuddyGroup.
2) Depending on the size and number of BuddySets this API may take some time to
complete.
3) A shell script with a sample SQL report is provided (see usageReport.sh in the
section shell scripts).
short UpdateBuddyGroupUsage (const char *pBuddyGroupName //
input
, short *pCallerTransAborted ); //
output
);
Return value:
0 = Successful
112 = Failed – Buddy Group not found
113 = Failed – Buddy Group Inactive
100 = System error (call GetSystemErrorString)
pBuddyGroupName:
is a 5 character alphanumeric name with no embedded spaces, for example:
GRP01 or B01.
pCallerTransAborted:
Indicates whether the caller’s TMF transaction has been aborted.
0 = not aborted
1 = aborted
3.4 Utility Programs
3.4.1 ReportBuddyConsistency
For a specified Buddy Group, this program checks the consistent usage of Buddy
Spaces. Any inconsistencies are reported back to the command line in free format
text. The information displayed enables a technician to subsequently query the Object
Buddy row and manually take appropriate corrective action. As all database
operations within the Large Object scheme are TMF protected, such inconsistencies
would be the result of incorrect administrative operations. So, it is envisaged that the
only corrective action would be to restore from a backup. The program logic does not
provide any corrective action to resolve the errors.
buddycon <Buddy Group Name>
3.4.2 ReloadBuddySet
This program moves objects from one Buddy Set into another. The in and out Buddy
Sets must belong to the same Buddy Group. The unique objectId used by application
Page 20 of 37