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

16:51:24 T: TDP0865 STARTING POOL ID: POOL0002 16:51:24 T: TDP0866 ADDING 0008 SESSIONS TO POOL ID: POOL0002 16:51:25 T: TDP0899 SESSION 1288 STARTED, JOB POOL0002 16:51:25 T: TDP0899 SESSION 1289 STARTED, JOB POOL0002 16:51:26 T: TDP0899 SESSION 1290 STARTED, JOB POOL0002 16:51:26 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
20:02:24 T: TDP0867 STOPPING POOL ID: POOL0002 20:02:24 T: TDP861 POOL ID: POOL002 IS NOW: STOPPED 20:02:25 T: TDP0898 SESSION 1295 ENDED, JOB POOL0002 RC=0000 20:02:25 T: TDP0898 SESSION 1294 ENDED, JOB POOL0002 RC = 0000 20:02:26 T: TDP898 SESSION 1293 ENDED, JOB POOL0002 RC = 0000 20:02:26 T: TDP0898 SESSION 1292 ENDED, JOB POOL0002 RC = 0000 20:02:27 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.