Appendix D
TDP Operations
After completing this appendix, you will be able to: Describe how the Teradata database is accessed through channel-attached clients. Discuss the function of the Teradata Director program (TDP) and how it processes parcels. Describe how Teradata returns answer sets to the client system. Describe how the Teradata database is accessed through network-attached clients. Discuss how to use session pools, including how to start and stop them.
Channel Environment
SYSTEM CONSOLE
OS390 AS TSO AS CICS AS IMS/DC
IMS MPP / BMP PreProcessed Batch or Teradata Utilities
AS
AS
( TDP)
Teradata Director
ITEQ BTEQ CICS or Transactions Coordinated Products
Program
CLI
CLI
CLI
CLI
CROSS MEMORY SERVICES (XMS)
BLOCK MULTIPLEXOR CHANNEL
Node
Channel Driver Software
HostNo 512
Gateway Software
HostNo 52
PE 16383
PE 16382
PE 16381
PE 16380
RDBMS
Sending Parcels to the TDP
USER REGION
TDP REGION
APPLICATION
REQUEST BUFFER USER CODE REQ PARCEL (SQL TEXT) RESPOND PARCEL REQUEST PARCEL
TDP
RESPOND PARCEL
RESPONSE BUFFER
MESSAGE
MESSAGE HEADER OTHER REQUESTS CONTEXT AREA HSICB
FUNCTION CODE SESSION NUMBER REQUEST NUMBER TIMESTAMP FIELDS
OTHER REQUESTS
HEADER
CHANNEL BLOCK
CLI
Moves Parcels (SQL statements) into application REQUEST BUFFER. The RESPOND parcel indicates the size of the RESPONSE BUFFER.
PE RDBMS
PE
Communicating with the TDP
From an MVS host console: F Tdpid, TDPcommandtext Where: F is the abbreviation for MVS modify. Tdpid is the four-character identifier for the TDP subsystem. TDPcommandtext is the syntax of the TDP command.
In a VM environment: Tdpid, TDPcommandtext Where: Tdpid is the four-character identifier for the TDP subsystem. TDPcommandtext is the syntax of the TDP command.
TDP Operator Commands
TDP
Display Module Display TDP RUN SHUTDOWN
CANCEL QUIck Orderly
IFP
ATTach DETach Display STArt STOp
POOL
ENAble DISAble Display LOGOFF MODIFY STArt STOp
2PC
COMMIT ENAble IRF DISAble IRF DISPLAY INDoubt ROLLBACK
SET Userid SET Charset SET Comchar
SMF
ENAble DISAble Display
QUEUES
Display
CELLS
Display ADD CELLS ADD XMSCELLS
LOGONS
DISAble ENAble
SESsion / JOB
TEST
EXITS
ENAble DISAble
TIME
ENAble DISAble
Display ENAble LOGOFF DISAble SET MAXSESS DISABLE SESSION RESERVE ENABLE SESSION RESERVE DISABLE SESSION DETAIL ENABLE SESSION DETAIL DISABLE SESSION STATUS ENABLE SESSION STATUS
AUTHORIZ
USERID ALL JOB
SAF
MODIFY DISABLE ENABLE
CHANNEL PROCESSORS
DISPLAY
SESSION PROCESSORS
DISPLAY
Sessions and Session Pools
A session is:
A logical connection between the user and the database that permits a user one request and one response at a time. Sessions are explicitly logged on to and off from the database and are identified by a logical client ID and a session number.
A session pool is:
A number of sessions using the same logon string that are logged on to the database using a START POOL command. To log off a session pool, use the LOGOFF or STOP POOL command. When you run a session pool, the TDP does not notify the database when an application logs off. It marks the session, not in use and makes it available to another application.
Starting a Session Pool
Start Pool Num 8 LOGON Orders, xxxxxxxxx
[Link] T: TDP0865 STARTING POOL ID: POOL0002 [Link] T: TDP0866 ADDING 0008 SESSIONS TO POOL ID: POOL0002 [Link] T: TDP0899 SESSION 1288 STARTED, JOB POOL0002 [Link] T: TDP0899 SESSION 1289 STARTED, JOB POOL0002 [Link] T: TDP0899 SESSION 1290 STARTED, JOB POOL0002 [Link] T: TDP0899 SESSION 1291 STARTED, JOB POOL0002
: : :
. ; POOL ID: POOL0002 SESSION NUMBERS 1288, 1289, 1290, 1291, 1292, 1293, 1294, 1295
TDP
PE SESSION 1288 SESSION 1292
PE SESSION 1289 SESSION 1293
PE SESSION 1290 SESSION 1294
PE SESSION 1291 SESSION 1295
Using a Session Pool
.LOGON ORDERS xxxxxxxxx .LOGON ANOTHER, yyyyyyyyy
.POOL ID: POOL0002 SESSION NUMBERS 1288, 1289, 1290, 1291, 1292, 1293, 1294, 1295
TDP
.SESSION CONTROL SESSION NUMBERS 1904
PE SESSION 1288 SESSION 1292
PE SESSION 1289 SESSION 1293 SESSION 1904
PE SESSION 1290 SESSION 1294
PE SESSION 1291 SESSION 1295
Using a session pool typically saves 2 to 3 seconds logon time. If all the sessions in the pool are active, additional logons fail. If sessions in the pool are disabled, logons fail.
Ending a Session Pool
Stop Pool ID Pool0002
[Link] T: TDP0867 STOPPING POOL ID: POOL0002 [Link] T: TDP861 POOL ID: POOL002 IS NOW: STOPPED [Link] T: TDP0898 SESSION 1295 ENDED, JOB POOL0002 RC=0000 [Link] T: TDP0898 SESSION 1294 ENDED, JOB POOL0002 RC = 0000 [Link] T: TDP898 SESSION 1293 ENDED, JOB POOL0002 RC = 0000 [Link] T: TDP0898 SESSION 1292 ENDED, JOB POOL0002 RC = 0000 [Link] T: TDP0898 SESSION 1291 ENDED, JOB POOL0002 RC = 0000
TDP
.SESSION CONTROL SESSION NUMBERS 1904
PE
PE SESSION 1904
PE
PE
DISABLE POOL STOP POOL
Disables Logons but does not end pool. Logs off unused sessions and disables new logons. When all sessions have logged off, the pool is ended. Logs off active sessions and ends pool.
LOGOFF POOL
TDP Memory Management
The TDP typically uses a virtual region of about 4 to 5 Megabytes. To avoid overhead calls to the operating system, the TDP divides its work areas in cells.
PROGRAM STORAGE 320K
CELLS
FREE STORAGE 500K
A warning message (TDP0021) displays when 80% of the cells of a certain size are in use. appearing when
D CELLS
TDP0501 TDP0528 TDP0528 TDP0528 TDP0528 TDP0528 TDP0528 TDP0528 CELSZ 00064 00128 00240 00256 00352 00992 12272 AVAIL INUSE 00062 00002 00050 00014 00032 00032 00320 00056 00480 00032 01331 00013 00009 00001 MXUSE GMAIN XMS #WAITS 00003 00000 00000 00000 00017 00000 00000 00000 00032 00000 00000 00000 00077 00000 00200 00000 00032 00000 00200 00000 00013 00000 00300 00000 00006 00000 00000 00000
TDP0529 OVERSIZE CELLS, INUSE : 1, MXUSE: 1, GETMAINS : 1
ADD CELLS SIZE 256 NUMBER 1 This command adds an extent of sixteen 256 byte cells.
Client Configuration Overview Summary
The Teradata Channel Interface is an architecture that enables communication between a mainframe client a Teradata server. The Teradata Director Program (TDP) resides on the mainframe and manages communication between the client application programs and the Teradata server. The Micro Teradata Director Program resides on the network and parcels user requests. It then sends them to the gateway, and on to the parsing engine (PE). A session is a logical connection between the user and the database. It permits a user one request and one response at a time. Users must logon and logoff from sessions; sessions are identified by a client ID and session number. A session pool is a number of sessions logged on to the Teradata server as a unit using the same logon string. Session pools are logged on and off from the database. The TDP does not notify the database when an application logs off, but instead marks the session as not in use.
Review Questions
Indicate whether a statement is True (T) or False (F).
1. The Teradata Director Program (TDP) facilitates communication between LAN clients and the Teradata database.
2. WorldMark servers can use either ESCON or Bus and Tag channel connections to connect to a mainframe host. 3. You can enter TDP commands from MVS and VM consoles before the RUN command.
Module 9 Review Questions
Solutions
Indicate whether a statement is True (T) or False (F).
1. The Teradata Director Program (TDP) facilitates communication between LAN clients and the Teradata database.
2. WorldMark servers can use either ESCON or Bus and Tag channel connections to connect to a mainframe host. 3. You can enter TDP commands from MVS and VM consoles before the RUN command.
