THE TTCN-3 INTERFACES

// INTERFACES // STIMULI // RESPONSES // CODEC // ADAPTER TYPES // CODEC TYPES // STANDARDS

RESPONSE ADAPTER

This section describes the methods of the interface TriCommunicationTE. These methods are called from the user's adapter to pass the responses of the system under test to the test system. For example, the static method triEnqueueMsg must be called to pass a message to the test system such that the message can be processed by a receive statement in TTCN-3.

The methods are defined in Part 5 of the TTCN-3 Standard: TTCN-3 Runtime Interface (TRI).

The data types of the parameters are described in

Types for Adapter Implementation

triEnqueueMsg

void triEnqueueMsg (
   TriPortId tsiPortId,
   TriAddress SUTaddress,
   TriComponentId componentId,
   TriMessage receivedMessage
)

This method is used to pass a message to the test system. The test system can then process the message by executing a statement

Port.receive(Message) from Address

The parameter tsiPortId indicates a test system port which is mapped to port Port of the component indicated by componentId. receivedMessage holds an encoded message which must match Message. SUTaddress may be null or hold an encoded address which then must match Address.

triEnqueueCall

void triEnqueueCall (
   TriPortId tsiPortId,
   TriAddress SUTAddress,
   TriComponentId componentId,
   TriSignatureId signatureId,
   TriParameterList parameterList
)

This method is used to pass a procedure call to the test system. The test system can then process the call by executing a statement

Port.getcall(Signature:{Parameters}) from Address

triEnqueueReply

void triEnqueueReply (
   TriPortId tsiPortId,
   TriAddress SUTAddress,
   TriComponentId componentId,
   TriSignatureId signatureId,
   TriParameterList parameterList,
   TriParameter returnValue
)

This method is used to pass a reply to the test system. The test system can then process the reply by executing a statement

Port.getreply(Signature:{Parameters} value Result) from Address

The parameter tsiPortId indicates a test system port which is mapped to port Port of the component indicated by componentId. signatureId refers to Signature. parameterList holds a list of encoded values that must match Parameters. returnValue is null if the called procedure does not return a result, otherwise it holds the encoded return value which must then match Result. SUTaddress may be null or hold an encoded address which then must match Address.

triEnqueueException

void triEnqueueException (
   TriPortId tsiPortId,
   TriAddress SUTaddress,
   TriComponentId componentId,
   TriSignatureId signatureId,
   TriException exception
)

This method is used to pass an exception to the test system. The test system can then process the exception by executing a statement

Port.catch(Signature, Exception) from Address

The parameter tsiPortId indicates a test system port which is mapped to port Port of the component indicated by componentId. signatureId refers to Signature. exception holds the encoded value of the exception that must match Exception. SUTaddress may be null or hold an encoded address which then must match Address.