Table 108 summarizes the trace domain’s specific gates. It shows the level-1 trace point IDs of the modules providing the functions for the gates, the functions provided by the gates, and whether or not the functions are available through the exit programming interface (XPI).
Gate | Trace | Function | XPI |
---|---|---|---|
TRPT |
None |
TRACE_PUT |
YES |
TRSR |
TR 0201 TR 0202 |
SET_INTERNAL_TABLE_SIZE START_INTERNAL_TRACE STOP_INTERNAL_TRACE INQUIRE_INTERNAL_TRACE START_AUXILIARY_TRACE STOP_AUXILIARY_TRACE PAUSE_AUXILIARY_TRACE SET_AUX_TRACE_AUTOSWITCH SWITCH_AUXILIARY_EXTENTS INQUIRE_AUXILIARY_TRACE START_GTF_TRACE STOP_GTF_TRACE INQUIRE_GTF_TRACE ACTIVATE_TRAP DEACTIVATE_TRAP |
NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO |
This function is invoked to write a trace entry to the active trace destinations.
The maximum total length of data that can be traced in one call is as described below:
Length of trace table block 4096
less length of trace table block header - 24
less length of trace entry header - 32
------
Maximum space for data + length fields 4040
For each DATA field specified, 2 bytes must be
subtracted to allow for the length field.
Maximum space for actual data = 4040 - (2 * n)
where 'n' is the number of DATA fields specified.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
The SET_INTERNAL_TABLE_SIZE function of the TRSR gate is used to change the size of the internal trace table during a CICS® run.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
RESPONSE | Possible REASON values |
---|---|
INVALID |
INVALID_TABLE_SIZE NO_SPACE |
Note:
INVALID_TABLE_SIZE indicates
that the value of TABLE_SIZE is less than 16KB. NO_SPACE indicates that the variable GETMAIN for the new trace table failed to obtain even the minimum trace table size. In this situation, the trace domain retains an amount equal to the minimum table size from the old table to use. |
The START_INTERNAL_TRACE function of the TRSR gate is used to activate tracing to the internal trace table.
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
The STOP_INTERNAL_TRACE function of the TRSR gate is used to deactivate tracing to the internal trace table.
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
The INQUIRE_INTERNAL_TRACE function of the TRSR gate is used to return the status of the internal trace and the current size of the internal trace table.
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
The START_AUXILIARY_TRACE function of the TRSR gate is used to open the current auxiliary trace extent (if it is closed) and start tracing to it.
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
RESPONSE | Possible REASON values |
---|---|
EXCEPTION |
CANT_GET_AUX_BUFFER DFHTRAO_NOT_AVAILABLE OPEN_FAILED |
Note:
CANT_GET_AUX_BUFFER indicates
that MVS had insufficient free storage to satisfy the request for a buffer
below the 16MB line. DFHTRAO_NOT_AVAILABLE indicates that the request to the CICS loader to acquire the auxiliary trace output program, DFHTRAO, has failed. OPEN_FAILED indicates that the MVS open of the auxiliary trace data set has failed. |
The STOP_AUXILIARY_TRACE function of the TRSR gate is used to stop auxiliary tracing and close the currently active auxiliary trace extent.
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
The PAUSE_AUXILIARY_TRACE function of the TRSR gate is used to stop auxiliary tracing without closing the currently active extent.
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
AUX_TRACE_STOPPED
meaning that the pause is allowed only if auxiliary trace is not stopped.
The SET_AUX_TRACE_AUTOSWITCH function of the TRSR gate is used to allow the autoswitch facility for the CICS auxiliary trace data set to be enabled or disabled.
OFF|ONCE|CONTINUOUS
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
INVALID_AUTOSWITCH_STATUS
meaning that an incorrect value was passed for AUTOSWITCH_STATUS.
The SWITCH_AUXILIARY_EXTENTS function of the TRSR gate allows switching from one auxiliary trace extent to the other.
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
OPEN_FAILED
meaning that the attempt to open the new auxiliary extent failed.
The INQUIRE_AUXILIARY_TRACE function of the TRSR gate is used to return the current state of the auxiliary trace.
None.
STARTED|STOPPED|PAUSED
DFHAUXT|DFHBUXT
OFF|ONCE|CONTINUOUS
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
The START_GTF_TRACE function of the TRSR gate is used to start the tracing of CICS activity to GTF. It is the responsibility of the user to ensure that GTF has been started in MVS with at least TRACE=USR. If it has not, CICS issues the GTF calls but they are ignored by GTF.
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
CANT_GET_GTF_BUFFER
meaning that there was insufficient storage for a buffer to be used in constructing continuation records when an individual entry is longer than 256 bytes.
The STOP_GTF_TRACE function of the TRSR gate is used to stop tracing of CICS activity to GTF.
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
The INQUIRE_GTF_TRACE function of the TRSR gate is used to return the current state of the GTF trace.
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
The ACTIVATE_TRAP function of the TRSR gate is used to activate the FE global trap/trace exit (DFHTRAP).
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
RESPONSE | Possible REASON values |
---|---|
EXCEPTION |
DFHTRAP_NOT_FOUND DFHTRAP_UNUSABLE |
Note:
DFHTRAP_NOT_FOUND indicates
that the request to the CICS loader to acquire the FE global trap/trace exit
program, DFHTRAP, has failed. DFHTRAP_UNUSABLE indicates that the trap was already active, but marked as unusable because a program check had previously occurred when DFHTRAP was in control. |
The DEACTIVATE_TRAP function of the TRSR gate is used to deactivate the FE global trap/trace exit (DFHTRAP).
None.
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED