TRPT gate, TRACE_PUT function

This function is invoked to write a trace entry to the active trace destinations.

Input Parameters

POINT_ID
is a number, unique within the calling domain, that identifies the trace entries made from this call.
DATA1
DATA2
DATA3
DATA4
DATA5
DATA6
DATA7
Optional Parameter

are BLOCK descriptions of up to seven areas to be included in the data section of the trace entry. They appear in numerical order in the entry. Each data field is preceded by a 2-byte length field. If the DFHTRP4 format is in use, the parameters are BLOCK64 so that 64-bit data can be traced.

The maximum total length of data that can be traced in one call is 4000 bytes. The total length of all the data fields and all their 2-byte length fields must be within this limit.

DOMAIN_TOKEN
Optional Parameter
A token that identifies the calling domain to the trace domain.
RETURN_ADDR
Optional Parameter
is used by DFHTRPT to provide a return address for the module that originally requested the trace entry.

Output Parameters

RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


dfhs3_TRPTtrace_put.html | Timestamp icon Last updated: Monday, 5 June 2017