CONTROL BLOCK NAME = DFHTMDEL
DESCRIPTIVE NAME = CICS TS Table Manager Directory Element
Licensed Materials - Property of IBM
Restricted Materials of IBM
5655-Y04
(C) Copyright IBM Corp. 1992, 1995
FUNCTION =
The table management directory element is a set of pointers
that address members of chains of directory elements and a
pointer to the corresponding directory segment. SKTFDEA in
the table points to the first directory element and DIRGNCHN
in each directory element points to its successor.
DIRGPCHN points back to the predecessor and is 0 if at the
front of the chain
LIFETIME =
Since directory elements are grouped into directory segments,
see the prolog for DFHTMDSG (directory segment) for details
about storage allocation.
Storage for a directory element will last for the duration
of a CICS run though, if a table entry is deleted then its
corresponding directory element will be marked as reusable
and placed on a chain of free directory elements.
STORAGE CLASS =
Shared storage above the 16M line.
LOCATION =
SKTFDEA in the scatter table points to the first directory
element, and DIRGNCHN in each directory element points to
its successor.
DIRELEMA in a directory segment points to the start of a
group of directory elements.
SKTFRDE in the scatter table points to the first free
directory element. Subsequent free directory elements are
chained together by the DIROWCHN field in the directory
element.
INNER CONTROL BLOCKS = None.
NOTES :
DEPENDENCIES = S/370
RESTRICTIONS = None.
------------------------------------------------------------------
EXTERNAL REFERENCES = None.
CONTROL BLOCKS = None.
GLOBAL VARIABLES (Macro pass) = None.
------------------------------------------------------------------
Table 1.
Offset Hex |
Type |
Len |
Name (Dim) |
Description |
(0) |
STRUCTURE |
* |
DIRELEM |
Directory element |
Directory element information
|
(0) |
CHARACTER |
28 |
DIREINFO |
Directory element info. |
(0) |
ADDRESS |
4 |
DIRTEA |
Table entry address |
(4) |
ADDRESS |
4 |
DIRHSCHN |
Hash chain |
(8) |
ADDRESS |
4 |
DIROWCHN |
Ownership chain |
(C) |
ADDRESS |
4 |
DIRPRIME |
Ptr. to primary DE. |
(10) |
ADDRESS |
4 |
DIRGNCHN |
Get next chain pointer |
(14) |
ADDRESS |
4 |
DIRGPCHN |
Get previous chain ptr |
(18) |
UNSIGNED |
1 |
DIRETTC |
Table type code |
(19) |
BIT(8) |
1 |
DIRSTATS |
Status of directory entry |
(19) |
1... .... |
|
DIRBFREE |
Directory entry is free |
(19) |
.1.. .... |
|
DIRBTEAQ |
DE is quiesced |
(19) |
..1. .... |
|
DIRBFIXD |
Table entry free forbidden |
(19) |
...1 .... |
|
* |
Reserved |
(19) |
.... 1... |
|
* |
Reserved |
(19) |
.... .1.. |
|
* |
Reserved |
(19) |
.... ..1. |
|
DIRBADD |
Uncommitted ADD request |
(19) |
.... ...1 |
|
DIRBDEL |
Uncommitted DELETE request |
(1A) |
BIT(8) |
1 |
DIRTYPE |
Type of entry |
(1A) |
1... .... |
|
DIRBPRIM |
Primary entry |
(1A) |
.1.. .... |
|
DIRBALI |
Alias entry |
(1A) |
..1. .... |
|
DIRBINDX |
Index entry |
(1A) |
...1 1111 |
|
* |
Reserved |
(1B) |
BIT(8) |
1 |
* |
Reserved |
Directory entry key
|
(1C) |
CHARACTER |
* |
DIRKEY |
Key of this entry |