Transaction ID returned from OV_Transaction::Start().
Script
Contains a Perl script.
Caption
Caption (Display Name). If a tool with the same Caption/Display
is already a child of the parent tool group, nothing happens, and
the method fails with MDLAPI_E_TOOL_HIERPATH_EXISTS. If the Caption
parameter is an empty string, contains invalid characters, or has
more than 1024 characters, the method fails with
MDLAPI_E_INVALID_CAPTION.
ParentName
The Name property of the instance of OV_Tools to which the
newly created tool is added. Optional parameter. If you do not
specify the parameter, or if it is equal to an empty string, the
root tool group is used. If the specified tool group does not
exist, the method fails with
MDLAPI_E_PARENT_TOOLGROUP_NOT_EXIST.
Name
The Name property of the instance of OV_Action to be created.
Optional parameter. If you do not specify the parameter, or if it
is equal to an empty string, it is created as a new GUID. If a tool
with the same Name already exists, nothing happens, and the method
fails with MDLAPI_E_TOOL_NAME_EXISTS.
Description
Copied to the Description property. Optional parameter.
ExecuteOn
Copied to the ExecuteOn property. Optional parameter. Default
is 0 ("Management Server").
IOType
Copied to the IOType property. Optional parameter. Default is 0
("NoOutput").
EditLogin
Copied to the EditLogin property. Optional parameter. Default
is false.
ExecuteAsUser
Copied to the ExecuteAsUser property. Optional parameter.
RequirePassword
Copied to the RequirePassword property. Optional parameter.
Default is false.
Password
Copied to the Password property. This parameter is applicable
only when RequirePassword is equal to true. Optional
parameter.
PredefinedList
Copied to the PredefinedList property. This parameter is
applicable only when ExecuteOn is equal to 2 ("Node List").
Optional parameter.
Calling Convention
These methods can be called from a WMI class or instance
object.
Description
Creates a tool (new instance of OV_Action) as a Perl script, and
adds it to an existing tool group (instance of OV_Tools).
All parameters are validated before the tool is actually
generated. If any parameter does not match, the method fails with
MDLAPI_E_INVALID_PARAMETER.
Return Value
Instance of the newly created OV_Action.
Extended Status Codes
MDLAPI_E_INVALID_PARAMETER
Parameter is not valid.
MDLAPI_E_INVALID_CAPTION
Specified object Caption parameter is not valid.
MDLAPI_E_TOOL_NAME_EXISTS
Tool with the same Name already exists.
MDLAPI_E_TOOL_HIERPATH_EXISTS
Tool with the same Caption is already a child of the parent
tool group.
MDLAPI_E_PARENT_TOOLGROUP_NOT_EXIST
Parent Tool Group does not exist.
MDLAPI_E_TRANSACTION_NOT_EXIST
Transaction with the specified ID does not exist.
500 Internal Server Error
Internal Server Error
The server encountered an internal error or
misconfiguration and was unable to complete
your request.
Please contact the server administrator at
webmaster@systemmanager.forsenergy.ru to inform them of the time this error occurred,
and the actions you performed just before this error.
More information about this error may be available
in the server error log.
Additionally, a 500 Internal Server Error
error was encountered while trying to use an ErrorDocument to handle the request.