Skip to main content

Element: Remote Call

Symbol: _tm_icon_remote_call.png

Function: The element starts a new CODESYS instance and executes a test script in the new CODESYS instance and/or a local test script from the first (current) CODESYS instance. Both test scripts can run parallel.

The _tm_icon_remote_call.png Remote call test element contains both the _tm_icon_remote_script.png <Empty Remote Call> element and the _tm_icon_call.png <Empty Local Call> element.

When you select a _tm_icon_remote_call.png Remote Call element in the test script, the Remote Call tab will open. On this tab, you configure the settings for the new CODESYS instance which contains the external script.

When you select _tm_icon_remote_script.png <Empty Remote Call> or _tm_icon_call.png <Empty Local Call> in the test script, the Call tab will open. For the remote call, you configure the call of the test script which runs in the new CODESYS instance. For the local call, you configure the call of the test script which runs in the current CODESYS instance.

Tab: Remote Call

Timeout for the remote script (seconds)

Maximum time span that the new CODESYS instance is allowed to run

If this time span is exceeded, then the instance is ended automatically.

Specified in seconds

Profile of remote instance

Profile of the new CODESYS instance

Specify the profile name exactly as it is displayed in the Help → About dialog of the development system or in the start menu on the computer.

The profile is specified without quotation marks.

If the field is blank, then the current profile is used.

Example: CODESYS V3SP13

Path of remote executable

Program path of CODESYS.exe of the new instance

If a path is specified here, then a value must be specified in Profile of remote instance. If a path is not specified, then the current installation of CODESYS is used.

Remote executable arguments

Command-line parameter for calling the new CODESYS instance

All command-line parameters of CODESYS are possible.

Note: The command-line parameters can cause conflicts with the test script of the new CODESYS instance, for example when a project is opened by the command-line parameters and the test script also opens a project.

Installation name of remote instance

Installation name as displayed in CODESYS Installer. This name has to be specified if the external installation was installed with the CODESYS Installer.

Tab: Call

Test script to call

A test script can be called with the following information:

  • Absolute paths

    All paths that contain a dot are considered absolute paths. It does not matter whether or not the dot is at the beginning.

    Examples:

    • .Script

    • .Folder_1.<folders>.Folder_N.Script

    • Folder_1.<folders>.Folder_N.Script

  • Relative paths

    • With relative paths, you can reference only scripts which are located in the same folder as the calling script.

    • You reference scripts in subfolders only by means of absolute paths.

Recommendation

Use absolute paths. The Input Assistant helps you avoid having to manually enter the full path.

_tm_icon_copy_selection_device_tree.png

Copies the absolute path of a script selected on the Test Scripts tab of the Test Manager view to the input field

_tm_icon_open_script.png

Opens the test script for processing which is specified in Test script to call.

Version (leave blank for newest)

Version of the test script which is called

Example: 2.1.0

If the field is blank, then the newest version is used automatically.

_cds_icon_delete.png

Removes the entry from the Version (leave blank for newest) field

Table 17. Input parameter

Input parameter which acts as an interface between the calling test script and the called test script

Hint: The input parameter name and variable name may be identical.

Name

Name of the input parameter

At the same time, this is also the declaration of the interface variable that can be used in the test script to be called.

Example: Subscript_Var_A

Variable

  • Name of the variable of the calling test script

    The value of the variable is passed to the input parameter.

    Note: The variable is declared in the calling test script.

  • Literal (string) which is passed to the input parameter

Up

Moves the selected input parameter one line up

Down

Moves the selected input parameter one line down

Remove

Deletes all selected input parameters



Table 18. Output parameter

Output parameter which acts as an interface between the calling test script and the subscript to be called

Hint: The output parameter name and variable name may be identical.

Name

Name of the output parameter

At the same time, this is the declaration of the interface variable which can be used in the calling test script.

Variable

Name of the variable in the called test script.

Note: The variable must exist in the called test script.

Up

Moves the selected output parameter one line up

Down

Moves the selected output parameter one line down

Remove

Deletes all selected output parameters