ICICommandSettings - Command Settings Interface

Commands can execute programs, scripts, or batch files with or without command line arguments. Commands can be invoked directly by a user from their client (if permitted by the Server administrator) or as an automated action from the Server’s Event Rules. When the Event Rule is triggered, the Server executes the specified custom Command. To configure the Server to execute Commands, you first create the command, then add the command to an Event Rule.

The ICICommandSettings interface allows you to make changes to the settings of a Site's custom Commands. Access the ICICommandSettings interface with the ICISite : GetCommandSettings method.

When you change a custom command with the ICICommandSettings interface, you must call ICIServer's ApplyChanges method for the changes to take effect.

interface ICICommandSettings : IDispatch

In the Members column, "Function" and "Sub" indicate that the member is a method; "Property" indicates that it is a property.

Example

Set cs = s.GetCommandSettings(aCommands(i))

 

Members

How It's Used

Applicable Version

Sub AddUserPermission(bstrUser As String)

Adds user to list of users or Settings Templates who are permitted to execute the command.

HRESULT AddUserPermission([in] BSTR bstrUser);

All versions

Property Description As String

Description of command.

HRESULT Description([out, retval] BSTR *pVal);

HRESULT Description([in] BSTR newVal);

All versions

Property EnableProcessTimeOut As Boolean

Retrieve or specify whether process timeout is enabled.

HRESULT EnableProcessTimeOut([out, retval] VARIANT_BOOL *pVal);

HRESULT EnableProcessTimeOut([in] VARIANT_BOOL newVal);

TRUE=Enabled; FALSE=Disabled

All versions

Property Executable As String

Name of file executed with the command.

HRESULT Executable([out, retval] BSTR *pVal);

HRESULT Executable([in] BSTR newVal);

All versions

Function GetUserPermissions() As Variant

Retrieves an array of users or Settings Templates who have permission to execute the command.

HRESULT GetUserPermissions([out, retval] VARIANT *aUsers);

All versions

Property IsEnabled As Boolean

Retrieve or specify whether command is enabled.

HRESULT IsEnabled([out, retval] VARIANT_BOOL *pVal);

HRESULT IsEnabled([in] VARIANT_BOOL newVal);

TRUE=Enabled; FALSE=Disabled

All versions

Property LogPath As String

Path to log for the command.

HRESULT LogPath([out, retval] BSTR *pVal);

HRESULT LogPath([in] BSTR newVal);

Examples (VBScript):

Retrieving:

logPath = Command.LogPath

Specifying:

Command.LogPath = "C:\" & Command.Name & ".log"

EFT Server v6.1 and later

Property MinNumOfParams As Long

Minimum number of parameters required to execute the command.

HRESULT MinNumOfParams([out, retval] long *pVal);

HRESULT MinNumOfParams([in] long newVal);

All versions

Property MinNumOfParamsMsg As String

Retrieves or changes the message sent when the wrong number of parameters is provided to execute a command.

HRESULT MinNumOfParamsMsg([out, retval] BSTR *pVal);

HRESULT MinNumOfParamsMsg([in] BSTR newVal);

All versions

Property Name As String

Name of the command. (Do not confuse with Executable.)

HRESULT Name([out, retval] BSTR *pVal);

HRESULT Name([in] BSTR newVal);

All versions

Property Parameters As String

Retrieves or changes the list of parameters required to execute command.

HRESULT Parameters([out, retval] BSTR *pVal);

HRESULT Parameters([in] BSTR newVal);

All versions

Property ProcessTimeOut As Long

Number of seconds to before timeout if command fails to execute.

HRESULT ProcessTimeOut([out, retval] long *pVal);

HRESULT ProcessTimeOut([in] long newVal);

All versions

Property RedirectOutputToClient As Boolean

Retrieve or specify whether to redirect output to the client.

HRESULT RedirectOutputToClient([out, retval] VARIANT_BOOL *pVal);

HRESULT RedirectOutputToClient([in] VARIANT_BOOL newVal);

TRUE=Enabled; FALSE=Disabled

All versions

Property RedirectOutputToLog As Boolean

Retrieve or specify whether to redirect output to the log.

HRESULT RedirectOutputToLog([out, retval] VARIANT_BOOL *pVal);

HRESULT RedirectOutputToLog([in] VARIANT_BOOL newVal);

TRUE=Enabled; FALSE=Disabled

All versions

Sub RemoveUserPermission(bstrUser As String)

Removes user or Settings Template from list of users or Settings Templates who are permitted to execute the command.

HRESULT RemoveUserPermission([in] BSTR bstrUser);

All versions

Property RequireParams As Boolean

Retrieve or specify whether parameters are required to execute the command.

HRESULT RequireParams([out, retval] VARIANT_BOOL *pVal);

HRESULT RequireParams([in] VARIANT_BOOL newVal);

TRUE=Require parameters; FALSE=Do not require parameters

All versions

Dialog Box Equivalents

The ICICommandSettings interface methods and properties correlate to the following fields and controls in the EFT Server administration interface. (The FTP Custom Command Specific dialog box appears when you click Configure.)