tracetronic: RemoteCommand¶

Vendor information

Vendor	Web page	Product name	Version
tracetronic GmbH	https://www.tracetronic.de	RemoteCommand

Operating system	Support
Windows	✓
Linux

Specifics¶

REMOTE-COMMAND provides system access to the host of Tool Server. For example, files can be transferred from or to the tool host or applications can be executed by using this tool.

For security reasons, REMOTE-COMMAND can only be used locally or if the ecu.test Tool Server communication has been secured (SSL client certificate).

Properties 🛈¶

Name	Available if	Default value	Valid values	Type	Description
Timeout for tool call ❲in sec.❳		‘600’		string	Timeout after which a tool call is aborted.

Jobs 🛈¶

CallCDll¶

Calls a cdecl function in a DLL file

Parameter

Name	Default value	Type	Description
args	[]	object	Argument list
dllFilePath		string	Absolute path of the DLL
functionName		string	Name of the function to be called

Return value

Name	Available if	Default value	Valid values	Type	Description
CallResult				object	Result of the function call

CallWinDll¶

Calls a stdcall function in a DLL file

Parameter

Name	Default value	Type	Description
args	[]	object	Argument list
dllFilePath		string	Absolute path of the DLL
functionName		string	Name of the function to be called

Return value

Name	Available if	Default value	Valid values	Type	Description
CallResult				object	Result of the function call

DeleteFile¶

Deletes a file from the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
remotepath				string	Remote file name with path

DeleteFolder¶

Deletes a directory from the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
recursive		False	[False, True]	bool	delete non-empty folder including content
remotepath				string	Remote path

DownloadDirRecursive¶

Copies a subdirectory from the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
localpath				string	Local directory
remotepath				string	Remote directory

DownloadFile¶

Copies a file from the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
localpath				string	Local file
remotepath				string	Remote file

ExecuteCommand¶

Executes a command

Parameter

Name	Default value	Valid values	Type	Description
args	[]		object	Argument list incl. program name
creationflags	0		int	creationflags
cwd			string	Execute inside directory
delay	0		int	Time to wait before requesting results in asynchronous execution
encoding	‘utf-8’		string	Character set for decoding of read characters. Set None for not decoded bytes.
env			object	Alternative environment variables
executeInShell	False	[False, True]	bool	Execute inside a command shell (cmd.exe)
inputtext			string	Text to be send to stdi
startupinfo			object	StartupInfo
sync	True	[False, True]	bool	Synchronous execution

Return value

Name	Available if	Default value	Valid values	Type	Description
ProcessResult				object	Tuple (return code, stdout content, stderr content)

HttpGet¶

Retrieves a document via HTTP or HTTPS

Parameter

Name	Available if	Default value	Valid values	Type	Description
url				string	URL

Return value

Name	Available if	Default value	Valid values	Type	Description
httpDocument				string	Content of the retrieved document

ListDir¶

Lists a directory recursively

Parameter

Name	Available if	Default value	Valid values	Type	Description
directory				string	The directory to be listed

Return value

Name	Available if	Default value	Valid values	Type	Description
directoryContent				object	Directory tree - each entry as a triple (name, path, isDir)

Ping¶

Pings the specified host

Parameter

Name	Available if	Default value	Valid values	Type	Description
ipAddressOrHostName				string	IP address or host name

Return value

Name	Available if	Default value	Valid values	Type	Description
pingResult				int	2 if ping successful

ReadRegistry¶

Reads a value from the registry

Parameter

Name	Default value	Type	Description
hKey	18446744071562067970	int	HKEY constant of win32con
subKey		string	Subkey
valueName		string	The value’s name

Return value

Name	Available if	Default value	Valid values	Type	Description
value				object	Value from registry

UploadDirRecursive¶

Copies a subdirectory to the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
localpath				string	Local directory
remotepath				string	Remote directory

UploadFile¶

Copies a file to the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
localpath				string	Local file
remotepath				string	Remote file