==================================================================
CONTROL BLOCK NAME = DFHTREN
NAME OF MATCHING ASM CONTROL BLOCK = DFHTREN
DESCRIPTIVE NAME = CICS trace entry
Licensed Materials - Property of IBM
Restricted Materials of IBM
5655-Y04
(C) Copyright IBM Corp. 1986, 2017
FUNCTION = Description of header of CICS trace entry.
LIFETIME = Created by DFHTRPT 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 = None
NOTES :
DEPENDENCIES = S/370
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 |
* |
DFHTREN |
Trace entry |
(0) |
CHARACTER |
40 |
TREN_HEADER |
Standard header |
(0) |
CHARACTER |
2 |
TREN_MARKER |
Eyecatcher '<>' |
(2) |
UNSIGNED |
2 |
TREN_LEN |
Length of entry inc. header |
(4) |
UNSIGNED |
2 |
TREN_CALLER |
Domain id of trace caller |
(6) |
UNSIGNED |
2 |
TREN_POINTID |
ID of trace point in domain |
(8) |
UNSIGNED |
1 |
TREN_TYPE |
Entry type |
(8) |
1... .... |
|
* |
The Top bits are used |
(8) |
.1.. .... |
|
* |
for the release of the |
(8) |
..1. .... |
|
* |
trace. |
(8) |
...1 .... |
|
* |
(8) |
.... 1... |
|
* |
The Bot Bits are used for |
(8) |
.... .1.. |
|
* |
the type. The types are |
(8) |
.... ..1. |
|
* |
listed below. |
(8) |
.... ...1 |
|
* |
(9) |
BIT(24) |
3 |
TREN_TASK |
Transaction manager task num |
(C) |
UNSIGNED |
2 |
TREN_KE_NUM |
Kernel task number |
(E) |
UNSIGNED |
2 |
TREN_OWNING_DOM |
Owning domain for system task |
(10) |
UNSIGNED |
2 |
TREN_HEADER_LENGTH |
Length of this header Offset of TREN_HEADER_LENGTH must not change. Add new header fields after this field |
(12) |
CHARACTER |
5 |
TREN_TCB_ID |
TCB ID |
(17) |
UNSIGNED |
1 |
TREN_CPU_TYPE |
CPU (CP, zAAP, zIIP) |
(18) |
ADDRESS |
4 |
TREN_TCBADDR |
TCB address |
(1C) |
ADDRESS |
4 |
TREN_RETADDR |
Addr of call to trace caller |
(20) |
CHARACTER |
8 |
TREN_TIME |
Time of entry - 8 byte STCK |
(28) |
CHARACTER |
* |
TREN_DATA |
Trace data |
(28) |
UNSIGNED |
2 |
TREN_FIELD_LEN |
Length of data field |
(2A) |
CHARACTER |
* |
TREN_FIELD_DATA |
Data field |
Table 2.
Len |
Type |
Value |
Name |
Description |
==================================================================
Tren type constants.
The Top Bits of TREN_TYPE will be used for the release.
X'F?' equals R710
X'E?' equals R700
X'D?' equals R690
X'C?' equals R680
X'B?' equals R670
X'A?' equals R660
X'9?' equals R650
X'8?' equals R640
X'7?' equals R630
X'6?' equals R620
X'5?' equals R610
X'4?' equals R530
X'3?' equals R520
X'2?' equals R510
X'1?' equals R410
X'0?' equals R330 and below
The Bottom Bits of TREN_TYPE will be used for the trace type.
The types below will need to be updated for release.
For example, the release after 5.1.0 will have the top bits
set like this '2?'X.
A new release field will also be added to the bottom.
If a new TREN_TYPE is added, be sure to change GTF_TYPE_NUM
in DFHTRFCA.
==================================================================
|
1 |
HEX |
F0 |
TREN_TYPE_NORMAL |
1 |
HEX |
FE |
TREN_TYPE_LE_PIPI_EXIT |
1 |
HEX |
FD |
TREN_TYPE_RRS_CALL |
1 |
HEX |
FC |
TREN_TYPE_RRMS_EXIT |
1 |
HEX |
FB |
TREN_TYPE_DB2_SUBTASK |
1 |
HEX |
FA |
TREN_TYPE_DBCTL_ RESUME_EXIT |
1 |
HEX |
F9 |
TREN_TYPE_RLS_QUIESCE_ EXIT |
1 |
HEX |
F8 |
TREN_TYPE_EXCI |
1 |
HEX |
F7 |
TREN_TYPE_LERADSYNAD_ HPO |
1 |
HEX |
F6 |
TREN_TYPE_VTAM_EXIT_ HPO |
1 |
HEX |
F5 |
TREN_TYPE_TP_END |
1 |
HEX |
F4 |
TREN_TYPE_LERAD_SYNAD |
1 |
HEX |
F3 |
TREN_TYPE_VTAM_EXIT |
1 |
HEX |
F2 |
TREN_TYPE_MONITORING |
1 |
HEX |
F1 |
TREN_TYPE_SDUMP_EXIT |
1 |
HEX |
F0 |
TREN_TYPE_R710 |
1 |
HEX |
E0 |
TREN_TYPE_R700 |
1 |
HEX |
D0 |
TREN_TYPE_R690 |
1 |
HEX |
C0 |
TREN_TYPE_R680 |
1 |
HEX |
B0 |
TREN_TYPE_R670 |
1 |
HEX |
A0 |
TREN_TYPE_R660 |
1 |
HEX |
90 |
TREN_TYPE_R650 |
1 |
HEX |
80 |
TREN_TYPE_R640 |
1 |
HEX |
70 |
TREN_TYPE_R630 |
1 |
HEX |
60 |
TREN_TYPE_R620 |
1 |
HEX |
50 |
TREN_TYPE_R610 |
1 |
HEX |
40 |
TREN_TYPE_R530 |
1 |
HEX |
30 |
TREN_TYPE_R520 |
1 |
HEX |
20 |
TREN_TYPE_R510 |
1 |
HEX |
10 |
TREN_TYPE_R410 |
1 |
HEX |
00 |
TREN_TYPE_R330 |