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 opens. 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 opens. 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 path

      The path has to begin with a period (.).

      Example: .Examples.ApplicationTest

    • Relative path

      The test script has to be located in a subfolder in the folder of the calling script.

      Example: Subfolder.SubTest_A

    • No path

      The test script has to be located in the same folder as the calling script.

      Example: Test_A

    _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 specified in Test script to call to be edited

    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 of the Version (leave blank for newest) field

    Table 7. 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

    Used in the test script to be called (internal variable of the subscript)

    This is also the declaration of the interface variables.

    Example: Subscript_Var_A

    Variable

    • Name of the variable of the calling test script

      Its value is passed to the input parameter.

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

      Hint: A variable $ENV or a variable $EXEC, for example, can be passed as a variable.

    • Expression whose value is passed to the input parameter

      Example: $EXEC.TESTER_NAME = t.tester

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

    Move Up

    Moves the selected input parameter one line up

    Move Down

    Moves the selected input parameter one line down

    Remove

    Deletes all selected input parameters



    Table 8. Output Parameters

    Output parameter that acts as an interface between the calling test script and the called subscript

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

    Name

    • Name of the output parameter

      Set in the script to be called (internal variable of the subscript)

      This is also the declaration of the interface variables.

    • Expression whose value is passed to the variable

      Example: $EXEC.TESTER_NAME = t.tester

    • Literal (string) which is passed to the variable

      Example: RUN_THROUGH

    Variable

    Name of the variable of the calling test script

    Gets a value from the subscript

    Hint: A value of the called script is passed to the variable (and specified in Name) by an output parameter, as an expression, or as a literal.

    Move Up

    Moves the selected output parameter one line up

    Move Down

    Moves the selected output parameter one line down

    Remove

    Deletes all selected output parameters