Veritas Cluster Server Bundled Agents Reference Guide

FileShare agents
CompositeFileShare agent
85
About ForceControl function
ForceControl is a FileShare agent function that allows you to reset the file share
properties as per what is defined in the VCS configuration. The agent overwrites
all modifications made to the file share properties, either externally or from within
VCS, and sets the properties as per what you had defined while configuring the
file shares in VCS. This function overrides the FileShare agent's AutoControl
attribute settings.
You can run the ForceControl function from the command line. To run the
ForceControl function on a fileshare resource, type the following command:
hares -action ForceControl
-sys
Here, is the name of the file share resource for which
you want to reset the properties and is the name of the cluster
node on which that file share resource is online.
For example, to run the ForceControl function on a FileShare resource A_fileshare
that is currently online on a cluster node Node1, type the following:
hares -action A_fileshare ForceControl -sys Node1
The changes take effect on the next agent monitor function.
Resource type definition
type CompositeFileShare
static keylist SupportedActions = { ForceControl }
static i18nstr ArgList[] = { "LanmanResName:VirtualName", MaxUsers,
"MountResName:MountPath", HiddenShare, ShareSubdirectories,
HideChildShares, AutoShare, AutoControl, ClientCacheType,
PathAndShareName, UserPermissions, AccessBasedEnumeration,
ShareComment }
str LanmanResName
str MaxUsers
str MountResName
i18nstr UserPermissions{} = { Everyone=READ_ACCESS }
boolean HiddenShare = 0
boolean ShareSubdirectories = 0
boolean HideChildShares = 0
boolean AutoShare = 1
boolean AutoControl = 1
i18nstr PathAndShareName{}
str ClientCacheType = MANUAL