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 (4294967302:456211456) |
STORED ADDR |
(18) |
CHARACTER |
8 |
TRFTW_FORMATTING_ NAME (4294967302:456211456) |
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 |
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 |