TCT indexing(DFHZGTI and DFHZLOC)

There are two types of requests that can be used in CICS® to locate terminal entries:
  1. DFHZGTI calls
  2. and DFHTC CTYPE=LOCATE calls
Both these modules use DFHTM calls to a variety of indexes and chains to locate terminal entries in the TCT with efficiency.
The DFHZGTI module has the following call types:
Locate
Find a TCT entry in the given ‘domain' which matches the name
GetStart
Obtain a browse token for Getnexts.
GetFirst
Find the first entry that matches the name in the given domain.
GetNext
Find the next entry that matches the name in the given domain.
GetEnd
Release the browse token
Release
Unlock an entry
Callers can decide to have an entry returned as locked or unlocked.
In DFHZGTI the total TCT is carved up into ‘domains' A TCT entry can reside in several domains depending on its type. Callers to DFHZGTI specify one domain on a call and are returned one entry that fits the name (or partial name) that is supplied. DFHZGTI calls can be for the following domains:
Terminal by termid
All terminals (local, remote, non-vtam) by the terminal id (4-char).
Session by termid
All sessions (z/OS® Communications Server, MRO, remote) by the terminal id (4-char).
Global by termid
All terminal and all sessions by the terminal id (4-char).
System by sysid
All connections (local, remote) by the sysid (4-char)
MRO system by sysid
MRO connections by sysid (4-char).
LU61 system by sysid
LU61 connections by sysid(4-char).
REMDEL system by sysid
Systems that need REMDEL sent to them (because they do not support timeout) when a local entry is deleted by sysid (4-char).
Terminal by netname
z/OS Communications Server local terminals by the netname (8-char).
System by netname
All connections (local, remote) by the netname (8-char).
Remote terminal by netname
Remote terminals by the netname (8-char).
Global by netname
Terminals, remote terminals and sessions by the netname (8-char).
Remote by Unique
All remote terminals and remote connections by the unique name that is Terminal-Owning-Region (TOR) netname, followed by a period, followed by the termid or sysid in the TOR. (13-char).
Remote terminal by Rsysid
Remote terminals by the value of REMOTESYSTEM (4-char).
Remote system by Rsysid
Remote connections by the value of REMOTESYSTEM (4-char).
Indirect system by Rsysid
Indirect connections by the value of REMOTESYSTEM (4-char).
Generic system by mbrname
Generic connections by the member-name of the connection in the generic z/OS Communications Server resource (8-char).

DFHTC CTYPE=LOCATE calls are processed by DFHZLOC. DFHZLOC does not have access to as wide a range of domains as DFHZGTI, but it provides extra facilities such as finding particular types of sessions for a connection. Both DFHZGTI and DFHZLOC can lock TCT entries.



dfhs3c001018.html | Timestamp icon Last updated: Monday, 5 June 2017