Set the configuration variables to the specified value on the specified systems.
Parameters
<config_var>[(<process_name>)]=[<value>]
When <process_name> is specified, a value is set only for the process specified in (<process_name>). Process-specific settings have higher priority than general settings. To reset a value to its default setting, do not specify <value>. Resetting the general settings does not affect the specic settings, and vice versa.
Note that the values are set in the nodeinfo file on the managed node. Different settings in the opcinfo file will overwrite any settings produced with this method.
If an exact match cannot be found, the behavior is as follows: If a node is specified without a domain, it is compared with a short name (until the first '.') in all OV_ManagedNode WMI instances that have entered FQDN as a Primary Node Name. Otherwise, if a node is specified with FQDN, a short name (until the first '.') is compared with an exact match (also a short name) in OV_ManagedNode WMI instances.
If more than one matching OV_ManagedNode WMI instance is found, an error is reported.
Node groups in the path are identified with the node group caption (that is, the Caption property of the OV_NodeGroup WMI instance).
Returning Parameter
None.
HRESULT Return Values
Description
The SetConfigVarAsync method sets the configuration variable to the specified value on the specified systems.
After having set a configuration variable with this method, the agents must be restarted for the new values to take affect.
Nodes are specified with some or all of the following parameters:
If any parameter is not used, it should be passed to the method as an empty Variant.
Even when the node is included in more than one parameter, remote administration is performed only once.
To also include all subgroups of the specified node group, call the method with the parameter bInclSubGroups set to VARIANT_TRUE. It defaults to VARIANT_FALSE (subgroups will not be enumerated).
To specify all managed nodes, specify a string with a single backslash character ("\") as a parameter varNodeGroupPaths, leave the parameters varNodePrimNames, varNodeIds, and varNodeGroupIds empty, and set the parameter bInclSubGroups to VARIANT_TRUE.
This is an asynchronous method. For a comparison of the synchronous and asynchronous methods, see the description of the IOvRemoteAgent interface.