TRFT gate, TRACE_PUT function

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

Input Parameters

FEATURE_TRACE_TOKEN
A token that the feature uses to identify itself to the CICS trace domain.
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

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 DFHTRF4 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.

EXCEPTION_TRACE
Optional Parameter
A binary value indicating whether the trace entry is for an exception trace.
Values for the parameter are:
  • NO
  • YES
RETURN_ADDR
Optional Parameter
is used by DFHTRFT to provide a return address for the module that originally requested the trace entry.

Output Parameters

REASON
The following values are returned when RESPONSE is INVALID:
  • DEREGISTERED_FEATURE
  • INV_FEATURE_TRACE_TOKEN
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


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