vtk_fsgroup

Usage:           
vtk_fsgroup_create fullname [-weight w] [-window ts]

Description:     
Creates the fairshare group named 'fullname' if it does not exist. 
The options -weight and -window specify the weight and time window of the fsgroup. 
If absent, default values are assigned. Example: If /time/regression does not exist before this VTK call, 
it will be created along with /time/regression/projectA vtk_fsgroup_create /time/regression/projectA

Example:
vtk_fsgroup_create /time/regression/projectA


Returns:         
VOV id of created fairshare group or the string 'nochange' if the fsgroup already exists.

Note:            
If fullname contains components that do not exist, they are created automatically, with default values for their weight 
and time window. When the fsgroup exists, nochange is returned even when a different weight or window is given, and the fsgroup's
values are unchanged.

Usage:         
vtk_fsgroup_delete fsgid

Description:   
Deletes the fairshare group having VOV id 'fsgid' and BEWARE! all its subordinates.

Returns:       
VOV status code

Usage:         
vtk_fsgroup_find fullname arrayname

Description:   
Retrieves information into the array named by 'arrayname' about the fairshare group named 'fullname'

Returns:       
VOV id of fairshare group if found, or 0 if there is no such fairshare group

Note:          
In either case, the array element 'found' is set to 1 or 0 respectively if the fairshare group exists or does not.

Example:
vtk_fsgroup_find /time/users/jchen info
parray info 
...array output...

Usage:         
vtk_fsgroup_get id arrayname

Description:   
Retrieves information into the array named by 'arrayname' about the FairShare group named 'fullname'

Returns:
VOV id of FairShare group if found, or 0 if there is no such FairShare group

Usage:         
vtk_fsgroup_set fsgid arrayname

Description:   
Sets the values of the FairShare group having VOV id 'fsgid' to those in the 
array named by 'arrayname'. Only the array slots 'weight', 'window', and 'owner' 
are {used;} the values of other array slots are ignored.

Returns:
VOV status code

Usage:         
vtk_fsgroup_update 

Description:   
Forces the server to update the statistics of the FairShare groups, such as 
Target Shares, Actual Shares, Excess Shares. Calling this function leaves a message 
in server log that says Updated fairshare statistics.

Returns:       
VOV status code