OpenTTCN/2.56.0/ANSI C SDK library reference/TRI/triSend

From OpenTTCN

triSend

The triSend function is called in the background by the library to indicate that the test execution has a frame to be sent to the SUT.

TriStatus triSend(
    const TriComponentId* componentId,
    const TriPortId* tsiPortId,
    const TriAddress* sutAddress,
    const TriMessage* sendMessage);

Parameters

componentId		Identification of test component that initiated send request through TTCN-3 send statement.
tsiPort		Name and optionally port array index of the TSI port through which the message was sent.
sutAddress		Address specified in the to clause of the TTCN-3 send statement that initiated this request, if any. Address is supplied in already encoded form to this function.
sendMessage		Message content in already encoded form to be sent to the SUT, originally specified in unencoded form as a parameter of the TTCN-3 send statement that initiated this request.

Return values

TRI_OK on success, TRI_ERROR on error. If TRI_ERROR is returned, test case error verdict is assigned and expedited test case termination is performed.

Remarks

This function belongs to message-based communication API. Several copies of this same function call may be running at the same time in several execution threads of the same adapter process, each with its own private copy of function parameters. Upon invocation, callback handler implemented by this function shall take prompt actions and deliver best effort to send the frame to the SUT. Execution of TTCN-3 send statement blocks until this user-implemented callback handler returns.

Requirements

Header	<tri/tri.h>
Library	openttcn-tsa-mt.lib
Compatibility	ETSI ES 201 873-5 (TRI), OpenTTCN ANSI C SDK 2.x and higher