TCT indexing(DFHZGTI and DFHZLOC)
There are two types of requests that can be used in CICS® to locate terminal entries:
- DFHZGTI calls
- and DFHTC CTYPE=LOCATE calls
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
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.