CONTROL BLOCK NAME = DFHTRFTC
DESCRIPTIVE NAME = CICS/ESA (TR) Feature Trace Entry Header
Licensed Materials - Property of IBM
Restricted Materials of IBM
5655-Y04
(C) Copyright IBM Corp. 1995, 2010
FUNCTION = This is the header for a trace entry made by
a Feature when the DFHTRFTM TRACE_PUT interface is
used.
It appears immediately after the TREN_HEADER for
a Feature trace entry, as the first part of the
TREN_DATA. The remaining trace entry data,
supplied by the Feature as TRFT_DATAn (where n is
between 1 and 7) on the TRFT TRACE_PUT call,
follows immediately after the TRFTE_HEADER.
LIFETIME = Created by DFHTRFT in the internal trace table for
each TRACE_PUT. Destroyed when overwritten after
the next trace table wrap. Trace entries are also
held on auxiliary trace datasets and GTF datasets.
STORAGE CLASS = Held in the internal trace table in MVS storage.
LOCATION = Each trace table block contains a block header
followed by as many entries contiguously as will
fit in the rest of the block.
INNER CONTROL BLOCKS =
This is an inner control block to the DFHTREN.
DFHTRFTE has no inner control blocks itself.
NOTES :
DEPENDENCIES = S/390
RESTRICTIONS = None
MODULE TYPE = Control block definition
------------------------------------------------------------------
EXTERNAL REFERENCES = None
DATA AREAS = None
CONTROL BLOCKS = None
GLOBAL VARIABLES (Macro pass) = None
------------------------------------------------------------------
Table 1. | Offset Hex |
Type |
Len |
Name (Dim) |
Description |
| (0) |
STRUCTURE |
94 |
TRFTE |
Feature trace entry |
| (0) |
UNSIGNED |
2 |
TRFTE_HEADER_LEN |
Feature trace header length - excludes the length of this field itself |
| (2) |
CHARACTER |
92 |
TRFTE_HEADER |
Feature trace header |
| (2) |
UNSIGNED |
1 |
TRFTE_VERSION |
Feature trace header version |
| (3) |
UNSIGNED |
1 |
* |
SPARE |
| (4) |
CHARACTER |
30 |
TRFTE_COMPANY_NAME |
Feature company name |
| (22) |
CHARACTER |
30 |
TRFTE_FEATURE_NAME |
Feature name |
| (40) |
CHARACTER |
10 |
TRFTE_FEATURE_LEVEL |
Feature release level |
| (4A) |
CHARACTER |
8 |
TRFTE_FORMATTING_ ROUTINE |
Feature trace formatting routine |
| (52) |
CHARACTER |
9 |
TRFTE_ABBREV_NAME |
Name for formatted trace |
| (5B) |
BIT(8) |
1 |
TRFTE_FLAGS |
Feature trace entry flags |
| (5B) |
1... .... |
|
TRFTE_EXCEPTION_TRACE |
Exception trace flag |
| (5B) |
.111 1111 |
|
* |
Spare |
| (5C) |
CHARACTER |
2 |
* |
Spare |
Table 2. | Offset Hex |
Type |
Len |
Name (Dim) |
Description |
| (0) |
STRUCTURE |
108 |
TRFTW |
FEATURE TRACE ENTRY |
| (0) |
ADDRESS |
4 |
TRFTW_FORMATTING_ ADDRESS (6) |
STORED ADDR |
| (18) |
CHARACTER |
8 |
TRFTW_FORMATTING_ NAME (6) |
STORED NAMES |
| (48) |
CHARACTER |
4 |
* |
SPARE |
| (4C) |
CHARACTER |
32 |
TRFTW_WIPE_AREA |
WIPED EACH CAL |
| (4C) |
UNSIGNED |
1 |
TRFTW_TRACE_TYPE |
TYPES BELOW |
| (4D) |
BIT(8) |
1 |
TRFTW_FLAGS |
| (4D) |
1... .... |
|
TRFTW_INTERPRETATION |
FOREIGN CODE |
| (4D) |
.1.. .... |
|
TRFTW_LOAD_FAILED |
MVS LOAD |
| (4D) |
..1. .... |
|
TRFTW_NO_NAME |
NO FORMAT |
| (4D) |
...1 .... |
|
TRFTW_FEATURE_ABEND |
NO FORMAT |
| (4D) |
.... 1... |
|
TRFTW_INT_OVERFLOW |
| (4D) |
.... .111 |
|
* |
SPARE |
| (4E) |
UNSIGNED |
2 |
TRFTW_LEN_LEFT |
WORK AREA |
| (50) |
ADDRESS |
4 |
TRFTW_NAB |
PTR WORK AREA |
| (54) |
ADDRESS |
4 |
TRFTW_DFHTRIB_ADDRESS |
TRIB ADDRESS |
| (58) |
ADDRESS |
4 |
TRFTW_CDPFTAB_ADDRESS |
CDURUN TABLE |
| (5C) |
CHARACTER |
8 |
TRFTW_MODULE_NAME |
FT MOD NAME |
| (64) |
CHARACTER |
8 |
* |
SPARE |
Constants
Table 3. | Len |
Type |
Value |
Name |
Description |
| 1 |
DECIMAL |
0 |
TRFTW_ENTRY |
ENTRY |
| 1 |
DECIMAL |
1 |
TRFTW_EXIT |
EXIT |
| 1 |
DECIMAL |
2 |
TRFTW_EXCEPTION |
EXCEPTION |
| 1 |
DECIMAL |
3 |
TRFTW_DATA |
DATA |
| 1 |
DECIMAL |
4 |
TRFTW_EVENT |
EVENT |
| 1 |
DECIMAL |
9 |
TRFTW_RUB |
| 1 |
DECIMAL |
0 |
TRFTW_RC_OK |
OK |
| 1 |
DECIMAL |
1 |
TRFTW_RC_OVERFLOW |
Overflow |