tracetronic: RemoteCommand

Legacy/internal identifier: REMOTE-COMMAND

Vendor information

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

Categories

MDL 🛈	APL 🛈	BAN 🛈	BMA 🛈	SVC 🛈	DGN 🛈	FIU 🛈	EES 🛈	FCT 🛈	DBG 🛈	IMG 🛈	AUDIO 🛈	ENVSIM 🛈	ENVCOM 🛈

Platform

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

Parameterization

Parameter

Name	Available if	Default value	Valid values	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

Parameterization

Parameter

Name	Available if	Default value	Valid values	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

Parameterization

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

Parameterization

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

Parameterization

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

Parameterization

Parameter

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

ExecuteCommand

Executes a command

Parameterization

Parameter

Name	Available if	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

Parameterization

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

Parameterization

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

Parameterization

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

Parameterization

Parameter

Name	Available if	Default value	Valid values	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

Parameterization

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

Parameterization

Parameter

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

2025-12-05