HP Large Objects System Management Manual

HP Large Objects System Management Manual – 543599.001
0 = not aborted
1 = aborted
3.3.7 SetBuddyGroupParm
Creates or amends a single specified parameter for a given BuddyGroup. Parameters
for a Buddy Group can only be amended/created whilst the Buddy Group is inactive.
This API does not check that values are sensible, only valid. It is therefore vital not to
change anything without understanding the affects on the system. See Appendix B,
for parameter descriptions.
Parameters are uniquely identified by a combination of the BuddyGroup, TokenNum,
and TokenString. The value of the parameter *pTokenValue is typically numeric, the
function taking a char so that all parameter types may be entered.
short SetBuddyGroupParm (const char *pBuddyGroupName //
input
, short TokenNum // input
, const char *pTokenString // input
, const char *pTokenValue // input
, short *pCallerTransAborted //
output
);
Return value:
0 = Successful
112 = Failed – Buddy Group not found
140 = Failed – Default parameters not found
100 = System error (call GetSystemErrorString)
pBuddyGroupName:
A 5 character alphanumeric name with no embedded spaces, for example:
GRP01 or B01.
TokenNum:
The TokenNumber used to identify the parameter to be created/amended.
pTokenString:
The TokenString used to identify the parameter to be created/amended. This
is an extra level of granularity from the TokenNum as it specifies whether the
parameter applies to ‘all’ powers of two, a specific power, or indeed if the
power is irrelevant for this parameter. See Appendix B, for more details on
the parameters.
pTokenValue:
The TokenValue to be created/amended.
pCallerTransAborted :
Indicates whether the caller’s TMF transaction has been aborted.
0 = not aborted
1 = aborted
3.3.8 UpdateBuddyGroupUsage
For a given Buddy Group the API calculates the percentage for each Buddy Space and
updates the pct_full column of the Buddy Space table. This enables the user to
prepare an SQL report listing the usage of each Buddy Set/Space.
Page 19 of 37