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.