MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service … More...

Collaboration diagram for MqContextC_SendApi_Basics_CS_API:

Functions
void	csmqmsgque.MqContextC.SendEND (string token, long timeout=(long) MkTimeoutE.DEFAULT)
	`C#: ctx.SendEND(string token, long timeout = (long)MkTimeoutE.DEFAULT)` → C-API MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service …

void	csmqmsgque.MqContextC.SendEND_AND_CALLBACK (string token, MqServiceCCB callback, long timeout=(long) MkTimeoutE.DEFAULT)
	`C#: ctx.SendEND_AND_CALLBACK(string token, MqServiceICB\|MqServiceCCB\|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT)` → C-API finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback …

void	csmqmsgque.MqContextC.SendEND_AND_CALLBACK (string token, MqServiceICB callback, long timeout=(long) MkTimeoutE.DEFAULT)
	`C#: ctx.SendEND_AND_CALLBACK(string token, MqServiceICB\|MqServiceCCB\|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT)` → C-API finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback …

void	csmqmsgque.MqContextC.SendEND_AND_CALLBACK (string token, MqServiceIF callback, long timeout=(long) MkTimeoutE.DEFAULT)
	`C#: ctx.SendEND_AND_CALLBACK(string token, MqServiceICB\|MqServiceCCB\|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT)` → C-API finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback …

void	csmqmsgque.MqContextC.SendEND_AND_SUB (string token, MqServiceCCB callback, long timeout=(long) MkTimeoutE.DEFAULT)
	`C#: ctx.SendEND_AND_SUB(string token, MqServiceICB\|MqServiceCCB\|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT)` → C-API finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback …

void	csmqmsgque.MqContextC.SendEND_AND_SUB (string token, MqServiceICB callback, long timeout=(long) MkTimeoutE.DEFAULT)
	`C#: ctx.SendEND_AND_SUB(string token, MqServiceICB\|MqServiceCCB\|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT)` → C-API finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback …

void	csmqmsgque.MqContextC.SendEND_AND_SUB (string token, MqServiceIF callback, long timeout=(long) MkTimeoutE.DEFAULT)
	`C#: ctx.SendEND_AND_SUB(string token, MqServiceICB\|MqServiceCCB\|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT)` → C-API finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback …

void	csmqmsgque.MqContextC.SendEND_AND_TRANSACTION (string token, string callback, long timeout=(long) MkTimeoutE.DEFAULT)
	`C#: ctx.SendEND_AND_TRANSACTION(string token, string callback, long timeout = (long)MkTimeoutE.DEFAULT)` → C-API finish the send-data-block, call the remote service to do a longterm-transaction-call …

void	csmqmsgque.MqContextC.SendEND_AND_WAIT (string token, long timeout=(long) MkTimeoutE.DEFAULT)
	`C#: ctx.SendEND_AND_WAIT(string token, long timeout = (long)MkTimeoutE.DEFAULT)` → C-API finish the send-data-block, call the remote service and wait for result…

void	csmqmsgque.MqContextC.SendSTART ()
	`C#: ctx.SendSTART()` → C-API initialize the send-data-package. …

void	csmqmsgque.MqContextC.SendSYNC ()
	`C#: ctx.SendSYNC()` → C-API garantee that all pending asynchronous-service-calls are processed. …

Detailed Description

MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service …

calling a remote service and wait timeout seconds for an result. If timeout == 0 it is an asynchronous-service-call and if the timeout > 0 it is a synchronous-service-call.

service-call	blocking	timeout
synchronous	yes	timeout > 0
asynchronous	no	timeout == 0

blocking mean waiting max timeout seconds to finishing the service-call:

If the service-call is finished in less than timeout seconds… the results are available and can be processed.
If the service-call is NOT finished in timeout seconds… an timeout-error is created and the transaction will be canceled.

If an error was raised on the server during the service-processing… the following error-handling will be available

on a synchronous-service-call the error will be the result of the service-call
on a asynchronous-service-call with callback the error will be the result of the callback
on a asynchronous-service-call without callback the error will be send asynchronous from the server to the client . On the client the error will be raised on the NEXT event-handlng-command or as background-error if the MqSetupS.BgError function was defined.

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	ctx	the MqContextS instance to work on
[in]	token	the MqContextC SERVICE API to identify the service
[in]	timeout	in seconds until a timeout-error is raised (possible values like ProcessEvent) (`MK_TIMEOUT_DEFAULT=0`)

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

See also: MqSendSYNC

Function Documentation

◆ SendEND()

void csmqmsgque.MqContextC.SendEND	(	string	token,
		long	timeout = (long)MkTimeoutE::DEFAULT )

inline

C#: ctx.SendEND(string token, long timeout = (long)MkTimeoutE.DEFAULT) → C-API
MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service …

Definition at line 1431 of file MqContextC.cs.

                                                                                 {
      IntPtr token_cstr = Marshal.StringToHGlobalAnsi(token);
      MkErrorE errVal = Mq.MqSendEND(mkrt, hdl, token_cstr, timeout);
      Marshal.FreeHGlobal(token_cstr);
      MkErrorC.Check(hdl, errVal);
    }

◆ SendEND_AND_CALLBACK() [1/3]

void csmqmsgque.MqContextC.SendEND_AND_CALLBACK	(	string	token,
		MqServiceCCB	callback,
		long	timeout = (long)MkTimeoutE::DEFAULT )

inline

C#: ctx.SendEND_AND_CALLBACK(string token, MqServiceICB|MqServiceCCB|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT) → C-API
finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback …

Definition at line 1439 of file MqContextC.cs.

                                                                                                                     {
      IntPtr token_cstr = Marshal.StringToHGlobalAnsi(token);
      IntPtr callback_ptr = callback == null ? IntPtr.Zero : (IntPtr)GCHandle.Alloc(new MqCall(mkrt,callback));
      MkErrorE errVal = Mq.MqSendEND_AND_CALLBACK(mkrt, hdl, token_cstr, ServiceCall, callback_ptr, ServiceFree, timeout);
      Marshal.FreeHGlobal(token_cstr);
      MkErrorC.Check(hdl, errVal);
    }

◆ SendEND_AND_CALLBACK() [2/3]

void csmqmsgque.MqContextC.SendEND_AND_CALLBACK	(	string	token,
		MqServiceICB	callback,
		long	timeout = (long)MkTimeoutE::DEFAULT )

inline

C#: ctx.SendEND_AND_CALLBACK(string token, MqServiceICB|MqServiceCCB|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT) → C-API
finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback …

Definition at line 1448 of file MqContextC.cs.

                                                                                                                     {
      IntPtr token_cstr = Marshal.StringToHGlobalAnsi(token);
      IntPtr callback_ptr = callback == null ? IntPtr.Zero : (IntPtr)GCHandle.Alloc(new MqCall(mkrt,callback));
      MkErrorE errVal = Mq.MqSendEND_AND_CALLBACK(mkrt, hdl, token_cstr, ServiceCall, callback_ptr, ServiceFree, timeout);
      Marshal.FreeHGlobal(token_cstr);
      MkErrorC.Check(hdl, errVal);
    }

◆ SendEND_AND_CALLBACK() [3/3]

void csmqmsgque.MqContextC.SendEND_AND_CALLBACK	(	string	token,
		MqServiceIF	callback,
		long	timeout = (long)MkTimeoutE::DEFAULT )

inline

C#: ctx.SendEND_AND_CALLBACK(string token, MqServiceICB|MqServiceCCB|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT) → C-API
finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback …

Definition at line 1457 of file MqContextC.cs.

                                                                                                                    {
      IntPtr token_cstr = Marshal.StringToHGlobalAnsi(token);
      IntPtr callback_ptr = callback == null ? IntPtr.Zero : (IntPtr)GCHandle.Alloc(new MqCall(mkrt,callback));
      MkErrorE errVal = Mq.MqSendEND_AND_CALLBACK(mkrt, hdl, token_cstr, ServiceCall, callback_ptr, ServiceFree, timeout);
      Marshal.FreeHGlobal(token_cstr);
      MkErrorC.Check(hdl, errVal);
    }

◆ SendEND_AND_SUB() [1/3]

void csmqmsgque.MqContextC.SendEND_AND_SUB	(	string	token,
		MqServiceCCB	callback,
		long	timeout = (long)MkTimeoutE::DEFAULT )

inline

C#: ctx.SendEND_AND_SUB(string token, MqServiceICB|MqServiceCCB|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT) → C-API
finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback …

Definition at line 1466 of file MqContextC.cs.

                                                                                                                {
      IntPtr token_cstr = Marshal.StringToHGlobalAnsi(token);
      IntPtr callback_ptr = callback == null ? IntPtr.Zero : (IntPtr)GCHandle.Alloc(new MqCall(mkrt,callback));
      MkErrorE errVal = Mq.MqSendEND_AND_SUB(mkrt, hdl, token_cstr, ServiceCall, callback_ptr, ServiceFree, timeout);
      Marshal.FreeHGlobal(token_cstr);
      MkErrorC.Check(hdl, errVal);
    }

◆ SendEND_AND_SUB() [2/3]

void csmqmsgque.MqContextC.SendEND_AND_SUB	(	string	token,
		MqServiceICB	callback,
		long	timeout = (long)MkTimeoutE::DEFAULT )

inline

C#: ctx.SendEND_AND_SUB(string token, MqServiceICB|MqServiceCCB|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT) → C-API
finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback …

Definition at line 1475 of file MqContextC.cs.

                                                                                                                {
      IntPtr token_cstr = Marshal.StringToHGlobalAnsi(token);
      IntPtr callback_ptr = callback == null ? IntPtr.Zero : (IntPtr)GCHandle.Alloc(new MqCall(mkrt,callback));
      MkErrorE errVal = Mq.MqSendEND_AND_SUB(mkrt, hdl, token_cstr, ServiceCall, callback_ptr, ServiceFree, timeout);
      Marshal.FreeHGlobal(token_cstr);
      MkErrorC.Check(hdl, errVal);
    }

◆ SendEND_AND_SUB() [3/3]

void csmqmsgque.MqContextC.SendEND_AND_SUB	(	string	token,
		MqServiceIF	callback,
		long	timeout = (long)MkTimeoutE::DEFAULT )

inline

C#: ctx.SendEND_AND_SUB(string token, MqServiceICB|MqServiceCCB|MqServiceIF callback, long timeout = (long)MkTimeoutE.DEFAULT) → C-API
finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback …

Definition at line 1484 of file MqContextC.cs.

                                                                                                               {
      IntPtr token_cstr = Marshal.StringToHGlobalAnsi(token);
      IntPtr callback_ptr = callback == null ? IntPtr.Zero : (IntPtr)GCHandle.Alloc(new MqCall(mkrt,callback));
      MkErrorE errVal = Mq.MqSendEND_AND_SUB(mkrt, hdl, token_cstr, ServiceCall, callback_ptr, ServiceFree, timeout);
      Marshal.FreeHGlobal(token_cstr);
      MkErrorC.Check(hdl, errVal);
    }

◆ SendEND_AND_TRANSACTION()

void csmqmsgque.MqContextC.SendEND_AND_TRANSACTION	(	string	token,
		string	callback,
		long	timeout = (long)MkTimeoutE::DEFAULT )

inline

C#: ctx.SendEND_AND_TRANSACTION(string token, string callback, long timeout = (long)MkTimeoutE.DEFAULT) → C-API
finish the send-data-block, call the remote service to do a longterm-transaction-call …

Definition at line 1493 of file MqContextC.cs.

                                                                                                                  {
      IntPtr token_cstr = Marshal.StringToHGlobalAnsi(token);
      IntPtr callback_cstr = Marshal.StringToHGlobalAnsi(callback);
      MkErrorE errVal = Mq.MqSendEND_AND_TRANSACTION(mkrt, hdl, token_cstr, callback_cstr, timeout);
      Marshal.FreeHGlobal(token_cstr);
      Marshal.FreeHGlobal(callback_cstr);
      MkErrorC.Check(hdl, errVal);
    }

◆ SendEND_AND_WAIT()

void csmqmsgque.MqContextC.SendEND_AND_WAIT	(	string	token,
		long	timeout = (long)MkTimeoutE::DEFAULT )

inline

C#: ctx.SendEND_AND_WAIT(string token, long timeout = (long)MkTimeoutE.DEFAULT) → C-API
finish the send-data-block, call the remote service and wait for result…

Definition at line 1503 of file MqContextC.cs.

                                                                                          {
      IntPtr token_cstr = Marshal.StringToHGlobalAnsi(token);
      MkErrorE errVal = Mq.MqSendEND_AND_WAIT(mkrt, hdl, token_cstr, timeout);
      Marshal.FreeHGlobal(token_cstr);
      MkErrorC.Check(hdl, errVal);
    }

◆ SendSTART()

void csmqmsgque.MqContextC.SendSTART ( )

inline

C#: ctx.SendSTART() → C-API
initialize the send-data-package. …

Definition at line 1511 of file MqContextC.cs.

                              {
      MkErrorE errVal = Mq.MqSendSTART(mkrt, hdl);
      MkErrorC.Check(hdl, errVal);
    }

◆ SendSYNC()

void csmqmsgque.MqContextC.SendSYNC ( )

inline

C#: ctx.SendSYNC() → C-API
garantee that all pending asynchronous-service-calls are processed. …

Definition at line 1517 of file MqContextC.cs.

                             {
      MkErrorE errVal = Mq.MqSendSYNC(mkrt, hdl);
      MkErrorC.Check(hdl, errVal);
    }

Functions

Detailed Description

Function Documentation

◆ SendEND()

◆ SendEND_AND_CALLBACK() [1/3]

◆ SendEND_AND_CALLBACK() [2/3]

◆ SendEND_AND_CALLBACK() [3/3]

◆ SendEND_AND_SUB() [1/3]

◆ SendEND_AND_SUB() [2/3]

◆ SendEND_AND_SUB() [3/3]

◆ SendEND_AND_TRANSACTION()

◆ SendEND_AND_WAIT()

◆ SendSTART()

◆ SendSYNC()