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.