LinkarClientSubroutine Method

Linkar Framework for .NET and Core

Executes a subroutine, synchronously only, with JSON input and output format.

Namespace: Linkar.Functions.Persistent.JSON
Assembly: Linkar.Functions.Persistent.JSON (in Linkar.Functions.Persistent.JSON.dll) Version: 2.3.1

Syntax

C++

Copy

public string Subroutine(
	string subroutineName,
	int argsNumber,
	string arguments,
	string customVars = "",
	int receiveTimeout = 0
)

Public Function Subroutine ( 
	subroutineName As String,
	argsNumber As Integer,
	arguments As String,
	Optional customVars As String = "",
	Optional receiveTimeout As Integer = 0
) As String

public:
String^ Subroutine(
	String^ subroutineName, 
	int argsNumber, 
	String^ arguments, 
	String^ customVars = L"", 
	int receiveTimeout = 0
)

member Subroutine : 
        subroutineName : string * 
        argsNumber : int * 
        arguments : string * 
        ?customVars : string * 
        ?receiveTimeout : int 
(* Defaults:
        let _customVars = defaultArg customVars ""
        let _receiveTimeout = defaultArg receiveTimeout 0
*)
-> string

Parameters

subroutineName String: Name of BASIC subroutine to execute.
argsNumber Int32: Number of arguments
arguments String: The subroutine arguments list. Each argument is a substring separated with the ASCII char DC4 (20).
customVars String (Optional): Free text sent to the database allows management of additional behaviours in SUB.LK.MAIN.CONTROL.CUSTOM, which is called when this parameter is set.
receiveTimeout Int32 (Optional): Maximum time in seconds that the client will wait for a response from the server. Default = 0 to wait indefinitely.

Return Value

String
The results of the operation.

Example

C++

Copy

using Linkar;
using Linkar.Functions.Persistent.JSON;

class Test
    {
        public string MySubroutine()
        {
            string result = "";
            try
            {
                CredentialOptions credentials = new CredentialOptions("127.0.0.1", "EPNAME", 11300, "admin", "admin");
                LinkarClient client = new LinkarClient();
                client.Login(credentials);

                result = client.Subroutine("SUB.DEMOLINKAR", 3,
                    "{" +
                    "  \"ARGUMENTS\": [" +
                    "    {" +
                    "      \"ARGUMENT\": \"0\"" +
                    "    }," +
                    "    {" +
                    "      \"ARGUMENT\": \"aaaa\"" +
                    "    }," +
                    "    {" +
                    "      \"ARGUMENT\": \"\"" +
                    "    }" +
                    "  ]" +
                    "}");
                client.Logout();
            }
            catch (Exception ex)
            {
                string error = ex.Message;
                // Do something
            }
            return result;
        }
    }

Imports Linkar
Imports Linkar.Functions.Persistent.JSON

Class Test

    Public Function MySubroutine() As String
        Dim result As String = ""

        Try
            Dim credentials As CredentialOptions = New CredentialOptions("127.0.0.1", "EPNAME", 11300, "admin", "admin")

            Dim client As LinkarClient = New LinkarClient()

            client.Login(credentials)

            result = client.Subroutine("SUB.DEMOLINKAR", 3,
                    "{" +
                    "  \"ARGUMENTS\": [" +
                    "    {" +
                    "      \"ARGUMENT\": \"0\"" +
                    "    }," +
                    "    {" +
                    "      \"ARGUMENT\": \"aaaa\"" +
                    "    }," +
                    "    {" +
                    "      \"ARGUMENT\": \"\"" +
                    "    }" +
                    "  ]" +
                    "}");

            client.Logout()
        Catch ex As Exception
            Dim[error] As String = ex.Message
            ' Do something

        End Try

        Return result
  End Function
End Class

Reference

LinkarClient Class

Linkar.Functions.Persistent.JSON Namespace